Guida al Formato del Tutorial

Versione 1.3

Se desideri pubblicare un tutorial su HowtoForge, ti preghiamo di leggere questa guida per imparare come formattare il tuo tutorial in modo che si adatti all’aspetto e alla sensazione di HowtoForge e appaia attraente per il maggior numero possibile di lettori. Queste linee guida ti aiutano anche a ridurre al minimo la dimensione del tuo documento.

1 Quale Programma Devo Usare Per Scrivere Il Mio HowTo?

Usa un editor HTML come Dreamweaver o l’alternativa gratuita Bluegriffon http://www.bluegriffon.org/ o qualsiasi altro editor HTML che crea HTML valido. Non usare MS Word per produrre contenuti HTML perché Word produce HTML “strano”…

2 Come Inizio?

Ok, sei seduto di fronte al tuo editor HTML, pronto per iniziare, ma cosa succede dopo? Ti preghiamo di copiare questo scheletro HTML nel tuo editor:

| |

Ora scrivi il tuo tutorial tra i tag e .

3 Formattazione

3.1 Testo Normale

Usa sempre il font predefinito per il testo normale e le intestazioni! Non usare i tag , e non definire le tue classi CSS. Tutta la formattazione sarà effettuata dalle classi CSS di HowtoForge dopo che avrai pubblicato il tuo tutorial su HowtoForge.

Ad esempio, qualcosa come

Questa è una frase.

dovrebbe essere evitato. Usa semplicemente

Questa è una frase.

invece. Su HowtoForge, apparirà così:

Questa è una frase.

3.2 Intestazioni

Ti preghiamo di usare

…

, o

…

per formattare le intestazioni. Ancora una volta, non usare i tag o le classi CSS per formattarle.

L’intestazione

Questa È Un'Intestazione

apparirà così su HowtoForge:

Questa È Un’Intestazione

3.3 Comandi

Ti preghiamo di usare la classe CSS .command (definita nella sezione … nello scheletro HTML) per formattare i comandi della shell in modo che il lettore sappia che è qualcosa che deve eseguire sulla shell. Ad esempio,

chmod 755 /path/to/file

apparirà così su HowtoForge:

chmod 755 /path/to/file

3.4 Contenuti Dei File

I contenuti dei file dovrebbero essere racchiusi tra

…

. Ad esempio, se vuoi mostrare ai tuoi lettori il contenuto di /etc/resolv.conf, lo fai in questo modo:

search server  
 nameserver 145.253.2.75  
 nameserver 193.174.32.18  
 nameserver 194.25.0.60

Questo apparirà così su HowtoForge:

search server
nameserver 145.253.2.75
nameserver 193.174.32.18
nameserver 194.25.0.60

3.5 Nomi Di File, Nomi Di Protocollo, Specifiche Di Sistema, Specifiche Tecniche, Ecc.

Se stai scrivendo su elementi relativi al sistema Linux che non sono comandi, ma che desideri formattare in un modo speciale comunque, puoi usare la classe CSS .system. Ad esempio, se menzioni un nome di file all’interno del testo normale, è una buona idea formattarlo in questo modo:

Successivamente modifichiamo /etc/network/interfaces in modo che appaia così:...

Su HowtoForge, apparirà così:

Successivamente modifichiamo /etc/network/interfaces in modo che appaia così:…

3.6 Evidenziare

Se desideri evidenziare qualcosa, puoi usare la classe CSS .highlight. Ad esempio,

server1:

appare così:

server1:

5 Immagini

Ti preghiamo di non usare immagini che superano i 550 pixel di larghezza!

4 Pubblica Il Tuo Tutorial

Ti preghiamo di comprimere il tuo tutorial (file HTML creato secondo i capitoli 1 - 3) insieme alle immagini e inviare il file zip a [email protected]. Ti preghiamo di includere il tuo nome utente HowtoForge nell’email in modo che possiamo pubblicare il tutorial a tuo nome.

6 Approvazione Dell’Amministratore

Il tuo nuovo tutorial non sarà disponibile al pubblico immediatamente. Uno dei nostri amministratori lo controllerà (formattazione, contenuti, ecc.), e molto probabilmente il tuo tutorial sarà approvato. Successivamente sarà disponibile su HowtoForge.