Strumenti Utente

Strumenti Sito


wiki:syntax

Sintassi di formattazione

Consiglio: la prossima volta che utilizzi questa pagina per creare i tuoi contenuti aprila utilizzando il tasto destro del mouse e cliccando su “Apri link in un'altra finestra”, così l'avrai sempre comodamente sottomano.

Extrapedia supporta del semplice linguaggio di formattazione, che cerca di rendere i file dei dati il più possibile leggibili. Questa pagina contiene tutta la sintassi che si può usare quando si creano o modificano le pagine. È anche sufficiente dare una semplice occhiata al codice sorgente di questa pagina premendo il comando Modifica questa pagina (primo in alto del menu fluttuante), per rendersi conto di come funziona la formattazione. Una formattazione ancora più semplice e veloce è data utilizzando i pulsanti della barra degli strumenti. In ogni caso, è sempre preferibile che ognuno conosca direttamente il linguaggio.

Basi per la Formattazione del testo

Extrapedia supporta testi in grassetto, corsivo, sottolineato ed equispaziato. Naturalmente tutti questi si possono combinare.

Extrapedia supporta testi in **grassetto**, //corsivo//, __sottolineato__ ed ''equispaziato''.
Naturalmente tutti questi si possono **__//''combinare''//__**.

Si possono usare anche pedici e apici.

Si possono usare anche <sub>pedici</sub> e <sup>apici</sup>.

Inoltre si può contrassegnare qualcosa come cancellato.

Inoltre si può contrassegnare qualcosa come <del>cancellato</del>.

I paragrafi sono creati da righe vuote. Se si vuole forzare un ritorno a capo senza un paragrafo, si possono usare due barre retroverse \\ seguite da uno spazio alla fine della riga.

Questo è del testo con qualche interruzione di linea
Notare che le due barre retroverse sono riconosciute soltanto alla fine di una linea
oppure quando seguite da
uno spazio \\ecco cosa succede senza.

Questo è del testo con qualche interruzione di linea\\ Notare che le
due barre retroverse sono riconosciute soltanto alla fine di una riga\\
oppure quando seguite da\\ uno spazio \\ecco cosa succede senza.

I ritorni a capo forzati dovrebbero essere usati solo quando realmente necessari.

Testo rientrato o esterno ai blocchi

Questo testo appare rientrato.

<wrap indent>Questo testo appare rientrato.</wrap>

Questo testo appare fuori blocco.

<wrap outdent>Questo testo appare fuori blocco.</wrap>

Testo al centro e testo a destra

<WRAP centeralign>
<color #ed1c24>Testo al centro...</color>
</WRAP>

Testo al centro…

<WRAP rightalign>
... e allineato a destra.
</WRAP>

… e allineato a destra.

Collegamenti

Extrapedia supporta molteplici modi per la creazione di collegamenti.

Esterni

I collegamenti esterni sono riconosciuti automaticamente: http://www.google.com o semplicemente www.google.com - Si possono impostare anche i testi dei collegamenti: Questo collegamento punta a Google. Sono riconosciuti anche gli indirizzi di posta elettronica come questo: staff@extrapedia.org.

Extrapedia supporta molteplici modi per la creazione di collegamenti. I collegamenti esterni sono riconosciuti
automaticamente: http://www.google.com o semplicemente www.google.com - Si possono impostare
anche i testi dei collegamenti: [[http://www.google.com|Questo collegamento punta a Google]]. Sono riconosciuti anche gli indirizzi di posta elettronica come questo: <staff@extrapedia.org> .

Interni

I collegamenti interni sono creati usando le parentesi quadre. Si può immettere un nome pagina es.:Privacy Policy (codice: [[info:privacy_policy|Privacy Policy]]) o, in alternativa, un testo introduttivo es.: condizioni d'uso (codice: [[info:privacy_policy|condizioni d'uso]]) aggiuntivo.

I nomi delle pagine sono convertiti automaticamente in minuscolo, i caratteri speciali non sono consentiti.

Si può specificare la categoria usando i due punti (:) nel nome della pagina.

Si può specificare la [[it:namespaces|categoria]] usando i due punti (:) nel nome della pagina.

È pure possibile realizzare collegamenti interni alla pagina, ossia a una specifica sezione dell'Indice Pagina (Tabella dei contenuti). È sufficiente aggiungere il nome della sezione prima del carattere diesis (#), come è noto dall'HTML. Questo collegamento punta a questa Sezione.

Questo collegamento punta a [[sintassi_di_formattazione#interni#interni|questa Sezione]].

Note:

  • I collegamenti a pagine esistenti sono visualizzati in colore rosso.
  • Quando l'intestazione di una sezione è modificata, anche il suo segnalibro (bookmark) cambia. Pertanto non bisogna fare troppo affidamento sui collegamenti alle sezioni.

Collegamenti a immagini

Si può anche usare un'immagine per creare un collegamento a un'altra pagina, interna o esterna, combinando la sintassi per i collegamenti e per le immagini (vedi sotto) come questa:

[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]

Notare: la formattazione dell'immagine è l'unica sintassi di formattazione accettata nei nomi dei collegamenti.

L'intera sintassi delle immagini e dei collegamenti è supportata (incluso il ridimensionamento, immagini interne ed esterne e i collegamenti di tipo URL e interwiki).


Note a piè di pagina

Si possono aggiungere note a piè di pagina 1) usando parentesi doppie.

Si possono aggiungere note a piè di pagina ((Questa è una nota a piè di pagina)) usando parentesi doppie.

Suddivisione in sezioni

Si possono usare fino a cinque differenti livelli di intestazione per strutturare il contenuto. Se si hanno più di tre intestazioni, un indice dei contenuti è generato automaticamente - ciò può essere disabilitato includendo la stringa ~~NOTOC~~ nel documento.

Livello di intestazione 3

Livello di intestazione 4

Livello di intestazione 5
==== Livello di intestazione 3 ====
=== Livello di intestazione 4 ===
== Livello di intestazione 5 ==

Usando quattro o più trattini e dando il comando “Invio”, si può fare una linea orizzontale:


Immagini e altri file

Codici:

Dimensione reale:

Ridimensionata a una larghezza data:

Ridimensionata a larghezza e altezza date (Quando il rapporto tra la larghezza e l'altezza dati non corrispondono con quelli dell'immagine, sarà ritagliata al nuovo rapporto prima di essere ridimensionata):

Immagine esterna ridimensionata:

Dimensione reale:                        {{wiki:dokuwiki-128.png}}
Ridimensionata a una larghezza data:            {{wiki:dokuwiki-128.png?50}}
Ridimensionata a larghezza e altezza date: {{wiki:dokuwiki-128.png?200x50}}
Immagine esterna ridimensionata:           {{http://de3.php.net/images/php.gif?200x50}}

Usando spazi bianchi a sinistra o a destra si può scegliere l'allineamento.

{{ wiki:dokuwiki-128.png}}
{{wiki:dokuwiki-128.png }}
{{ wiki:dokuwiki-128.png }}

Naturalmente, si può aggiungere anche un titolo (visualizzato come suggerimento dalla maggior parte dei programmi di navigazione).

Questa è la didascalia

{{ wiki:dokuwiki-128.png |Questa è la didascalia}}

Se si specifica il nome di un file (esterno o interno) che non è un'immagine (gif, jpeg, png), allora esso sarà visualizzato come collegamento.

Per collegare un'immagine a un'altra pagina, vedere Collegamenti a immagini sopra.

Didascalia immagini

Aggiungere [ e ] al normale codice che si utilizza per inserire immagini, es.: [{{ImagePath|Didascalia immagine}}]

Ecco l'aggiunta di una didascalia per questa immagine

codice utilizzato: [{{wiki:dokuwiki-128.png|Ecco l'aggiunta di una didascalia per questa immagine}}]

Liste

Extrapedia supporta liste ordinate e non-ordinate. Se non si usano i comandi della barra degli strumenti, per creare un elemento di una lista, indentare il testo con due spazi e usare un asterisco (*) per le liste non ordinate, oppure un trattino (-) per quelle ordinate.

  • Questa è una lista
  • Il secondo elemento
    • Si possono avere livelli differenti
  • Un altro elemento
  1. La stessa lista ma ordinata
  2. Un altro elemento
    1. ) Usare semplicemente l'indentazione per ottenere livelli più profondi
  3. È tutto
  * Questa è una lista
  * Il secondo elemento
    * Si possono avere livelli differenti
  * Un altro elemento

  - La stessa lista ma ordinata
  - Un altro elemento
    - Usare semplicemente l'indentazione per ottenere livelli più profondi
  - È tutto

Citazioni

Talvolta si vuole contrassegnare del testo per mostrare che esso è una risposta o un commento. Si può usare la sintassi seguente:

Penso che dovremmo farlo

> No, non dovremmo  

>> Be', dico che dovremmo  

> Davvero?  

>> Sì!  

>>> Allora facciamolo!  

Penso che dovremmo farlo

No, non dovremmo
Be', dico che dovremmo
Davvero?
Sì!
Allora facciamolo!

Tabelle

Extrapedia supporta una semplice sintassi per la creazione di tabelle.

Intestazione 1 Intestazione 2 Intestazione 3
Riga 1 Col 1 Riga 1 Col 2 Riga 1 Col 3
Riga 2 Col 1 Celle unite (notare il doppio pipe)
Riga 3 Col 1 Riga 3 Col 2 Riga 3 Col 3

Le righe delle tabelle devono iniziare e terminare con un carattere | per le righe normali o con il carattere ^ per le intestazioni.

^ Intestazione 1 ^ Intestazione 2  ^ Intestazione 3      ^
| Riga 1 Col 1   | Riga 1 Col 2    | Riga 1 Col 3        |
| Riga 2 Col 1   | Celle unite (notare il doppio pipe)  ||
| Riga 3 Col 1   | Riga 3 Col 2    | Riga 3 Col 3        |

Per unire le celle orizzontalmente, è sufficiente rendere completamente vuota la cella successiva come mostrato sopra. Assicurarsi di avere sempre lo stesso numero totale di separatori di celle!

È pure possibile realizzare intestazioni verticali di tabella.

Intestazione 1 Intestazione 2
Intestazione 3 Riga 1 Col 2 Riga 1 Col 3
Intestazione 4 niente fusione questa volta
Intestazione 5 Riga 2 Col 2 Riga 2 Col 3

Come si può notare, è il separatore di cella prima di una cella che decide il tipo di formattazione:

|                 ^ Intestazione 1              ^ Intestazione 2     ^
^ Intestazione 3  | Riga 1 Col 2                | Riga 1 Col 3       |
^ Intestazione 4  | niente fusione questa volta |                    |
^ Intestazione 5  | Riga 2 Col 2                | Riga 2 Col 3       |

Si possono avere celle unite verticalmente aggiungendo ::: dentro le celle sotto quella a cui devono connettersi.

Intestazione 1 Intestazione 2 Intestazione 3
Riga 1 Col 1 questa cella è unita verticalmente Row 1 Col 3
Riga 2 Col 1 Row 2 Col 3
Riga 3 Col 1 Row 2 Col 3

A parte la sintassi di unione quelle celle non devono contenere niente altro.

^ Intestazione 1 ^ Intestazione 2                     ^ Intestazione 3     ^
| Riga 1 Col 1    | questa cella è unita verticalmente | Riga 1 Col 3        |
| Riga 2 Col 1    | :::                                | Riga 2 Col 3        |
| Riga 3 Col 1    | :::                                | Riga 3 Col 3        |

Si può allineare anche il contenuto di una tabella. È sufficiente aggiungere almeno due spazi bianchi al lato opposto del testo: aggiungere due spazi a sinistra per allineare a destra, due spazi a destra per allineare a sinistra e almeno due spazi da entrambi i lati per il testo centrato.

Tabella con allineamento
destra centro sinistra
sinistra destra centro
xxxxxxxxxxxx xxxxxxxxxxxx xxxxxxxxxxxx

Ecco come appare nel formato sorgente:

^         Tabella con allineamento         ^^^
|        destra|    centro    |sinistra      |
|sinistra      |        destra|    centro    |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

Nota 1: l'allineamento verticale non è supportato.
Nota 2: quando si creano tabelle è sempre opportuno verificare la completa visibilità anche su schermi piccoli, tipo Tablet e Smartphone. Per la verifica è possibile utilizzare questo Sito: https://it.infobyip.com/testwebsiteresolution.php inserendo l'URL della pagina che si vuole testare.

Creare tabelle tramite pulsante

Come si creano le tabelle in modo semplice? La funzione è attivata dal tasto della barra di formattazione dell'editor delle pagine, da lì, cliccando col tasto destro del mouse, si possono aggiungere colonne e righe, ma anche altre cose, come la formattazione. Una volta finito, salvando, vedrete la tabella sotto forma di codice, in pratica la funzione vi fa creare tabelle in modo semplificato.

Nessuna formattazione

Se avete bisogno di visualizzare il testo esattamente come è scritto (senza alcuna formattazione), racchiudete l'area sia con il marcatore <nowiki> o più semplicemente, con i segni di doppia percentuale %%.

Questo è del testo che contiene indirizzi come questo http://www.splitbrain.org e **formattazione**, ma niente è fatto con esso.

Lo stesso è vero per //__questo__ testo// con una faccina ;-).

<nowiki>
Questo è del testo che contiene indirizzi come questo: http://www.splitbrain.org e **formattazione**, ma niente è fatto con esso.
</nowiki>
Lo stesso è vero per %%//__questo__testo// con una faccina ;-)%%.

Blocchi di codice

È possibile includere blocchi di codice nei documenti sia indentandoli con almeno due spazi (come negli esempi precedenti), sia usando i marcatori code o file.

Questo testo è intentato con due spazi.
Questo è codice preformattato e tutti gli spazi sono preservati: come              <-questo
  
Questo è praticamente la stessa cosa, ma si potrebbe usare per mostrare che è stato citato un file.
  

Questi blocchi sono stati creati da questi sorgenti:

Questo testo è indentato con due spazi.
<code>
Questo è codice preformato ogni spazio è preservato: come              <-questo
</code>
<file>
Questo è praticamente la stessa cosa, ma si potrebbe usare per mostrare che è stato citato un file.
</file>

In alternativa si può usare questo comando: %%</wrap indent>Testo indentato<</wrap>%%. 

Macro di Controllo

Alcune sintassi influenzano come è restituisce una pagina. La seguente macro di controllo è disponibile per non creare l'Indice T.o.C.:

Macro Descrizione
~~NOTOC~~ Se questa macro è trovata nella pagina, la tabella dei contenuti non sarà creata

Funzioni Aggiuntive

Queste funzioni sono attivabili direttamente tramite il tasto della barra degli strumenti dell'editor (dove si scrive il testo delle pagine) .

Testo Enfatizzato Speciale

Questa è un'anteprima di come apparirà il tuo testo.
Comando utilizzato: <wrap em> Questa è un'anteprima di come apparirà il tuo testo.</wrap>

Box Semplice

Bla bla bla bla bla bla


Codice:
<WRAP center round box 40%> Bla bla bla bla bla bla </WRAP> (percentuale modificabile)

Box Informazione

Bla bla bla bla bla bla


Codice:
<WRAP center round info 40%> Bla bla bla bla bla bla </WRAP> (percentuale modificabile)

Box Importante

Bla bla bla bla bla bla


Codice:
<WRAP center round important 40%> Bla bla bla bla bla bla </WRAP> (percentuale modificabile)

Box di Aiuto

Bla bla bla bla bla bla


Codice:
<WRAP center round help 40%> Bla bla bla bla bla bla </WRAP> (percentuale modificabile)

Box di Attenzione

Bla bla bla bla bla bla (Va messo un file da scaricare, semplice manovra, identica a quando carichi le immagini)


Codice:
<WRAP center round alert 40%> Bla bla bla bla bla bla </WRAP> (percentuale modificabile)

Box Cose da Fare

Bla bla bla bla bla bla


Codice:
<WRAP center round todo 40%> Bla bla bla bla bla bla </WRAP> (percentuale modificabile)

Download

Download


Codice:
<WRAP center round download 20%> Download </WRAP> (percentuale modificabile)

Testo Evidenziato

Questa è un'anteprima di come apparirà il tuo testo.
Comando utilizzato: <wrap hi>Questa è un'anteprima di come apparirà il tuo testo. </wrap>

Colonne

È sconsigliato utilizzare le colonne per le difficoltà di visualizzazione degli schermi piccoli (Tablet e Smartphone). In ogni caso vedere la sorgente dell'Home Page.

Testo Meno importante

meno importante, testo piccolo
Codice utilizzato: <wrap lo>meno importante, testo piccolo</wrap>


Funzioni Extra no click

Queste altre funzioni (qui sotto) non sono opzioni cliccabili, ma possiamo inserirle tramite queste stringhe di codice che le richiamano:

<WRAP warning>prova</WRAP>

prova

<WRAP caution>prova</WRAP>

prova

<WRAP danger>prova</WRAP>

prova

<WRAP round notice>prova</WRAP>

prova

<WRAP round safety>prova</WRAP>

prova

Codice per blocchi piccoli

Tutti i blocchi WRAP sopra specificati, possono anche essere inseriti in linea nel testo, basta semplicemente eliminare il numero percentuale e scrivere wrap in minuscolo, così Info , Help , Errore , Download
Codice utilizzato: <wrap info> Info </wrap>, <wrap help> Help </wrap>,<wrap alert> Errore </wrap>, <wrap download> Download </wrap>

Questo vale anche per: prova, prova, prova, etc
Codice utilizzato: <wrap round safety>prova</wrap>, <wrap warning>prova</wrap>, <wrap round notice>prova</wrap>

Testo colorato

La funzione per scrivere in diversi colori, sempre nella barra degli strumenti, tasto . Questo tasto rilascia dei codici colori di base, che possono essere cambiati a piacimento, magari prelevando il codice che interessa da siti come questo.


1)
Questa è una nota a piè di pagina
wiki/syntax.txt · Ultima modifica: 18/04/2019 05:58 da @Staff R.