XWiki - XWiki Syntax Guide

Page / - ultima modifica di Fabio Scubla il 2022/08/01 16:14

XWiki Syntax Guide

ultima modifica di Fabio Scubla

il 2022/08/01 16:14

Indice

XWiki Syntax 2.1: Collegamenti - Links

XWiki Syntax 2.1 » Modifica » Collegamenti - Links

XWiki Syntax 2.1: Collegamenti - Links

Generale

Preliminare

Considerazioni Generali

Altre sintassi

Modifica

Paragrafi

Titoli

Formattazione Testo

Riga Orizzontale

Elenchi

Elenchi di Definizione

Nuova riga/Interruzioni di riga

Collegamenti - Links

Tabelle

Immagini

Avanzato

Verbatim

Citazioni

Gruppi

Escapes

Parameters

Programmazione

Macro

HTML

Scripts

2.1 Links

Caratteristica	Sintassi XWiki 2.1	Risultato
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 testo	Questo è un URL: http://xwiki.org	Questo è 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]]
Link ad un'immagine con parametri	[[[[image:Space2.Page2@img.png||width="26" height="26"]]>>Space1.Page1]]
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"