4. HOWTO Project Sviluppo
Indice di questa sezione
4.1 Cercasi HOWTO e mini-HOWTO
Se siete interessati a scrivere qualcosa circa questi soggetti , cortesemente fatemelo sapere all'indirizzo
gregh@sunsite.unc.edu
- GCC/LIBRARY HOWTO. Discussione circa l'installazione e upgrade del GCC e delle "shared libraries" su Linux. Come compilare le "shared libraries". La maggior parte del materiale ci e` stata fornita da Mitchum DeSouza's GCC FAQ.
- Notebook HOWTO o Notebook mini-HOWTO. Una guida ai notebooks - informazioni sul power management, LCD displays, video controller, riferimenti al materiale relativo (PCMCIA-HOWTO), e qualsiasi cosa attinente i notebooks.
- Info Services HOWTO. Tutto circa l'installazione degli "information services" (WWW, FTP, etc).
- DNS HOWTO. Come configurare un DNS.
- Se avete qualche idea circa un nuovo HOWTO o mini-HOWTO, fatemelo sapere.
4.2 HOWTO correntemente in fase di allestimento
- Il Printing HOWTO e` stato completamente riscritto, e viene rimpiazzato dai "Printing Usage" e "Printing Setup" HOWTO.
- Il Tips HOWTO e` stato riscritto.
- Parallel Processing HOWTO. Informazioni circa i pacchetti "parallel processing" (PVM, MPI, etc.) ed i metodi per connettere (networking) un cluster per il "parallel processing", ed una varieta` di consigli per il "system administration" e miglioramento delle performance.
- Un Shadow Password mini-HOWTO e` stato scritto.
- Il Security HOWTO e` stato scritto.
- Le GCC FAQ saranno incluse nel GCC HOWTO.
4.3 Scrivere e pubblicare un HOWTO
Se avete voglia di scrivere un HOWTO per Linux , qui c'e` una traccia da seguire.
- Prima di tutto avvisatemi , e fatemi sapere che volete lavorare a qulcosa. Mi troverete a
gregh@sunsite.unc.edu
- Usate una struttura ed organizzazione dell'HOWTO che sia coerente, e scrivete in modo chiaro. Ricordatevi che la maggior parte di chi consulta gli HOWTOs non parla l'inglese come lingua madre.
- Se state scrivendo un HOWTO, dovete usare il pacchetto Linuxdoc-SGML , che trovate su
sunsite.unc.edu:/pub/Linux/utils/text/
, per formattare l'HOWTO. Questo pacchetto vi permette di produrre LaTeX (per dvi e PostScript), testo normale, HTML e altri formati da un singolo documento sorgente, sviluppato da Matt Welsh specificatamente per gli HOWTO. Conferisce, inoltre, un look uniforme agli HOWTO.
- Se state scrivendo un mini-HOWTO, potete usare il formato che vi pare. I mini-HOWTOs sono brevi , di formato libero su soggetti specifici. In generale, dovrebbero essere veloci da scrivere e mantenere, quindi non c'e` bisogno di usare il pacchetto Linuxdoc-SGML . Cio` non sminuisce altresi` l'importanza dei mini-HOWTOs! Vengono distribuite comunque solo le versioni formato testo dei mini-HOWTO.
- Assicuratevi che tutte le informazioni siano corrette. Non si sa mai abbastanza. Se siete in dubbio, confrontatevi, ma rendetevi conto che state solo provando.
- Controllate di stare usando la versione piu` recente del software. Pertanto, assicuratevi di includere le istruzioni complete su dove scaricare il software (sito FTP , percorso completo), la versione corrente e la data di rilascio del software .
- Includete una sezione per le FAQ alla fine (se serve). Alcuni HOWTO hanno bisogno di una sezione "FAQ" o "Common Problems" per fornire le informazioni che non si possono dare all'interno del testo normale.
- Usate gli altri HOWTO come modello. Il sorgente SGML dell'HOWTO lo trovate sui siti FTP Linux .
- Infine, preparatevi a ricevere domande e commenti sui vostri scritti. Ho notato centinaia di accessi giornalieri alla collezione degli HOWTO da tutte le parti del mondo!
Dopo che avrete completato l'HOWTO, speditemelo. Se avete usato Linuxdoc-SGML, speditemi solo il sorgente SGML; mi prendero` cura io stesso della formattazione del documento. Inoltre provvedero` ad archiviarlo sulla sunsite.unc.edu
e lo spediro` ai vari newsgroups. E` importante che voi passiate attraverso di me quando pubblicate l'HOWTO, visto che mi preoccupo di mantenere gli archivi ed ho bisogno di sapere quali HOWTO sono stati scritti e conoscere cosa si sta gia` facendo. Poi , tutto cio` che dovrete fare e` mandarmi periodicamente le vostre revisioni.
Capitolo Successivo,
Capitolo Precedente
Indice di questo capitolo,
Indice generale
Inizio del documento,
Inizio di questo Capitolo