Aiuto:Manuale di stile: differenze tra le versioni

Da Wikitrek.
Vai alla navigazione Vai alla ricerca
 
(30 versioni intermedie di 2 utenti non mostrate)
Riga 1: Riga 1:
{{Bozza}}
Questa pagina spiega i principi base per come contribuire a WikiTrek e come scrivere le sue pagine in maniera che sia omogenea, informativa e comprensibile dal pubblico.<br />
Questa pagina spiega i principi base per come contribuire a WikiTrek e come scrivere le sue pagine in maniera che sia omogenea, informativa e comprensibile dal pubblico.<br />
Al momento è '''WORK IN PROGRESS''': ognuno è pregato di contribuire usando l'apposita linguetta ''Discussione''.
Al momento è '''WORK IN PROGRESS''': ognuno è pregato di contribuire usando l'apposita linguetta [[Discussioni aiuto:Manuale di stile|''Discussione'']].


== Principi ==
== Come scrivere una pagina ==
=== WTStaff ===
=== Modelli ===
É una mailing list ''vecchio stampo'' che serve per coordinare il progetto di migrazione delle pagine da [[HyperTrek]] verso WikiTrek.
'''Per un elenco dei modelli di pagine disponibili, fare riferimento alla pagina [[WikiTrek:Modelli]].'''
 
=== Schema della pagina ===
<pre style="width:80%;">{{Eventuali AmBox}}
{{Eventuali box informativo}}
 
Introduzione
 
== {{Etichetta|Tipo=Trama}} ==
Eventuale trama
 
== {{Etichetta|Tipo=Descrizione}} ==
Per una pagina che NON sia di un episodio
 
== {{Etichetta|Tipo=Componenti}} ==
Componenti tipici di un meccanismo o una tecnologia
 
== {{Etichetta|Tipo=Sezioni}} ==
=== {{Etichetta|Tipo=Uniformi}} ===
 
=== {{Etichetta|Tipo=Gradi}} ===
 
=== {{Etichetta|Tipo=Mostreggiature}} ===
 
=== {{Etichetta|Tipo=MostreggiatureDivisa}} ===
 
=== {{Etichetta|Tipo=Dizionario}} ===
 
=== {{Etichetta|Tipo=Mirror}} ===
 
=== {{Etichetta|Tipo=Iqe}} ===
 
=== {{Etichetta|Tipo=Note}} ===
 
=== {{Etichetta|Tipo=Onlocation}} ===
 
=== {{Etichetta|Tipo=Timealt}} ===
 
=== {{Etichetta|Tipo=47}} ===
 
=== {{Etichetta|Tipo=Okudagram}} ===
 
=== {{Etichetta|Tipo=Technobabble}} ===
 
=== {{Etichetta|Tipo=Blooper}} ===
 
=== {{Etichetta|Tipo=YATI}} ===
 
=== {{Etichetta|Tipo=Riciclati}} ===
 
=== {{Etichetta|Tipo=DVD}} ===
 
=== {{Etichetta|Tipo=VersioneIitaliana}} ===
 
=== {{Etichetta|Tipo=Premi}} ===
 
=== {{Etichetta|Tipo=Citazioni}} ===
 
=== {{Etichetta|Tipo=Scenetagliate}} ===
 
=== {{Etichetta|Tipo=Script}} ===
 
=== {{Etichetta|Tipo=Produzione}} ===
 
== Riferimenti ==
Raggruppati per capitoli in ordine alfabetico come titoli di terzo livello
 
== Collegamenti esterni ==
* {{InterlinkMA|Nome=Titolo esatto della pagina su Memory Alpha}}
* altri collegamenti
*
== {{Etichetta|Tipo=Annotazioni}} ==
<references />
 
 
{{NavGlobale}}
 
[[Categoria:Una o più categorie]]
[[Categoria:Una o più categorie]]
</pre>


== Come si collabora ==
=== Schema della pagina con dati registrati in DataTrek ===
* Salvo rari casi NON usiamo la mailing list per le segnalazioni
<pre style="width:80%;">
* Quando qualcuno ha qualcosa da segnalare, se è ragionevolmente sicuro, lo aggiunge alla Wiki - questo è il bello! - e punto
{{IncipitGenerico}}
* Se non è sicuro (oppure se qualcuno vuole obiettare a una "sicurezza") si usa la pagina di Discussione della Wiki


In questo maniera otteniamo vari risultati:
== {{Etichetta|Tipo=Riferimenti}} ==
* Ognuno è responsabile del suo contributo dall'inizio alla fine (lo vede, lo categorizza, lo scrive, lo formatta, lo mantiene e lo difende se necessario)
{{EpilogoGenerico}}
* Non usiamo la Mailing List con due finalità diverse
</pre>
* Tutte le discussioni sono automaticamente archiviate nelle apposita pagina e si evita di ripeterle mille volte. Vedi, solo a titolo esemplificativo, la discussione lunga chilometri e anni riguardo la sezione a disco della Ent-D che provoca o non provoca incendi.


== Come scrivere una pagina ==
=== Schema della pagina EPISODIO con dati registrati in DataTrek ===
<pre style="width:80%;">
{{IncipitEpisodio}}
 
=== Primo atto ===
 
=== Secondo atto ===
 
=== Terzo atto ===
 
== {{Etichetta|Tipo=Sezioni}} ==
=== {{Etichetta|Tipo=IQE}} ===
 
=== {{Etichetta|Tipo=Note}} ===
 
=== {{Etichetta|Tipo=47}} ===
 
=== {{Etichetta|Tipo=Okudagram}} ===
 
=== {{Etichetta|Tipo=Blooper}} ===
 
=== {{Etichetta|Tipo=YATI}} ===
 
=== {{Etichetta|Tipo=VI}} ===
 
=== {{Etichetta|Tipo=Continuity}} ===
=== {{Etichetta|Tipo=Citazioni}} ===
=== {{Etichetta|Tipo=Produzione}} ===
 
== {{Etichetta|Tipo=Riferimenti}} ==
 
{{EpilogoGenerico}}
</pre>
 
=== Timeline ===
Per velocizzare l'inserimento di informazioni nelle pagine della Timeline si possono sfruttare i template esistenti che si usano per i link alle pagine delle serie.
Ad esempio, per inserire l'evento "Primo contatto dell'''Enterprise''-D con i [[Borg]]. ([[Q Who?]])" relativo all'episodio di TNG, è sufficiente scrivere la stringa <pre>{{TNG|Primo contatto dell'{{S|ed}} con i [[Borg]]. ([[Q Who?]])}}</pre> per ottenere l'entry correttamente formattata e completa di icona relativa alla serie.
Nell'esempio qui sopra riportato, il risultato visualizzato sarà:
{{TNG|Primo contatto dell'{{S|ed}} con i [[Borg]]. ([[Q Who?]])}}
 
Per le informazioni ricavate dai romanzi, enciclopedie e libri in genere è possibile utilizzare allo stesso modo il template '''<nowiki>{{LIBRI}}</nowiki>''', mentre per le informazioni ricavate dai film è possibile utilizzare il template '''<nowiki>{{FILM}}</nowiki>'''
 
Un template utile per popolare ''automaticamente'' le pagine della Timeline con contenuti delle pagine di episodi e film è [[Template:TLentry|'''<nowiki>{{TLentry}}</nowiki>''']].
 
=== Scrivere ''template'' ===
Un template è composto da una parte da [[:wikipedia:it:Transclusione|transcludere]] e da una parte invece da visualizzare solo nella pagina del template.<br />Qui di seguito un esempio per impostare un template da zero.
 
'''Importante:''' non mettere a capo dopo <code><nowiki><includeonly></nowiki></code> e prima di <code><nowiki></includeonly></nowiki></code>, così come tra <code><nowiki></includeonly></nowiki></code> e <code><nowiki><noinclude></nowiki></code> altrimenti nella pagina in cui il template è inserito verranno inclusi spazi verticali spuri.
<pre>
<includeonly>Codice del template</includeonly><noinclude>
Introduzione
 
== Uso ==
<code><nowiki><nowiki></nowiki>{{Template con qualche parametro di prova, se presente}}<nowiki></nowiki></nowiki></code>
Eventualmente un breve commento
 
== Esempio ==
{{Template con qualche parametro di prova, se presente}}
Eventualmente un breve commento
[[Categoria:Eventuale categoria del template]]
</noinclude>
</pre>
 
=== ''Template'' etichette ===
Servono per mantenere uniformità nei termini nella wiki. Si trovano nella [[:Categoria:Template etichette]].
 
=== Timeline alternative ===
Alcune pagine della wiki sono specifiche per argomenti [[Canone|non canonici]], altre pagine invece contengono ''anche'' informazioni relative a timeline alternative.<br />In linea di massima ci si comporta così:
* se c'è molto materiale su un argomento di una timeline alternativa, si fa una pagina a parte (come, per esempio, ''[[James T. Kirk (specchio)]]'')
* Se c'è poco da scrivere, partiamo con una sezione della pagina (come in ''[[Bajor#Universo_dello_Specchio]]'' e poi eventualmente si fa lo spinoff di quella sezione in un nuova pagina solo se necessiario.
 
Nel primo caso, per le pagine ''completamente'' riferite a una timeline alternativa, si usano i template specifici:
* [[Template:SpecificoMirror]]
* [[Template:SpecificoKelvinTimeline]]
* [[Template:SpecificoTimelineAlternativa]]
 
=== Formattazione delle date e orari ===
Grazie alle funzionalità di formattazione di ''MediaWiki'' è possibile inserire date nel testo e formattarle a posteriori.<br />Per inserire le date si usa la formattazione
 
<code><nowiki>{{#timel: {{FormatoData|Tipo=</nowiki>''TipoFormatoData''<nowiki>}}|</nowiki>''Data e ora in [[:wikipedia:it:ISO 8601|formato ISO8601]]''<nowiki>}}</nowiki></code>
 
Il [[:wikipedia:it:ISO 8601|formato ISO8601]] assicura una data (e ora, se necessaria) non ambigua, mentre la formattazione passata tramite [[Template:FormatoData]] consente di rendere la data gradevole alla lettura.<br />Per dettagli sulla formattazione, si veda [[:mw:Help:Extension:ParserFunctions##time|''Extension:ParserFunctions#time'']]
 
Per semplificare ulteriormente la sintassi e migliorare l'output, esiste ora il template <code>[[:Template:TimeL|<nowiki>{{TimeL}}</nowiki>]]</code> da usarsi così:
 
<code><nowiki>{{TimeL|Tipo=</nowiki>''TipoFormatoData''<nowiki>|Istante=</nowiki>''Data e ora in [[:wikipedia:it:ISO 8601|formato ISO8601]]''<nowiki>}}</nowiki></code>
 
In questo caso la sintassi è più compatta e più chiara, inoltre la data è circondata dal tag <code><nowiki><time></nowiki></code> con la proprietà <code><nowiki>timespan</nowiki></code> appropriatamente impostata.
 
== Riferimenti utili ==
=== Icone ===
https://commons.wikimedia.org/wiki/Commons:Standard_icons
 
Da inserire usando la normale sintassi (ad esempio <code><nowiki>[[File:System-search.svg|40px|System-search]]</nowiki></code>: [[File:System-search.svg|40px|System-search]]) grazie a [[:mw:InstantCommons|''InstantCommons'']].

Versione attuale delle 15:44, 10 set 2023

Gnome-colors-alacarte.svg
Bozza
Questa pagina contiene solo una bozza dell'argomento da trattare. Contribuisci a migliorarla.

Questa pagina spiega i principi base per come contribuire a WikiTrek e come scrivere le sue pagine in maniera che sia omogenea, informativa e comprensibile dal pubblico.
Al momento è WORK IN PROGRESS: ognuno è pregato di contribuire usando l'apposita linguetta Discussione.

Come scrivere una pagina

Modelli

Per un elenco dei modelli di pagine disponibili, fare riferimento alla pagina WikiTrek:Modelli.

Schema della pagina

{{Eventuali AmBox}}
{{Eventuali box informativo}}

Introduzione

== {{Etichetta|Tipo=Trama}} ==
Eventuale trama

== {{Etichetta|Tipo=Descrizione}} ==
Per una pagina che NON sia di un episodio

== {{Etichetta|Tipo=Componenti}} ==
Componenti tipici di un meccanismo o una tecnologia

== {{Etichetta|Tipo=Sezioni}} ==
=== {{Etichetta|Tipo=Uniformi}} ===

=== {{Etichetta|Tipo=Gradi}} ===

=== {{Etichetta|Tipo=Mostreggiature}} ===

=== {{Etichetta|Tipo=MostreggiatureDivisa}} ===

=== {{Etichetta|Tipo=Dizionario}} ===

=== {{Etichetta|Tipo=Mirror}} ===

=== {{Etichetta|Tipo=Iqe}} ===

=== {{Etichetta|Tipo=Note}} ===

=== {{Etichetta|Tipo=Onlocation}} ===

=== {{Etichetta|Tipo=Timealt}} ===

=== {{Etichetta|Tipo=47}} ===

=== {{Etichetta|Tipo=Okudagram}} ===

=== {{Etichetta|Tipo=Technobabble}} ===

=== {{Etichetta|Tipo=Blooper}} ===

=== {{Etichetta|Tipo=YATI}} ===

=== {{Etichetta|Tipo=Riciclati}} ===

=== {{Etichetta|Tipo=DVD}} ===

=== {{Etichetta|Tipo=VersioneIitaliana}} ===

=== {{Etichetta|Tipo=Premi}} ===

=== {{Etichetta|Tipo=Citazioni}} ===

=== {{Etichetta|Tipo=Scenetagliate}} ===

=== {{Etichetta|Tipo=Script}} ===

=== {{Etichetta|Tipo=Produzione}} ===

== Riferimenti ==
Raggruppati per capitoli in ordine alfabetico come titoli di terzo livello

== Collegamenti esterni ==
* {{InterlinkMA|Nome=Titolo esatto della pagina su Memory Alpha}}
* altri collegamenti
* 
== {{Etichetta|Tipo=Annotazioni}} ==
<references />


{{NavGlobale}}

[[Categoria:Una o più categorie]]
[[Categoria:Una o più categorie]]

Schema della pagina con dati registrati in DataTrek

{{IncipitGenerico}}

== {{Etichetta|Tipo=Riferimenti}} ==
{{EpilogoGenerico}}

Schema della pagina EPISODIO con dati registrati in DataTrek

{{IncipitEpisodio}}

=== Primo atto ===

=== Secondo atto ===

=== Terzo atto ===

== {{Etichetta|Tipo=Sezioni}} ==
=== {{Etichetta|Tipo=IQE}} ===

=== {{Etichetta|Tipo=Note}} ===

=== {{Etichetta|Tipo=47}} ===

=== {{Etichetta|Tipo=Okudagram}} ===

=== {{Etichetta|Tipo=Blooper}} ===

=== {{Etichetta|Tipo=YATI}} ===

=== {{Etichetta|Tipo=VI}} ===

=== {{Etichetta|Tipo=Continuity}} ===
=== {{Etichetta|Tipo=Citazioni}} ===
=== {{Etichetta|Tipo=Produzione}} ===

== {{Etichetta|Tipo=Riferimenti}} ==

{{EpilogoGenerico}}

Timeline

Per velocizzare l'inserimento di informazioni nelle pagine della Timeline si possono sfruttare i template esistenti che si usano per i link alle pagine delle serie.

Ad esempio, per inserire l'evento "Primo contatto dell'Enterprise-D con i Borg. (Q Who?)" relativo all'episodio di TNG, è sufficiente scrivere la stringa

{{TNG|Primo contatto dell'{{S|ed}} con i [[Borg]]. ([[Q Who?]])}}

per ottenere l'entry correttamente formattata e completa di icona relativa alla serie.

Nell'esempio qui sopra riportato, il risultato visualizzato sarà:

Per le informazioni ricavate dai romanzi, enciclopedie e libri in genere è possibile utilizzare allo stesso modo il template {{LIBRI}}, mentre per le informazioni ricavate dai film è possibile utilizzare il template {{FILM}}

Un template utile per popolare automaticamente le pagine della Timeline con contenuti delle pagine di episodi e film è {{TLentry}}.

Scrivere template

Un template è composto da una parte da transcludere e da una parte invece da visualizzare solo nella pagina del template.
Qui di seguito un esempio per impostare un template da zero.

Importante: non mettere a capo dopo <includeonly> e prima di </includeonly>, così come tra </includeonly> e <noinclude> altrimenti nella pagina in cui il template è inserito verranno inclusi spazi verticali spuri.

<includeonly>Codice del template</includeonly><noinclude>
Introduzione

== Uso ==
<code><nowiki>{{Template con qualche parametro di prova, se presente}}</nowiki></code>
Eventualmente un breve commento

== Esempio ==
{{Template con qualche parametro di prova, se presente}}
Eventualmente un breve commento
[[Categoria:Eventuale categoria del template]]
</noinclude>

Template etichette

Servono per mantenere uniformità nei termini nella wiki. Si trovano nella Categoria:Template etichette.

Timeline alternative

Alcune pagine della wiki sono specifiche per argomenti non canonici, altre pagine invece contengono anche informazioni relative a timeline alternative.
In linea di massima ci si comporta così:

  • se c'è molto materiale su un argomento di una timeline alternativa, si fa una pagina a parte (come, per esempio, James T. Kirk (specchio))
  • Se c'è poco da scrivere, partiamo con una sezione della pagina (come in Bajor#Universo_dello_Specchio e poi eventualmente si fa lo spinoff di quella sezione in un nuova pagina solo se necessiario.

Nel primo caso, per le pagine completamente riferite a una timeline alternativa, si usano i template specifici:

Formattazione delle date e orari

Grazie alle funzionalità di formattazione di MediaWiki è possibile inserire date nel testo e formattarle a posteriori.
Per inserire le date si usa la formattazione

{{#timel: {{FormatoData|Tipo=TipoFormatoData}}|Data e ora in formato ISO8601}}

Il formato ISO8601 assicura una data (e ora, se necessaria) non ambigua, mentre la formattazione passata tramite Template:FormatoData consente di rendere la data gradevole alla lettura.
Per dettagli sulla formattazione, si veda Extension:ParserFunctions#time

Per semplificare ulteriormente la sintassi e migliorare l'output, esiste ora il template {{TimeL}} da usarsi così:

{{TimeL|Tipo=TipoFormatoData|Istante=Data e ora in formato ISO8601}}

In questo caso la sintassi è più compatta e più chiara, inoltre la data è circondata dal tag <time> con la proprietà timespan appropriatamente impostata.

Riferimenti utili

Icone

https://commons.wikimedia.org/wiki/Commons:Standard_icons

Da inserire usando la normale sintassi (ad esempio [[File:System-search.svg|40px|System-search]]: System-search) grazie a InstantCommons.