Destinazioni

Collegamenti

Nel caso di oggetti sul proprio file-system è possibile utilizzare per i Collegamenti il loro indirizzo relativo (relativo alla posizione dove si trova il collegamento).

I collegamenti relativi possono puntare esclusivamente ad oggetti interni al portale (o comunque raggiungibili tramite il browser nel proprio sistema locale). Differiscono dai collegamenti assoluti solo nella forma dell'indirizzo che viene (eventualmente) assegnato al riferimento. Nei collegamenti assoluti l'indirizzo è un indirizzo URL valido. Nei collegamenti relativi l'indirizzo è solo la parte finale dell'URL (la parte relativa appunto).

Collegamenti interni

• Collegamenti a elementi del documento reST interni: quelli che hanno come destinazione I titoli (o altre Destinazioni ipertestuali implicite dell'albero dei riferimenti interno del documento reST).

  Tali destinazioni esistenti nel proprio sistema sono automaticamente riconosciute e possono essere collegate come negli esempi che seguono.

  Per ottenere questo	Scrivi questo
  Alcuni collegamenti in questo documento: all'elemento indice di questa pagina	Alcuni collegamenti in questo documento: all'elemento indice_ di questa pagina
  ai titoli delle sezioni di questa pagina: Immagini?¿, Collegamenti esterni	ai titoli delle sezioni di questa pagina: Immagini_, `Collegamenti esterni`_

• Collegamenti ad altri documenti o ad altri tipi di oggetto contenuti nel portale.

  Per ottenere questo	Scrivi questo
  Alcuni collegamenti ad altri documenti: alla pagina indice Avvio rapido	Alcuni collegamenti ad altri documenti: alla pagina indice `Avvio rapido`_
  ad altre pagine di aiuto: Navigare, Partecipare, Collaborare Usare le tabelle Elenchi di definizioni	ad altre pagine di aiuto: - Navigare_, Partecipare_, Collaborare_ - `Usare le tabelle`_ - `Elenchi di definizioni`_
  o ad un oggetto file in una sottodirectory	o ad un oggetto `file`_ in una sottodirectory .. _file: .img/prova.txt

Collegamenti esterni

• Tutti gli altri Collegamenti (esterni)

  Mentre nei casi precedenti la destinazione è immediatamente riconosciuta dal sistema per gli altri collegamenti è necessario fornire al reST le informazioni relative alle destinazioni.

  Oltre a marcare le parole da collegare (che avviene nello stesso modo dei collegamenti interni) si deve quindi fornire un indirizzo di destinazione valido.

  NB: Un indirizzo URL valido messo nel testo viene regolarmente e semplicemente riconosciuto sul posto: http://docit.bice.dyndns.org/ReST/

  Per ottenere questo	Scrivi questo
  Questo è un collegamento alla mia pagina personale. Visitatela.	Questo è un collegamento alla `mia pagina`_ personale. Visitatela. .. _`mia pagina`: http://www.plone.org
  Ora due collegamenti: uno ancora alla mia pagina personale ed uno a Google. (notare che non è necessario ripetere il primo collegamento che funziona in quanto riutilizziamo quello dell'esempio precedente)	Ora due collegamenti: uno ancora alla `mia pagina`_ personale ed uno a Google_. (notare che non è necessario ripetere il primo collegamento che funziona in quanto *riutilizziamo* quello dell'esempio precedente) .. _Google: http://www.google.it
  o ad un oggetto file remoto	o ad un oggetto `file remoto`_ .. _file: http://www.gnu.org/copyleft/gpl.txt

Vedi anche il breviario e le specifiche tecniche dei Collegamenti ipertestuali.

Visualizzare Immagini

Le immagini possono essere collegate come oggetti esterni (in modo che chiamandole saranno visualizzate in pagine autonome) piuttosto che essere visualizzate nella pagina corrente.

Nel primo caso si tratta di un normale collegamento e segue le regole esposte in precedenza. Nel secondo caso si tratta di usare la direttiva .. immagine:: e collegare l'indirizzo dell'immagine.

Per ottenere questo	Scrivi questo
Una immagine (scalata) con indirizzo relativo:	Una immagine (scalata) con indirizzo relativo: .. immagine:: logo.jpg :width: 300
Una immagine con indirizzo assoluto:	Una immagine con indirizzo assoluto: .. immagine:: http://plone.org/logo.jpg

Vedi anche il breviario e le specifiche tecniche della direttiva Immagine ipertestuali`.

Istruzioni dettagliate per creare un collegamento esterno

Per convertire un pezzo di testo che si è inserito in un Collegamento (Hyperlink) seguire queste istruzioni:

• Delimitare il testo tra apici inversi in questo modo `la mia pagina`.

• Aggiungere un carattere di sottolineato ("_") subito dopo l'apice inverso di destra senza frapporre spazi ed il nostro riferimento nel testo avrà questo aspetto:

  `la mia pagina`_
  

• In fondo al testo (o comunque dove ti è più comodo all'interno del documento), dopo una riga vuota, inserisci due punti seguiti da uno spazio e da un sottolineato, come questi: .. _.

• Immediatamente dopo questo carattere di sottolineatura inseriamo esattamente lo stesso testo che stiamo trasformando in collegamento seguito da un duepunti, in questo modo .. _la mia pagina:.

  NB: Anche questo testo può essere delimitato da apici inversi: .. _`la mia pagina`:.

• Lasciare uno spazio dopo il duepunti ed inserire l'URL della destinazione. Otteniamo una cosa del tipo:

  .. _la mia pagina: http://qualchecosa.la.fuori
  

  A questo punto posso invitare a visitare la mia pagina, semplice no?.