Guida allo stile
Questa pagina riassume le convenzioni stilistiche e di formattazione della wiki.
Lista delle pagine di "Guida" di questa wiki
Stile e lingua
Ricorda di usare il corretto taglio linguistico quando scrivi nuove pagine
Lo stile ideale della wiki è:
- italiano "moderno" (non medievale tipo "conciosiaccosachè li fanti de lo sire...")
- vagamente "aulico".. insomma, un po' ricercato e purista, evitando parole che sanno troppo di contemporaneo, come "piattaforma politica" o "psicanalizzare", e vocaboli di origine straniera, come "ok", "business" o "chance"
- scevro di formulazioni un po' troppo didascaliche-enciclopediche in stile Wikipedia o "manuale di D&D" ("microeconomia della regione X", "attacchi e difese della creatura Y" etc.).
Qualche suggerimento di GRAMMATICA e sintassi!
- cercate di usare frasi positive e non negative, sono piu' immediate e chirare e contribuiscono alla facilità di lettura (EG: "la scalata non era facile" Vs "la scalata era difficoltosa"
- dopo la "," non si deve usare un congiunzione come "e
- i punti cardinali sono sempre minuscoli salvo siano nomi popri di luogo ( a sud-ovest di Vigezia Vs il Sud di Meridia)
- limitate l'uso degli avverbi, troppi -mente appesantiscono la lettura
- sempre meglio una frase diretta rispetto ad una perifrasi
Formattazione
Quando possibile, usa il wikitext editor e non il visual editor (puoi accedere al wikitext editor cliccando sulla freccetta a destra del pulsante "Save", nella modalità di modifica; puoi anche impostarlo come
editor di default selezionando "Usa editor visuale: no" sulle Impostazioni, che puoi raggiungere cliccando sul tuo nome utente in alto a destra).
Il wikitext editor è più preciso e permette di capire meglio se la formattazione della pagina presenta errori.
Leggi la
Guida al wikitext.
Non usare mai stili (cioè colori, testo allineato al centro o a sinistra, e tutte le altre funzioni cui puoi accedere cliccando sul pulsante "Style Text" (la T con una tavolozza). Gli stili appesantiscono inutilmente il codice della wiki e non è comodo rimuoverli da un testo.
Titoli
Non scrivere mai i titoli in CAPS LOCK. Non usare i titoli più grandi (Heading 1 ed Heading 2) a meno che la pagina contenga molte sezioni e abbia bisogno di molti livelli di titoli.
Normalmente, i titoli principali di una pagina devono essere in Heading 3. I titoli secondari in Heading 4. I titoletti per elenchi o brevi paragrafi in Heading 5 o in Heading 6.
Quando inserisci un titolo, metti sempre un "a capo", cioè una riga vuota, prima del titolo (ma non dopo). Non mettere mai più di una riga vuota: non servono a niente!
Table of Content (Sommario)
Se il testo è lungo, dividilo in più paragrafi assegnando a ogni paragrafo un titolo appropriato. Se la pagina ha più di 2 o 3 titoli, probabilmente ti conviene inserire una "Table of content" come quella che vedi in alto a destra in questa pagina.
Per farlo è sufficiente che tu vada all'inizio della pagina (nella primissima riga) e scriva [[toc]], seguito da un 'a capo' (cioè sulla prima riga ci deve essere
solo [[toc]] e nient'altro)
Tag
Completa sempre le nuove pagine che crei con i
tag appropriati e accertati che i
tag che vorresti aggiungere non ci siano già (consulta la
Guida ai tag). Attenzione: TAGGA SEMPRE IN MINUSCOLO
Link
Questo è un ipertesto, e ogni pagina dovrebbe contenere molti rimandi ad altre pagine (i link).
Controlla sempre il corretto funzionamento dei
link che inserisci. Per trasformare un nome in un link è sufficiente inserirlo tra doppie parentesi quadre: se scrivi [[Altabrina]], diventa
Altabrina.
Puoi anche fare in modo che il testo visualizzato sia diverso dal link di destinazione, semplicemente usando il simbolo | : [[NomePaginaDaLinkare|TestoDaVisualizzare]]. Ad esempio se scrivi [[Altabrina|la terra dei barbari]], il risultato sarà questo:
la terra dei barbari.
Quando linkare e quando non farlo
Se TUTTI i nomi e i concetti di ogni articolo fossero link alle pagine relative, gli articoli sarebbero illeggibili.
E' buona norma linkare una parola solo la PRIMA volta che appare in un articolo. Ad esempio se in un articolo sul Culto della Terra gli Elfi sono menzionati 17 volte,
è SBAGLIATO inserire 17 link alla pagina Elfi: basta mettere 1 link la prima volta che gli Elfi vengono nominati.
Bisogna fare particolare attenzione a non inserire troppi link alle pagine più comuni, cioè ai nomi che ricorrono più spesso negli articoli, ad esempio i nomi dei Principati e delle razze.
Per contro, quando un articolo menziona un personaggio specifico o qualcos'altro di specifico, è necessario mettere un link alla pagina relativa (almeno la prima volta).
Convenzioni sui nomi delle pagine
Per preservare la correttezza dei link, è importante che i nomi delle pagine abbiano lo stesso "formato". In particolare è facile creare confusione con le pagine dedicate a personaggi: la wiki distingue il maiuscolo e il minuscolo, quindi
Alarico D'Urso,
Alarico d'Urso e
Principe Alarico sono 3 pagine diverse per la wiki (quella giusta è la prima!)
La funzione "redirect" può in parte attenuare questo problema, comunque è preferibile adottare una convenzione unica e rispettarla.
Per le pagine di ambientazione, il nome corretto è ad esempio
Altabrina o
Pitti; NON
Principato di Altabrina nè
Razza dei Pitti nè
Razza/ Pitti.
Per i paragrafi tratti dal manuale, il nome convenzionalmente corretto è solitamente il titolo del paragrafo del manuale, es.
Produzione e Commerci di Corona del Re, non
Le produzioni e i commerci di Corona Del Re nè qualsiasi altra variante.
Non inserire l'articolo all'inizio del nome della pagina!
Per le pagine dedicate ai personaggi, il formato corretto è
NomeCompleto CasataNobiliare oppure
NomeCompleto da Luogo oppure
NomeCompleto Appellativo, a seconda di come è più conosciuto il personaggio. In ogni caso non bisogna MAI inserire solo il nome, nè bisogna premettere al nome titoli come "Ser", "Dama", "Principe" eccetera.
Esempi di pagine intitolate giuste: Ettore Cassio da Vigezia,
Falcobrando del Clan del Falco,
Clizia Elora degli Alessandridi,
Lisimaco Ariele
Esempi di pagine intitolate sbagliate: Ettore,
Ettore Cassio,
Ettore da Vigezia,
Principe Falcobrando,
Falcobrando del Falco,
Dama Clizia,
Ser Lisimaco
Impaginazione
DOPO aver salvato modifiche, controlla che l'impaginazione sia rimasta stabile e non ne sia uscita scombinata. A volte sembra giusta nella schermata di modifica e poi....
lui ti divora!
Immagini
Inserisci tutte le immagini che vuoi sulla wiki! Gli articoli sono più belli se decorati da qualche immagine (occhio a non strafare: solo gli articoli lunghi dovrebbero avere più di 1 o 2 foto!)
Puoi trovare moltissime foto sulle
Gallerie di Terre Spezzate. Ma per prima cosa
cerca l'immagine nella wiki stessa... magari è già stata caricata da qualcun altro!
Prima di caricare una foto, assicurati che:
1) Abbia un
nome identificativo di ciò che rappresenta: "Immagine023.jpg" non va bene, molto meglio "Alarico.jpg" oppure "Orchi alla carica.jpg"
2) Non sia troppo
grande: le foto più larghe di 350 pixel sono tendenzialmente inutili, quelle più larghe di 700 pixel quasi sicuramente "sballano" la pagina.
3) Non sia troppo
pesante: un normale ritratto
DEVE pesare
MENO di 100 kb, una foto piccola
DEVE pesare
MENO di 50 kb. Non c'è
alcun motivo di inserire immagini più pesanti di 500 kb. Puoi usare Photoshop o un programma gratuito come
GIMP o
Irfanview per ridimensionare e comprimere facilmente le pagine. Salva in .jpg, o in .png se vuoi che l'immagine conservi le "trasparenze" (tuttavia il .png è un formato più pesante).
Caricare immagini esterne
E' anche possibile inserire direttamente nella wiki immagini che si trovano su altri siti. E' sufficiente selezionare "immagine esterna" quando dopo aver cliccato sul pulsante "file", o semplicemente incollare questo codice:
[[image:http://www.sito.com/immagine.jpg]] , naturalmente inserendo il percorso appropriato dell'immagine dopo
``[[image:====Dove trovare foto e MAPPE?====
qui e' un buon posto. Molte immagini sono già state caricate sulla wiki e sono pronte per essere inserite nelle pagine. Quindi prima di caricare una nuova immagine, controlla che non ci sia già
in questa pagina , oppure direttamente dalla schermata di "Insert file". In particolare sono state inserite più di
200 immagini taggate "foto manuale" tratte dal
Manuale in PDF; e inoltre la
serie di illustrazioni e disegni presente su Picasa.
Caricare uno slideshow
Utilizzando il widget "Altro HTML", puoi inserire uno slideshow realizzato con Picasa, Flickr o altri servizi online che permettono di generare codice da incorporare (
embed) in altre pagine web.
I passi sono: 1) apri Picasa, Flickr o l'altro servizio; 2) genera il codice e copialo; 3) fai widget => altro html e incolla il codice nello spazio 4) salva la pagina
Questa è la (brevissima)
guida di Picasa per incorporare una slideshow (nota che devi essere il proprietario dell'album per poterlo fare! Per le
Gallerie tematiche puoi rivolgerti a
Ser Neone chiedendogli di inviarti il codice (oppure copiare il codice da uno degli widget slideshow già creati, se vuoi riutilizzarlo in un'altra pagina).
Inserire uno "spoiler" ovvero testo a scomparsa
E' possibile senza troppo sforzo uno spoiler come questo:
Titolo dello spoiler
Testo nascosto.
Questo testo (che può includere immagini e ogni altra cosa:
) compare solo quando si clicca su "scopri" o sul titolo dello spoiler.
Per farlo è sufficiente utilizzare "include page" per inserire 3 "pagine di servizio" che contengono il codice che crea lo spoiler: "spoiler1titolo" va all'inizio, prima del titolo; "spoiler2nascosto" va inserito dove finisce il titolo e comincia il testo da nascondere; "spoiler3fine" va messo alla fine.
Il codice da copia&incollare e modificare (in
modalità wikitext!) è questo:
[[include page="spoiler1titolo"]]
Titolo dello spoiler
[[include page="spoiler2nascosto"]]
Testo nascosto.
Questo testo compare solo quando si clicca su "scopri" o sul titolo dello spoiler.
[[include page="spoiler3fine"]]
(nota che gli "a capo" non sono necessari; sono inseriti nell'esempio solo per chiarezza. Il codice funziona altrettanto bene senza a capo, così:
[[include page="spoiler1titolo"]]Titolo dello spoiler[[include page="spoiler2nascosto"]]Testo nascosto.
Questo testo compare solo quando si clicca su "scopri" o sul titolo dello spoiler.[[include page="spoiler3fine"]]
... semplicemente verranno meno righe vuote nella pagina finale.
IMPORTANTE: nota che è possibile inserire solo UNO spoiler in ogni pagina. Se ne inserisci più di uno, i successivi NON funzioneranno.