Classi personalizzate: come suggerire all’utente di scaricare un file

  • Creatore
    Topic
  • #116255
    Up
    0
    Down
    ::


    Cari tutti,

    ho recentemente caricato su CTAN la classe UniFiTh.
    Dopo essermi accorto che il logo dell’università era stato messo per sbaglio nella cartella della documentazione (e quindi chi provava a usare la classe riceveva un errore “file not found” in fase di compilazione) ho scritto a Karl Berry (TeXLive) e Christian Schenk (MiKTeX) per rimediare al problema.
    Così facendo però, Karl Berry si è accorto che il logo non è “free software” e quindi non può essere distribuito con TeXLive.

    Scrivo per chiedere secondo voi qual è la soluzione più intelligente al problema. Considerando anche che il 90% degli utenti non legge la documentazione…
    Io avevo pensato a due soluzioni:
    1. se manca il logo, si stampa un messaggio di errore nel log con una brevissima descrizione del problema e il link per scaricare il logo
    2. se manca il logo, il pdf viene compilato lo stesso ma al posto del logo compare un rettangolo con una brevissima descrizione del problema e il link per scaricare il logo

    Grazie mille.
    Ciao ciao.
    Fra

Visualizzazione 8 filoni di risposte
  • Autore
    Risposte
    • #116256
      Up
      0
      Down
      ::


      Ciao, premetto che non sono un utente esperto comunque mi permetto di dire la mia per questo motivo..
      Secondo me l’opzione migliore è la prima perché in questo modo ci si accorge subito del problema…
      Ho detto la mia poi vedi tu

    • #116257
      sergio
      Partecipante
        Up
        0
        Down
        ::


        A mio parere, invece, l’utente meno esperto fatica a leggere nel file di log soprattutto con compilazioni di file complessi e sarebbe meglio la seconda opzione. Entrambe le opzioni insieme non sarebbe una soluzione possibile?

        sergio

      • #116258
        Up
        0
        Down
        ::


        Ricordo che mi trovai in una situazione molto simile quando scrissi la classe per le lettere dei dottorandi padovani. In quella circostanza optai per un avvertimento a schermo, e non solo nel file [tt].log[/tt], emesso tramite [tt]\ClassWarningNoLine[/tt] durante il caricamento della classe stessa. Oltre a ciò, metterei, al posto del logotipo, una cornicetta di uguali dimensioni con il nome del file, esattamente come fa il modo [tt]draft[/tt] del pacchetto graphics; si potrebbe pensare di aggiungere sotto, in piccolo, la dicitura «Scaricabile da qui», dove la parola «qui» dovrebbe essere un collegamento ipertestuale, ma io lo sconsiglio. Tieni presente che questa seconda opzione richiede, primo, che sia caricato il pacchetto hyperref, secondo, che la compilazione avvenga con un engine e un formato che supportano il collegamento e infine, terzo, che anche il visualizzatore a schermo supporti il collegamento. Certo, tu mi dirai che, al giorno d’oggi, è ragionevole assumere che la gente compili con uscita PDF con pdfTeX, XeTeX a LuaTeX, per i quali hyperref possiede drivers adeguati. Concediamolo pure; ma quando si stampa il documento, cosa dovrebbe avvenire della scritta? Comprimere nello spazio, presumibilmente non grandissimo, destinato al logotipo l’URL completo dello stesso, se da un lato risolverebbe il problema per quanto riguarda la stampa, dall’altro sarebbe difficile da realizzare proprio per l’esiguità dello spazio.

        No, io metteri l’URL dentro l’avvertimento stampato a terminale, anche se quest’ultimo, ovviamente, non può essere reso «cliccabile». Oppure ancora, potresti rendere cliccabile direttamente il nome del file che stampi dentro la cornicetta (oltre a scrivere l’URL completo nel messaggio di avvertimento). Comunque, ribadisco, opterei per un avvertimento a schermo (appunto, con [tt]\ClassWarningNoLine[/tt]) e non per un messaggio nel solo file [tt].log[/tt] (emesso, tanto per capirci, con [tt]\ClassInfo[/tt]), per le ragioni che ha già spiegato @MisterMandarino.

        Ciao.


        Gustavo

      • #116259
        robitex
        Amministratore del forum
          Up
          0
          Down
          ::


          Ciao.
          Con LuaTeX è possibile durante la compilazione scaricare file dalla rete.
          Incorpora infatti la libreria luasocket.
          Occorre valutare se l’operazione non violi il copyright ma credo di no.
          Il codice potrebbe usare anche il modulo lfs o kpse per verificare se il logo è già presente (e scaricare una sola volta), e inoltre dovrebbe essere incluso in un blocco \ifluatex così da consentire la compilazione anche con altri compositori.
          R.

        • #116260
          OldClaudio
          Partecipante
            Up
            0
            Down
            ::


            Francesco, anch’io ho incontrato il problema con i loghi e il pacchetto TOPtesi. Ne allegavo una dozzina, fra cui anche loghi di università straniere, visto che TOPtesi avrebbe dovuto servire anche per le tesi per i programmi in doppio titolo.

            Quando Karl mi ha fatto osservare che non si tratta di materiale libero e che non poteva essere distribuito tramite TeX Live, ho optto per un’altra soluzione.
            Da un lato ho segnalato questa impossibilità di allegare qualsiasi logo nel file README, nel file toptesi.pdf e nel file toptesi-it.pdf, ma come giustamente osservi, gli utenti non sono molto inclini a leggere qualsiasi tipo di documentazione; Inoltre ho creato un logo finto, che contiene un disegno che ho creato io, vi ho messo dentro una acronimo di fantasia TIT (che starebbe per Turin Institute of Technlogy, che è, sì la traduzione di Politecnico di Torino, ma non è copyright di nessuno, perché solo la denominazione in italiano è quella di cui il PoliTO ha il copyright e la proprietà legale) e accanto un logotipo con quel nome di fantasia; vi ho messo dietro un watermark che riporta la dicitura in diagonale FAKE LOGO, per cui chiunque si rende conto che deve fare qualcosa in prima persona; di fatto davanti a quell’immagine, (ed ad altre immagini di fantasia, presenti nelle schermate dei vari tipi di frontespizi che si possono fare con TOPtesi) chiunque capisce che deve fare qualcosa che, ovviamente, consiste nel leggere la documentazione; lo fanno praticamente tutti, e qui sul forum non ho mai ricevuto richieste di spiegazioni in merito.

            Anche i modelli/template che ha creato Lorenzo Pantieri contengono un logo di sua fantasia che è molto più elegante del mio FAKE LOGO, ma si riferisce all’università inesistente: Otto von Guerricke Universität Magdeburg; Anche nella documentazione del pacchetto frontespizio di Enrico Gregorio si usa un logo fittizio che che si riferisce all’università fittizia di St. Anford. Quindi i loghi fittizi sono una buona soluzione già adottata da altri.

            I consigli e i suggerimenti che ti hanno inviato gli altri che ti hanno scritto in merito sono tutti validi e non sono mutuamente esclusivi, come non escludono nemmeno gli altri approcci che ti ho descritto; quindi non hai altro che l’imbarazzo della scelta.

          • #116261
            Up
            0
            Down
            ::


            Grazie mille a tutti per le spiegazioni e gli ottimi suggerimenti!

            A presto con la nuova versione di UniFiTh!

            Ciao ciao.
            Fra

          • #116262
            Up
            0
            Down
            ::


            Cari tutti,

            nella versione 1.2 di UniFiTh alla fine ho deciso di fare così:
            1. usare il comando \IfFileExists per controllare se il logo esiste o meno;
            2. nel caso esista tutto ok e carico il logo
            3. nel caso non esista restituisco un Warning (\ClassWarningNoLine) dove semplicemente dico di guardare la documentazione o il frontespizio.
            Carico hyperref e poi sul frontespizio, al posto del logo, creo un rettangolo con l’ambiente picture al cui interno metto un warning, il link cliccabile da cui scaricare il logo e le istruzioni su dove metterlo.

            Quindi non ho creato un vero fake logo. Ma ho fatto tutto con l’ambiente picture.

            Purtroppo la parte del warning nel file log, cioè il \ClassWarningNoLine, non sarà subito disponibile per un mio errore di caricamento dei file sul CTAN… comparirà con un futuro aggiornamento.

            Grazie a tutti!

            Ciao ciao.
            Fra

          • #116263
            OldClaudio
            Partecipante
              Up
              0
              Down
              ::


              Ottimo. In altri tempi si sarebbe detto “Troppa grazia sant’Antonio”… 😉

            • #116264
              Up
              0
              Down
              ::

              OldClaudio” post=116708Ottimo. In altri tempi si sarebbe detto “Troppa grazia sant’Antonio”… 😉

              😀

          Visualizzazione 8 filoni di risposte
          • Devi essere connesso per rispondere a questo topic.

          Go to top