Utente:Jaydee.jp/Sandbox/guide

Pagina dei primi argomenti che ho imparato. Riassunto delle linee base fondamentali per creare una pagina a regola senza entrare in eccessivi e spaesanti dettagli. Utile prontuario per chi non ha ancora nessuna conoscenza nel campo e vuole creare una pagina.

LINGUAGGIO DI SCRITTURA

Testo piano e Wikitesto
Nella scrittura delle voci e delle altre pagine di Wikipedia, oltre al testo piano, si utilizza anche uno specifico linguaggio di markup, detto wikitesto, con il quale si ottengono effetti di formattazione (del testo e della pagina) e di strutturazione (della singola pagina e ipertestuale). In generale un linguaggio di markup è un insieme di regole che descrivono i meccanismi di rappresentazione (strutturali, semantici o presentazionali) di un testo che, utilizzando convenzioni standardizzate, sono utilizzabili su più supporti. La tecnica di formattazione per mezzo di marcatori (o espressioni codificate) richiede quindi una serie di convenzioni, ovvero appunto di un linguaggio a marcatori di documenti.

LAYOUT BASE

Nozioni base per un primo layout della pagina per rendere le informazioni chiare, intuitivee e nel rispetto del manuale di stile.
Detto questo è importante ricordarsi che:

«Alcuni gruppi di voci, come gli elementi della tavola periodica, i comuni d'Italia, le voci su animali e piante, i popoli antichi e le regioni storiche o quelle correlate alla storia romana hanno già una struttura predefinita, un modello di stesura ideato dai wikipediani riunitisi all'interno di un progetto dedicato a quell'argomento, pronto per essere adottato e completato (si possono vedere nella Categoria:Modelli di voce).»

(Wikipedia, Manuale di stile, La struttura di una voce)

CREAZIONE DELLA PAGINA

Come prima cosa bisogna pensare a un titolo.
Il titolo sembrerebbe a intuito la parte da scrivere meno soggetta a regolamentazioni. In realtà sono molte le cose a cui fare attenzione. Oltre alla ovvia difficoltà di trovare una o poche parole che esprimano immediatamente ed intuitivamente il contenuto della pagina, bisogna anche controllare che non esistano già sia una pagina dal titolo diverso ma con gli stessi argomenti sia una pagina con lo stesso titolo (indipendentemente che abbia gli stessi argomenti o argomenti diversi). Vedi a proposito la voce Titolo del Manuale di stile.
Una volta deciso il titolo per creare la pagina basta inserire il titolo scelto nella barra di ricerca interna di wikipedia. Se si sono seguiti correttamente i suddetti accorgimenti dovrebbe apparire la pagina speciale di ricerca senza risultati contenente già il link Crea la pagina "titolo scelto". Altrimenti nella barra degli indirizzi del proprio browser basta aggiungere /titolo scelto all'indirizzo https://it.wikipedia.org/wiki ottenendo https://it.wikipedia.org/wiki/titolo scelto.

In ogni caso, che si stia creando o modificando una pagina, è opportuno fare delle prove scrivendo il wikitesto nella propria sandbox (o in quella comune se non si è un utente registrato). Si possono anche creare delle sottopagine nella propria sandbox aventi come titolo il titolo scelto. Il procedimento è lo stesso. Basta aggiungere /titolo scelto all'indirizzo https://it.wikipedia.org/wiki/Utente:nome utente/Sandbox ottenendo https://it.wikipedia.org/wiki/Utente:nome utente/Sandbox/titolo scelto.

INCIPIT

Sarebbe opportuno scrivere nella sezione iniziale, prima dell'indice, un'introduzione o incipit, in cui spiegare in termini semplici il contenuto della voce. L'incipit funziona da riassunto e sommario della voce, e illustra l'importanza dell'argomento in poche frasi.

INDICE

Non è necessario utilizzare un linguaggio di markup.
Il software MediaWiki genera automaticamente un indice (in inglese table of contents, abbreviato in TOC) per tutte le pagine che contengono almeno quattro sezioni. Ciascun elemento dell'indice fornisce inoltre un collegamento cliccabile che rimanda alla sezione cui si riferisce. Per tornare all'indice dopo averlo cliccato, puoi usare il pulsante "freccia indietro" del tuo browser.

SEZIONI

Utili per dividere i vari argomenti della pagina e per permettere la generazione di un indice (dalle 4 sezioni in su).

Cosa si scrive	Come appare
=Titolo= * Qui scrivo l'incipit. ==Sezione== Qui scrivo il testo della sezione. ===Sottosezione=== Qui scrivo il testo della sottosezione. ====Sotto-sottosezione==== Qui scrivo il testo della sotto-sottosezione.	Titolo Qui scrivo l'incipit. Sezione Qui scrivo il testo della sezione. Sottosezione Qui scrivo il testo della sottosezione. Sotto-sottosezione Qui scrivo il testo della sotto-sottosezione.

* Ho utilizzato la sintassi di intestazione (ovvero quella con un solo "=") per mostrare dimensione e stile delle sezioni in rapporto col titolo, ma anche per poter sottolineare che in realtà tale sintassi è RISERVATA al titolo e viene quindi gestita automaticamente dal software MediaWiki. Non deve pertanto essere usata dagli utenti nel redigere una voce.

LAYOUT AVANZATI

TABELLE

Il markup di una tabella si può riassumere nella seguente legenda:

{|	Inizio della tabella
|+	didascalia della tabella, facoltativa, si può mettere solo fra l'Inizio della tabella e la prima riga della tabella
|-	riga della tabella, facoltativa sulla prima riga – MediaWiki assume che esista la prima riga
!	cella intestazione (header), facoltativa (di colore grigio più scuro). Intestazioni consecutive possono stare sulla stessa linea separata da doppi punti esclamativi (!!).
|	contenuto della tabella, obbligatorio! Celle consecutive possono essere aggiunte sulla stessa riga separate da doppi pipe (||) o cominciate su nuove righe, ciascuna che inizia con un pipe (|).
|}	Fine della tabella

ESEMPI CON CODICI

Usare nowiki o sostituire parte del codice con corrispondente entity html

Entity HTML

Carattere	Sostituito con
"	"
&	&
<	&lt;
>	&gt;
{	&#123;
}	&#125;

ATTRIBUTI HTML

A	B
class=""
width=""
style="width: ; text-align: ; color: ; float: ;"
colspan=""
rowspan=""

font-weight:""
font-variant:""
font-style:""
font-size-adjust:""
font-family:""
line-height:""(em)
color:""
font-size:""(%)(x-small)
vertical-align:""
clear:;
margin-top:

TAG

A	B
<br>
<code> </code>
<span> </span>	Crea una divisione logica sulla riga. Permette di assegnare a porzioni di testo un id o una classe, utilizzabili con i CSS.
<div> </div>	Crea un livello logico block-level. Soprattutto per l'uso dei CSS.
<ref></ref>
<nowiki> </nowiki>

PROVA
TESTO

TEMPLATES

E' incluso in una doppia parentesi graffa e con n sezioni separate da | {{sezione|sezione|sezione}}

Esempi:
TRADOTTO DA: {{Tradotto da|Codice della lingua|Nome della voce in lingua originale|Data della versione originale tradotta|oldid}}
SPAZIO: {{Spazi|N}}
CITAZIONE: {{Citazione|citazione da inserire|Autore, Titolo}}
CITAZIONE WEB: {{cita web|indirizzo|Etichetta|lingua del sito citato (es. lingua=en}}

ARRICCHIMENTI

COLLEGAMENTI INTERNI

Si usa la doppia parentesi quadra. Si usa eventualmente | per dare un etichetta

Aiuto:Wikitesto
Aiuto:Indice
Wikipedia:Citazioni
Aiuto:Tabelle vedi anche Template:Wikitable

COLLEGAMENTI ESTERNI

Si usa la parentesi quadra

freeformatter.com, HTML Entity List

NOTE

bla bla bla