Software
/
wiki
mirror of https://github.com/OpenMandrivaSoftware/wiki.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
wiki/it/doc/omawiki-style-guide.md

3.0 KiB
Raw Permalink Blame History

title description published date tags editor dateCreated
Guida specifica allo stile della wiki di OpenMandriva true 2020-12-22T09:07:59.821Z markdown 2020-05-10T10:00:59.389Z

Guida specifica allo stile della wiki di OpenMandriva

Prima leggi Guida generale allo stile del wiki {.is-danger}

Regole specifiche della wiki di OpenMandriva

Questa pagina non è definitiva (lavori in corso), ma sarà aggiornata nel tempo non appena troverò motivo di aggiungere altre istruzioni. {.is-info}

Immagini

Gli screenshot e le comuni immagini che vengono inserite nelle pagine della wiki devono essere caricate soltanto nella cartella /images. E' il motivo per cui la cartella è stata creata.

I nomi dei file immagine non devono contenere:

  • Spazi (utilizza un trattino al loro posto)
  • Trattini bassi (usa un trattino normale al loro posto)
  • Punti (sono riservati alle estensioni dei file)
  • Caratteri URL non sicuri (come segni di punteggiatura, virgolette, simboli matematici, ecc...)

Quando è possibile, rinomina i tuoi file immagine con qualcosa che abbia un significato relativo alla pagina o a ciò che l'immagine mostra.

Percorsi (paths)

I percorsi devono essere in lettere minuscole. Usa i trattini per separare le parole. Non sono ammessi segni di punteggiatura ad eccezione di trattini e/o trattini bassi. -- Nota: anche se tecnicamente permesso, lo standard della wiki di OpenMandriva usa i trattini normali e non quelli bassi. Non è necessario nominare il percorso con l'intero titolo della pagina: si può, anzi si dovrebbe quando è possibile, essere accorciato.

I percorsi non possono contenere i seguenti caratteri:

  • Spazi (utilizza un trattino al loro posto)
  • Punti (sono riservati alle estensioni dei file)
  • Caratteri URL non sicuri (come segni di punteggiatura, virgolette, simboli matematici, ecc...)

Siccome spesso dobbiamo scrivere il numero di versione della release (4.0, 4.1, 4.2, ecc...), al momento della creazione delle nuove pagine semplicemente converti in 40, 41, 42, ecc. omettendo il punto nel percorso.

Se la pagina è chiamata "How to foo bar whatever" il percorso deve essere /doc/guides/howto-something Non how-to, né howtos, né how-tos, ecc.

Flusso di lavoro delle traduzioni

Per la migliore organizzazione mantieni il percorso originale inglese senza modificarlo, cambia solo il prefisso della lingua. Di conseguenza en/home diventerà fr/home, it/home, ecc. Come altro esempio /en/doc/guides/howto-list-packages-iso diventerà /it/doc/guides/howto-list-packages-iso e il titolo della tua pagina tradotta (che è tutt'altra cosa rispetto al percorso) sarà "Come ottenere una lista di tutti i pacchetti presenti nella ISO" Tieni a mente che il percorso è una convenzione, il titolo della pagina può essere qualsiasi cosa nella tua lingua. L'azione di cui sopra è comunque semplificata e viene eseguita automaticamente cliccando sull'icona Language in alto a destra della pagina.

-