Strumenti Utente

Strumenti Sito


wiki:collabora
Traduzioni di questa pagina:

Questa è una vecchia versione del documento!


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)

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).

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

<style background box>
:!: **NOTA:** //eventuale titolo della nota//\\ 
testo della nota
</style>

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

:?: **TUTORIAL:** [[link al tutorial]]
:?: **FAQ:** [[link alla FAQ]]
wiki/collabora.1352906278.txt.gz · Ultima modifica: 2021/03/08 15:39 (modifica esterna)