Aiuto:Linguaggio di Mediawiki

Da Teleschermo Blu.

Questa pagina spiega nel dettaglio come modificare una pagina di Teleschermo Blu, la sintassi e le convenzioni utilizzate e il flusso di lavoro da seguire.

Nel testo seguente verranno usati in maniera intercambiabile i termini "articolo", "voce" e "pagina" per indicare ogni singola pagina consultabile in Teleschermo Blu. Anche questa che state leggendo è, ad esempio, una "pagina". Funzionalmente parlando, tutte le pagine sono uguali, indipendentemente dal loro contenuto e/o dalla sezione che le contiene. Possono tutte essere modificate seguendo le medesime procedure, a patto di possedere i permessi appropriati.

Un contributore può modificare un articolo cliccando sulla linguetta Modifica o Crea in cima alla pagina. Ovviamente tale linguetta appare solo se l'utente è autorizzato all'operazione.

Secondo la politica di Teleschermo Blu gli articoli pubblicamente visibili NON sono modificabili. Un utente che desidera contribuire può modificare soltanto le bozze di quelle che diverranno le pagine pubbliche. Per sapere come contribuire a rendere Teleschermo Blu sempre migliore leggete l'articolo Come contribuire.

Una volta entrati in modalità di modifica di un articolo, tutte le formattazioni del testo si effettuano semplicemente inserendo degli opportuni caratteri di controllo nel testo.

Indice 1 Paragrafi 2 Sezioni 3 Grassetto e corsivo. 4 Liste puntate e numerate 5 Elenchi di definizioni 6 Link e collegamenti 7 Immagini

Paragrafi

Il sistema ignora i semplici a capo. Se si desidera iniziare un nuovo paragrafo bisogna lasciare una linea vuota.

Sezioni

Il testo di un articolo deve essere organizzato in sezioni per essere ben leggibile. ad esempio questo testo è contenuto nella sezione "Sezioni" di questa pagina.

NOTA: le voci di Teleschermo Blu cercano di seguire una struttura precisa e comune, in modo da facilitare la stesura degli articoli e la consultazione da parte dei lettori. La struttura consiste principalmente nella presenza di determinate sezioni e in una sequenza prefissata. Tutti i contributi devono attenersi il più possibile a questa struttura.

Per creare una nuova sezione è sufficiente racchiudere l'intestazione della sezione in un numero variabile di caratteri di uguale ("="). L'intestazione deve essere l'unico testo sulla riga.

Esempio:

=Sezione di livello 1=
==Sottosezione di livello 2==
===Sottosezione di livello 3===

Il numero di segni di uguale determina il livello della sottosezione. Non devono mai essere usate sezioni di primo livello, in quanto esse vengono generate automaticamente dal sistema come titolo dell'articolo stesso, in questo caso: "Aiuto:Linguaggio di Mediawiki".

Questo vuol dire che la maggior parte delle sezioni in un articolo saranno sezioni di secondo livello. Il sistema crea automaticamente un indice ordinato delle sezioni in una voce. E' comunque sconsigliato suddividere un articolo in troppi livelli di sezioni, in quanto può rendere difficoltosa la lettura. In un articolo ben scritto non dovrebbe essere mai necessario andare oltre al terzo livello di intestazione. Piuttosto, potrebbe essere necessario consultare un redattore per scindere l'articolo in due.

Grassetto e corsivo.

• Lo stile di carattere grassetto si applica racchiudendo il testo tra tre caratteri di apice singolo

Esempio:

'''grassetto'''

Diventa: grassetto

• Il corsivo si applica il testo tra due caratteri di apice singolo.

Esempio:

''corsivo''

Diventa: corsivo

• Entrambi gli stili possono essere combinati usando cinque caratteri di apice singolo.

Esempio:

'''''grassetto e corsivo'''''

Diventa: grassetto e corsivo

Liste puntate e numerate

In maniera analoga alle sezioni, liste puntate di testo possono essere create iniziando la riga con uno o più caratteri di asterisco. In numero di caratteri determina il livello dell'annidamento della lista. L'inserimento di una riga vuota termina una lista.

Esempio:

* Frutti
** Mele
*** Rosse
*** Verdi
** Pere
* Ortaggi
** Carote
** Peperoni
** Pomodori

Diventa:

• Frutti
  • Mele
    • Rosse
    • Verdi
  • Pere
• Ortaggi
  • Carote
  • Peperoni
  • Pomodori

Le liste numerate vengono create invece iniziando la riga con uno o più caratteri di cancelletto. La numerazione viene gestita automaticamente dal sistema.

Esempio:

# Alberi
## Abete
## Quercia
# Fiori
## Rosa
### Rossa
### Gialla
## Margherita

Diventa:

1. Alberi
   1. Abete
   2. Quercia
2. Fiori
   1. Rosa
      1. Rossa
      2. Gialla
   2. Margherita

I due tipi di lista possono essere anche combinati.

Esempio:

* Cartoni
*# Fantascienza
*# Sportivi
*## Calcio
*## Baseball
*# Drammatici
* Film
*# Horror
*# Avventura

Diventa:

• Cartoni
  1. Fantascienza
  2. Sportivi
     1. Calcio
     2. Baseball
  3. Drammatici
• Film
  1. Horror
  2. Avventura

Elenchi di definizioni

Un'altra struttura molto utile è l'elenco di definizioni. Consente di specificare delle strutture indentate e formattate. Sono particolarmente utili ed indicati per descrivere, ad esempio, gli episodi di un cartone animato, o i personaggi.

Si realizzano scrivendo la voce da descrivere in una riga iniziata dal carattere carattere punto e virgola (;) e, in una riga successiva, la definizione relativa in una riga iniziata dal carattere due punti (:).

Esempio:

;Voce 1
:definizione 1
;Voce 2
:definizione 2
;Voce 3
:definizione 3
;Voce 4
:definizione 4

Voce 1

definizione 1

Voce 2

definizione 2

Voce 3

definizione 3

Voce 4

definizione 4

Link e collegamenti

Per inserire un link interno (cioè un link ad un'altra pagina di Teleschermo blu) è sufficiente racchiudere il nome completo della pagina tra due coppie di parentesi quadre

Esempio:

[[Teleschermo Blu:Informazioni]]

Diventa: Teleschermo Blu:Informazioni

E' possibile specificare un testo diverso dal nome dell'articolo separandolo da un carattere di barra verticale (solitamente il primo tasto in alto a sinistra di una tastiera standard).

Esempio:

[[Teleschermo Blu:Informazioni|Informazioni su Teleschermo Blu]]

Diventa: Informazioni su Teleschermo Blu

Un link esterno (cioè un link ad un qualsiasi sito internet) si inserisce racchiudendo il link tra una coppia di parentesi quadre e specificando il testo che deve apparire, separato da uno spazio

Esempio:

[http://www.sigletv.net SIGLETV.NET]

Diventa: SIGLETV.NET

Se si inserisce un link senza specificare il testo da visualizzare tale link verrà riportato come link numerato gestito automaticamente.

Esempio:

[http://www.radioanimati.it]

Diventa: [1]

Immagini

Per inserire un'immagine in un articolo, questa deve prima essere caricata sul sito. Per far questo si utilizza la pagina Carica un file

NOTA: si raccomanda di caricare solo i file necessari, e solo alle dimensioni e risoluzione strettamente necessarie allo scopo. Lo spazio sul server non è infinito!!

Il modo più semplice per collegare un'immagine è:

[[Immagine:NOME_IMMAGINE]]

Al tag è possibile inoltre specificare alcuni parametri aggiuntivi per migliorare la formattazione dell'immagine, da aggiungere dopo il nome dell'immagine, e separati da barre verticali.

• left, center 'right specificano il posizionamento dell'immagine rispetto al testo.

[[Immagine:NOME_IMMAGINE|left]]

• per inserire una miniatura dell'immagine reale è possibile specificare la dimensione in pixel dell'immagine da visualizzare. Non bisogna abusare di questa possibilità.

[[Immagine:NOME_IMMAGINE|120px]]

• E' possibile, anzi consigliato, specificare del testo aggiuntivo all'immagine, che il browser visualizzerà in caso di impossibilità di visualizzare l'immagine o di solito passandoci sopra col mouse. Basta scrivere del testo qualsiasi che non sia uno dei paramentri speciali.

[[Immagine:NOME_IMMAGINE|Descrizione dell'immagine]]

I parametri possono essere combinati. Questo permette per le miniature, usando il parametro thumb, di creare delle miniature che seguono lo standard di Teleschermo blu

[[Image:NOME_IMMAGINE‎|left|thumb|120px|<small>Descrizione dell'immagine<small>]]

In questo esempio si è usato il posizionamento a sinistra, una dimensione di 120 pixel e un carattere piccolo per la descrizione.