Strumenti Utente

Strumenti Sito


wiki:collabora
Traduzioni di questa pagina:

Collabora al manuale di DNG

Il presente manuale è aperto alla collaborazione di tutti coloro vogliano contribuire al suo miglioramento. Proprio per questo abbiamo scelto di utilizzare una piattaforma wiki!

Chiunque è in grado di modificarne le pagine una volta registrato.

Per aiutare chiunque si avvicinasse per la prima volta al mondo dei wiki, abbiamo predisposto una pagina che introduce alla Sintassi wiki, inoltre è possibile trovare online diversi strumenti per la conversione automatica (per esemprio sul sito ufficiale di DokuWiki oppure anche qui).

Abbiamo installato diversi plugin, uno dei più utili è wrap per la creazione e il posizionamento di box nella pagina. Consigliamo di usarlo per le note.

Come contribuire

E' possibile aiutare in diversi modi:

  • per chi già conosce la sintassi dokuwiki, è possibile creare o migliorare direttamente le pagine
    Ogni volta che trovare un link in rosso, sarà sufficiente cliccarvi per poter creare la pagina (solo per utenti registrati), mentre quando trovate l'icona FIXME significa che la pagina è da verificare e migliorare.
  • per chi si stesse avvicinando per la prima volta al mondo wiki, potreste migliorare le pagine utilizzando l'editor presente in “Modifica”:
    - aggiungendo link tra le pagine
    - inserendo screenshots (immagini delle pagine di DNG)
    - aggiungendo il tag FIXME dove ritenete ci siano cose da correggere
    - migliorando la leggibilità del testo con a capo, grassetti, corsivi e sottolineati :)
  • per chi non avesse voglia di editare le pagine, ma avesse comunque del materiale utile per il manuale, potete inviare una mail ad assistenza@comperio.it specificando nell'oggetto [DNG Manual] e allegando il materiale in questione. L'ideale sono file in formato .odt o .doc. (che convertiti grazie agli strumenti linkati prima, permettono di preservate le intestazioni e i link).

Cerca le pagine del manuale da correggere.

Regole di formattazione

Intestazioni, vanno utilizzate il più possibile a partire dal primo livello (H1), questo permette la generazione automatica del menu di navigazione nella parte superiore destra della pagina.

Nel caso di descrizione di un elenco di elementi come i filtri di ricerca, è preferibile utilizzare una tabella che elenchi le etichette sulla sinistra e il significato sulla destra.

Le NOTE dovrebbero essere suggerimenti o osservazioni particolarmente rilevanti e vanno formattati utilizzando la seguente sintassi

<WRAP info round>
== Titolo della nota ==
testo della nota
</WRAP>

Per l'aggiunta di note abbiamo scelto di usare il plugin per DokuWiki wrap. In questo senso, a seconda del tipo di nota, al posto di info, è possibile usare anche: important, tip, help, download, todo, alert.

Per il link alle FAQ o ai GUIDE sarebbe meglio utilizzare la seguente sintassi

:?: **GUIDE:** [[link alla guida]]
:?: **FAQ:** [[link alla FAQ]]
wiki/collabora.txt · Ultima modifica: 2012/12/19 17:30 da gbonanome