Il nuovo sito del GuIT e la pagina sulla documentazione

  • Creatore
    Topic
  • #65410
    lorenzo.pantieri
    Partecipante
      Up
      0
      Down
      ::


      Ciao a tutti. Visto che sono co-autore di una guida a LaTeX, su questo argomento sono di parte. Vogliate accettare lo stesso le mie riflessioni.

      http://www.guitex.org/home/index.php?option=com_content&view=article&id=4&Itemid=23&lang=it

      1.

      La documentazione è essenziale per i sistemi non visuali. In questa sezione troverete un elenco ragionato del materiale disponibile.

      Trovo l’espressione “sistema non visuale ” inutilmente criptica: io direi più semplicemente che “la doc. è essenziale per un software come LaTeX”. Anche “il materiale disponibile” è fuorviante: di materiale disponibile su LaTeX ce n’è molto di più. Ammorbidirei in “alcune guide e manuali su questo programma”. Tommaso farebbe sicuramente meglio.

      2.

      Guide per iniziare

      La Guida del GuIT

      Più semplicemente: la Guida GuIT. È il riferimento per l’utente italiano del sistema di composizione LaTeX. La guida, curata dal Prof. Claudio Beccari, viene periodicamente aggiornata e quella che trovate qui è l’ultima versione di luglio 2011.

      Qui per me ci sono tre errori.

      a) Che la guida sia solo “curata” dal prof. Beccari mi sembra falso, e in ultima analisi ingeneroso nei confronti di Claudio, che ha (io credo) peccato di modestia: Claudio è l’autore di quella guida, altro che il (semplice) curatore! C’è qualcuno del Gruppo che si sente autore o co-autore della guida? Non credo di dire bestemmie affermando che l’ “Introduzione all’arte della composizione tipografica con LaTeX” sia farina (finissima e squisita) del sacco di Claudio. (Gli) va riconosciuto.

      b) Che poi la guida sia “il riferimento per l’utente italiano del sistema di composizione LaTeX” mi pare non definisca bene lo status di quel lavoro, che, come dice lo stesso Claudio nella prefazione, presuppone che il lettore abbia già una certa dimestichezza con LaTeX. Io direi che l’Introduzione (di Claudio, non del GuIT) è un manuale su LaTeX in italiano che sviscera LaTeX in profondità, esaminandone (anche) gli aspetti più complessi.

      c) Che la guida di Beccari sia “per iniziare” è smentito da quanto scrive l’autore stesso nella prefazione.

      3.
      Mettere l’Arte sotto “Le guide di Pantieri” è ingeneroso per Tommaso, con cui collaboro da anni; l’Arte è tanto mia quanto sua (ormai, è più sua che mia…) . Anche qui, non si tratta di riconoscere un merito: si tratta di dire la verità. Su questo punto non transigo: va corretto. 😉

      Che cosa propongo? Di strutturare la pagina di documentazione come segue.

      Guide e manuali in italiano

      Guide di base, per iniziare:

      • L’arte di scrivere con LaTeX (di Lorenzo Pantieri e Tommaso Gordini)
      • LaTeX per l’impaziente (di Lorenzo Pantieri)

      Per approfondire:

      • Introduzione all’arte della composizione tipografica con LaTeX (di Claudio Beccari)
      • Complementi all’Arte di scrivere con LaTeX (di Lorenzo Pantieri)
      • LaTeX, breve guida ai pacchetti di uso più comune (di Enrico Gregorio)
      • Introduzione a XeLaTeX (di Enrico Gregorio)
      • Introduzione a TeXworks (di Enrico Gregorio)

      Tutto qui.

      Chiedo scusa per l’auto-citazione (che ho sempre considerato una pratica delle più sgradevoli): al di là della proposta, opinabilissima, credo che le inesattezze vadano corrette e i meriti più equamente distribuiti…

      A presto,
      L.

    Visualizzazione 1 filone di risposte
    • Autore
      Risposte
      • #65411
        Up
        0
        Down
        ::


        Commosso per le lusinghiere parole, concordo con Lorenzo. 8)

        Critiche a parte, la pagina web in questione, con i frontespizi dei PDF mi piace molto 🙂

        Se posso esprimere la mia opinione, LaTeX per l’impaziente e i Complementi mi stupiscono non poco! Sono guide a cui Lorenzo non mette mano da tempo, e neppure io sono mai riuscito a convincerlo a travasare qualcosa dai Complementi all’Arte. Come ci siete riusciti? 👿 😛 🙂 😆

        Ciao
        Tommaso

      • #65412
        lorenzo.pantieri
        Partecipante
          Up
          0
          Down
          ::

          illinguista1972″ post=64496Critiche a parte, la pagina web in questione, con i frontespizi dei PDF mi piace molto.

          Critiche a parte, piace anche a me.

          illinguista1972″ post=64496Se posso esprimere la mia opinione, LaTeX per l’impaziente e i Complementi mi stupiscono non poco! Sono guide a cui Lorenzo non mette mano da tempo, e neppure io sono mai riuscito a convincerlo a travasare qualcosa dai Complementi all’Arte. Come ci siete riusciti? 👿 😛 🙂 😆

          Una volta pubblicata la nuova versione dell’Arte, dovremo mettere mano anche all’Impaziente. Il lavoro non è molto, credimi: si tratta di prendere l’Arte e di eliminare tutto quanto non è strettamente indispensabile per scrivere un documento decoroso. Il nuovo Impaziente sarà di “Pantieri e Gordini”, naturalmente. Anche i Complementi andrebbero rinfrescati, ma per quello c’è tempo: non è una guida di base, al lettore che vuole approfondire LaTeX le soluzioni non mancano…

          Ciao,
          L.

      Visualizzazione 1 filone di risposte
      • Devi essere connesso per rispondere a questo topic.

      Go to top