XWiki Syntax Guide

XWiki Syntax 2.1 » Modifica » Collegamenti - Links

CaratteristicaSintassi XWiki 2.1Risultato
Link ad una pagina nello Spazio corrente[[WebHome]]XWiki
Link con etichetta

[[etichetta>>WebHome]]
La sintassi XWiki è supportata anche all'interno delle etichette

etichetta
Link con sintassi XWiki nell'etichetta[[**etichetta in grassetto**>>WebHome]]etichetta in grassetto
Link ad una pagina di uno spazio specificato[[Main.WebHome]]Main
Link ad un subwiki[[subwiki:Main.WebHome]]Main
Link che si apre in una nuova pagina[[etichetta>>WebHome||rel="__blank"]]etichetta
Link ad un URL direttamente nel testoQuesto è un URL: http://xwiki.orgQuesto è un URL: http://xwiki.org
Link ad un URL[[http://xwiki.org]]http://xwiki.org
Link ad un URL con etichetta[[XWiki>>http://xwiki.org]]XWiki
Link ad un indirizzo email[[john@smith.net>>mailto:john@smith.net]]john@smith.net
Link ad un'immagine[[image:Space2.Page2@img.png>>Space1.Page1]]img.png
Link ad un'immagine con parametri[[[[image:Space2.Page2@img.png||width="26" height="26"]]>>Space1.Page1]]img.png
Link ad un allegato nella pagina corrente[[text>>attach:img.png]]text
Link ad un allegato in una pagina diversa[[text>>attach:Space.Page@img.png]]text
Link ad una Ancora in una pagina[[label>>Space.Page||anchor=anchor]]label
Link ad un Titolo in una pagina[[label>>Space.Page||anchor=HMyheading]]label

Quando s'inserisce un Titolo, si crea un'ancora di nome "H" seguita dal testo dell'intestazione di sole lettere. Per esempio, per Titolo "My heading", l'ancora generata sarà "HMyheading".

Specifiche dei link con la Sintassi XWiki 2.1

Le parti tra ( ) sono richieste, le parti tra [ ] sono opzionali.

Il formato completo di un link è [etichetta>>] (risorsa) [||parametri]

  • etichetta: Stringa opzionale che sarà mostrata all'utente dopo il render del link. L'etichetta può contenere della sintassi XWiki. Se non viene specificata un'etichetta sarà generata un'etichetta predefinita. Il modello di generazione può essere cambiato, vedere la Admin Guide. Esempio: My Page
  • risorsa: Stringa richiesta con il riferimento al link in una delle forma seguenti
    • URL: qualsiasi URL nella forma [url:] (protocollo://percorso). Esempi: http://xwiki.org, url:https://svn.xwiki.org/
      • url: Stringa opzionale che identifica la risorsa come un URL.
    • Wiki page name Nome pagina WIki, riferimento nella forma [doc:] [[wikiName:] spazio.] (pagina). Esempi: WebHome, Main.WebHome, mywiki:Main.WebHome
      • doc: Stringa opzionale che identifica la risorsa come documento XWiki.
      • wikiName: Stringa opzionale contenente il nome di un subwiki (animal) di una 'farm' di wiki. Il link punterà ad una pagina all'interno di quel subwiki. Esempio: miowiki
      • spazio: Nome opzionale di uno Spazio del wiki. Se non si specifica uno spazio verrà usato lo spazio corrente. Esempio: Main
      • pagina: Stringa richiesta con il nome della pagina wiki cui punta il link. Esempio: WebHome
    • InterWiki page name Nome pagina Interwiki, riferimento nella forma interwiki: (interWikiAlias:) (page). Esempio: interwiki:wikipedia:XWiki
      • interwiki: Stringa richiesta che identifica la risorsa come un link InterWiki.
      • interWikiAlias: Alias opzionale dell'Inter Wiki come definito dall'InterWiki Map (vedere la Admin Guide). Esempio: wikipedia
      • pagina: Stringa richiesta con il nome della pagina wiki cui punta il link. Esempio:: XWiki
    • Allegato Allegato, riferimento nella forma attach: [wikiPageName@] (attachmentName). Esempi: attach:img.png, attach:mywiki:Main.WebHome@img.png
      • attach:: Stringa richiesta che identifica la risorsa come un allegato.
      • wikiPageName: Stringa opzionale che indica il riferimento al documento che contiene l'allegato, vedere "Wiki page name" precedente.
      • attachmentName: Nome dell'alllegato come memorizzato nel wiki.
    • Email address Indirizzo email, nella forma mailto: (emailAddress) (#anchor non è valido). Esempio: mailto:john@smith.com
      • mailto:: Stringa richiesta che indentifica la risorsa come email.
      • emailAddress: Indirizzo email del destinatario. Esempio: john@smith.com
    • Relative path Percorso relativo, riferimento sul server nella forma path: (relPath). Esempio: path:$doc.getURL('reset') produce l'indirizzo di destinazione http://server.domain.com/xwiki/bin/reset/Space/Page dove /xwiki/bin/reset/Space/Page è prodotto da $doc.getURL('reset').
      • path: Stringa richiesta che identifica la risorsa come percorso relativo.
      • relPath: Stringa richiesta contenente il percorso relativo della risorsa sul server cui punta il link.
    • UNC (Windows Explorer) riferimento nella forma unc: (path). Il link è reso come un link ad un file:// . Esempi: unc:C:\Windows\, unc:\\myserver\path\img.png, unc:home/user/somefile
      • unc: Stringa richiesta che identifica la risorsa come un percorso UNC (Windows Explorer).
      • path: Stringa richiesta contenente il percorso locale della risorsa acessibile dall'utente. Esempi: C:\Windows\, \\myserver\path\img.png, home/user/somefile
  • parametri: Lista opzionale separata da spazi di parametri passati al link. Esempio: queryString="mydata1=5&mydata2=Hello" anchor="HTableOfContents" rel="__blank"
    • Stringaquery: Stringa opzionale di query per specifici parametri che saranno appesi all'indirizzo del link e usati nel rendering dell'URL. Eaempio: url:http://domain.com/path||queryString="mydata1=5&mydata2=Hello" produce l'indirizzo di destinazione http://domain.com/path?mydata1=5&mydata2=Hello
    • ancora: Nome opzionale di un ancora che punta ad un ancora definita nel link cui si riferisce. Notare che in XWiki le ancore per i titoli sono create automaticamente. Esempio: url:http://domain.com/path||anchor="HTableOfContents" produce l'indirizzo di destinazione http://domain.com/path#HTableOfContents
    • rel: Parametro opzionale che consente di aprire il link in una nuova finestra. Esempio: rel="__blank"