Inserimento/modifica del contenuto

È disponibile una versione pdf di questo documento per la consultazione offline e per la stampa.

Introduzione

Per definizione, in un sito dinamico il contenuto può essere inserito, modificato o eliminato dagli utenti che hanno i privilegi per poterlo fare.

In internet il contenuto delle pagine viene codificato in html (o dialetti derivati): per ovvi motivi di usabilità (e di sicurezza) non si può presupporre che tutti gli utenti o amministratori di un sito web siano esperti di codifica html.

A questo scopo sono nati i parser wiki: per rendere più agevole l'inserimento di commenti, articoli o documenti vengono adottate semplici regole da usare direttamente nel testo.

Ogni wiki adotta convenzioni (tecnicamente chiamate tags) differenti: i siti basati su TiP si appoggiano al pacchetto PEAR Text_Wiki.

I wiki sono molto pignoli sulla semantica. Omettere uno spazio, per esempio, può annullare la formattazione desiderata.

Struttura versus apparenza

Un concetto difficile da digerire per gli utenti abituati all'uso di strumenti WYSIWYG (What You See Is What You Get, ossia l'approccio dei tradizionali word-processor) è la differenza tra struttura e apparenza.

Porre una parola in grassetto o impostarla come evidenziata sono due operazioni molto diverse, anche se portano allo stesso risultato. Definirla evidenziata ne precisa la struttura logica, non fa cenno alcuno su come verrà usata questa informazione. L'approccio dei wiki è appunto a struttura.

Ciò implica che il come verranno visualizzate le parole evidenziate, per esempio, dipende da come è stato progettato il sito e può variare, anche di

molto. I risultati degli esempi qui riportati sono pertanto da considerarsi una delle tante possibilità di visualizzazione di contenuti wiki.

Divisione in paragrafi

Premere INVIO due volte per generare un'interruzione di paragrafo.

Per tenere le linee unite anche se è necessario dividerle con un INVIO (se l'editor di testo usato lo richiede, per esempio), terminare la linea con uno spazio e BACKSLASH ( \) e premere INVIO una volta. Questo unirà le due linee mentre il carattere di BACKSLASH non sarà visualizzato.

Formattazione all'interno del paragrafo

testo normale	testo normale
//corsivo//	corsivo
**evidenziato**	evidenziato
//**corsivo evidenziato**//	corsivo evidenziato
{{spaziatura fissa}}	spaziatura fissa

Ignorare i tag di formattazione

Se non si vuole applicare alcuna formattazione, è necessario includere il testo tra doppi backticks:

Questo //testo// sarà **formattato**.
``Questo //testo// non sarà **formattato**.``

Questo testo sarà formattato.

Questo //testo// non sarà **formattato**.

Righe orizzontali

Digitare quattro meno (----) su una linea solitaria per creare una riga orizzontale.

Liste

Liste generiche

Si possono creare liste generiche iniziando un paragrafo con un asterisco seguito da uno spazio (* ). Sono consentite indentazioni di liste inserendo ulteriori spazio prima dell'asterisco.

* Prima voce
 * Sottovoce
  * Sotto-sottovoce
 * Altra sottovoce
* Seconda voce

• Prima voce
  • Sottovoce
    • Sotto-sottovoce
  • Altra sottovoce
• Seconda voce

Liste numerate

Nello stesso modo, si possono creare liste numerate usando il carattere diesis al posto dell'asterisco (# ).

# Primo
# Secondo
 # Prima sottovoce
 # Seconda sottovoce

1. Primo
2. Secondo
   1. Prima sottovoce
   2. Seconda sottovoce

E' consentito mischiare liste generiche e numerate:

# Numero 1
 * Sottovoce generica
 * Altra sottovoce generica
# Numero 2
 * Sottovoce generica
  * Sotto-sottovoce generica
   # Lista ordinata
   # Ecc...
# Numero 3

1. Numero 1
   • Sottovoce generica
   • Altra sottovoce generica
2. Numero 2
   • Sottovoce generica
     • Sotto-sottovoce generica
       1. Lista ordinata
       2. Ecc...
3. Numero 3

Citazioni

Per generare una citazione, iniziare la linea con MAGGIORE e uno spazio (> ).

Testo normale ....

> Citazione ...
> continua citazione e ...
>> ... citazione nella citazione.

Testo normale: notare il doppio //INVIO//...

Testo normale ....

Citazione ...continua citazione e ...

... citazione nella citazione.

Testo normale: notare il doppio INVIO...

Collegamenti e immagini

Digitando un indirizzo corretto, verrà automaticamente evidenziato come link.

http://www.entidi.it/

http://www.entidi.it/

Indirizzi parziali non verranno considerati e saranno trattati come testo normale:

www.entidi.it

www.entidi.it

Se il collegamento fa riferimento ad un'immagine (gif, jpeg o png) questa sarà automaticamente visualizzata al posto dell'indirizzo:

http://www.entidi.it/style/Entidi/shared/images/vento.png

Conclusione

Anche se a prima vista le convenzioni di Text_Wiki possono sembrare complesse, in realtà sono abbastanza intuitive.

Se si vuole provare direttamente quanto qui descritto, si può usare il Sito dimostrativo, implementato proprio per questo scopo.