Aiuto:Convenzioni di nomenclatura: differenze tra le versioni

Contenuto cancellato Contenuto aggiunto
Ramac (discussione | contributi)
sistemo
Riga 8:
== [[Immagine:Vista-clean.png|25px|Questa è la politica corretta ed accettata dalla comunità, che va applicata.]] Linee guida per il nome dei [[Aiuto:Libro|libri]] ==
# '''I nomi dei libri non devono avere le iniziali maiuscole''', al contrario dei libri inglesi. Per esempio: <nowiki>[[Chimica generale]]</nowiki> è preferibile a <nowiki>[[Chimica Generale]]</nowiki>.
# '''Non abbreviare il titolo del libro quando si creano le sottopagine'''. Questo non permette il corretto funzionamento del sistema di sottopagine di Wikiboooks. Per esempio, nel libro [[Inglese]] c'è una sottopagina <nowiki>[[Inglese/Il Simple Past]]</nowiki>, ma sarebbe sbagliato crearne una così: <nowiki>[[CIIng/Il Simple past]]</nowiki>.
# '''Sii breve e descrittivo''': <nowiki>[[C]]</nowiki> è preferibile a <nowiki>[[Linguaggio C]]</nowiki>, a <nowiki>[[Programmare in C]]</nowiki>, oppure a <nowiki>[[Programmare nel linguaggio C]]</nowiki>. Non usare però nomi troppo generici o vaghi per i libri: ognuno deve avere un nome univoco che ne renda facile l'identificazione.
 
Riga 16:
=== Sottopaginazione ===
 
'''Questa convenzione è consigliataobbligatoria per i nuovi libri.'''
 
I moduli vanno sottopaginati usando il segno di '''slash''' (/) e con '''un solo livello di sottopaginazione'''.
 
Il vantaggio nell'usare questa sintassi è che il software [[w:MediaWiki|MediaWiki]] fornisce il link alle pagine di livello superiore, agevolando la navigazione.
 
Line 36 ⟶ 37:
Puoi ottenere una gerarchia usando elenchi nidificati nella pagina principale del libro, ma '''non''' nidificando le pagine.
In questo modo si è liberi di riorganizzare le pagine come si meglio crede, dato che la gerarchia è solo apparente.
 
Ad esempio:
 
Line 55 ⟶ 57:
=== Dare il nome ai moduli ===
Ricorda che il titolo del libro e dei suoi moduli apparirà e dovrà essere digitato nella barra dell'URL di un browser: '''scegli dei nomi brevi'''.
 
Idealmente, il nome di un modulo dovrebbe essere formato da una parola sola, ma non sempre ciò è possibile.
Idealmente, il nome di un modulo dovrebbe essere formato da una parola sola, ma non sempre ciò è possibile. In ogni caso, cerca di essere il più sintetico possibile, senza però che questo vada a discapito della chiarezza.
 
Per convenzione, '''i nomi dei moduli iniziano sempre con una lettera maiuscola'''.
Line 82 ⟶ 84:
 
=== Esempi ===
* [[JavaScript]]
* [[Russo|Corso di russo]]
 
Line 121 ⟶ 124:
 
==== Esempi ====
* [[JavaScriptOttimizzare C++]]
==== Template ====
Il template {{tl|md}} aiuta a inserire la sottopaginazione. </br>
Sintassi: <tt><nowiki> {{md|''nome modulo''}}</nowiki> </tt> </br>
L'esempio <tt><nowiki> {{md|Esempio}} </nowiki></tt> </br>
linka a {{md|Esempio}} ''(Convenzioni di nomenclatura/Esempio)'' </br>
 
=== Vecchi titoli ===
 
'''Queste strutture sono deprecate. Non usarlausarle nei nuovi libri.'''
 
Se trovi libri organizzati in questo modo, sposta le pagine in modo da seguire la convenzione con lo ''slash''. A volte i libri presenti su altri Wikibooks seguono queste nomenclature; se li traduci, abbi cura di convertirne i titoli:
Line 142 ⟶ 140:
* La convenzione "Wikipedia": <code><nowiki>[[Capitolo]]</nowiki></code>, dove non si nomina il nome del libro; tali pagine vanno contrassegnate con il {{tl|Da collocare}}
* La convenzione "scaffale": <code><nowiki>[[Scaffale:Libro]]</nowiki></code>, come <nowiki>[[Programmazione:C]]</nowiki>, <nowiki>[[Programmazione:Java]]</nowiki>, <nowiki>[[Programmazione:Pascal]]</nowiki> etc...
 
== Alcuni trucchi ==
Per effettuare i collegamenti alle sottopagine semplicemente usando la sintassi:
<nowiki>[[/Nome modulo/]]</nowiki>
Ad esempio, se si inserisce <nowiki>[[/Introduzione/]]</nowiki> nella pagina <nowiki>[[Pascal]]</nowiki>, si otterrà un link alla pagina [[Pascal/Introduzione]] come se fosse stato scritto: <nowiki>[[Pascal/Introduzione|Introduzione]]</nowiki>, con questo risultato: [[Pascal/Introduzione|Introduzione]].
 
[[Categoria:Aiuto|Convenzioni di nomenclatura]]