Sostieni Telethon Sostieni Telethon: in 20 anni Telethon ha finanziato più di 2200 progetti di ricerca e il lavoro di oltre 1400 ricercatori. Perché nascere con una malattia genetica non sia una condanna. Con il tuo contributo aiuterai a finanziare i migliori progetti di ricerca per scrivere la parola cura accanto al nome di ogni malattia genetica.

  • Versione stampabile
  • Esporta in OpenOffice
  • Esporta in PDF
  • Aggiungi pagina al libro
  • Strumenti:

Consigli di buon stile

Questi sono alcuni suggerimenti su come scrivere una buona pagina wiki.

Struttura della pagina

  • Si inizi la propria pagina con un'intestazione di primo livello con un titolo significativo.
  • Nidificare i livelli nel loro ordine corretto, le sezioni nel secondo livello dovrebbe iniziare con un titolo di secondo livello.
  • Suddividere 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 (3-5) paragrafi, si consideri la suddivisione in sezioni aggiungendo livelli di intestazioni dal secondo al quinto.
  • Quando il testo diventa più lungo di 2-3 pagine dello schermo, si inserisca un breve sommario dei contenuti della pagina dopo la prima intestazione. Quando la pagina diviene significativamente più lunga si consideri di dividerla in più pagine.
  • Se si hanno molti collegamenti ad altre pagine del wiki o risorse esterne, si aggiunga una sezione speciale con ulteriori riferimenti (si veda di seguito).
  • 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 cerci di evitare strutture di categorie eccessivamente complicate. Si cerchi di usare nomi di categorie brevi, facili da ricordare.

Formattazione del testo

  • Sottolineare parole singole o brevi brani di testo utilizzando bold or italics. Scegline uno e rispetta la scelta.
  • Scegliere uno stile per la rappresentazione di output su schermo e il testo sullo schermo come bottoni o etichette menu e utilizzarlo in modo coerente. Potrebbe essere una buona idea quella di aggiungere una pagina con una spiegazione del vostro convenzioni di stile adottate nel tuo wiki.
  • Usare liste non ordinate per le istruzioni che sono indipendenti l'uno dall'altro. Se si sta sviluppando una linea di pensiero, scrivere una sequenza continua di frasi.
  • Usare note sintassi con parsimonia e solo per le osservazioni aggiuntive breve. Se c'è tanto da dire su un argomento specifico, inserirlo su una nuova pagina wiki. Se si vuole fare riferimento ad altre fonti di informazioni (esterni), usare links.
  • Le Tabelle possono migliorare notevolmente la leggibilità dei dati strutturati. Se si inserisce una tabella, assicuratevi che sia intestazioni di cella significativo e fornire una didascalia che indichi chiaramente il contenuto della tabella (ad esempio “Tabella 1.2: distanza media tra i pianeti”).
  • tabelle di grandi dimensioni tendono ad essere molto difficili da modificare. In questo caso, considerare di rappresentare i dati in un elenco nidificato.

Lingua

  • Scrivere frasi appropriate e articoli per utilizzare sostantivi quando necessari.
  • Inizia ogni frase con una lettera maiuscola e termina con un punto o altri segni di punteggiatura appropriati.
  • Prova a scrivere frasi brevi e chiare, senza ricorrere troppo a frasi subordinate. Quando pensi che hai finito la tua pagina, rileggila per rivedere che la struttura non sia troppo complessa.
  • Controlla la tua pagina per eventuali errori grammaticali o di ortografia prima di salvarla. Se il testo presenta molti errori, si riduce la credibilità di ciò che si scrive, a prescindere dalle intenzioni positive di chi scrive.
  • Sviluppare il proprio stile. Non sforzatevi di scrivere in una maniera che non vi si addice. Se farete ciò non sarebbe naturale e pertanto sgradevole da leggere.

Riferimenti

  • Unordered List ItemUnordered List ItemQuando si incontra un termine che ha bisogno di più spiegazioni, aggiungere una nuova pagina wiki linkando il termine.
  • Re-check (riprovare) la tua pagina prima di terminarla, aggiungere il link alle pagine esistenti nel wiki e ai termini di riferimento principali della pagina.
  • Non aggiungere un link a ogni termine specifico. Effettuare il primo link alla pagina prevalente e magari aggiungere un link alla sezione di riferimento.
  • Fornire collegamenti alle fonti di immagini, dati e citazioni.
  • Considerare l'aggiunta di un “Vedi anche:” riga alla fine della pagina. Fornire link a pagine wiki che sono legate al tema della tua pagina.
  • Se si vuole dare dei riferimenti a risorse esterne che hanno ulteriori informazioni sul tuo argomento o che hai utilizzato per scrivere la tua pagina, aggiungere una sezione intitolata “Riferimenti” o “Ulteriori informazioni” alla fine e dare un elenco di link o di altri puntatori (ad esempio numeri ISBN). Se non lo hai già fatto, nel testo principale, dichiarane l'intenzione nel riferimento.
  • L’impostazione delle scorciatoie interwiki può aiutare i link alle risorse comuni.

Immagini e altri media

  • “Un'immagine dice più di mille parole.” Potrebbe anche significare più di quanto si intende dire. Gli esseri umani tendono a mettere in discussione l'autenticità delle immagini inferiore a quello del linguaggio. Una breve descrizione testuale è meglio di niente o di un'immagine inesatta.
  • Come per le tabelle, inserire sempre una didascalia nelle immagini, che indica ciò che si vuole descrivere con l'immagine.
  • Se non hai creato tu stesso l’argomento, indicane la fonte (possibilmente con un link) e il diritto d'autore.
  • Non linkare immagini da siti esterni, se non si è autorizzati a farlo esplicitamente. Questo è in primis fonte di lite per questioni di copyright, ma potrebbe anche essere considerato come una intrusione in una rete altrui.
  • Se l'immagine è più grande di circa un terzo di una pagina sullo schermo, utilizzare un link con il ridimensionamento istruzioni per inserire una (thumbnail) miniatura.