Loading…
 None
String updated in the repository |
|
|
None
Source string changed |
= Editing =
== Images == === 1.0 Images === |=Feature|=XWiki Syntax 1.0|=Result |Image from attachment on current page|((( {{info}}See [[Image Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Image%20Macro%20%28Radeox%29]] for details{{/info}} {{{{image:img.png}}}} )))|image:XWiki.XWikiSyntaxImages@img.png |Image from attachment on another page|{{{{image:img.png|document=Space.Page}}}}|image:XWiki.XWikiSyntaxImages@img.png |Image with parameters|{{{{image:img.png|width=25|height=25}}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]] |Images located at URL|{{{https://some/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png === 2.0 Images === |=Feature|=XWiki Syntax 2.0|=Result |Image from attachment on current page|{{{image:img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Image from attachment on another page|{{{image:Space.Page@img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Image with parameters|{{{[[image:img.png||width="25" height="25"]]}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]] |Image with caption|{{{[[~[~[XWiki~>~>https://www.xwiki.org~]~] supports captions.>>image:img.png]]}}}|((([[~[~[XWiki~>~>https://www.xwiki.org~]~] supports captions.>>image:XWiki.XWikiSyntaxImages@img.png]]))) |Images located at URL|{{{image:https://some/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png {{velocity}}$subHeading XWiki Syntax 2.0 Image Specification $subHeading{{/velocity}} {{info}} The part in ##( )## is required, while the parts in ##{ }## are optional. {{/info}} The full format of an image is either **##image~: (reference)##** or **##~[~[{caption>>}image~: (reference) {||parameters}]]##** * **##caption##**: An optional caption. May contain arbitrary XWiki 2.0 syntax but nested link syntax must be escaped using ##~~##. The caption is only supported when the image syntax is the only content of a paragraph. The captioned image may also be wrapped in a link. In this case, the link will contain the image but not the caption. * **##image~:##** A required string identifying the resource as image. * **##reference##**: The reference to the image that shall be displayed in one of the following forms: ** **URL**: Any URL to an image in the form of **##http:~/~/path/imageName##**. Example: ##http:~/~/domain.org/path/img.png## ** **Attachment** reference in the form **##~{~{~{wikiName:} space.} page@} (imageName)##** *** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. Example: mywiki *** **##space##**: An optional wiki Space name. If no space is specified the current space is used. Example: Main *** **##page##**: An optional string containing the name of the wiki page to which the referenced image is attached. Example: WebHome *** **##imageName##**: A required string containing the name of the image attached to a page as it is stored in the wiki. * **##parameters##**: An optional list of space-separated parameters passed to the image. Example: ##width="800" height="600" alt="img.png" title="My nice image"## ** **HTML attributes**: All attributes defined by the HTML standard will be added to the rendered HTML ##<img>## tag. *** **##style##**: CSS style information that should be applied to the image. Examples: ##style="float:right;height:50"## (image on right side, height 50 px), ##style="display:block;margin-left:auto;margin-right:auto;width:80%"## (image centered, width 80% of block width), ##style="vertical-align:bottom"## (text starts at bottom of picture) *** **##height##**: A parameter that defines the height of the displayed image. The value should be presented either in pixel (example: ##height="80"##) or in pixel related to the height of the block containing the image (example: ##height="40%"##). *** **##width##**: A parameter that defines the width of the displayed image. The value should be presented either in pixel (example: ##width="80"##) or in pixel related to the width of the block containing the image (example: ##width="40%"##). *** **##title##**: A parameter that defines the title the displayed image which will be visible when hovering the mouse trigger over the image, for instance. Example: ##title="My nice image"## *** **##alt##**: A parameter that defines which text should be displayed if the browser is not able to display the image. Since this is a required HTML attribute XWiki will use the file name instead if the ##alt## parameter is not defined. Example: ##alt="img.png"## *** **More**: A more in depth explanation on the HTML ##<img>## tag including more attributes can be reviewed [[in the HTML standard>>https://html.spec.whatwg.org/multipage/embedded-content.html#the-img-element]]. === 2.1 Images === |=Feature|=XWiki Syntax 2.1|=Result |Image from attachment on current page|{{{image:img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Image from attachment on another page|{{{image:PageA.PageB@img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Image with parameters|{{{[[image:img.png||width="25" height="25"]]}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]] |Image with caption|{{{[[~[~[XWiki~>~>https://www.xwiki.org~]~] supports captions.>>image:img.png]]}}}|((([[~[~[XWiki~>~>https://www.xwiki.org~]~] supports captions.>>image:XWiki.XWikiSyntaxImages@img.png]]))) |Images located at URL|{{{image:https://some/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Prepackaged Icons|{{{image:icon:accept}}}|image:icon:accept {{velocity}}$subHeading XWiki Syntax 2.1 Image Specification $subHeading{{/velocity}} {{info}} Legend: The parts are ##()## are required, while the parts in ##{}## are optional. {{/info}} The full format of an image is either **##image~: (reference)##** or **##~[~[{caption>>}image~: (reference) {||parameters}]]##** * **##caption##**: An optional caption. May contain arbitrary XWiki 2.1 syntax but nested link syntax must be escaped using ##~~##. The caption is only supported when the image syntax is the only content of a paragraph. The captioned image may also be wrapped in a link. In this case, the link will contain the image but not the caption. * **##image~:##** A required string identifying the resource as image. * **##reference##**: The reference to the image that shall be displayed in one of the following forms: ** **URL**: Any URL to an image in the form of **##[url:](protocol:~/~/path/imageName)##**. Example: ##http:~/~/domain.org/path/img.png## *** **##url:##** An optional string identifying the image as an URL. *** **##protocol:~/~/path/imageName##**: The URL to the image ** **Attachment**: A reference in the form **##[attach~:]~{~{~{(wikiName):}(spaceNameList).}(pageName)@}(imageName)##** *** **##attach~:##** An optional string identifying the reference as an XWiki Document attachment. *** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## *** **##pageName##**: An optional string containing the name of the wiki page to which the referenced image is attached. Example: ##Welcome## *** **##imageName##**: A required string containing the name of the image attached to a page as it is stored in the wiki. Example: ##myImage.png## ** **Page Attachment**: A reference in the form **##pageAttach~:~{~{~{(wikiName):}(pageNameList)/}(imageName)##** *** **##pageAttach~:##** An required string identifying the reference as an XWiki Page attachment. *** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##pageNameList##**: An optional dot-separated list of wiki page names. If no page is specified the current page is used. Examples: ##Main##, ##A/B##, ##A/B/C## *** **##imageName##**: A required string containing the name of the image attached to a page as it is stored in the wiki. Example: ##myImage.png## ** **Icon**: A reference in the form **##icon{{{:(}}}iconName)##**. Example: **##icon:accept##** *** **##icon:##** A required string identifying the image reference as an icon from the [[XWiki Icon Set>>https://www.famfamfam.com/lab/icons/silk/previews/index_abc.png]]. *** **##iconName##**: A required string identifying the icon referenced. Example: ##accept## *** **##icon:##** A required string identifying the image reference as an icon from the [[XWiki Icon Set>>https://www.famfamfam.com/lab/icons/silk/previews/index_abc.png]]. *** **##iconName##**: A required string identifying the icon referenced. Example: ##accept## *** **##data:##** A required string identifying the image as being specified inline using the [[Data URI scheme>>https://en.wikipedia.org/wiki/Data_URI_scheme]]. *** **##content##**: The encoded image. Example: ##{{{image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==}}}## * **##parameters##**: An optional list of space-separated parameters passed to the image. Example: ##width="800" height="600" alt="img.png" title="My nice image"## ** **HTML attributes**: All attributes defined by the HTML standard will be added to the rendered HTML ##<img>## tag. *** **##style##**: CSS style information that should be applied to the image. Examples: ##style="float:right;height:50"## (image on right side, height 50 px), ##style="display:block;margin-left:auto;margin-right:auto;width:80%"## (image centered, width 80% of block width), ##style="vertical-align:bottom"## (text starts at bottom of picture) *** **##height##**: A parameter that defines the height of the displayed image. The value should be presented either in pixel (example: ##height="80"##) or in pixel related to the height of the block containing the image (example: ##height="40%"##). *** **##width##**: A parameter that defines the width of the displayed image. The value should be presented either in pixel (example: ##width="80"##) or in pixel related to the width of the block containing the image (example: ##width="40%"##). *** **##title##**: A parameter that defines the title the displayed image which will be visible when hovering the mouse trigger over the image, for instance. Example: ##title="My nice image"## *** **##alt##**: A parameter that defines which text should be displayed if the browser is not able to display the image. Since this is a required HTML attribute XWiki will use the file name instead if the ##alt## parameter is not defined. Example: ##alt="img.png"## *** **More**: A more in depth explanation on the HTML ##<img>## tag including more attributes can be reviewed [[in the HTML standard>>https://html.spec.whatwg.org/multipage/embedded-content.html#the-img-element]]. ** **##queryString##**: Allows queries to be passed to the server when creating the download link for the referenced image. Example: ##queryString="width=100&height=800&keepAspectRatio=true"## (**##keepAspectRatio=true## will fail if the ##width## and ##height## parameters are specified in addition to ##queryString##!**) |
|
None
String updated in the repository |
= Editing =
== Images == === 1.0 Images === |=Feature|=XWiki Syntax 1.0|=Result |Image from attachment on current page|((( {{info}}See [[Image Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Image%20Macro%20%28Radeox%29]] for details{{/info}} {{{{image:img.png}}}} )))|image:XWiki.XWikiSyntaxImages@img.png |Image from attachment on another page|{{{{image:img.png|document=Space.Page}}}}|image:XWiki.XWikiSyntaxImages@img.png |Image with parameters|{{{{image:img.png|width=25|height=25}}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]] |Images located at URL|{{{https://some/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png === 2.0 Images === |=Feature|=XWiki Syntax 2.0|=Result |Image from attachment on current page|{{{image:img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Image from attachment on another page|{{{image:Space.Page@img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Image with parameters|{{{[[image:img.png||width="25" height="25"]]}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]] |Image with caption|{{{[[~[~[XWiki~>~>https://www.xwiki.org~]~] supports captions.>>image:img.png]]}}}|((([[~[~[XWiki~>~>https://www.xwiki.org~]~] supports captions.>>image:XWiki.XWikiSyntaxImages@img.png]]))) |Images located at URL|{{{image:https://some/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png {{velocity}}$subHeading XWiki Syntax 2.0 Image Specification $subHeading{{/velocity}} {{info}} The part in ##( )## is required, while the parts in ##{ }## are optional. {{/info}} The full format of an image is either **##image~: (reference)##** or **##~[~[{caption>>}image~: (reference) {||parameters}]]##** * **##caption##**: An optional caption. May contain arbitrary XWiki 2.0 syntax but nested link syntax must be escaped using ##~~##. The caption is only supported when the image syntax is the only content of a paragraph. The captioned image may also be wrapped in a link. In this case, the link will contain the image but not the caption. * **##image~:##** A required string identifying the resource as image. * **##reference##**: The reference to the image that shall be displayed in one of the following forms: ** **URL**: Any URL to an image in the form of **##http:~/~/path/imageName##**. Example: ##http:~/~/domain.org/path/img.png## ** **Attachment** reference in the form **##~{~{~{wikiName:} space.} page@} (imageName)##** *** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. Example: mywiki *** **##space##**: An optional wiki Space name. If no space is specified the current space is used. Example: Main *** **##page##**: An optional string containing the name of the wiki page to which the referenced image is attached. Example: WebHome *** **##imageName##**: A required string containing the name of the image attached to a page as it is stored in the wiki. * **##parameters##**: An optional list of space-separated parameters passed to the image. Example: ##width="800" height="600" alt="img.png" title="My nice image"## ** **HTML attributes**: All attributes defined by the HTML standard will be added to the rendered HTML ##<img>## tag. *** **##style##**: CSS style information that should be applied to the image. Examples: ##style="float:right;height:50"## (image on right side, height 50 px), ##style="display:block;margin-left:auto;margin-right:auto;width:80%"## (image centered, width 80% of block width), ##style="vertical-align:bottom"## (text starts at bottom of picture) *** **##height##**: A parameter that defines the height of the displayed image. The value should be presented either in pixel (example: ##height="80"##) or in pixel related to the height of the block containing the image (example: ##height="40%"##). *** **##width##**: A parameter that defines the width of the displayed image. The value should be presented either in pixel (example: ##width="80"##) or in pixel related to the width of the block containing the image (example: ##width="40%"##). *** **##title##**: A parameter that defines the title the displayed image which will be visible when hovering the mouse trigger over the image, for instance. Example: ##title="My nice image"## *** **##alt##**: A parameter that defines which text should be displayed if the browser is not able to display the image. Since this is a required HTML attribute XWiki will use the file name instead if the ##alt## parameter is not defined. Example: ##alt="img.png"## *** **More**: A more in depth explanation on the HTML ##<img>## tag including more attributes can be reviewed [[in the HTML standard>>https://html.spec.whatwg.org/multipage/embedded-content.html#the-img-element]]. === 2.1 Images === |=Feature|=XWiki Syntax 2.1|=Result |Image from attachment on current page|{{{image:img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Image from attachment on another page|{{{image:PageA.PageB@img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Image with parameters|{{{[[image:img.png||width="25" height="25"]]}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]] |Image with caption|{{{[[~[~[XWiki~>~>https://www.xwiki.org~]~] supports captions.>>image:img.png]]}}}|((([[~[~[XWiki~>~>https://www.xwiki.org~]~] supports captions.>>image:XWiki.XWikiSyntaxImages@img.png]]))) |Images located at URL|{{{image:https://some/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Prepackaged Icons|{{{image:icon:accept}}}|image:icon:accept {{velocity}}$subHeading XWiki Syntax 2.1 Image Specification $subHeading{{/velocity}} {{info}} Legend: The parts are ##()## are required, while the parts in ##{}## are optional. {{/info}} The full format of an image is either **##image~: (reference)##** or **##~[~[{caption>>}image~: (reference) {||parameters}]]##** * **##caption##**: An optional caption. May contain arbitrary XWiki 2.1 syntax but nested link syntax must be escaped using ##~~##. The caption is only supported when the image syntax is the only content of a paragraph. The captioned image may also be wrapped in a link. In this case, the link will contain the image but not the caption. * **##image~:##** A required string identifying the resource as image. * **##reference##**: The reference to the image that shall be displayed in one of the following forms: ** **URL**: Any URL to an image in the form of **##[url:](protocol:~/~/path/imageName)##**. Example: ##http:~/~/domain.org/path/img.png## *** **##url:##** An optional string identifying the image as an URL. *** **##protocol:~/~/path/imageName##**: The URL to the image ** **Attachment**: A reference in the form **##[attach~:]~{~{~{(wikiName):}(spaceNameList).}(pageName)@}(imageName)##** *** **##attach~:##** An optional string identifying the reference as an XWiki Document attachment. *** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## *** **##pageName##**: An optional string containing the name of the wiki page to which the referenced image is attached. Example: ##Welcome## *** **##imageName##**: A required string containing the name of the image attached to a page as it is stored in the wiki. Example: ##myImage.png## ** **Page Attachment**: A reference in the form **##pageAttach~:~{~{~{(wikiName):}(pageNameList)/}(imageName)##** *** **##pageAttach~:##** An required string identifying the reference as an XWiki Page attachment. *** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##pageNameList##**: An optional dot-separated list of wiki page names. If no page is specified the current page is used. Examples: ##Main##, ##A/B##, ##A/B/C## *** **##imageName##**: A required string containing the name of the image attached to a page as it is stored in the wiki. Example: ##myImage.png## ** **Icon**: A reference in the form **##icon{{{:(}}}iconName)##**. Example: **##icon:accept##** *** **##icon:##** A required string identifying the image reference as an icon from the [[XWiki Icon Set>>https://www.famfamfam.com/lab/icons/silk/previews/index_abc.png]]. *** **##iconName##**: A required string identifying the icon referenced. Example: ##accept## ** **Icon**: A reference in the form **##icon{{{:(}}}iconName)##**. Example: **##icon:accept##** *** **##icon:##** A required string identifying the image reference as an icon from the [[XWiki Icon Set>>https://www.famfamfam.com/lab/icons/silk/previews/index_abc.png]]. *** **##iconName##**: A required string identifying the icon referenced. Example: ##accept## ** **Data URI**: A reference in the form **##(data{{{:)}}}(content)##**. Example: **##{{{data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==}}}##** *** **##data:##** A required string identifying the image as being specified inline using the [[Data URI scheme>>https://en.wikipedia.org/wiki/Data_URI_scheme]]. *** **##content##**: The encoded image. Example: ##{{{image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==}}}## * **##parameters##**: An optional list of space-separated parameters passed to the image. Example: ##width="800" height="600" alt="img.png" title="My nice image"## ** **HTML attributes**: All attributes defined by the HTML standard will be added to the rendered HTML ##<img>## tag. *** **##style##**: CSS style information that should be applied to the image. Examples: ##style="float:right;height:50"## (image on right side, height 50 px), ##style="display:block;margin-left:auto;margin-right:auto;width:80%"## (image centered, width 80% of block width), ##style="vertical-align:bottom"## (text starts at bottom of picture) *** **##height##**: A parameter that defines the height of the displayed image. The value should be presented either in pixel (example: ##height="80"##) or in pixel related to the height of the block containing the image (example: ##height="40%"##). *** **##width##**: A parameter that defines the width of the displayed image. The value should be presented either in pixel (example: ##width="80"##) or in pixel related to the width of the block containing the image (example: ##width="40%"##). *** **##title##**: A parameter that defines the title the displayed image which will be visible when hovering the mouse trigger over the image, for instance. Example: ##title="My nice image"## *** **##alt##**: A parameter that defines which text should be displayed if the browser is not able to display the image. Since this is a required HTML attribute XWiki will use the file name instead if the ##alt## parameter is not defined. Example: ##alt="img.png"## *** **More**: A more in depth explanation on the HTML ##<img>## tag including more attributes can be reviewed [[in the HTML standard>>https://html.spec.whatwg.org/multipage/embedded-content.html#the-img-element]]. ** **##queryString##**: Allows queries to be passed to the server when creating the download link for the referenced image. Example: ##queryString="width=100&height=800&keepAspectRatio=true"## (**##keepAspectRatio=true## will fail if the ##width## and ##height## parameters are specified in addition to ##queryString##!**)
= Editing =
== Immagini == {{comment}}please do not translate the sub headlines{{/comment}} === 1.0 Images === |=Caratteristica|=Sintassi XWiki 1.0|=Risultato |Immagine da un allegato nella pagina corrente|((( {{info}}Vedere [[Image Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Image%20Macro%20%28Radeox%29]] per dettagli{{/info}} {{{{image:img.png}}}} )))|image:XWiki.XWikiSyntaxImages@img.png |Immagine da un allegato di un altro documento|{{{{image:img.png|document=Space.Page}}}}|image:XWiki.XWikiSyntaxImages@img.png |Immagine con parametri|{{{{image:img.png|width=25|height=25}}}}|[[image:XWiki.XWikiSyntaxImages@img.png||height="25" width="25"]] |Immagini raggiungibili con un URL|{{{http://some/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png === 2.0 Images === |=Caratteristica|=Sintassi XWiki 2.0|=Risultato |Immagine da un allegato nella pagina corrente|{{{image:img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Immagine da un allegato di un altro documento|{{{image:Space.Page@img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Immagine con parametri|{{{[[image:img.png||width="25" height="25"]]}}}|[[image:XWiki.XWikiSyntaxImages@img.png||height="25" width="25"]] |Immagini raggiungibili con un URL|{{{image:http://some/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png {{velocity}}$subHeading Specifiche per le Immagini in Sintassi XWiki 2.0 $subHeading{{/velocity}} {{info}} La parte tra ##( )## è richiesta, mentre le parti tra ##{ }## sono opzionali. {{/info}} Il formato completo di un'immagine è **##image~: (riferimento)##** oppure **##~[~[image~: (riferimento) {||parametri}]]##** * **##image~:##** Stringa richiesta che identifica la risora come immagine. * **##riferimento##**: Il riferimento all'immagine che sarà mostrata in una delle forme seguenti: ** **URL**: Un qualunque URL ad un'immagine nel formato **##http:~/~/percorso/Nomeimmagine##**. Esempio: ##http:~/~/domain.org/path/img.png## ** **Allegato** riferimento nel formato **##~{~{~{Nomewiki:} spazio.} pagina@} (Nomeimmagine)##** *** **##NomeWiki##**: Stringa opzionale che contiene 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 viene usato lo spazio corrente. Esempio: Main *** **##pagina##**: Stringa opzionale che contiene il nome di una pagina del wiki a cui l'immagine fa riferimento come allegato. Esempio: WebHome *** **##Nomeimmagine##**: Stringa richiesta con il nome dell'immagine allegata alla pagina così come è memorizzato nel wiki. * **##parametri##**: Elenco opzionale di parametri separati da uno spazio passati all'immagine. Esempio: ##width="800" height="600" alt="img.png" title="My nice image"## ** **Attributi HTML**: Tutti gli attributi definiti dallo standard HTML saranno aggiunti al codice HTML renderizzato ##<img>## tag. *** **##style##**: Informazioni sullo stile CSS che si deve applicare all'immagine. Esempio: ##style="float:right;height:50"## (immagina a destra, altezza 50 pixel), ##style="display:block;margin-left:auto;margin-right:auto;width:80%"## (immagine centrata, larghezza 80% del blocco), ##style="vertical-align:bottom"## (il testo inzia in basso all'immagine) *** **##height##**: Parametro che definisce l'altezza visualizzata dell'immagine. Il valore dovrebbe essere in pixel (esempio: ##height="80"##) o in pixel relativi all'altezza del blocco contenente l'immagine (esempio: ##height="40%"##). *** **##width##**: Parametro che definisce la larghezza visualizzata dell'immagine. Il valore dovrebbe essere in pixel (esempio: ##width="80"##) o in pixel relativi alla larghezza del blocco contenente l'immagine (esempio: ##width="40%"##). *** **##title##**: Parametro che definisce il titolo visualizzato dell'immagine che sarà visibile quando ci si passa sopra con il mouse, per esempio. Esempio: ##title="La mia bella immagine"## *** **##alt##**: Parametro che definisce quale testo deve essere mostrato se il browser non è in grado di visualizzare l'immagine. Dal momento che questo è un attributo HTML richiesto XWiki userà il nome del file se il parametro ##alt## non è definito. Esempio: ##alt="img.png"## *** **Altro**: Una spiegazione più approfondita sul tag HTML ##<img>## tag che comprende altri attributi si può trovare su [[on w3.org>>http://www.w3.org/TR/html4/struct/objects.html#h-13.2]]. === 2.1 Images === |=Caratteristica|=Sintassi XWiki 2.1|=Risultato |Immagine da un allegato nella pagina corrente|{{{image:img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Immagine da un allegato di un altro documento|{{{image:Space.Page@img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Immagine con parametri|{{{[[image:img.png||width="25" height="25"]]}}}|[[image:XWiki.XWikiSyntaxImages@img.png||height="25" width="25"]] |Immagini raggiungibili con un URL|{{{image:http://some/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Icona|{{{image:icon:accept}}}|image:icon:accept {{velocity}}$subHeading Specifiche per le Immagini in Sintassi XWiki 2.1 $subHeading{{/velocity}} Il formato completo di un'immagine è **##image~: (riferimento)##** oppure **##~[~[image~: (riferimento) {||parametri}]]##** * **##image~:##** Stringa richiesta che identifica la risora come immagine. * **##riferimento##**: Il riferimento all'immagine che sarà mostrata in una delle forme seguenti: ** **URL**: Un qualunque URL ad un'immagine nel formato **##protocollo:~/~/percorso/Nomeimmagine##**. Esempio: ##http:~/~/domain.org/path/img.png## ** **Allegato** riferimento nel formato **##~{~{~{Nomewiki:} spazio.} pagina@} (Nomeimmagine)##** *** **##NomeWiki##**: Stringa opzionale che contiene 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 viene usato lo spazio corrente. Esempio: Main *** **##pagina##**: Stringa opzionale che contiene il nome di una pagina del wiki a cui l'immagine fa riferimento come allegato. Esempio: WebHome *** **##Nomeimmagine##**: Stringa richiesta con il nome dell'immagine allegata alla pagina così come è memorizzato nel wiki. ** **Icona** riferimento nel formato **##{{{(icon:)}}} (iconName)##**. Esempio: **##icon:accept##** *** **##icon:##** Stringa richiesta che identifica il riferimento come un'icona da [[XWiki Icon Set>>http://www.famfamfam.com/lab/icons/silk/previews/index_abc.png]]. *** **##iconName##**: Stringa richiesta che identifica l'icona cui si fa riferimento. Esempio: ##accept## * **##parametri##**: Elenco opzionale di parametri separati da uno spazio passati all'immagine. Esempio: ##width="800" height="600" alt="img.png" title="My nice image"## ** **Attributi HTML**: Tutti gli attributi definiti dallo standard HTML saranno aggiunti al codice HTML renderizzato ##<img>## tag. *** **##style##**: Informazioni sullo stile CSS che si deve applicare all'immagine. Esempio: ##style="float:right;height:50"## (immagina a destra, altezza 50 pixel), ##style="display:block;margin-left:auto;margin-right:auto;width:80%"## (immagine centrata, larghezza 80% del blocco), ##style="vertical-align:bottom"## (il testo inzia in basso all'immagine) *** **##height##**: Parametro che definisce l'altezza visualizzata dell'immagine. Il valore dovrebbe essere in pixel (esempio: ##height="80"##) o in pixel relativi all'altezza del blocco contenente l'immagine (esempio: ##height="40%"##). *** **##width##**: Parametro che definisce la larghezza visualizzata dell'immagine. Il valore dovrebbe essere in pixel (esempio: ##width="80"##) o in pixel relativi alla larghezza del blocco contenente l'immagine (esempio: ##width="40%"##). *** **##title##**: Parametro che definisce il titolo visualizzato dell'immagine che sarà visibile quando ci si passa sopra con il mouse, per esempio. Esempio: ##title="La mia bella immagine"## *** **##alt##**: Parametro che definisce quale testo deve essere mostrato se il browser non è in grado di visualizzare l'immagine. Dal momento che questo è un attributo HTML richiesto XWiki userà il nome del file se il parametro ##alt## non è definito. Esempio: ##alt="img.png"## *** **Altro**: Una spiegazione più approfondita sul tag HTML ##<img>## tag che comprende altri attributi si può trovare su [[on w3.org>>http://www.w3.org/TR/html4/struct/objects.html#h-13.2]]. ** **##queryStringa##**: Consente di inviare richieste al server quando si crea il link per il download dell'immagine referenziata. Esempio: ##queryString="width=100&height=800&keepAspectRatio=true"## (**##keepAspectRatio=true## non avrà successo se i parametri ##width## e ##height## non vengono specificati oltre a ##queryString##!**) |
|
None
Source string changed |
= Editing =
== Images == === 1.0 Images === |=Feature|=XWiki Syntax 1.0|=Result |Image from attachment on current page|((( {{info}}See [[Image Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Image%20Macro%20%28Radeox%29]] for details{{/info}} {{{{image:img.png}}}} )))|image:XWiki.XWikiSyntaxImages@img.png |Image from attachment on another page|{{{{image:img.png|document=Space.Page}}}}|image:XWiki.XWikiSyntaxImages@img.png |Image with parameters|{{{{image:img.png|width=25|height=25}}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]] |Images located at URL|{{{https://some/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png === 2.0 Images === |=Feature|=XWiki Syntax 2.0|=Result |Image from attachment on current page|{{{image:img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Image from attachment on another page|{{{image:Space.Page@img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Image with parameters|{{{[[image:img.png||width="25" height="25"]]}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]] |Image with caption|{{{[[~[~[XWiki~>~>https://www.xwiki.org~]~] supports captions.>>image:img.png]]}}}|((([[~[~[XWiki~>~>https://www.xwiki.org~]~] supports captions.>>image:XWiki.XWikiSyntaxImages@img.png]]))) |Images located at URL|{{{image:https://some/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png {{velocity}}$subHeading XWiki Syntax 2.0 Image Specification $subHeading{{/velocity}} {{info}} The part in ##( )## is required, while the parts in ##{ }## are optional. {{/info}} The full format of an image is either **##image~: (reference)##** or **##~[~[{caption>>}image~: (reference) {||parameters}]]##** * **##caption##**: An optional caption. May contain arbitrary XWiki 2.0 syntax but nested link syntax must be escaped using ##~~##. The caption is only supported when the image syntax is the only content of a paragraph. The captioned image may also be wrapped in a link. In this case, the link will contain the image but not the caption. * **##image~:##** A required string identifying the resource as image. * **##reference##**: The reference to the image that shall be displayed in one of the following forms: ** **URL**: Any URL to an image in the form of **##http:~/~/path/imageName##**. Example: ##http:~/~/domain.org/path/img.png## ** **Attachment** reference in the form **##~{~{~{wikiName:} space.} page@} (imageName)##** *** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. Example: mywiki *** **##space##**: An optional wiki Space name. If no space is specified the current space is used. Example: Main *** **##page##**: An optional string containing the name of the wiki page to which the referenced image is attached. Example: WebHome *** **##imageName##**: A required string containing the name of the image attached to a page as it is stored in the wiki. * **##parameters##**: An optional list of space-separated parameters passed to the image. Example: ##width="800" height="600" alt="img.png" title="My nice image"## ** **HTML attributes**: All attributes defined by the HTML standard will be added to the rendered HTML ##<img>## tag. *** **##style##**: CSS style information that should be applied to the image. Examples: ##style="float:right;height:50"## (image on right side, height 50 px), ##style="display:block;margin-left:auto;margin-right:auto;width:80%"## (image centered, width 80% of block width), ##style="vertical-align:bottom"## (text starts at bottom of picture) *** **##height##**: A parameter that defines the height of the displayed image. The value should be presented either in pixel (example: ##height="80"##) or in pixel related to the height of the block containing the image (example: ##height="40%"##). *** **##width##**: A parameter that defines the width of the displayed image. The value should be presented either in pixel (example: ##width="80"##) or in pixel related to the width of the block containing the image (example: ##width="40%"##). *** **##title##**: A parameter that defines the title the displayed image which will be visible when hovering the mouse trigger over the image, for instance. Example: ##title="My nice image"## *** **##alt##**: A parameter that defines which text should be displayed if the browser is not able to display the image. Since this is a required HTML attribute XWiki will use the file name instead if the ##alt## parameter is not defined. Example: ##alt="img.png"## *** **More**: A more in depth explanation on the HTML ##<img>## tag including more attributes can be reviewed [[in the HTML standard>>https://html.spec.whatwg.org/multipage/embedded-content.html#the-img-element]]. === 2.1 Images === |=Feature|=XWiki Syntax 2.1|=Result |Image from attachment on current page|{{{image:img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Image from attachment on another page|{{{image:PageA.PageB@img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Image with parameters|{{{[[image:img.png||width="25" height="25"]]}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]] |Image with caption|{{{[[~[~[XWiki~>~>https://www.xwiki.org~]~] supports captions.>>image:img.png]]}}}|((([[~[~[XWiki~>~>https://www.xwiki.org~]~] supports captions.>>image:XWiki.XWikiSyntaxImages@img.png]]))) |Images located at URL|{{{image:https://some/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Prepackaged Icons|{{{image:icon:accept}}}|image:icon:accept {{velocity}}$subHeading XWiki Syntax 2.1 Image Specification $subHeading{{/velocity}} {{info}} Legend: The parts are ##()## are required, while the parts in ##{}## are optional. {{/info}} The full format of an image is either **##image~: (reference)##** or **##~[~[{caption>>}image~: (reference) {||parameters}]]##** * **##caption##**: An optional caption. May contain arbitrary XWiki 2.1 syntax but nested link syntax must be escaped using ##~~##. The caption is only supported when the image syntax is the only content of a paragraph. The captioned image may also be wrapped in a link. In this case, the link will contain the image but not the caption. * **##image~:##** A required string identifying the resource as image. * **##reference##**: The reference to the image that shall be displayed in one of the following forms: ** **URL**: Any URL to an image in the form of **##[url:](protocol:~/~/path/imageName)##**. Example: ##http:~/~/domain.org/path/img.png## *** **##url:##** An optional string identifying the image as an URL. *** **##protocol:~/~/path/imageName##**: The URL to the image ** **Attachment**: A reference in the form **##[attach~:]~{~{~{(wikiName):}(spaceNameList).}(pageName)@}(imageName)##** *** **##attach~:##** An optional string identifying the reference as an XWiki Document attachment. *** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## *** **##pageName##**: An optional string containing the name of the wiki page to which the referenced image is attached. Example: ##Welcome## *** **##imageName##**: A required string containing the name of the image attached to a page as it is stored in the wiki. Example: ##myImage.png## ** **Page Attachment**: A reference in the form **##pageAttach~:~{~{~{(wikiName):}(pageNameList)/}(imageName)##** *** **##pageAttach~:##** An required string identifying the reference as an XWiki Page attachment. *** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##pageNameList##**: An optional dot-separated list of wiki page names. If no page is specified the current page is used. Examples: ##Main##, ##A/B##, ##A/B/C## *** **##imageName##**: A required string containing the name of the image attached to a page as it is stored in the wiki. Example: ##myImage.png## ** **Icon**: A reference in the form **##icon{{{:(}}}iconName)##**. Example: **##icon:accept##** *** **##icon:##** A required string identifying the image reference as an icon from the [[XWiki Icon Set>>https://www.famfamfam.com/lab/icons/silk/previews/index_abc.png]]. *** **##iconName##**: A required string identifying the icon referenced. Example: ##accept## ** **Icon**: A reference in the form **##icon{{{:(}}}iconName)##**. Example: **##icon:accept##** *** **##icon:##** A required string identifying the image reference as an icon from the [[XWiki Icon Set>>https://www.famfamfam.com/lab/icons/silk/previews/index_abc.png]]. *** **##iconName##**: A required string identifying the icon referenced. Example: ##accept## ** **Data URI**: A reference in the form **##(data{{{:)}}}(content)##**. Example: **##{{{data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==}}}##** *** **##data:##** A required string identifying the image as being specified inline using the [[Data URI scheme>>https://en.wikipedia.org/wiki/Data_URI_scheme]]. *** **##content##**: The encoded image. Example: ##{{{image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==}}}## * **##parameters##**: An optional list of space-separated parameters passed to the image. Example: ##width="800" height="600" alt="img.png" title="My nice image"## ** **HTML attributes**: All attributes defined by the HTML standard will be added to the rendered HTML ##<img>## tag. *** **##style##**: CSS style information that should be applied to the image. Examples: ##style="float:right;height:50"## (image on right side, height 50 px), ##style="display:block;margin-left:auto;margin-right:auto;width:80%"## (image centered, width 80% of block width), ##style="vertical-align:bottom"## (text starts at bottom of picture) *** **##height##**: A parameter that defines the height of the displayed image. The value should be presented either in pixel (example: ##height="80"##) or in pixel related to the height of the block containing the image (example: ##height="40%"##). *** **##width##**: A parameter that defines the width of the displayed image. The value should be presented either in pixel (example: ##width="80"##) or in pixel related to the width of the block containing the image (example: ##width="40%"##). *** **##title##**: A parameter that defines the title the displayed image which will be visible when hovering the mouse trigger over the image, for instance. Example: ##title="My nice image"## *** **##alt##**: A parameter that defines which text should be displayed if the browser is not able to display the image. Since this is a required HTML attribute XWiki will use the file name instead if the ##alt## parameter is not defined. Example: ##alt="img.png"## *** **More**: A more in depth explanation on the HTML ##<img>## tag including more attributes can be reviewed [[in the HTML standard>>https://html.spec.whatwg.org/multipage/embedded-content.html#the-img-element]]. ** **##queryString##**: Allows queries to be passed to the server when creating the download link for the referenced image. Example: ##queryString="width=100&height=800&keepAspectRatio=true"## (**##keepAspectRatio=true## will fail if the ##width## and ##height## parameters are specified in addition to ##queryString##!**) |
|
None
Source string changed |
= Editing =
== Images == === 1.0 Images === |=Feature|=XWiki Syntax 1.0|=Result |Image from attachment on current page|((( {{info}}See [[Image Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Image+Macro+%28Radeox%29]] for details{{/info}} {{{{image:img.png}}}} )))|image:XWiki.XWikiSyntaxImages@img.png |Image from attachment on another page|{{{{image:img.png|document=Space.Page}}}}|image:XWiki.XWikiSyntaxImages@img.png |Image with parameters|{{{{image:img.png|width=25|height=25}}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]] |Images located at URL|{{{https://some/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png === 2.0 Images === |=Feature|=XWiki Syntax 2.0|=Result |Image from attachment on current page|{{{image:img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Image from attachment on another page|{{{image:Space.Page@img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Image with parameters|{{{[[image:img.png||width="25" height="25"]]}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]] |Image with caption|{{{[[~[~[XWiki~>~>https://www.xwiki.org~]~] supports captions.>>image:img.png]]}}}|((([[~[~[XWiki~>~>https://www.xwiki.org~]~] supports captions.>>image:XWiki.XWikiSyntaxImages@img.png]]))) |Images located at URL|{{{image:https://some/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png {{velocity}}$subHeading XWiki Syntax 2.0 Image Specification $subHeading{{/velocity}} {{info}} The part in ##( )## is required, while the parts in ##{ }## are optional. {{/info}} The full format of an image is either **##image~: (reference)##** or **##~[~[{caption>>}image~: (reference) {||parameters}]]##** * **##caption##**: An optional caption. May contain arbitrary XWiki 2.0 syntax but nested link syntax must be escaped using ##~~##. The caption is only supported when the image syntax is the only content of a paragraph. * **##image~:##** A required string identifying the resource as image. * **##reference##**: The reference to the image that shall be displayed in one of the following forms: ** **URL**: Any URL to an image in the form of **##http:~/~/path/imageName##**. Example: ##http:~/~/domain.org/path/img.png## ** **Attachment** reference in the form **##~{~{~{wikiName:} space.} page@} (imageName)##** *** **##wikiName##**: An optional string containing the name of a *** **##space##**: An optional wiki Space name. If no space is specified the current space is used. Example: Main *** **##page##**: An optional string containing the name of the wiki page to which the referenced image is attached. Example: WebHome *** **##imageName##**: A required string containing the name of the image attached to a page as it is stored in the wiki. * **##parameters##**: An optional list of space-separated parameters passed to the image. Example: ##width="800" height="600" alt="img.png" title="My nice image"## ** **HTML attributes**: All attributes defined by the HTML standard will be added to the rendered HTML ##<img>## tag. *** **##style##**: CSS style information that should be applied to the image. Examples: ##style="float:right;height:50"## (image on right side, height 50 px), ##style="display:block;margin-left:auto;margin-right:auto;width:80%"## (image centered, width 80% of block width), ##style="vertical-align:bottom"## (text starts at bottom of picture) *** **##height##**: A parameter that defines the height of the displayed image. The value should be presented either in pixel (example: ##height="80"##) or in pixel related to the height of the block containing the image (example: ##height="40%"##). *** **##width##**: A parameter that defines the width of the displayed image. The value should be presented either in pixel (example: ##width="80"##) or in pixel related to the width of the block containing the image (example: ##width="40%"##). *** **##title##**: A parameter that defines the title the displayed image which will be visible when hovering the mouse trigger over the image, for instance. Example: ##title="My nice image"## *** **##alt##**: A parameter that defines which text should be displayed if the browser is not able to display the image. Since this is a required HTML attribute XWiki will use the file name instead if the ##alt## parameter is not defined. Example: ##alt="img.png"## *** **More**: A more in depth explanation on the HTML ##<img>## tag including more attributes can be reviewed [[ === 2.1 Images === |=Feature|=XWiki Syntax 2.1|=Result |Image from attachment on current page|{{{image:img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Image from attachment on another page|{{{image:PageA.PageB@img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Image with parameters|{{{[[image:img.png||width="25" height="25"]]}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]] |Image with caption|{{{[[~[~[XWiki~>~>https://www.xwiki.org~]~] supports captions.>>image:img.png]]}}}|((([[~[~[XWiki~>~>https://www.xwiki.org~]~] supports captions.>>image:XWiki.XWikiSyntaxImages@img.png]]))) |Images located at URL|{{{image:https://some/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Prepackaged Icons|{{{image:icon:accept}}}|image:icon:accept {{velocity}}$subHeading XWiki Syntax 2.1 Image Specification $subHeading{{/velocity}} {{info}} Legend: The part {{/info}} The full format of an image is either **##image~: (reference)##** or **##~[~[{caption>>}image~: (reference) {||parameters}]]##** * **##caption##**: An optional caption. May contain arbitrary XWiki 2.1 syntax but nested link syntax must be escaped using ##~~##. The caption is only supported when the image syntax is the only content of a paragraph. * **##image~:##** A required string identifying the resource as image. * **##reference##**: The reference to the image that shall be displayed in one of the following forms: ** **URL**: Any URL to an image in the form of **##[url:](protocol:~/~/path/imageName)##**. Example: ##http:~/~/domain.org/path/img.png## *** **##url:##** An optional string identifying the image as an URL. *** **##protocol:~/~/path/imageName##**: The URL to the image ** **Attachment**: A reference in the form **##[attach~:]~{~{~{(wikiName):} *** **##attach~:##** An optional string identifying the reference as an XWiki Document attachment. *** **##wikiName##**: An optional string containing the name of a *** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## *** **##pageName##**: An optional string containing the name of the wiki page to which the referenced image is attached. Example: ##Welcome## *** **##imageName##**: A required string containing the name of the image attached to a page as it is stored in the wiki. Example: ##myImage.png## ** ** *** **##pageAttach~:##** An required string identifying the reference as an XWiki Page attachment. *** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##pageNameList##**: An optional dot-separated list of wiki page names. If no page is specified the current page is used. Examples: ##Main##, ##A/B##, ##A/B/C## *** **##imageName##**: A required string containing the name of the image attached to a page as it is stored in the wiki. Example: ##myImage.png## ** **Icon**: A reference in the form **##icon{{{:(}}}iconName)##**. Example: **##icon:accept##** *** **##icon:##** A required string identifying the image reference as an icon from the [[XWiki Icon Set>>https://www.famfamfam.com/lab/icons/silk/previews/index_abc.png]]. *** **##iconName##**: A required string identifying the icon referenced. Example: ##accept## ** **Icon**: A reference in the form **##icon{{{:(}}}iconName)##**. Example: **##icon:accept##** *** **##icon:##** A required string identifying the image reference as an icon from the [[XWiki Icon Set>>https://www.famfamfam.com/lab/icons/silk/previews/index_abc.png]]. *** **##iconName##**: A required string identifying the icon referenced. Example: ##accept## ** **Data URI**: A reference in the form **## *** **##data:##** A required string identifying the image as being specified inline using the [[Data URI scheme>>https://en.wikipedia.org/wiki/Data_URI_scheme]]. *** **##content##**: The encoded image. Example: ##{{{image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==}}}## * **##parameters##**: An optional list of space-separated parameters passed to the image. Example: ##width="800" height="600" alt="img.png" title="My nice image"## ** **HTML attributes**: All attributes defined by the HTML standard will be added to the rendered HTML ##<img>## tag. *** **##style##**: CSS style information that should be applied to the image. Examples: ##style="float:right;height:50"## (image on right side, height 50 px), ##style="display:block;margin-left:auto;margin-right:auto;width:80%"## (image centered, width 80% of block width), ##style="vertical-align:bottom"## (text starts at bottom of picture) *** **##height##**: A parameter that defines the height of the displayed image. The value should be presented either in pixel (example: ##height="80"##) or in pixel related to the height of the block containing the image (example: ##height="40%"##). *** **##width##**: A parameter that defines the width of the displayed image. The value should be presented either in pixel (example: ##width="80"##) or in pixel related to the width of the block containing the image (example: ##width="40%"##). *** **##title##**: A parameter that defines the title the displayed image which will be visible when hovering the mouse trigger over the image, for instance. Example: ##title="My nice image"## *** **##alt##**: A parameter that defines which text should be displayed if the browser is not able to display the image. Since this is a required HTML attribute XWiki will use the file name instead if the ##alt## parameter is not defined. Example: ##alt="img.png"## *** **More**: A more in depth explanation on the HTML ##<img>## tag including more attributes can be reviewed [[ ** **##queryString##**: Allows queries to be passed to the server when creating the download link for the referenced image. Example: ##queryString="width=100&height=800&keepAspectRatio=true"## (**##keepAspectRatio=true## will fail if the ##width## and ##height## parameters are specified in addition to ##queryString##!**) |
|
None
Source string changed |
= Editing =
== Images == === 1.0 Images === |=Feature|=XWiki Syntax 1.0|=Result |Image from attachment on current page|((( {{info}}See [[Image Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Image+Macro+%28Radeox%29]] for details{{/info}} {{{{image:img.png}}}} )))|image:XWiki.XWikiSyntaxImages@img.png |Image from attachment on another page|{{{{image:img.png|document=Space.Page}}}}|image:XWiki.XWikiSyntaxImages@img.png |Image with parameters|{{{{image:img.png|width=25|height=25}}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]] |Images located at URL|{{{https://some/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png === 2.0 Images === |=Feature|=XWiki Syntax 2.0|=Result |Image from attachment on current page|{{{image:img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Image from attachment on another page|{{{image:Space.Page@img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Image with parameters|{{{[[image:img.png||width="25" height="25"]]}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]] |Image with caption|{{{[[~[~[XWiki~>~>https://www.xwiki.org~]~] supports captions.>>image:img.png]]}}}|((([[~[~[XWiki~>~>https://www.xwiki.org~]~] supports captions.>>image:XWiki.XWikiSyntaxImages@img.png]]))) |Images located at URL|{{{image:https://some/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png {{velocity}}$subHeading XWiki Syntax 2.0 Image Specification $subHeading{{/velocity}} {{info}} The part in ##( )## is required, while the parts in ##{ }## are optional. {{/info}} The full format of an image is either **##image~: (reference)##** or **##~[~[{caption>>}image~: (reference) {||parameters}]]##** * **##caption##**: An optional caption. May contain arbitrary XWiki 2.0 syntax but nested link syntax must be escaped using ##~~##. The caption is only supported when the image syntax is the only content of a paragraph. * **##image~:##** A required string identifying the resource as image. * **##reference##**: The reference to the image that shall be displayed in one of the following forms: ** **URL**: Any URL to an image in the form of **##http:~/~/path/imageName##**. Example: ##http:~/~/domain.org/path/img.png## ** **Attachment** reference in the form **##~{~{~{wikiName:} space.} page@} (imageName)##** *** **##wikiName##**: An optional string containing the name of a *** **##space##**: An optional wiki Space name. If no space is specified the current space is used. Example: Main *** **##page##**: An optional string containing the name of the wiki page to which the referenced image is attached. Example: WebHome *** **##imageName##**: A required string containing the name of the image attached to a page as it is stored in the wiki. * **##parameters##**: An optional list of space-separated parameters passed to the image. Example: ##width="800" height="600" alt="img.png" title="My nice image"## ** **HTML attributes**: All attributes defined by the HTML standard will be added to the rendered HTML ##<img>## tag. *** **##style##**: CSS style information that should be applied to the image. Examples: ##style="float:right;height:50"## (image on right side, height 50 px), ##style="display:block;margin-left:auto;margin-right:auto;width:80%"## (image centered, width 80% of block width), ##style="vertical-align:bottom"## (text starts at bottom of picture) *** **##height##**: A parameter that defines the height of the displayed image. The value should be presented either in pixel (example: ##height="80"##) or in pixel related to the height of the block containing the image (example: ##height="40%"##). *** **##width##**: A parameter that defines the width of the displayed image. The value should be presented either in pixel (example: ##width="80"##) or in pixel related to the width of the block containing the image (example: ##width="40%"##). *** **##title##**: A parameter that defines the title the displayed image which will be visible when hovering the mouse trigger over the image, for instance. Example: ##title="My nice image"## *** **##alt##**: A parameter that defines which text should be displayed if the browser is not able to display the image. Since this is a required HTML attribute XWiki will use the file name instead if the ##alt## parameter is not defined. Example: ##alt="img.png"## *** **More**: A more in depth explanation on the HTML ##<img>## tag including more attributes can be reviewed [[ === 2.1 Images === |=Feature|=XWiki Syntax 2.1|=Result |Image from attachment on current page|{{{image:img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Image from attachment on another page|{{{image:PageA.PageB@img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Image with parameters|{{{[[image:img.png||width="25" height="25"]]}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]] |Image with caption|{{{[[~[~[XWiki~>~>https://www.xwiki.org~]~] supports captions.>>image:img.png]]}}}|((([[~[~[XWiki~>~>https://www.xwiki.org~]~] supports captions.>>image:XWiki.XWikiSyntaxImages@img.png]]))) |Images located at URL|{{{image:https://some/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Prepackaged Icons|{{{image:icon:accept}}}|image:icon:accept {{velocity}}$subHeading XWiki Syntax 2.1 Image Specification $subHeading{{/velocity}} {{info}} Legend: The part {{/info}} The full format of an image is either **##image~: (reference)##** or **##~[~[{caption>>}image~: (reference) {||parameters}]]##** * **##caption##**: An optional caption. May contain arbitrary XWiki 2.1 syntax but nested link syntax must be escaped using ##~~##. The caption is only supported when the image syntax is the only content of a paragraph. * **##image~:##** A required string identifying the resource as image. * **##reference##**: The reference to the image that shall be displayed in one of the following forms: ** **URL**: Any URL to an image in the form of **##[url:](protocol:~/~/path/imageName)##**. Example: ##http:~/~/domain.org/path/img.png## *** **##url:##** An optional string identifying the image as an URL. *** **##protocol:~/~/path/imageName##**: The URL to the image ** **Attachment**: A reference in the form **##[attach~:]~{~{~{(wikiName):} *** **##attach~:##** An optional string identifying the reference as an XWiki attachment. *** **##wikiName##**: An optional string containing the name of a *** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## *** **##pageName##**: An optional string containing the name of the wiki page to which the referenced image is attached. Example: ##Welcome## *** **##imageName##**: A required string containing the name of the image attached to a page as it is stored in the wiki. Example: ##myImage.png## ** **Icon**: A reference in the form **## *** **##icon:##** A required string identifying the image reference as an icon from the [[XWiki Icon Set>>https://www.famfamfam.com/lab/icons/silk/previews/index_abc.png]]. *** **##iconName##**: A required string identifying the icon referenced. Example: ##accept## ** **Data URI**: A reference in the form **## *** **##data:##** A required string identifying the image as being specified inline using the [[Data URI scheme>>https://en.wikipedia.org/wiki/Data_URI_scheme]]. *** **##content##**: The encoded image. Example: ##{{{image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==}}}## * **##parameters##**: An optional list of space-separated parameters passed to the image. Example: ##width="800" height="600" alt="img.png" title="My nice image"## ** **HTML attributes**: All attributes defined by the HTML standard will be added to the rendered HTML ##<img>## tag. *** **##style##**: CSS style information that should be applied to the image. Examples: ##style="float:right;height:50"## (image on right side, height 50 px), ##style="display:block;margin-left:auto;margin-right:auto;width:80%"## (image centered, width 80% of block width), ##style="vertical-align:bottom"## (text starts at bottom of picture) *** **##height##**: A parameter that defines the height of the displayed image. The value should be presented either in pixel (example: ##height="80"##) or in pixel related to the height of the block containing the image (example: ##height="40%"##). *** **##width##**: A parameter that defines the width of the displayed image. The value should be presented either in pixel (example: ##width="80"##) or in pixel related to the width of the block containing the image (example: ##width="40%"##). *** **##title##**: A parameter that defines the title the displayed image which will be visible when hovering the mouse trigger over the image, for instance. Example: ##title="My nice image"## *** **##alt##**: A parameter that defines which text should be displayed if the browser is not able to display the image. Since this is a required HTML attribute XWiki will use the file name instead if the ##alt## parameter is not defined. Example: ##alt="img.png"## *** **More**: A more in depth explanation on the HTML ##<img>## tag including more attributes can be reviewed [[ ** **##queryString##**: Allows queries to be passed to the server when creating the download link for the referenced image. Example: ##queryString="width=100&height=800&keepAspectRatio=true"## (**##keepAspectRatio=true## will fail if the ##width## and ##height## parameters are specified in addition to ##queryString##!**) |
|
None
Source string changed |
= Editing =
== Images == === 1.0 Images === |=Feature|=XWiki Syntax 1.0|=Result |Image from attachment on current page|((( {{info}}See [[Image Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Image+Macro+%28Radeox%29]] for details{{/info}} {{{{image:img.png}}}} )))|image:XWiki.XWikiSyntaxImages@img.png |Image from attachment on another page|{{{{image:img.png|document=Space.Page}}}}|image:XWiki.XWikiSyntaxImages@img.png |Image with parameters|{{{{image:img.png|width=25|height=25}}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]] |Images located at URL|{{{https://some/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png === 2.0 Images === |=Feature|=XWiki Syntax 2.0|=Result |Image from attachment on current page|{{{image:img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Image from attachment on another page|{{{image:Space.Page@img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Image with parameters|{{{[[image:img.png||width="25" height="25"]]}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]] |Images located at URL|{{{image:https://some/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png {{velocity}}$subHeading XWiki Syntax 2.0 Image Specification $subHeading{{/velocity}} {{info}} The part in ##( )## is required, while the parts in ##{ }## are optional. {{/info}} The full format of an image is either **##image~: (reference)##** or **##~[~[image~: (reference) {||parameters}]]##** * **##image~:##** A required string identifying the resource as image. * **##reference##**: The reference to the image that shall be displayed in one of the following forms: ** **URL**: Any URL to an image in the form of **##http:~/~/path/imageName##**. Example: ##http:~/~/domain.org/path/img.png## ** **Attachment** reference in the form **##~{~{~{wikiName:} space.} page@} (imageName)##** *** **##wikiName##**: An optional string containing the name of a *** **##space##**: An optional wiki Space name. If no space is specified the current space is used. Example: Main *** **##page##**: An optional string containing the name of the wiki page to which the referenced image is attached. Example: WebHome *** **##imageName##**: A required string containing the name of the image attached to a page as it is stored in the wiki. * **##parameters##**: An optional list of space-separated parameters passed to the image. Example: ##width="800" height="600" alt="img.png" title="My nice image"## ** **HTML attributes**: All attributes defined by the HTML standard will be added to the rendered HTML ##<img>## tag. *** **##style##**: CSS style information that should be applied to the image. Examples: ##style="float:right;height:50"## (image on right side, height 50 px), ##style="display:block;margin-left:auto;margin-right:auto;width:80%"## (image centered, width 80% of block width), ##style="vertical-align:bottom"## (text starts at bottom of picture) *** **##height##**: A parameter that defines the height of the displayed image. The value should be presented either in pixel (example: ##height="80"##) or in pixel related to the height of the block containing the image (example: ##height="40%"##). *** **##width##**: A parameter that defines the width of the displayed image. The value should be presented either in pixel (example: ##width="80"##) or in pixel related to the width of the block containing the image (example: ##width="40%"##). *** **##title##**: A parameter that defines the title the displayed image which will be visible when hovering the mouse trigger over the image, for instance. Example: ##title="My nice image"## *** **##alt##**: A parameter that defines which text should be displayed if the browser is not able to display the image. Since this is a required HTML attribute XWiki will use the file name instead if the ##alt## parameter is not defined. Example: ##alt="img.png"## *** **More**: A more in depth explanation on the HTML ##<img>## tag including more attributes can be reviewed [[on w3.org>>https://www.w3.org/TR/html4/struct/objects.html#h-13.2]]. === 2.1 Images === |=Feature|=XWiki Syntax 2.1|=Result |Image from attachment on current page|{{{image:img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Image from attachment on another page|{{{image:PageA.PageB@img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Image with parameters|{{{[[image:img.png||width="25" height="25"]]}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]] |Images located at URL|{{{image:https://some/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Prepackaged Icons|{{{image:icon:accept}}}|image:icon:accept {{velocity}}$subHeading XWiki Syntax 2.1 Image Specification $subHeading{{/velocity}} {{info}} Legend: The part {{/info}} The full format of an image is either **##image~: (reference)##** or **##~[~[image~: (reference) {||parameters}]]##** * **##image~:##** A required string identifying the resource as image. * **##reference##**: The reference to the image that shall be displayed in one of the following forms: ** **URL**: Any URL to an image in the form of **##[url:](protocol:~/~/path/imageName)##**. Example: ##http:~/~/domain.org/path/img.png## *** **##url:##** An optional string identifying the image as an URL. *** **##protocol:~/~/path/imageName##**: The URL to the image ** **Attachment**: A reference in the form **##[attach~:]~{~{~{(wikiName):} *** **##attach~:##** An optional string identifying the reference as an XWiki attachment. *** **##wikiName##**: An optional string containing the name of a *** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## *** **##pageName##**: An optional string containing the name of the wiki page to which the referenced image is attached. Example: ##Welcome## *** **##imageName##**: A required string containing the name of the image attached to a page as it is stored in the wiki. Example: ##myImage.png## ** **Icon**: A reference in the form **## *** **##icon:##** A required string identifying the image reference as an icon from the [[XWiki Icon Set>>https://www.famfamfam.com/lab/icons/silk/previews/index_abc.png]]. *** **##iconName##**: A required string identifying the icon referenced. Example: ##accept## ** **Data URI**: A reference in the form **## *** **##data:##** A required string identifying the image as being specified inline using the [[Data URI scheme>>https://en.wikipedia.org/wiki/Data_URI_scheme]]. *** **##content##**: The encoded image. Example: ##{{{image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==}}}## * **##parameters##**: An optional list of space-separated parameters passed to the image. Example: ##width="800" height="600" alt="img.png" title="My nice image"## ** **HTML attributes**: All attributes defined by the HTML standard will be added to the rendered HTML ##<img>## tag. *** **##style##**: CSS style information that should be applied to the image. Examples: ##style="float:right;height:50"## (image on right side, height 50 px), ##style="display:block;margin-left:auto;margin-right:auto;width:80%"## (image centered, width 80% of block width), ##style="vertical-align:bottom"## (text starts at bottom of picture) *** **##height##**: A parameter that defines the height of the displayed image. The value should be presented either in pixel (example: ##height="80"##) or in pixel related to the height of the block containing the image (example: ##height="40%"##). *** **##width##**: A parameter that defines the width of the displayed image. The value should be presented either in pixel (example: ##width="80"##) or in pixel related to the width of the block containing the image (example: ##width="40%"##). *** **##title##**: A parameter that defines the title the displayed image which will be visible when hovering the mouse trigger over the image, for instance. Example: ##title="My nice image"## *** **##alt##**: A parameter that defines which text should be displayed if the browser is not able to display the image. Since this is a required HTML attribute XWiki will use the file name instead if the ##alt## parameter is not defined. Example: ##alt="img.png"## *** **More**: A more in depth explanation on the HTML ##<img>## tag including more attributes can be reviewed [[on w3.org>>https://www.w3.org/TR/html4/struct/objects.html#h-13.2]]. ** **##queryString##**: Allows queries to be passed to the server when creating the download link for the referenced image. Example: ##queryString="width=100&height=800&keepAspectRatio=true"## (**##keepAspectRatio=true## will fail if the ##width## and ##height## parameters are specified in addition to ##queryString##!**) |
shirahara
Source string comment
The block under "** Icon: A reference in the form ##icon{{{:(}}}iconName)##. Example: ##icon:accept##" is duplicated.
petrenkonikita112263
Resolved comment
As update to above comment, here what's duplicated
** Icon: A reference in the form ##icon{{{:(}}}iconName)##. Example: ##icon:accept## *** ##icon:## A required string identifying the image reference as an icon from the [[XWiki Icon Set>>https://www.famfamfam.com/lab/icons/silk/previews/index_abc.png]]. *** ##iconName##: A required string identifying the icon referenced. Example: ##accept## ** Icon: A reference in the form ##icon{{{:(}}}iconName)##. Example: ##icon:accept## *** ##icon:## A required string identifying the image reference as an icon from the [[XWiki Icon Set>>https://www.famfamfam.com/lab/icons/silk/previews/index_abc.png]]. *** ##iconName##: A required string identifying the icon referenced. Example: ##accept##
![https://www.famfamfam.com/lab/icons/silk/previews/index_abc.png]](https://www.famfamfam.com/lab/icons/silk/previews/index_abc.png]){kind=link}
== Images ==
=== 1.0 Images ===
|=Feature|=XWiki Syntax 1.0|=Result
|Image from attachment on current page|(((
{{info}}See [[Image Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Image%20Macro%20%28Radeox%29]] for details{{/info}}
{{{{image:img.png}}}}
)))|image:XWiki.XWikiSyntaxImages@img.png
|Image from attachment on another page|{{{{image:img.png|document=Space.Page}}}}|image:XWiki.XWikiSyntaxImages@img.png
|Image with parameters|{{{{image:img.png|width=25|height=25}}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]]
|Images located at URL|{{{https://some/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png
=== 2.0 Images ===
|=Feature|=XWiki Syntax 2.0|=Result
|Image from attachment on current page|{{{image:img.png}}}|image:XWiki.XWikiSyntaxImages@img.png
|Image from attachment on another page|{{{image:Space.Page@img.png}}}|image:XWiki.XWikiSyntaxImages@img.png
|Image with parameters|{{{[[image:img.png||width="25" height="25"]]}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]]
|Image with caption|{{{[[~[~[XWiki~>~>https://www.xwiki.org~]~] supports captions.>>image:img.png]]}}}|((([[~[~[XWiki~>~>https://www.xwiki.org~]~] supports captions.>>image:XWiki.XWikiSyntaxImages@img.png]])))
|Images located at URL|{{{image:https://some/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png
{{velocity}}$subHeading XWiki Syntax 2.0 Image Specification $subHeading{{/velocity}}
{{info}}
The part in ##( )## is required, while the parts in ##{ }## are optional.
{{/info}}
The full format of an image is either **##image~: (reference)##** or **##~[~[{caption>>}image~: (reference) {||parameters}]]##**
* **##caption##**: An optional caption. May contain arbitrary XWiki 2.0 syntax but nested link syntax must be escaped using ##~~##. The caption is only supported when the image syntax is the only content of a paragraph. The captioned image may also be wrapped in a link. In this case, the link will contain the image but not the caption.
* **##image~:##** A required string identifying the resource as image.
* **##reference##**: The reference to the image that shall be displayed in one of the following forms:
** **URL**: Any URL to an image in the form of **##http:~/~/path/imageName##**. Example: ##http:~/~/domain.org/path/img.png##
** **Attachment** reference in the form **##~{~{~{wikiName:} space.} page@} (imageName)##**
*** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. Example: mywiki
*** **##space##**: An optional wiki Space name. If no space is specified the current space is used. Example: Main
*** **##page##**: An optional string containing the name of the wiki page to which the referenced image is attached. Example: WebHome
*** **##imageName##**: A required string containing the name of the image attached to a page as it is stored in the wiki.
* **##parameters##**: An optional list of space-separated parameters passed to the image. Example: ##width="800" height="600" alt="img.png" title="My nice image"##
** **HTML attributes**: All attributes defined by the HTML standard will be added to the rendered HTML ##<img>## tag.
*** **##style##**: CSS style information that should be applied to the image. Examples: ##style="float:right;height:50"## (image on right side, height 50 px), ##style="display:block;margin-left:auto;margin-right:auto;width:80%"## (image centered, width 80% of block width), ##style="vertical-align:bottom"## (text starts at bottom of picture)
*** **##height##**: A parameter that defines the height of the displayed image. The value should be presented either in pixel (example: ##height="80"##) or in pixel related to the height of the block containing the image (example: ##height="40%"##).
*** **##width##**: A parameter that defines the width of the displayed image. The value should be presented either in pixel (example: ##width="80"##) or in pixel related to the width of the block containing the image (example: ##width="40%"##).
*** **##title##**: A parameter that defines the title the displayed image which will be visible when hovering the mouse trigger over the image, for instance. Example: ##title="My nice image"##
*** **##alt##**: A parameter that defines which text should be displayed if the browser is not able to display the image. Since this is a required HTML attribute XWiki will use the file name instead if the ##alt## parameter is not defined. Example: ##alt="img.png"##
*** **More**: A more in depth explanation on the HTML ##<img>## tag including more attributes can be reviewed [[in the HTML standard>>https://html.spec.whatwg.org/multipage/embedded-content.html#the-img-element]].
=== 2.1 Images ===
|=Feature|=XWiki Syntax 2.1|=Result
|Image from attachment on current page|{{{image:img.png}}}|image:XWiki.XWikiSyntaxImages@img.png
|Image from attachment on another page|{{{image:PageA.PageB@img.png}}}|image:XWiki.XWikiSyntaxImages@img.png
|Image with parameters|{{{[[image:img.png||width="25" height="25"]]}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]]
|Image with caption|{{{[[~[~[XWiki~>~>https://www.xwiki.org~]~] supports captions.>>image:img.png]]}}}|((([[~[~[XWiki~>~>https://www.xwiki.org~]~] supports captions.>>image:XWiki.XWikiSyntaxImages@img.png]])))
|Images located at URL|{{{image:https://some/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png
|Prepackaged Icons|{{{image:icon:accept}}}|image:icon:accept
{{velocity}}$subHeading XWiki Syntax 2.1 Image Specification $subHeading{{/velocity}}
{{info}}
Legend: The parts are ##()## are required, while the parts in ##{}## are optional.
{{/info}}
The full format of an image is either **##image~: (reference)##** or **##~[~[{caption>>}image~: (reference) {||parameters}]]##**
* **##caption##**: An optional caption. May contain arbitrary XWiki 2.1 syntax but nested link syntax must be escaped using ##~~##. The caption is only supported when the image syntax is the only content of a paragraph. The captioned image may also be wrapped in a link. In this case, the link will contain the image but not the caption.
* **##image~:##** A required string identifying the resource as image.
* **##reference##**: The reference to the image that shall be displayed in one of the following forms:
** **URL**: Any URL to an image in the form of **##[url:](protocol:~/~/path/imageName)##**. Example: ##http:~/~/domain.org/path/img.png##
*** **##url:##** An optional string identifying the image as an URL.
*** **##protocol:~/~/path/imageName##**: The URL to the image
** **Attachment**: A reference in the form **##[attach~:]~{~{~{(wikiName):}(spaceNameList).}(pageName)@}(imageName)##**
*** **##attach~:##** An optional string identifying the reference as an XWiki Document attachment.
*** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##.
*** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C##
*** **##pageName##**: An optional string containing the name of the wiki page to which the referenced image is attached. Example: ##Welcome##
*** **##imageName##**: A required string containing the name of the image attached to a page as it is stored in the wiki. Example: ##myImage.png##
** **Page Attachment**: A reference in the form **##pageAttach~:~{~{~{(wikiName):}(pageNameList)/}(imageName)##**
*** **##pageAttach~:##** An required string identifying the reference as an XWiki Page attachment.
*** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##.
*** **##pageNameList##**: An optional dot-separated list of wiki page names. If no page is specified the current page is used. Examples: ##Main##, ##A/B##, ##A/B/C##
*** **##imageName##**: A required string containing the name of the image attached to a page as it is stored in the wiki. Example: ##myImage.png##
** **Icon**: A reference in the form **##icon{{{:(}}}iconName)##**. Example: **##icon:accept##**
*** **##icon:##** A required string identifying the image reference as an icon from the [[XWiki Icon Set>>https://www.famfamfam.com/lab/icons/silk/previews/index_abc.png]].
*** **##iconName##**: A required string identifying the icon referenced. Example: ##accept##
** **Data URI**: A reference in the form **##(data{{{:)}}}(content)##**. Example: **##{{{data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==}}}##**
*** **##data:##** A required string identifying the image as being specified inline using the [[Data URI scheme>>https://en.wikipedia.org/wiki/Data_URI_scheme]].
*** **##content##**: The encoded image. Example: ##{{{image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==}}}##
* **##parameters##**: An optional list of space-separated parameters passed to the image. Example: ##width="800" height="600" alt="img.png" title="My nice image"##
** **HTML attributes**: All attributes defined by the HTML standard will be added to the rendered HTML ##<img>## tag.
*** **##style##**: CSS style information that should be applied to the image. Examples: ##style="float:right;height:50"## (image on right side, height 50 px), ##style="display:block;margin-left:auto;margin-right:auto;width:80%"## (image centered, width 80% of block width), ##style="vertical-align:bottom"## (text starts at bottom of picture)
*** **##height##**: A parameter that defines the height of the displayed image. The value should be presented either in pixel (example: ##height="80"##) or in pixel related to the height of the block containing the image (example: ##height="40%"##).
*** **##width##**: A parameter that defines the width of the displayed image. The value should be presented either in pixel (example: ##width="80"##) or in pixel related to the width of the block containing the image (example: ##width="40%"##).
*** **##title##**: A parameter that defines the title the displayed image which will be visible when hovering the mouse trigger over the image, for instance. Example: ##title="My nice image"##
*** **##alt##**: A parameter that defines which text should be displayed if the browser is not able to display the image. Since this is a required HTML attribute XWiki will use the file name instead if the ##alt## parameter is not defined. Example: ##alt="img.png"##
*** **More**: A more in depth explanation on the HTML ##<img>## tag including more attributes can be reviewed [[in the HTML standard>>https://html.spec.whatwg.org/multipage/embedded-content.html#the-img-element]].
** **##queryString##**: Allows queries to be passed to the server when creating the download link for the referenced image. Example: ##queryString="width=100&height=800&keepAspectRatio=true"## (**##keepAspectRatio=true## will fail if the ##width## and ##height## parameters are specified in addition to ##queryString##!**)
== Immagini ==
{{comment}}please do not translate the sub headlines{{/comment}}
=== 1.0 Images ===
|=Caratteristica|=Sintassi XWiki 1.0|=Risultato
|Immagine da un allegato nella pagina corrente|(((
{{info}}Vedere [[Image Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Image%20Macro%20%28Radeox%29]] per dettagli{{/info}}
{{{{image:img.png}}}}
)))|image:XWiki.XWikiSyntaxImages@img.png
|Immagine da un allegato di un altro documento|{{{{image:img.png|document=Space.Page}}}}|image:XWiki.XWikiSyntaxImages@img.png
|Immagine con parametri|{{{{image:img.png|width=25|height=25}}}}|[[image:XWiki.XWikiSyntaxImages@img.png||height="25" width="25"]]
|Immagini raggiungibili con un URL|{{{http://some/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png
=== 2.0 Images ===
|=Caratteristica|=Sintassi XWiki 2.0|=Risultato
|Immagine da un allegato nella pagina corrente|{{{image:img.png}}}|image:XWiki.XWikiSyntaxImages@img.png
|Immagine da un allegato di un altro documento|{{{image:Space.Page@img.png}}}|image:XWiki.XWikiSyntaxImages@img.png
|Immagine con parametri|{{{[[image:img.png||width="25" height="25"]]}}}|[[image:XWiki.XWikiSyntaxImages@img.png||height="25" width="25"]]
|Immagini raggiungibili con un URL|{{{image:http://some/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png
{{velocity}}$subHeading Specifiche per le Immagini in Sintassi XWiki 2.0 $subHeading{{/velocity}}
{{info}}
La parte tra ##( )## è richiesta, mentre le parti tra ##{ }## sono opzionali.
{{/info}}
Il formato completo di un'immagine è **##image~: (riferimento)##** oppure **##~[~[image~: (riferimento) {||parametri}]]##**
* **##image~:##** Stringa richiesta che identifica la risora come immagine.
* **##riferimento##**: Il riferimento all'immagine che sarà mostrata in una delle forme seguenti:
** **URL**: Un qualunque URL ad un'immagine nel formato **##http:~/~/percorso/Nomeimmagine##**. Esempio: ##http:~/~/domain.org/path/img.png##
** **Allegato** riferimento nel formato **##~{~{~{Nomewiki:} spazio.} pagina@} (Nomeimmagine)##**
*** **##NomeWiki##**: Stringa opzionale che contiene 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 viene usato lo spazio corrente. Esempio: Main
*** **##pagina##**: Stringa opzionale che contiene il nome di una pagina del wiki a cui l'immagine fa riferimento come allegato. Esempio: WebHome
*** **##Nomeimmagine##**: Stringa richiesta con il nome dell'immagine allegata alla pagina così come è memorizzato nel wiki.
* **##parametri##**: Elenco opzionale di parametri separati da uno spazio passati all'immagine. Esempio: ##width="800" height="600" alt="img.png" title="My nice image"##
** **Attributi HTML**: Tutti gli attributi definiti dallo standard HTML saranno aggiunti al codice HTML renderizzato ##<img>## tag.
*** **##style##**: Informazioni sullo stile CSS che si deve applicare all'immagine. Esempio: ##style="float:right;height:50"## (immagina a destra, altezza 50 pixel), ##style="display:block;margin-left:auto;margin-right:auto;width:80%"## (immagine centrata, larghezza 80% del blocco), ##style="vertical-align:bottom"## (il testo inzia in basso all'immagine)
*** **##height##**: Parametro che definisce l'altezza visualizzata dell'immagine. Il valore dovrebbe essere in pixel (esempio: ##height="80"##) o in pixel relativi all'altezza del blocco contenente l'immagine (esempio: ##height="40%"##).
*** **##width##**: Parametro che definisce la larghezza visualizzata dell'immagine. Il valore dovrebbe essere in pixel (esempio: ##width="80"##) o in pixel relativi alla larghezza del blocco contenente l'immagine (esempio: ##width="40%"##).
*** **##title##**: Parametro che definisce il titolo visualizzato dell'immagine che sarà visibile quando ci si passa sopra con il mouse, per esempio. Esempio: ##title="La mia bella immagine"##
*** **##alt##**: Parametro che definisce quale testo deve essere mostrato se il browser non è in grado di visualizzare l'immagine. Dal momento che questo è un attributo HTML richiesto XWiki userà il nome del file se il parametro ##alt## non è definito. Esempio: ##alt="img.png"##
*** **Altro**: Una spiegazione più approfondita sul tag HTML ##<img>## tag che comprende altri attributi si può trovare su [[on w3.org>>http://www.w3.org/TR/html4/struct/objects.html#h-13.2]].
=== 2.1 Images ===
|=Caratteristica|=Sintassi XWiki 2.1|=Risultato
|Immagine da un allegato nella pagina corrente|{{{image:img.png}}}|image:XWiki.XWikiSyntaxImages@img.png
|Immagine da un allegato di un altro documento|{{{image:Space.Page@img.png}}}|image:XWiki.XWikiSyntaxImages@img.png
|Immagine con parametri|{{{[[image:img.png||width="25" height="25"]]}}}|[[image:XWiki.XWikiSyntaxImages@img.png||height="25" width="25"]]
|Immagini raggiungibili con un URL|{{{image:http://some/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png
|Icona|{{{image:icon:accept}}}|image:icon:accept
{{velocity}}$subHeading Specifiche per le Immagini in Sintassi XWiki 2.1 $subHeading{{/velocity}}
Il formato completo di un'immagine è **##image~: (riferimento)##** oppure **##~[~[image~: (riferimento) {||parametri}]]##**
* **##image~:##** Stringa richiesta che identifica la risora come immagine.
* **##riferimento##**: Il riferimento all'immagine che sarà mostrata in una delle forme seguenti:
** **URL**: Un qualunque URL ad un'immagine nel formato **##protocollo:~/~/percorso/Nomeimmagine##**. Esempio: ##http:~/~/domain.org/path/img.png##
** **Allegato** riferimento nel formato **##~{~{~{Nomewiki:} spazio.} pagina@} (Nomeimmagine)##**
*** **##NomeWiki##**: Stringa opzionale che contiene 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 viene usato lo spazio corrente. Esempio: Main
*** **##pagina##**: Stringa opzionale che contiene il nome di una pagina del wiki a cui l'immagine fa riferimento come allegato. Esempio: WebHome
*** **##Nomeimmagine##**: Stringa richiesta con il nome dell'immagine allegata alla pagina così come è memorizzato nel wiki.
** **Icona** riferimento nel formato **##{{{(icon:)}}} (iconName)##**. Esempio: **##icon:accept##**
*** **##icon:##** Stringa richiesta che identifica il riferimento come un'icona da [[XWiki Icon Set>>http://www.famfamfam.com/lab/icons/silk/previews/index_abc.png]].
*** **##iconName##**: Stringa richiesta che identifica l'icona cui si fa riferimento. Esempio: ##accept##
* **##parametri##**: Elenco opzionale di parametri separati da uno spazio passati all'immagine. Esempio: ##width="800" height="600" alt="img.png" title="My nice image"##
** **Attributi HTML**: Tutti gli attributi definiti dallo standard HTML saranno aggiunti al codice HTML renderizzato ##<img>## tag.
*** **##style##**: Informazioni sullo stile CSS che si deve applicare all'immagine. Esempio: ##style="float:right;height:50"## (immagina a destra, altezza 50 pixel), ##style="display:block;margin-left:auto;margin-right:auto;width:80%"## (immagine centrata, larghezza 80% del blocco), ##style="vertical-align:bottom"## (il testo inzia in basso all'immagine)
*** **##height##**: Parametro che definisce l'altezza visualizzata dell'immagine. Il valore dovrebbe essere in pixel (esempio: ##height="80"##) o in pixel relativi all'altezza del blocco contenente l'immagine (esempio: ##height="40%"##).
*** **##width##**: Parametro che definisce la larghezza visualizzata dell'immagine. Il valore dovrebbe essere in pixel (esempio: ##width="80"##) o in pixel relativi alla larghezza del blocco contenente l'immagine (esempio: ##width="40%"##).
*** **##title##**: Parametro che definisce il titolo visualizzato dell'immagine che sarà visibile quando ci si passa sopra con il mouse, per esempio. Esempio: ##title="La mia bella immagine"##
*** **##alt##**: Parametro che definisce quale testo deve essere mostrato se il browser non è in grado di visualizzare l'immagine. Dal momento che questo è un attributo HTML richiesto XWiki userà il nome del file se il parametro ##alt## non è definito. Esempio: ##alt="img.png"##
*** **Altro**: Una spiegazione più approfondita sul tag HTML ##<img>## tag che comprende altri attributi si può trovare su [[on w3.org>>http://www.w3.org/TR/html4/struct/objects.html#h-13.2]].
** **##queryStringa##**: Consente di inviare richieste al server quando si crea il link per il download dell'immagine referenziata. Esempio: ##queryString="width=100&height=800&keepAspectRatio=true"## (**##keepAspectRatio=true## non avrà successo se i parametri ##width## e ##height## non vengono specificati oltre a ##queryString##!**)