Repository 32bit  Forum
Repository 64bit  Wiki

Documentazione/Syntax: differenze tra le versioni

Da Slacky.eu.
(info elenchi - NOTA: la skin non visualizza bullet e numerazione)
(-)
 
(7 revisioni intermedie di 2 utenti non mostrate)
Riga 1: Riga 1:
<!-- Pagina con esempi della sintassi Mediawiki -->
+
== Paragrafi e intestazioni == <!-- Pagina con esempi della sintassi Mediawiki -->
== Paragrafi e intestazioni ==
+
Il "contenitore" usato in questo wiki è Mediawiki, lo stesso di Wikipedia. Uno degli elementi portanti di questo sistema, nato proprio per documentare, è l'uso dei paragrafi o header (intestazioni). Dalle intestazioni, Mediawiki ricava automaticamente l'indice. '''Per creare un buon articolo è fondamentale partire da un buon indice, quindi l'indice è la prima cosa da abbozzare.''' Un esempio concreto di sorgente dovrebbe chiarire il tutto:
Il "contenitore" usato in questo wiki è Mediawiki, lo stesso di Wikipedia. Uno degli elementi portanti di questo sistema, nato proprio per documentare, è l'uso dei paragrafi o header (intestazioni). Dalle intestazioni, Mediawiki ricava automaticamente l'indice. '''Per creare un buon articolo è fondamentale partire da un buon indice, quindi l'indice la prima cosa da abbozzare.''' Un esempio concreto di sorgente dovrebbe chiarire il tutto:
 
{| class="wikitable" width="400"
{| class="wikitable" width="400"
! Sorgente !! Risultato
! Sorgente !! Risultato
Riga 17: Riga 17:
</source>
</source>
| style="color:blue;" |
| style="color:blue;" |
*1. Il computer
+
:1. Il computer
**1.1 La scheda madre
+
::1.1 La scheda madre
***1.1.1 CPU
+
:::1.1.1 CPU
***1.1.2 RAM
+
:::1.1.2 RAM
***1.1.3 Hard disk
+
:::1.1.3 Hard disk
**2 Alimentatore
+
::1.2 Alimentatore
**3 Case
+
::1.3 Case
|}
|}
Riga 36: Riga 36:
**Level 1
**Level 1
***Level 2
***Level 2
  +
  +
#Root
#Root
##Level 1
##Level 1
###Level 2
###Level 2
  +
  +
:Root
:Root
::Level 1
::Level 1
Riga 67: Riga 71:
</source>
</source>
|[[Documentazione|Ritorna a pagina principale]]
|[[Documentazione|Ritorna a pagina principale]]
  +
|-
  +
|Link a sezioni interne al documento
  +
|<source lang="text">
  +
[[#Paragrafi_e_intestazioni | Vai a "Paragrafi e intestazione"]]
  +
</source>
  +
|[[#Paragrafi_e_intestazioni | Vai a "Paragrafi e intestazione"]]
|-
|-
|Link esterni
|Link esterni
Riga 73: Riga 83:
</source>
</source>
|[http://www.slacky.eu Slacky Community]
|[http://www.slacky.eu Slacky Community]
 
|}
|}
'''Controllare comunque le estensioni permesse e le raccomandazioni''' in [http://www.slacky.eu/wikislack/index.php?title=Speciale:Carica Carica un file]
'''Controllare comunque le estensioni permesse e le raccomandazioni''' in [http://www.slacky.eu/wikislack/index.php?title=Speciale:Carica Carica un file]

Versione attuale delle 16:51, 8 apr 2012

Indice

[modifica] Paragrafi e intestazioni

Il "contenitore" usato in questo wiki è Mediawiki, lo stesso di Wikipedia. Uno degli elementi portanti di questo sistema, nato proprio per documentare, è l'uso dei paragrafi o header (intestazioni). Dalle intestazioni, Mediawiki ricava automaticamente l'indice. Per creare un buon articolo è fondamentale partire da un buon indice, quindi l'indice è la prima cosa da abbozzare. Un esempio concreto di sorgente dovrebbe chiarire il tutto:

Sorgente Risultato
= Il computer =
 
== La scheda madre ==
=== CPU ===
=== RAM ===
=== Hard disk ===
 
== Alimentatore ==
 
== Case ==
1. Il computer
1.1 La scheda madre
1.1.1 CPU
1.1.2 RAM
1.1.3 Hard disk
1.2 Alimentatore
1.3 Case

[modifica] Elenchi puntati e numerati

Creare elenchi puntati e numerati è molto semplice. Il risultato grafico (forma dei bullet, ecc.) dipende dalla skin usata. Esempio diretto:

Sorgente Risultato
*Root
**Level 1
***Level 2
 
 
#Root
##Level 1
###Level 2
 
 
:Root
::Level 1
:::Level 2
  • Root
    • Level 1
      • Level 2
  1. Root
    1. Level 1
      1. Level 2
Root
Level 1
Level 2

[modifica] Inserire dei link

L'inserimento di link nel testo dell'articolo avviene semplicemente inserendo nomi e percorsi tra parentesi quadre. Esempio diretto:

Sorgente Risultato
Link interni
[[Documentazione|Ritorna a pagina principale]]
Ritorna a pagina principale
Link a sezioni interne al documento
[[#Paragrafi_e_intestazioni | Vai a "Paragrafi e intestazione"]]
Vai a "Paragrafi e intestazione"
Link esterni
[http://www.slacky.eu Slacky Community]
Slacky Community

Controllare comunque le estensioni permesse e le raccomandazioni in Carica un file

[modifica] Costruire tabelle

Per costruire delle tabelle si possono usare i tag HTML, ma è meglio usare la sintassi Mediawiki. Un semplice esempio:

Sorgente Risultato
{| class="wikitable" ** Inizio tabella e stili **
! Header1 ** Intestazioni **
! Header2
! Header3
|- ** questo crea una nuova riga **
| Cell 1 ** Contenuti **
| Cell 2
| Cell 3
|}
Header1 Header2 Header3
Cell 1 Cell 2 Cell 3

Nota: ** tra asterischi i commenti, da rimuovere **

[modifica] Inserire immagini

Le immagini possono essere caricate con l'apposito link Carica un file, ma generalmente si procede in un modo più diretto, stile wiki: si inserisce il wiki-tag nella posizione voluta del testo, si salva la pagina, quindi si carica il file cliccando sul riquadro ancora vuoto. In questo modo il file che avete sul PC viene rinominato al caricamento. E' buona cosa specificare un nome lungo e significativo, possibilmente legato all'articolo.

Sorgente Risultato
[[Image:Esempio sintassi immagini.jpg|right|thumb|300px|Didascalia]]
(cliccando sul link a destra si attiva la procedura di caricamento)

La sintassi proposta è quella più adatta al nostro wiki, in particolare le immagini allineate a destra rendono migliore l'impaginazione. Per approfondimenti si rimanda alla pagina di aiuto:images di Mediawiki.

Nota: l'esempio si riferisce di proposito ad una immagine ancora da caricare

Attenzione, non inserire immagini di cui non si hanno i diritti di pubblicazione

E' bene assicurarsi che le immagini che carichiamo siano esenti da vincoli di pubblicazione su questo wiki. Un buon metodo per evitare problemi è di scattare in proprio una foto dell'oggetto che vogliamo raffigurare anche se ciò non ci mette totalmente al riparo da sorprese (es: foto di un quadro = foto di opera d'arte derivata). Un posto in cui cercare immagini già controllate sotto il profilo dei diritti di pubblicazione è Wikimedia Commons.

[modifica] Caricare dei file

Per i file da allegare all'articolo vale quanto già scritto per le immagini: conviene prima inserire il tag che specifica il file da caricare, quindi, salvato l'articolo, caricarlo:

Sorgente Risultato
[[File:Nome lungo e significativo.estensione]]
File:Nome lungo e significativo.estensione

(cliccando sul link sopra si carica il file)

Controllare comunque le estensioni permesse e le raccomandazioni in Carica un file

[modifica] Usare un Template

I Template (modelli di pagina) sono un ottimo strumento per creare delle strutture, anche complesse, con stili personalizzati e riutilizzabili in più articoli. Vediamo un esempio di utilizzo:

Sorgente Risultato
{{Hint
|Esempio
|Questo è un esempio di utilizzo di un Template
}}
Esempio
Questo è un esempio di utilizzo di un Template

I modelli presenti in questo wiki sono raccolti qui: Modelli disponibili

[modifica] Assegnare una categoria

E' molto importante assegnare una categoria all'articolo in modo che possa essere ritrovato con facilità. La sintassi è la seguente:

[[Category:Install e Upgrade]]

Le categorie da usare sono, di norma, quelle riportate in Pagina principale.

Nota: fare attenzione al maiuscolo/minuscolo, Mediawiki potrebbe essere "case sensitive". Il wiki-tag Category andrebbe collocato a fine pagina.

[modifica] Firmare l'articolo

Nel caso si volesse firmare l'articolo con il proprio nickname cliccabile, data e ora, basta aggiungere 4 tilde consecutive:

~~~~
Strumenti personali
Namespace

Varianti