ReTerWiki: Manuale di stile

Pagina in bozza

Questa pagina non è completa o non condivisa, quindi è da considerarsi una bozza in fase di elaborazione o di consenso.

Mini guida utile per agevolare l'uniformità di stile e formattazione nelle pagine, usando convenzioni standardizzate.

Per quanto qui non definito, si faccia riferimento al Aiuto:Manuale_di_stile di Wikipedia al quale questa pagina è ispirata.

La struttura di una pagina

Giunti in fondo...

In fondo alla pagina, dopo il testo vero e proprio, si collocano paragrafi «accessori», che hanno lo scopo di permettere approfondimenti. Non obbligatori ovviamente, ma per convenzione useremo sempre lo stesso ordine:

  • Bibliografia (testi di riferimento usati o utili per l'approfondimento)
  • Voci correlate (rimando a voci interne al Wiki, per approfondire o perché vicine nel tema)
  • Altri progetti (contenuti collegati ma presenti su altre piattaforme e account di ReTer, ad es. notizie sul sito o mappe su Umap)
  • Collegamenti esterni (link a pagine della rete utili per l'approfondimento o da consultare per prendere spunti)
  • Note (spiegazioni sul testo o fonti dell'informazione)

Le note si generano inserendo il testo all'interno di doppie parentesi1) che DokuWiki automaticamente colloca in fondo alla pagina. Per cui, in presenza di note nella pagina, è bene chiudere il testo con un'intestazione di livello 2 nominata “Note”

Quando una pagina è completa?

Ovviamente mai! Ma ci sono casi in cui, perché abbia senso, una pagina deve contenere tutti gli elementi essenziali che si propone di contenere. In questo wiki è il caso di alcune pagine il cui completamento è definibile, come ad esempio le guide o i report. Al contrario delle pagine di servizio (es. gestione) utili alla costruzioni di un progetto che sono per definizione sempre dei cantieri aperti.

Un altro caso in cui una pagina è da considerare come non completa è quello di pagine i cui contenuti non sono del tutto condivisi dai gestori delle pagine.

In questi casi va messo in testa alla pagina un alert che definisca il contenuto come in bozza:

Pagina in bozza

Questa pagina non è completa o non condivisa, quindi è da considerarsi una bozza in fase di elaborazione o di consenso.

Per fare ciò inserire in testa, immediatamente dopo il titolo, il seguente contenuto:

<callout type="warning" icon="fa fa-edit" title="Pagina in bozza">
Questa pagina non è completa o non condivisa, quindi è da considerarsi una bozza in fase di elaborazione o di consenso.
</callout>