Creare collegamenti
Come creare collegamenti nei Documenti ad oggetti posizionati dentro e fuori dal sito
In un sito Plone è semplice creare collegamenti a documenti, cartelle o altri oggetti.
La sintassi per creare il collegamento in un Documento dipende dall'editor che si sta usando: editor testuale o editor grafico.
Nota
Questo vale per i principali tipi di contenuto come Documento, Evento o Notizia, dove cioé 'è possibile inserire liberamente del testo.
Attenzione!
Se vuoi semplicemente creare un oggetto che colleghi una risorsa interna o esterna puoi utilizzare un contenuto di tipo Collegamento.
Creare collegamenti con l'editor grafico
Se per modificare il contenuto di un Documento stai utilizzando un editor grafico, per creare un collegamento tutto quello che devi fare è selezionare il testo che vuoi collegare e poi cliccare sull'icona collegamento nell'angolo a destra in alto della finestra dell'editor (assomiglia ad una coppia di anelli di catena). Poi, se l'oggetto che vuoi collegare è contenuto nel sito puoi cercarlo con la finestra pop-up che ti viene mostrata. Se l'oggetto è esterno al sito puoi inserire l'indirizzo (URL) o la posizione del file.
Usa questa sintassi per puntare ad un indirizzo nel web:
http://www.qualcosa.com
Il collegamento ad un indirizzo e-mail è altrettanto semplice. Semplicemente inserisci la frase mailto: seguita dall'indirizzo e-mail a cui desideri collegarti. Per esempio:
mailto:qualcuno@qualcosa.com
Creare collegamenti con un editor testuale
Se stai utilizzando l'editor predefinito (o un editor testuale) puoi usare vari tipi di formattazione del sorgente come per esempio il Testo Strutturato (STX), il Testo ristrutturato (reST) o l'HTML. (C'è anche l'opzione testo semplice ma non è possibile creare collegamenti con il formato testo semplice e quindi, per il nostro caso, non è una scelta valida).
Creare collegamenti con il formato Testo Strutturato (STX)
Per creare un collegamento con il Testo strutturato metti semplicemente la frase da collegare tra virgolette doppie (") seguita da un duepunti (:) seguito a sua volta dall'indirizzo dell'oggetto che vuoi collegare (URL).
Per esempio inserisci qualcosa come:
"Un indirizzo web":http://www.qualcosa.com
Per creare un collegamento ad una risorsa interna al tuo sito usa al posto dell'intero indirizzo web (URL - indirizzo assoluto) il solo nome dell'oggetto (indirizzo relativo). Per esempio, se hai un documento denominato contatti nella cartella radice del tuo sito Plone puoi inserire un collegamento così:
"Clicca qui per contattarmi":contatti
Creare collegamenti con il formato HTML
Per creare il medesimo collegamento usando l'HTML devi inserire questo:
<a href="http://www.qualcosa.com">Un indirizzo web</a>
Attenzione!
Ovviamente siccome il tipo di formattazione che si sceglie interessa l'intero documento, se vuoi usare l'HTML per i tuoi collegamenti dovrai usarlo anche per tutto il resto del documento. Analogamente se per i collegamenti usi il Testo strutturato o il Testo ristrutturato dovrai usare rispettivamente le regole dei formati Testo strutturato o Testo ristrutturato per tutto il resto del documento.
Creare collegamenti con il formato Testo Ristrutturato (reST)
Con il Testo ristrutturato il precedente collegamento può essere creato così:
Questo è `Un indirizzo web`_ nel mio testo. .. _`Un indirizzo web`: http://www.qualcosa.com
per ottenere questo [1]:
Questo è Un indirizzo web nel mio testo.
Inizialmente sembra un po' sgraziato ma funziona ed è facile da riutilizzare.
| [1] | Siamo in un Documento scritto utilizzando il formato reST e quindi è possibile vedere come viene reso realmente questo collegamento scritto in quel formato. |