Progetto

Generale

Profilo

TruedocWikiRules » Cronologia » Versione 4

Amministratore Truelite, 21-11-2006 15:18

1 1 Amministratore Truelite
[[TracNav(TOC)]]
2
= Convenzioni per la stesura della documentazione =
3
4
Per mantenere uniformità grafica nella stesura della documentazione sul Wiki sono state adotte le convenzioni illustrate in questa pagina, che può servire sia da riferimento per il lettore, che come linee guida per chi scrive.
5
6
Le convenzioni generali seguite finore sono le seguenti:
7 2 Amministratore Truelite
 * I nomi di file sono indicati in ''monospace'', vale a dire che {{{filename}}} va scritto come 
8
   `{{{filename}}}`.
9 3 Amministratore Truelite
 * I nomi dei comandi sono indicati in ''monospace'', vale a dire che {{{cmd}}} va scritto come 
10 1 Amministratore Truelite
   `{{{cmd}}}`.
11 3 Amministratore Truelite
 * I nomi di funzionalità di sistema, di programmi, distribuzioni o in generale i nomi inglesi vanno 
12
   scritti in ''italic'', ad esempio ''debconf'' deve essere scritto come {{{''debconf''}}}.
13 4 Amministratore Truelite
 * gli indirizzi web e di posta elettronica devono essere inseriti con la sintassi wiki (cioè protetti da  
14
   parentesi quadre.
15 2 Amministratore Truelite
16
17
Ogni pagina deve contenere il menu di navigazione, ed un titolo principale corrispondente, questo si fa inserendo all'inizio della pagina la sezione:
18 1 Amministratore Truelite
{{{
19
[TracNav(TOC)]]
20
= Titolo della pagina =
21 3 Amministratore Truelite
}}}
22
23
Gli estratti dei risultati dei comandi e dei file di configurazione vanno scritti come testo formattato, cioè qualcosa del tipo:
24
{{{
25
 piccardi@monk:~/truedoc/corso$ ls *.tex
26
 advadmin.tex   corsoFSE.tex  netbase.tex   netlpi.tex          shell.tex
27
 appendici.tex  corso.tex     netdns.tex    ordadmin.tex        stradmin.tex
28
 config.tex     netadmin.tex  netinter.tex  ringraziamenti.tex  struttura.tex
29
}}}
30
andrà scritto nella forma:
31
{{{
32
 {{{
33
 piccardi@monk:~/truedoc/corso$ ls *.tex
34
 advadmin.tex   corsoFSE.tex  netbase.tex   netlpi.tex          shell.tex
35
 appendici.tex  corso.tex     netdns.tex    ordadmin.tex        stradmin.tex
36
 config.tex     netadmin.tex  netinter.tex  ringraziamenti.tex  struttura.tex
37
 }}}
38 2 Amministratore Truelite
}}}