Progetto LaTeXpedia – enciclopedia del LaTeX

  • Creatore
    Topic
  • #11812
    Up
    0
    Down
    ::


    In un recente topic è stata sollevata la questione delle guide dove imparare LaTeX. Il problema è che nessuna copre tutti gli argomenti ed alcune risultano obsolete.

    Dalla discussione è nata un’idea che ritengo innovativa e stimolante: creare un’enciclopedia del LaTeX a cui possano contribuire tutti, come Wikipedia. Un progetto di questo tipo ha notevoli vantaggi tra cui

    1. il numero di persone che contribuiscono è illimitato. L’esperienza di Wikipedia insegna che spesso chi usufruisce dell’enciclopedia, in seguito contribuisce e quindi la base si allarga costantemente.

    2. ognuno aggiunge soluzioni ai problemi che ha trovato. Chi scrive un manuale, infatti riporta quasi esclusivamente i problemi che ha trovato nella propria esperienza di utente LaTeX e quindi difficilemente potrà scrivere una guida esaustiva.

    3. esperti correggono le soluzioni proposte. Gli utenti più esperti possono concentrarsi sulla correzione delle soluzioni scritte dagli altri in modo che il lavoro sia distribuito a tutti i livelli (nei manuali di solito tutto il lavoro è a carico degli esperti).

    4. l’opera diventa fruibile fin dall’inizio. Il manuale richiede invece che si raggiunga una certa quantità di materiale prima di pubblicarne la prima edizione.

    Io non so come funzioni Wikipedia e quanto lavoro richieda mettere su qualcosa di simile che sfrutti il motore wiki tuttavia ritengo che un’iniziativa per il LaTeX in quella direzione sarebbe interessante ed innovativa (che io sappia nessun altro TUG si è mosso in questa direzione).

    Se qualcuno conosce il funzionamento di Wikipedia è invitato ad intervenire in questa discussione. Credo che, se realizzabile, LaTeXpedia potrebbe essere un’ottima iniziativa per GuIT.

Visualizzazione 25 filoni di risposte
  • Autore
    Risposte
    • #11813
      Up
      0
      Down
      ::


      Ciao Lapo,

      ho dato un’occhiata al volo alle entry TeX e LaTeX in Wikipedia; c’è già un bel po’ di materiale, prevalentemente in Inglese; qualcosa in Italiano è abbozzato, ma volendo si potrebbe contribuire parecchio a traduzione e scrittura delle parti mancanti.

      Pensavi a LaTeXpedia perché quanto presente in Wikipedia non ti soddisfa o per un altro motivo?

      Ciao!

    • #11814
      Up
      0
      Down
      ::

      Pensavi a LaTeXpedia perché quanto presente in Wikipedia non ti soddisfa o per un altro motivo?

      Wikipedia è una enciclopedia generica in cui sotto la voce LaTeX deve esserci una concisa spiegazione di cosa sia e al massimo qualche esempio semplice di come funzioni. Quello a cui sto pensando io è un’enciclopedia dedicata al LaTeX in cui vengono sviscerati tutti gli aspetti che gli utenti decidono di approfondire fornendo soluzioni ed esempi. Credo che un progetto a sé stante sia necessario.

    • #11815
      Up
      0
      Down
      ::


      Qualcosa tipo questo?

      http://tex.loria.fr/index.html

    • #11816
      Up
      0
      Down
      ::


      L’idea di un progetto wiki per il LaTeX mi è piaciuta dall’inizio anche per un altro motivo. Il forum di GuIT contiene una quantità di informazioni su come risolvere problemi sul LaTeX incredibile. Nonostante che il motore di ricerca aiuti molto, spesso non è facile trovare il topic giusto anche perché non si sa con esattezza cosa stiamo cercando. Con LaTeXpedia, quando un utente ha un problema, crea una nuova pagina in cui viene spiegato il problema. Gli utenti che sanno come risolverlo spiegano come risolvere (sempre su quella pagina). Gli esperti controllano che la soluzione sia corretta e poi posizionano la pagina nella giusta sezione dell’enciclopedia. In questo modo si otterrebbe un servizio simile a quello del forum (anche se più lento) ma con una struttura che permette di cercare gli argomenti molto più facilmente. Questo eviterebbe anche uno dei problemi più grossi del forum, ovvero la ripetizione degli stessi topic.

      Inoltre LaTeXpedia diventerebbe automaticamente uno strumento didattico. In teoria anche il forum lo sarebbe, ma data la sua non strutturazione, è difficile che possa essere usato come tale, soprattutto per chi è agli inizi.

      Un altro modo per sviluppare LaTeXpedia potrebbe essere il seguente. Una volta che un utente del forum di GuIT ha ottenuto la risposta ad un problema, si impegna a scrivere il problema e la soluzione sull’enciclopedia.

      Spero che questa iniziativa possa dare luogo a qualche cosa perché più volte è stato suggerito dai membri del GuIT di creare un super manuale con tutti i topic rilevanti del forum, ma nessuno si è mai preso un incarico così grande.

    • #11817
      Up
      0
      Down
      ::

      Qualcosa tipo questo?

      http://tex.loria.fr/index.html

      Sì, ma con motore wiki. Se gli utenti non hanno la possibilità di scrivere le pagine, si torna al problema del manuale (piccola redazione, poche idee, tempi lunghi prima della fruizione, ecc.).

      Ricordo anche che Wikipedia ha un motore (http://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style_(mathematics)#Using_LaTeX_markup) che permette di scrivere le formule matematiche con la sintassi del LaTeX il che cadrebbe proprio a fagiolo.

    • #11818
      Up
      0
      Down
      ::


      Riporto l’ottimo suggerimento di axlman (originalmente inviato qui).

      Un buon punto di partenza per informarsi dovrebbe essere questo. Per uno che si intende di web e siti, mi dicono che la faccenda è piuttosto semplice. Secondo un conoscente che ha a che fare con Wikipedia, riporto:

      L’installazione è abbatanza semplice, è tutta guidata (l’ho fatta io che non avevo assolutamente alcuna esperienza di LAMP = Linux + Apache + MySQL + PHP).

      Poi bisogna configurarlo, e se hai bisogno delle impostazioni standard (cioè grosso modo come funziona per Wikipedia, quindi tutti possono leggere ed editare -anche i non registrati- i messaggi di sistema hanno gli stessi testi, ecc. ecc. ) devi cambiare poco.
      Chiaramente è più difficile -devi conoscere i settaggi- se vuoi cambiare qualcosa.

      Poi devi personalizzarlo (mettere i loghi, cambiare la grafia, ecc.) e questo è più o meno facile a seconda di quanto e cosa vuoi cambiare.

      E poi iniziare a strutturarlo e a riempirlo di contenuti.

      Mi ha anche detto che la versione in inglese della pagina che avevo indicato è più completa.

      Nel caso che durante il procedimento si verifichino problemi, mi ha assicurato che è pronto a dare dei consigli, certo non a fare tutto il lavoro lui. Così, se i responsabili del sito sono disposti a fare l’esperimento, un consulente a disposizione ci sarebbe. Anche io mi metto a disposizione, nel caso possa e riesca ad essere utile in qualche modo.

    • #11819
      Up
      0
      Down
      ::


      Ciao, scusa ma non mi ero accorto che avevi aperto questo thread. Mi sono informato meglio sul tempo necessario e pare proprio sia velocissimo, per chi ha dimestichezza con computer e linguaggi.
      Riporto:

      L’installazione dura sì e no un quarto d’ora – mezz’ora (c’è uno script che fa tutto lui).

      Certo dipende da cosa si sa già fare:
      io ho avuto più problemi perché era la prima volta che avevo a che fare con un webserver, non sapevo cosa fosse un databse MySQL e come crearlo in ambiente condiviso … ho dovuto ambientarmi un po’.

      Poi ovvio che io conoscevo già wikipedia, quindi sapevo già cosa fosse una pagina, cosa un redirect, cosa una pagina d’aiuto, cosa una categoria, ecc.. Altrimenti installi wikimedia e ti trovi un sito ma non capisci com’è organizzato e come funziona e devi “studiartelo”.

      Poi si tratta di personalizzarlo, e li dipende molto da cosa devi fare: cambiare solo il logo nell’angolo? cambiare la licenza? cambiare i colori? cambiare i diritti d’acceso -ad es. i non registrati non possono editare-? ecc. ecc.

      Quindi l’unica è provare, decidere di preciso l’impostazione (grafica, licenza, diritti d’accesso, ecc) e poi, per le questioni tecniche irrisolte, chiedo.

      Intanto potreste fare qui un elenco completo delle possibili impostazioni, così ognuno può suggerire la sua.
      Ad esempio io proverei prima l’accesso illimitato a tutti, e solo in caso di problemi ingestibili, limitarlo agli utenti registrati.
      Per la licenza, non so, non mi intendo delle varie sfumature.

      Per quanto riguarda un’idea generale di massima, io l’avevo pensata così:
      chi ha un problema irrisolto, lo espone nel forum e quando viene risolto, la soluzione viene inserita nella L-pedia, e il thread spostato in un’apposito forum “Problemi risolti ed enciclopedizzati”.
      Se invece, cercando nel forum, si trova già la soluzione postata, la si inserisce nella L-pedia e si porta all’attenzione dello staff la cosa (ad esempio aggiungendo al thread la risposta “SPULCIATO”): gli amministratori provvederanno a controllare il corretto inserimento nella L-pedia e a spostare il thread spulciato nei “Problemi risolti”.
      Idem se uno trova dei post la cui soluzione è già contenuta nella L-pedia.
      Thread costituiti da una domanda e una sola risposta tipo “Guarda qui “, una volta messi all’attenzione dello staff con il metodo degli spulciati, si potrebbero tranquillamente cancellare.

      Saluti.

    • #11820
      Up
      0
      Down
      ::

      Per quanto riguarda un’idea generale di massima, io l’avevo pensata così:
      chi ha un problema irrisolto, lo espone nel forum e quando viene risolto, la soluzione viene inserita nella L-pedia, e il thread spostato in un’apposito forum “Problemi risolti ed enciclopedizzati”.
      Se invece, cercando nel forum, si trova già la soluzione postata, la si inserisce nella L-pedia e si porta all’attenzione dello staff la cosa (ad esempio aggiungendo al thread la risposta “SPULCIATO”): gli amministratori provvederanno a controllare il corretto inserimento nella L-pedia e a spostare il thread spulciato nei “Problemi risolti”.
      Idem se uno trova dei post la cui soluzione è già contenuta nella L-pedia.
      Thread costituiti da una domanda e una sola risposta tipo “Guarda qui “, una volta messi all’attenzione dello staff con il metodo degli spulciati, si potrebbero tranquillamente cancellare.

      Sono d’accordo su ogni punto. Appena ho tempo formalizzo l’impostazione in un breve documento con le linee guida e chiedo in modo esplicito chi è che vuole collaborare. Per il momento chiunque sia interessato può contattarmi via email.

    • #11821
      Up
      0
      Down
      ::


      Riporto un’osservazione di Daniele (originariamente inviata qui).

      Un nuovo utente del forum pone una domanda più volte affrontata, tipo “Come faccio a fare una tabella su due pagine?”. Normalmente viene diretto verso un precedente post, che contiene, spezzettate in modo piuttosto inomogeneo, domande, risposte e commenti. Più volte una risposta è racchiusa in più posts. Segnalandogli invece il capitolo “Tabelle” della LaTeXpedia, l’utente avrà una visione d’insieme dell’argomento, e potrà trovare non solo la soluzione al suo problema, ma imparare anche come fare una tabella in modo corretto.

    • #11822
      Up
      0
      Down
      ::


      a che punto siamo nell’implementazione della wiki? Io la trovo una cosa indispensabile oltre che geniale. E sono pronto a collaborare. Nella mia ops4GuIT ho implementato una tiddlywiki che è un versione wiki costituita di un solo file con javascript. C’ero arrivato pure io a pensare una manuale multiutente wiki … portatile!! 😀 Potrebbe seguire pari pari la crescita della grande wiki di questo sito. Anzi mi viene in mente di implementare nella mia suite un piccolo server portatile e copiarvi dentro tutta la futura wikilatex. Che ne dite?

    • #11823
      Up
      0
      Down
      ::

      a che punto siamo nell’implementazione della wiki? Io la trovo una cosa indispensabile oltre che geniale. E sono pronto a collaborare.

      Grazie per i complimenti e soprattutto per l’interessamento. Io ho scritto un piano di lavoro che dovrebbe comparire sul prossimo numero di Ars TeXnica e poi, in base a quello, dovremmo iniziare ad arruolare interessati (devo dire con soddisfazione che sono già parecchi). In particolare dovremo organizzare un comitato di redazione (in verità due, uno per la versione online e uno per la versione pdf) ed un gruppo che si occupa delle tecnologie necessarie per implementare il tutto.

      Nella mia ops4GuIT ho implementato una tiddlywiki che è un versione wiki costituita di un solo file con javascript. C’ero arrivato pure io a pensare una manuale multiutente wiki … portatile!! 😀 Potrebbe seguire pari pari la crescita della grande wiki di questo sito. Anzi mi viene in mente di implementare nella mia suite un piccolo server portatile e copiarvi dentro tutta la futura wikilatex. Che ne dite?

      Mi sembra un’ottima idea che si andrebbe ad aggiungere all’ottimo prodotto che hai già creato. L’unico problema che intravedo sono le dimensioni dell’archivio di LaTeXpedia: non ho alcun dato in mano, ma temo che possa essere piuttosto grande.

      Colgo l’occasione per invitare chiunque sia interessato a partecipare al progetto a contattarmi in modo che io possa informarlo sugli sviluppi. Prossimamente verrà creata una mailing list dedicata alla coordinazione progetto.

    • #11824
      Up
      0
      Down
      ::


      Il progetto LaTeXpedia è iniziato.

      Con la formazione di un gruppo di lavoro e la creazione di una mailing list usata per coordinare il lavoro, il progetto LaTeXpedia è ufficialmente iniziato. A questo stadio è difficile prevedere come si evolverà il progetto, ma credo che siano necessari differenti tipi di contribuiti da parte dei partecipanti. Queste sono le possibili aree di lavoro:

      • Gestione tecnica del sito Wiki. Questo gruppo si occupa dell’installazione e dell’aggiornamento del motore Wiki. Si occupa anche della realizzazione dello stile del sito (credo che funzioni con i CSS o in modo analogo).

      • Gestione dei contenuti. Questo gruppo (costituito da utenti intermedi o esperti di LaTeX) si occupa di verificare i contenuti delle pagine dell’enciclopedia e dell’organizzazione della struttura dell’enclopedia.

      • Pubblicazione dei contenuti. Questo gruppo si occupa di pubblicare periodicamente (direi come indicazione semestralmente o annualmente) una versione PDF dell’enciclopedia. La mia idea sarebbe di creare uno script automatico che converta l’enciclopedia (compresa la sua struttura in capitoli, sezioni, ecc.) in un codice LaTeX che possa poi essere compilato con PDFLaTeX. Non so se la cosa sia o meno fattibile, ma questa è la speranza.

      Questi gruppi non sono ovviamente rigidi, ma servono a dare un’idea di quali sono le competenze richieste per sviluppare LaTeXpedia. Chiunque sia interessato ad uno o più gruppi può farmelo sapere sempre per email.

      L’innovatività del progetto ha destato interesse anche in TUG stranieri che probabilmente diventeranno partners in futuro. Credo che per GuIT sia un’ottima occasione per diffondere il LaTeX sia in Italia che nel resto del mondo.

    • #11825
      Up
      0
      Down
      ::


      A me sembra davvero un’ottima idea,
      credo sia proprio quello che manchi al LaTeX per poterlo sfruttare appieno!!!
      La documentazione esistente è vasta e anche fatta bene, ma solo a patto di sapere cosa cercare!

      Una enciclopedia sul LaTeX che copra tutti gli aspetti, contenga suggerimenti pratici basati sull’esperienza degli utenti, e soprattutto organizzata in maniera sistematica per argomenti (e necessità di utilizzo anche magari) credo sia utilissima!!!

      Spero di vederla attiva presto!!!

    • #11826
      Up
      0
      Down
      ::


      Ottima cosa, c’è già online il sito?

      Altrimenti forse posso farvi ospitare su un server dova già gira media wiki

    • #11827
      Up
      0
      Down
      ::

      Ottima cosa, c’è già online il sito?

      Altrimenti forse posso farvi ospitare su un server dova già gira media wiki

      Grazie per l’offerta! Al momento il sito non è ancora online perché stiamo effettuando l’installazione sullo stesso server che ospita questo forum.

    • #11828
      Up
      0
      Down
      ::


      salve a tutt,

      ho visto solo ora questo topic, ed ho visto che le uniche soluzioni proposte sono state wikipedia (che però non è esattamente il luogo adatto) oppure un server ad hoc.

      io avrei invece un suggerimento diverso: si potrebbe usare http://it.wikibooks.org, che è stato pensato esattamente con lo scopo di creare manuali a moltissime mani!

      mi spiace non essere intervenuto più tempestivamente, ma, come ho detto, solo ora ho visto questo thread.

      qualche argomentazione a favore di usare wikibooks:
      1) ha una visibilità maggiore;
      2) ha risorse più grandi, dedicate esattamente a questo scopo.
      3) mi duole dirlo, ma questo sito a volte (specie di giorno) ha qualche problema di banda.

    • #11829
      Up
      0
      Down
      ::


      Salve,

      anche se sono nuovo di queste parti mi sembra una grande idea e vorrei provare a contribuirvi…

      Mi permetto di porre il problema sull’indicizzazione. Il problema, secondo me, potrebbe essere quello di wikipedia ossia che le voci possono crescere in modo “disordinato”.
      Faccio un esempio. Giusto oggi ho postato una richiesta per un problema particolare della bibliografia e come la mia ce ne sono a centinaia nel forum. In teoria sarebbe opportuno che tutte le riposte finissero nel wiki magari nel capitolo “gestione bibliografia” ma, anche se in un apposito paragrafo, credo che appesantirebbero la lettura per il semplice utente che vuole solo capire la differenza tra plain e alpha.
      Se immaginiamo la cosa ripetuta per tutti i dubbi postati e risolti e magari ci mettiamo pure riassunti e traduzioni dei vari doc disponibili credo che genereremo un “mostro” (…anche se indubbiamente utile)

      Credo che il pregio di una buona enciclopedia siano anche dei buoni indici e la la loro assenza non può essere risolta solo con delle ricerche automatiche anche se con il corretto uso degli operatori logici AND, OR e NOT (…ammesso che tutti gli utenti siano in grado di utilizzarli. Questo progetto si merita l’accesso più ampio possibile soprattutto per i neofiti).

      La mia idea sarebbe quella di realizzare qualcosa su più livelli parzialmente idipendenti. Mi spiego: il manuale “Una (mica tanto) breve introduzione a LaTeX” potrebbe essere una buona base di partenza infatti permette di realizzare un documento TeX in semplici passi. Il livello successivo potrebbe essere “bibitexing” poi si potrebbe passare a makebst fino ad arrivare a “btxhak”. Perchè la cosa funzioni si dovrebbe poter passare da un livello a quello successivo con appositi link e la comprensione di un livello non dovrebbe richiedere la lettura dei livelli sottostanti. L’idea è quella di realizzare un “iperesto tridimensionale”

      Provo a fare uno schema ASCII… che non vuole essere né completo né esaustivo.
      `
      liv. 0 – Informazioni base che permettono di realizzare un teso semplice
      |
      liv. 1 – Soluzione dei problemi di installazione, stampa e conversione .dvi, .pdf, .html, etc.
      |
      liv. 2 – Guida base agli stili ed ambienti più comuni (tabelle, matematica, bibliografia, etc) e relativi pacchetti.
      |
      liv. 3 – Guida specifica ai vari pacchetti “speciali”
      |
      liv. 4 – Guida alle formattazioni personalizzate del testo e dei .bst
      |
      livelli intermedi se necessari…
      |
      liv. n – Programmazione TeX basso livello
      `

      Non so se la cosa è fattibile con un motore wiki ma credo di si. Al gruppo di gestione del wiki l’arduo compito di definire i livelli e cosa dovrebbe stare ad un livello od ad un altro…

      Spero di essermi spiegato…

      A presto. Ciao a tutti.

      E.

    • #11830
      Stemby
      Partecipante
        Up
        0
        Down
        ::


        Questo progetto è stato chiuso, è in stallo o sta procedendo? Avete preso in considerazione la possibilità di lavorare su wikibooks, come suggerito da giorgian? A me sembra una grande idea, wikibooks esiste proprio per queste cose, non si disperdedono le risorse e, al contrario, si permette in questo modo lo sviluppo di un progetto già esistente.

        Saluti

        Carlo

      • #11831
        Up
        0
        Down
        ::


        No, credo proprio che il progetto non sia morto. Credo stiano aspettando che su qualche server sia installato MySQL versione 4 per poter ospitare un Wiki. Forse altri potranno essere più precisi.

        Ciao

        Daniele

      • #11832
        Stemby
        Partecipante
          Up
          0
          Down
          ::


          C’è già un sever (Wikibooks), con già installato MediaWiki e che non aspetta altro che contributori…

        • #11833
          Up
          0
          Down
          ::


          Il progetto non è morto. Nei prossimi giorni installeremo il software Mediawiki e poi inizierà la costruzione.

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


            Ciao a tutti,

            volevo dire la mia sull’argomento (documentazione di LaTeX) da apprendista ovviamente.

            Cosa ho studiato:
            I testi i rete che ho studiato di più sono:
            1 – le presentazioni delle quattro lezioni introduttive (Introduzione al mondo di LaTeX);
            2 – la guida GuIT: Introduzione all’arte della composizione tipografia con LATEX;
            3 – il manuale del pacchetto PGF.

            Cosa ho rilevato (IMHO):
            Questi tre documenti sono i principali miei riferimenti (ovviamente ho consultato molta altra documentazione, dello stesso Mori tra l’altro).
            Le lezioni sono ottime per un riferimento iniziale, mentre la guida GuIT espone gli approfondimenti necessari per i primi documenti di produzione, mentre li manuale PGF offre una metodologia espositiva eccellente.
            Tutti e tre messi insieme dicono: occorre un esposizione dell’argomento che ne delinei i concetti principali fondamentali, le specifiche di sintassi, applicazioni d’esempio in cui compare il codice assieme al risultato che produce e commenti utili.
            Questo offre sia le informazioni necessarie per apprendere, sia il riferimento nell’uso e nella soddisfazione di particolari esigenze.

            Cosa ritengo opportuno filosoficamente aldilà degli strumenti tecnici:
            La documentazione di LaTeX dovrebbe :
            1 – essere liberamente disponibile in rete ed aperta ai contributi;
            2 – essere multilingua;
            3 – essere scritta secondo uno stesso standard migliorabile e sufficientemente flessibile;
            4 – essere aggiornata;
            5 – essere strutturata così da rendere le informazioni facilmente rintracciabili;
            6 – essere di qualità eccellente.

            Spero che si possa fare un buon lavoro perchè ritengo che la documentazione sia il mezzo principale per consentire alle persone di scegliere LaTeX.

            A presto.

          • #11835
            Up
            0
            Down
            ::

            Il progetto non è morto. Nei prossimi giorni installeremo il software Mediawiki e poi inizierà la costruzione.

            è ancora vivo il progetto?

          • #11836
            Up
            0
            Down
            ::


            Ho trovato un progetto simile, in inglese (ma forse già lo conoscete):
            http://en.wikibooks.org/wiki/TeX
            e
            http://en.wikibooks.org/wiki/LaTeX

            Saluti

          • #11837
            Up
            0
            Down
            ::


            Solo un piccolo contributo semi-inutile: nel titolo di questo topic (o come si chiama l’argomento di discussione, insomma) sarebbe più bello scrivere “enciclopedia” invece che “enciclpedia” 😛
            Spero di non aver fatto un intervento inopportuno. 🙂

          • #11838
            Up
            0
            Down
            ::


            Non ho mai caricato il CMS Wiki finora ma se è come gli altri non presenta particolari problemi nell’installazione però bisogna considerare che necessita di uno spazio web e di un database MySQL anche se il prezzo degli host che offrono anche questo servizio è sceso negli ultimi mesi.
            In alternativa, magari per i primi mesi si potrebbe partire con il progetto di una Wiki su LaTeX ospitando il tutto su siti che offrono gratuitamente spazio web con Wiki già incorporata (ovviamente in cambio di pubblicità sul sito).

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

        Go to top