appunti:stile_scrittura_wiki
Differenze
Queste sono le differenze tra la revisione selezionata e la versione attuale della pagina.
— | appunti:stile_scrittura_wiki [2023/07/03 13:32] (versione attuale) – creata - modifica esterna 127.0.0.1 | ||
---|---|---|---|
Linea 1: | Linea 1: | ||
+ | ====Suggerimenti per ottenere buon stile di scrittura sul wiki==== | ||
+ | |||
+ | |||
+ | ==Struttura pagina== | ||
+ | |||
+ | * Si inizi la propria pagina con un' | ||
+ | * Si nidifichino i livelli nel loro ordine corretto, le sezioni nel secondo livello dovrebbero iniziare con un titolo di secondo livello. | ||
+ | * Si suddivida il proprio testo in paragrafi, lasciando una riga vuota tra essi. Un paragrafo medio non dovrebbe essere più lungo di 10-20 righe. | ||
+ | * Se il testo è più lungo di alcuni (3-5) paragrafi, si consideri la suddivisione in sezioni aggiungendo livelli di intestazioni dal secondo al quinto. | ||
+ | * | ||
+ | * Se si hanno molti collegamenti ad altre pagine del wiki o risorse esterne, si aggiunga una sezione speciale con ulteriori riferimenti (si veda sotto). | ||
+ | * Se la maggior parte delle pagine di una categoria condividono una struttura comune si aggiunga un modello di categoria così ogni nuova pagina può iniziare con quello schema di struttura. | ||
+ | * Si cerchi di evitare strutture di categorie eccessivamente complicate. Si cerchi di usare nomi di categorie brevi, facili da ricordare. | ||
+ | |||
+ | |||
+ | ==Formattazione testo== | ||
+ | |||
+ | * Si enfatizzino singole parole o brevi brani di testo utilizzando il grassetto o il corsivo. Se ne scelga uno e si mantenga la scelta. | ||
+ | * Si scelga uno stile per rappresentare i risultati e i testi a video come bottoni o menu etichette e lo si usi in modo coerente. Potrebbe essere una buona idea aggiungere una pagina con una spiegazione delle convenzioni di stile adottate nel proprio wiki. | ||
+ | * Si usino liste non ordinate per espressioni indipendenti l'una dall' | ||
+ | * Si usino note a piè di pagina con parsimonia e solo per commenti aggiuntivi molto brevi. Se c'è molto altro da dire su un argomento specifico, lo si inserisca su una nuova pagina wiki. Se si vuole fare riferimento ad altre fonti di informazioni (esterne), si usino invece i collegamenti. | ||
+ | * Le tabelle possono migliorare notevolmente la leggibilità dei dati strutturati. Se si inserisce una tabella, assicurarsi che abbia intestazioni di cella significative e si fornisca una didascalia che indichi chiaramente il contenuto della tabella (ad esempio “Tabella 1.2: distanza media tra i pianeti”). | ||
+ | * Le tabelle di grandi dimensioni tendono ad essere molto difficili da modificare. Si consideri, in alternativa, | ||
+ | |||
+ | ==Lingua== | ||
+ | |||
+ | * Si scrivano frasi appropriate e si usino gli articoli per i sostantivi quando necessari. | ||
+ | * Si inizi ogni frase con una lettera maiuscola e la si concluda con un punto o altri segni di punteggiatura appropriati. | ||
+ | * Si provi a scrivere frasi brevi, chiare, senza ricorrere troppo a frasi subordinate. Quando si pensa di aver finito la propria pagina, la si rilegga ancora e si corregga ogni frase che ha una struttura troppo complessa. | ||
+ | * Si decida come rivolgersi ai propri lettori. Poiché DokuWiki è orientato verso la scrittura di documentazione, | ||
+ | * Si controlli la propria pagina per eventuali errori grammaticali o di ortografia prima di salvarla. Se il testo presenta molti errori, si riduce la credibilità delle dichiarazioni scritte, indipendentemente da quanto ben pensate possano essere. | ||
+ | * Si sviluppi il proprio stile. Non si facciano sforzi per scrivere in un modo che non si sente proprio. Questo sarebbe innaturale e sgradevole da leggere. | ||
+ | |||
+ | ==Riferimenti== | ||
+ | |||
+ | * Quando si incontra un termine che necessita si maggiori spiegazioni, | ||
+ | * Si ricontrolli la propria pagina prima di concluderla, | ||
+ | * Non si aggiunga un collegamento ad ogni occorrenza di uno specifico termine. Si crei un collegamento dalla prima/più importante occorrenza sulla pagina e magari si aggiunga un collegamento nella sezione riferimenti. | ||
+ | * Si forniscano collegamenti alle fonti di immagini, dati e citazioni. | ||
+ | * Si consideri di aggiungere un riga “Si veda anche” alla fine della propria pagina. Si forniscano collegamenti a pagine wiki strettamente legati al tema della propria pagina. | ||
+ | * Se si vuole dare indicazioni su risorse esterne che forniscono ulteriori informazione sul proprio argomento o che si sono usate per scrivere la propria pagina, si aggiunga una sezione chiamata “Riferimenti” o “Ulteriori informazioni” alla fine e si fornisca un elenco di collegamenti o altre indicazioni (ad esempio numeri ISBN). Se non è stato fatto nel testo principale, si dichiarino le intenzioni dei riferimenti. | ||
+ | | ||
+ | ==Immagini e altri media== | ||
+ | |||
+ | * “Un' | ||
+ | * Come per le tabelle, si inserisca sempre una didascalia delle immagini, che indica ciò che si vuole mostrare con l' | ||
+ | * Se non si è l' | ||
+ | * Non si creino collegamenti a immagini di siti esterni, se non si è autorizzati a farlo esplicitamente. Questo è in primo luogo un problema di diritti d' | ||
+ | * Se l' | ||
+ | |||