Loading…
![]() Translation changed |
|
![]() 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## ** **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##!**)
= Bearbeiten =
== Bilder == {{comment}}please do not translate the sub headlines{{/comment}} === 1.0 Images === |=Funktion|=XWiki Syntax 1.0|=Ergebnis |Bild von Anhang auf aktueller Seite|((( {{info}}Siehe [[Bildmakro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Image%20Macro%20%28Radeox%29]] für Details{{/info}} {{{{image:XWiki.XWikiSyntaxImages@img.png}}}} )))|image:XWiki.XWikiSyntaxImages@img.png |Bild von Anhang auf anderer Seite|{{{{image:img.png|document=Bereich.Seite}}}}|image:XWiki.XWikiSyntaxImages@img.png |Bild mit Parametern|{{{{image:img.png|width=25|height=25}}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]] |Bild befindlich an URL|{{{http://eine/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png === 2.0 Images === |=Funktion|=XWiki Syntax 2.0|=Ergebnis |Bild von Anhang auf aktueller Seite|{{{image:img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Bild von Anhang auf anderer Seite|{{{image:Bereich.Seite@img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Bild mit Parametern|{{{[[image:img.png||width="25" height="25"]]}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]] |Bild mit Bildunterschrift|{{{[[~[~[XWiki~>~>https://www.xwiki.org~]~] unterstützt Bildunterschriften.>>image:img.png]]}}}|(( ([[~[~[XWiki~>~>https://www.xwiki.org~]~] unterstützt Bildunterschriften.>>image:XWiki.XWikiSyntaxImages@img.png]]))) |Bild befindlich an URL|{{{image:http://eine/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png {{velocity}}$subHeading XWiki Syntax 2.0 Bild-Spezifikation $subHeading{{/velocity}} {{info}} Der Teil in ##( )## ist erforderlich, während die Teile in ##{ }## optional sind. {{/info}} Das vollständige Format eines Bilder ist entweder **##image~: (Verweis)##** oder **##~[~[{caption>>}image~: (Verweis) {||Parameter}]]##** * **##caption##**: Eine optionale Beschriftung. Kann beliebige XWiki 2.0-Syntax enthalten, aber verschachtelte Link-Syntax muss mit ##~~## maskiert werden. Die Beschriftung wird nur unterstützt, wenn die Bildsyntax der einzige Inhalt eines Absatzes ist. Das Bild mit der Beschriftung kann auch in einen Link eingebettet sein. In diesem Fall enthält der Link das Bild, aber nicht die Beschriftung. * **##image~:##** Ein erforderlicher Text, welches die folgenden Angaben als Bild kennzeichnet. * **##Verweis##**: Der Verweis auf das anzuzeigende Bild. Der Verweis kann in folgenden Formaten angegeben werden: ** **URL**: Eine URL zu einem externen Bild in dem Format **##http:~/~/pfad/BildName##**. Beispiel: ##http:~/~/example.org/pfad/bild.png## ** **Anhang**: Ein Verweis auf einen Anhang im Wiki im Format **##~{~{~{wikiName:} Bereich.} Seite@} (BildName)##** *** **##wikiName##**: Ein optionaler Text, welcher den Namen eines Subwikis enthält. Das Bild wird dann in dem entsprechenden Subwiki nachgeschlagen. Beispiel: ##meinwiki## *** **##Bereich##**: Der Name eines Bereiches, in dem das Bild nachgeschlagen wird (optional). Wenn kein Bereich angegeben, wird der aktuelle Bereich verwendet. Beispiel: ##Main## *** **##Seite##**: Der Namen einer Seite, an der das Bild angehangen ist (optional). Wird keine Seite angegeben, wird die aktuelle Seite verwendet. Beispiel: ##WebHome## *** **##BildName##**: Ein erforderlicher Text, welcher den Dateinamen des anzuzeigenden Bildes enthält, wie er im Wiki gespeichert ist. * **##Parameter##**: Eine optionale Liste von durch Leerzeichen getrennten Parametern, die an das Bild durchgereicht werden. Beispiel: ##width="800" height="600" alt="Ein beispielhaftes Bild" title="Dies ist ein schönes Bild"## ** **HTML Attribute**: Alle Attribute, welche im HTML Standard vorgesehen sind, werden zu dem erzeugten ##<img>## Element hinzugefügt. *** **##style##**: CSS-Stil Anweisungen, welche auf das Bild angewendet werden. Beispiele: ##style="float:right;height:50px"## (d.h. das Bild wird rechtsbündig eingebettet mit einer Höhe von 50 Pixeln), ##style="style="display:block;margin-left:auto;margin-right:auto;width:80%"## (Bild wird zentriert dargestellt in einer Breite von 80% des zur verfügung stehenden Platzes). ##style="vertical-align:bottom"## (Der folgende Text startet direkt an unteren Ende des Bildes). *** **##height##**: Die vertikale Grösse des angezeigten Bildes. Der Parameterwert sollte entweder in Bildschirmpixeln angeben werden (Beispiel ##height="80"##) oder in prozentualen Anteilen des Anzeigebereichs (Beispiel ##height="40%"##) *** **##width##**: Die horizontale Grösse des angezeigten Bildes. Der Parameterwert sollte entweder in Bildschirmpixeln angeben werden (Beispiel ##width="120"##) oder in prozentualen Anteilen des Anzeigebereichs (Beispiel ##width="80%"##) *** **##title##**: Der Text, der beim Überfahren den Bildes mit dem Mauszeiger angezeigt wird. Beispiel: ##title="Dies ist ein schönes Bild"## *** **##alt##**: Der Text, welcher //alt//ernativ angezeigt wird, wenn der Browser das Bild nicht darstellen kann. Da dies im HTML eine Pflichtangabe ist, verwendet XWiki den Dateinamen, wenn kein Wert für ##alt## angegeben wurde. Beispiel: alt="Ein beispielhaftes Bild" *** **... und mehr**: Die offizielle Liste aller unterstützten Attribute kann auf der offiziellen [[Seite des HTML-Standards>> https://html.spec.whatwg.org/multipage/embedded-content.html#the-img-element]] (in Englisch) eingesehen werden. === 2.1 Images === |=Funktion|=XWiki Syntax 2.1|=Ergebnis |Bild von Anhang auf aktueller Seite|{{{image:img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Bild von Anhang auf anderer Seite|{{{image:Bereich.Seite@img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Bild mit Parametern|{{{[[image:img.png||width="25" height="25"]]}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]] |Bild mit Bildunterschrift|{{{[[~[~[XWiki~>~>https://www.xwiki.org~]~] unterstützt Bildunterschriften.>>image:img.png]]}}}|(( ([[~[~[XWiki~>~>https://www.xwiki.org~]~] unterstützt Bildunterschriften.>>image:XWiki.XWikiSyntaxImages@img.png]]))) |Bild befindlich an URL|{{{image:http://eine/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Vordefiniertes Piktogramm|{{{image:icon:accept}}}|image:icon:accept {{velocity}}$subHeading XWiki Syntax 2.1 Bild-Spezifikation $subHeading{{/velocity}} {{info}} Der Teil in ##( )## ist erforderlich, während die Teile in ##{ }## optional sind. {{/info}} Das vollständige Format eines Bilder ist entweder **##image~: (Verweis)##** oder **##~[~[{caption>>}image~: (Verweis) {||Parameter}]]##** * **##caption##**: Eine optionale Beschriftung. Kann beliebige XWiki 2.1-Syntax enthalten, aber verschachtelte Link-Syntax muss mit ##~~## maskiert werden. Die Beschriftung wird nur unterstützt, wenn die Bildsyntax der einzige Inhalt eines Absatzes ist. Das Bild mit der Beschriftung kann auch in einen Link eingebettet sein. In diesem Fall enthält der Link das Bild, aber nicht die Beschriftung. * **##image~:##** Ein erforderlicher Text, welches die folgenden Angaben als Bild kennzeichnet. * **##Verweis##**: Der Verweis auf das anzuzeigende Bild. Der Verweis kann in folgenden Formaten angegeben werden: ** **URL**: Eine URL zu einem externen Bild in dem Format **##http:~/~/pfad/BildName##**. Beispiel: ##http:~/~/example.org/pfad/bild.png## ** **Anhang**: Ein Verweis auf einen Anhang eines XWiki-Dokuments im Format **##~{~{~{wikiName:} Bereich.} Seite@} (BildName)##** *** **##wikiName##**: Ein optionaler Text, welcher den Namen eines Subwikis enthält. Das Bild wird dann in dem entsprechenden Subwiki nachgeschlagen. Beispiel: ##mywiki## *** **##Bereich##**: Der Name eines Bereiches, in dem das Bild nachgeschlagen wird (optional). Wenn kein Bereich angegeben, wird der aktuelle Bereich verwendet. Beispiel: ##Main## *** **##Seite##**: Der Namen einer Seite, an der das Bild angehangen ist (optional). Wird keine Seite angegeben, wird die aktuelle Seite verwendet. Beispiel: ##WebHome## *** **##BildName##**: Ein erforderlicher Text, welcher den Dateinamen des anzuzeigenden Bildes enthält, wie er im Wiki gespeichert ist. ** **Seiten-Anhang**: Ein Verweis in der Form **##pageAttach~:~{~{~{(wikiName):}(seitenNamenListe)/}(anhangName)##** *** **##pageAttach~:##** Eine erforderliche Zeichenfolge, die die Referenz als Anhang einer XWiki-Seite identifiziert. *** **##wikiName##**: Ein optionaler Text, welcher den Namen eines Subwikis enthält. Das Bild wird dann in dem entsprechenden Subwiki nachgeschlagen. Beispiel: ##mywiki## *** **##seitenNamenListe##**: Eine optionale, durch Punkte getrennte Liste von Wiki-Seitennamen. Wenn keine Seite angegeben ist, wird die aktuelle Seite verwendet. Beispiele: ##Main##, ##A/B##, ##A/B/C## *** **##anhangName##**: Eine erforderliche Zeichenfolge, die den Namen des an eine Seite angehängten Bildes enthält, wie es im Wiki gespeichert ist. Beispiel: ##myImage.png## ** **Piktogramme** Ein Verweis mittels des Textes **##{{{(icon:)}}} (iconName)##**. Beispiel: **##icon:accept##** *** **##icon:##** Ein erforderlicher Text, welcher die folgende Angabe als Piktogramm kennzeichnet. Piktogramme können nur aus der vorinstallierten Liste der [[XWiki Icons>>http://www.famfamfam.com/lab/icons/silk/previews/index_abc.png]] ausgewählt werden. *** **##iconName##**: Ein erforderlicher Text mit dem (englischen) Namen des anzuzeigenden Piktogramms. Beispiel: ##accept## ** **Data URI**s in der Form **##{{{(data:)}}} (bilddaten)##**. Beispiel: **##data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4~/~/8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==##** *** **##data:##** Ein erforderlicher Text, welcher die folgende Angabe als Binärdaten zu interpretieren erlaubt, enstprechend dem [['data' URI Schema>>http://de.wikipedia.org/wiki/Data-URL]]. *** **##bilddaten##**: Angabe zu Dateiformat und Codierung, etwa für PNG-Bilder in Base64-codierung ##{{{image/png;base64,}}}## gefolgt von den Binärdaten des Bildes in der angegebenen textuellen Codierung * **##Parameter##**: Eine optionale Liste von durch Leerzeichen getrennten Parametern, die an das Bild durchgereicht werden. Beispiel: ##width="800" height="600" alt="Ein beispielhaftes Bild" title="Dies ist ein schönes Bild"## ** **HTML Attribute**: Alle Attribute, welche im HTML Standard vorgesehen sind, werden zu dem erzeugten ##<img>## Element hinzugefügt. *** **##style##**: CSS-Stil Anweisungen, welche auf das Bild angewendet werden. Beispiele: ##style="float:right;height:50px"## (d.h. das Bild wird rechtsbündig eingebettet mit einer Höhe von 50 Pixeln), ##style="style="display:block;margin-left:auto;margin-right:auto;width:80%"## (Bild wird zentriert dargestellt in einer Breite von 80% des zur Verfügung stehenden Platzes), ##style="vertical-align:bottom"## (Der folgende Text startet direkt an unteren Ende des Bildes). *** **##height##**: Die vertikale Grösse des angezeigten Bildes. Der Parameterwert sollte entweder in Bildschirmpixeln angeben werden (Beispiel ##height="80"##) oder in prozentualen Anteilen des Anzeigebereichs (Beispiel ##height="40%"##) *** **##width##**: Die horizontale Grösse des angezeigten Bildes. Der Parameterwert sollte entweder in Bildschirmpixeln angeben werden (Beispiel ##width="120"##) oder in prozentualen Anteilen des Anzeigebereichs (Beispiel ##width="80%"##) *** **##title##**: Der Text, der beim Überfahren den Bildes mit dem Mauszeiger angezeigt wird. Beispiel: ##title="Dies ist ein schönes Bild"## *** **##alt##**: Der Text, welcher //alt//ernativ angezeigt wird, wenn der Browser das Bild nicht darstellen kann. Da dies im HTML eine Pflichtangabe ist, verwendet XWiki den Dateinamen, wenn kein Wert für ##alt## angegeben wurde. Beispiel: alt="Ein beispielhaftes Bild" *** **... und mehr**: Die offizielle Liste aller unterstützten Attribute kann auf der offiziellen [[Seite des HTML-Standards>> https://html.spec.whatwg.org/multipage/embedded-content.html#the-img-element]] (in Englisch) eingesehen werden. ** **##queryString##**: Ein optionaler Text, welcher als Abfrageparameter an die URL angehangen wird, unter der das Bild vom Server abgeholt wird. Beispiel: ##queryString="width=100&height=800&keepAspectRatio=true"## (**##keepAspectRatio=true##** soll den Server veranlassen, die Seitenverhältnisse des Bildes beizubehalten, wird aber ignoriert, wenn sowohl ##width## als auch ##height## angegeben werden) |
![]() 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##!**) |
![]() Translation 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##!**)
= Bearbeiten =
== Bilder == {{comment}}please do not translate the sub headlines{{/comment}} === 1.0 Images === |=Funktion|=XWiki Syntax 1.0|=Ergebnis |Bild von Anhang auf aktueller Seite|((( {{info}}Siehe [[Bildmakro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Image%20Macro%20%28Radeox%29]] für Details{{/info}} {{{{image:XWiki.XWikiSyntaxImages@img.png}}}} )))|image:XWiki.XWikiSyntaxImages@img.png |Bild von Anhang auf anderer Seite|{{{{image:img.png|document=Bereich.Seite}}}}|image:XWiki.XWikiSyntaxImages@img.png |Bild mit Parametern|{{{{image:img.png|width=25|height=25}}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]] |Bild befindlich an URL|{{{http://eine/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png === 2.0 Images === |=Funktion|=XWiki Syntax 2.0|=Ergebnis |Bild von Anhang auf aktueller Seite|{{{image:img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Bild von Anhang auf anderer Seite|{{{image:Bereich.Seite@img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Bild mit Parametern|{{{[[image:img.png||width="25" height="25"]]}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]] |Bild mit Bildunterschrift|{{{[[~[~[XWiki~>~>https://www.xwiki.org~]~] unterstützt Bildunterschriften.>>image:img.png]]}}}|(( ([[~[~[XWiki~>~>https://www.xwiki.org~]~] unterstützt Bildunterschriften.>>image:XWiki.XWikiSyntaxImages@img.png]]))) |Bild befindlich an URL|{{{image:http://eine/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png {{velocity}}$subHeading XWiki Syntax 2.0 Bild-Spezifikation $subHeading{{/velocity}} {{info}} Der Teil in ##( )## ist erforderlich, während die Teile in ##{ }## optional sind. {{/info}} Das vollständige Format eines Bilder ist entweder **##image~: (Verweis)##** oder **##~[~[{caption>>}image~: (Verweis) {||Parameter}]]##** * **##caption##**: Eine optionale Beschriftung. Kann beliebige XWiki 2.0-Syntax enthalten, aber verschachtelte Link-Syntax muss mit ##~~## maskiert werden. Die Beschriftung wird nur unterstützt, wenn die Bildsyntax der einzige Inhalt eines Absatzes ist. Das Bild mit der Beschriftung kann auch in einen Link eingebettet sein. In diesem Fall enthält der Link das Bild, aber nicht die Beschriftung. * **##image~:##** Ein erforderlicher Text, welches die folgenden Angaben als Bild kennzeichnet. * **##Verweis##**: Der Verweis auf das anzuzeigende Bild. Der Verweis kann in folgenden Formaten angegeben werden: ** **URL**: Eine URL zu einem externen Bild in dem Format **##http:~/~/pfad/BildName##**. Beispiel: ##http:~/~/example.org/pfad/bild.png## ** **Anhang**: Ein Verweis auf einen Anhang im Wiki im Format **##~{~{~{wikiName:} Bereich.} Seite@} (BildName)##** *** **##wikiName##**: Ein optionaler Text, welcher den Namen eines Subwikis enthält. Das Bild wird dann in dem entsprechenden Subwiki nachgeschlagen. Beispiel: ##meinwiki## *** **##Bereich##**: Der Name eines Bereiches, in dem das Bild nachgeschlagen wird (optional). Wenn kein Bereich angegeben, wird der aktuelle Bereich verwendet. Beispiel: ##Main## *** **##Seite##**: Der Namen einer Seite, an der das Bild angehangen ist (optional). Wird keine Seite angegeben, wird die aktuelle Seite verwendet. Beispiel: ##WebHome## *** **##BildName##**: Ein erforderlicher Text, welcher den Dateinamen des anzuzeigenden Bildes enthält, wie er im Wiki gespeichert ist. * **##Parameter##**: Eine optionale Liste von durch Leerzeichen getrennten Parametern, die an das Bild durchgereicht werden. Beispiel: ##width="800" height="600" alt="Ein beispielhaftes Bild" title="Dies ist ein schönes Bild"## ** **HTML Attribute**: Alle Attribute, welche im HTML Standard vorgesehen sind, werden zu dem erzeugten ##<img>## Element hinzugefügt. *** **##style##**: CSS-Stil Anweisungen, welche auf das Bild angewendet werden. Beispiele: ##style="float:right;height:50px"## (d.h. das Bild wird rechtsbündig eingebettet mit einer Höhe von 50 Pixeln), ##style="style="display:block;margin-left:auto;margin-right:auto;width:80%"## (Bild wird zentriert dargestellt in einer Breite von 80% des zur verfügung stehenden Platzes). ##style="vertical-align:bottom"## (Der folgende Text startet direkt an unteren Ende des Bildes). *** **##height##**: Die vertikale Grösse des angezeigten Bildes. Der Parameterwert sollte entweder in Bildschirmpixeln angeben werden (Beispiel ##height="80"##) oder in prozentualen Anteilen des Anzeigebereichs (Beispiel ##height="40%"##) *** **##width##**: Die horizontale Grösse des angezeigten Bildes. Der Parameterwert sollte entweder in Bildschirmpixeln angeben werden (Beispiel ##width="120"##) oder in prozentualen Anteilen des Anzeigebereichs (Beispiel ##width="80%"##) *** **##title##**: Der Text, der beim Überfahren den Bildes mit dem Mauszeiger angezeigt wird. Beispiel: ##title="Dies ist ein schönes Bild"## *** **##alt##**: Der Text, welcher //alt//ernativ angezeigt wird, wenn der Browser das Bild nicht darstellen kann. Da dies im HTML eine Pflichtangabe ist, verwendet XWiki den Dateinamen, wenn kein Wert für ##alt## angegeben wurde. Beispiel: alt="Ein beispielhaftes Bild" *** **... und mehr**: Die offizielle Liste aller unterstützten Attribute kann auf der offiziellen [[Seite des HTML-Standards>> https://html.spec.whatwg.org/multipage/embedded-content.html#the-img-element]] (in Englisch) eingesehen werden. === 2.1 Images === |=Funktion|=XWiki Syntax 2.1|=Ergebnis |Bild von Anhang auf aktueller Seite|{{{image:img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Bild von Anhang auf anderer Seite|{{{image:Bereich.Seite@img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Bild mit Parametern|{{{[[image:img.png||width="25" height="25"]]}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]] |Bild mit Bildunterschrift|{{{[[~[~[XWiki~>~>https://www.xwiki.org~]~] unterstützt Bildunterschriften.>>image:img.png]]}}}|(( ([[~[~[XWiki~>~>https://www.xwiki.org~]~] unterstützt Bildunterschriften.>>image:XWiki.XWikiSyntaxImages@img.png]]))) |Bild befindlich an URL|{{{image:http://eine/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Vordefiniertes Piktogramm|{{{image:icon:accept}}}|image:icon:accept {{velocity}}$subHeading XWiki Syntax 2.1 Bild-Spezifikation $subHeading{{/velocity}} {{info}} Der Teil in ##( )## ist erforderlich, während die Teile in ##{ }## optional sind. {{/info}} Das vollständige Format eines Bilder ist entweder **##image~: (Verweis)##** oder **##~[~[{caption>>}image~: (Verweis) {||Parameter}]]##** * **##caption##**: Eine optionale Beschriftung. Kann beliebige XWiki 2.1-Syntax enthalten, aber verschachtelte Link-Syntax muss mit ##~~## maskiert werden. Die Beschriftung wird nur unterstützt, wenn die Bildsyntax der einzige Inhalt eines Absatzes ist. Das Bild mit der Beschriftung kann auch in einen Link eingebettet sein. In diesem Fall enthält der Link das Bild, aber nicht die Beschriftung. * **##image~:##** Ein erforderlicher Text, welches die folgenden Angaben als Bild kennzeichnet. * **##Verweis##**: Der Verweis auf das anzuzeigende Bild. Der Verweis kann in folgenden Formaten angegeben werden: ** **URL**: Eine URL zu einem externen Bild in dem Format **##http:~/~/pfad/BildName##**. Beispiel: ##http:~/~/example.org/pfad/bild.png## ** **Anhang**: Ein Verweis auf einen Anhang eines XWiki-Dokuments im Format **##~{~{~{wikiName:} Bereich.} Seite@} (BildName)##** *** **##wikiName##**: Ein optionaler Text, welcher den Namen eines Subwikis enthält. Das Bild wird dann in dem entsprechenden Subwiki nachgeschlagen. Beispiel: ##mywiki## *** **##Bereich##**: Der Name eines Bereiches, in dem das Bild nachgeschlagen wird (optional). Wenn kein Bereich angegeben, wird der aktuelle Bereich verwendet. Beispiel: ##Main## *** **##Seite##**: Der Namen einer Seite, an der das Bild angehangen ist (optional). Wird keine Seite angegeben, wird die aktuelle Seite verwendet. Beispiel: ##WebHome## *** **##BildName##**: Ein erforderlicher Text, welcher den Dateinamen des anzuzeigenden Bildes enthält, wie er im Wiki gespeichert ist. ** **Seiten-Anhang**: Ein Verweis in der Form **##pageAttach~:~{~{~{(wikiName):}(seitenNamenListe)/}(anhangName)##** *** **##pageAttach~:##** Eine erforderliche Zeichenfolge, die die Referenz als Anhang einer XWiki-Seite identifiziert. *** **##wikiName##**: Ein optionaler Text, welcher den Namen eines Subwikis enthält. Das Bild wird dann in dem entsprechenden Subwiki nachgeschlagen. Beispiel: ##mywiki## *** **##seitenNamenListe##**: Eine optionale, durch Punkte getrennte Liste von Wiki-Seitennamen. Wenn keine Seite angegeben ist, wird die aktuelle Seite verwendet. Beispiele: ##Main##, ##A/B##, ##A/B/C## *** **##anhangName##**: Eine erforderliche Zeichenfolge, die den Namen des an eine Seite angehängten Bildes enthält, wie es im Wiki gespeichert ist. Beispiel: ##myImage.png## ** **Piktogramme** Ein Verweis mittels des Textes **##{{{(icon:)}}} (iconName)##**. Beispiel: **##icon:accept##** *** **##icon:##** Ein erforderlicher Text, welcher die folgende Angabe als Piktogramm kennzeichnet. Piktogramme können nur aus der vorinstallierten Liste der [[XWiki Icons>>http://www.famfamfam.com/lab/icons/silk/previews/index_abc.png]] ausgewählt werden. *** **##iconName##**: Ein erforderlicher Text mit dem (englischen) Namen des anzuzeigenden Piktogramms. Beispiel: ##accept## ** **Data URI**s in der Form **##{{{(data:)}}} (bilddaten)##**. Beispiel: **##data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4~/~/8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==##** *** **##data:##** Ein erforderlicher Text, welcher die folgende Angabe als Binärdaten zu interpretieren erlaubt, enstprechend dem [['data' URI Schema>>http://de.wikipedia.org/wiki/Data-URL]]. *** **##bilddaten##**: Angabe zu Dateiformat und Codierung, etwa für PNG-Bilder in Base64-codierung ##{{{image/png;base64,}}}## gefolgt von den Binärdaten des Bildes in der angegebenen textuellen Codierung * **##Parameter##**: Eine optionale Liste von durch Leerzeichen getrennten Parametern, die an das Bild durchgereicht werden. Beispiel: ##width="800" height="600" alt="Ein beispielhaftes Bild" title="Dies ist ein schönes Bild"## ** **HTML Attribute**: Alle Attribute, welche im HTML Standard vorgesehen sind, werden zu dem erzeugten ##<img>## Element hinzugefügt. *** **##style##**: CSS-Stil Anweisungen, welche auf das Bild angewendet werden. Beispiele: ##style="float:right;height:50px"## (d.h. das Bild wird rechtsbündig eingebettet mit einer Höhe von 50 Pixeln), ##style="style="display:block;margin-left:auto;margin-right:auto;width:80%"## (Bild wird zentriert dargestellt in einer Breite von 80% des zur Verfügung stehenden Platzes), ##style="vertical-align:bottom"## (Der folgende Text startet direkt an unteren Ende des Bildes). *** **##height##**: Die vertikale Grösse des angezeigten Bildes. Der Parameterwert sollte entweder in Bildschirmpixeln angeben werden (Beispiel ##height="80"##) oder in prozentualen Anteilen des Anzeigebereichs (Beispiel ##height="40%"##) *** **##width##**: Die horizontale Grösse des angezeigten Bildes. Der Parameterwert sollte entweder in Bildschirmpixeln angeben werden (Beispiel ##width="120"##) oder in prozentualen Anteilen des Anzeigebereichs (Beispiel ##width="80%"##) *** **##title##**: Der Text, der beim Überfahren den Bildes mit dem Mauszeiger angezeigt wird. Beispiel: ##title="Dies ist ein schönes Bild"## *** **##alt##**: Der Text, welcher //alt//ernativ angezeigt wird, wenn der Browser das Bild nicht darstellen kann. Da dies im HTML eine Pflichtangabe ist, verwendet XWiki den Dateinamen, wenn kein Wert für ##alt## angegeben wurde. Beispiel: alt="Ein beispielhaftes Bild" *** **... und mehr**: Die offizielle Liste aller unterstützten Attribute kann auf der offiziellen [[Seite des HTML-Standards>> https://html.spec.whatwg.org/multipage/embedded-content.html#the-img-element]] (in Englisch) eingesehen werden. ** **##queryString##**: Ein optionaler Text, welcher als Abfrageparameter an die URL angehangen wird, unter der das Bild vom Server abgeholt wird. Beispiel: ##queryString="width=100&height=800&keepAspectRatio=true"## (**##keepAspectRatio=true##** soll den Server veranlassen, die Seitenverhältnisse des Bildes beizubehalten, wird aber ignoriert, wenn sowohl ##width## als auch ##height## angegeben werden) |
![]() 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##!**)
= Bearbeiten =
== Bilder == {{comment}}please do not translate the sub headlines{{/comment}} === 1.0 Images === |=Funktion|=XWiki Syntax 1.0|=Ergebnis |Bild von Anhang auf aktueller Seite|((( {{info}}Siehe [[Bildmakro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Image%20Macro%20%28Radeox%29]] für Details{{/info}} {{{{image:XWiki.XWikiSyntaxImages@img.png}}}} )))|image:XWiki.XWikiSyntaxImages@img.png |Bild von Anhang auf anderer Seite|{{{{image:img.png|document=Bereich.Seite}}}}|image:XWiki.XWikiSyntaxImages@img.png |Bild mit Parametern|{{{{image:img.png|width=25|height=25}}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]] |Bild befindlich an URL|{{{http://eine/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png === 2.0 Images === |=Funktion|=XWiki Syntax 2.0|=Ergebnis |Bild von Anhang auf aktueller Seite|{{{image:img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Bild von Anhang auf anderer Seite|{{{image:Bereich.Seite@img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Bild mit Parametern|{{{[[image:img.png||width="25" height="25"]]}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]] |Bild mit Bildunterschrift|{{{[[~[~[XWiki~>~>https://www.xwiki.org~]~] unterstützt Bildunterschriften.>>image:img.png]]}}}|(( ([[~[~[XWiki~>~>https://www.xwiki.org~]~] unterstützt Bildunterschriften.>>image:XWiki.XWikiSyntaxImages@img.png]]))) |Bild befindlich an URL|{{{image:http://eine/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png {{velocity}}$subHeading XWiki Syntax 2.0 Bild-Spezifikation $subHeading{{/velocity}} {{info}} Der Teil in ##( )## ist erforderlich, während die Teile in ##{ }## optional sind. {{/info}} Das vollständige Format eines Bilder ist entweder **##image~: (Verweis)##** oder **##~[~[{caption>>}image~: (Verweis) {||Parameter}]]##** * **##caption##**: Eine optionale Beschriftung. Kann beliebige XWiki 2.0-Syntax enthalten, aber verschachtelte Link-Syntax muss mit ##~~## maskiert werden. Die Beschriftung wird nur unterstützt, wenn die Bildsyntax der einzige Inhalt eines Absatzes ist. * **##image~:##** Ein erforderlicher Text, welches die folgenden Angaben als Bild kennzeichnet. * **##Verweis##**: Der Verweis auf das anzuzeigende Bild. Der Verweis kann in folgenden Formaten angegeben werden: ** **URL**: Eine URL zu einem externen Bild in dem Format **##http:~/~/pfad/BildName##**. Beispiel: ##http:~/~/example.org/pfad/bild.png## ** **Anhang**: Ein Verweis auf einen Anhang im Wiki im Format **##~{~{~{wikiName:} Bereich.} Seite@} (BildName)##** *** **##wikiName##**: Ein optionaler Text, welcher den Namen eines Subwikis enthält. Das Bild wird dann in dem entsprechenden Subwiki nachgeschlagen. Beispiel: ##meinwiki## *** **##Bereich##**: Der Name eines Bereiches, in dem das Bild nachgeschlagen wird (optional). Wenn kein Bereich angegeben, wird der aktuelle Bereich verwendet. Beispiel: ##Main## *** **##Seite##**: Der Namen einer Seite, an der das Bild angehangen ist (optional). Wird keine Seite angegeben, wird die aktuelle Seite verwendet. Beispiel: ##WebHome## *** **##BildName##**: Ein erforderlicher Text, welcher den Dateinamen des anzuzeigenden Bildes enthält, wie er im Wiki gespeichert ist. * **##Parameter##**: Eine optionale Liste von durch Leerzeichen getrennten Parametern, die an das Bild durchgereicht werden. Beispiel: ##width="800" height="600" alt="Ein beispielhaftes Bild" title="Dies ist ein schönes Bild"## ** **HTML Attribute**: Alle Attribute, welche im HTML Standard vorgesehen sind, werden zu dem erzeugten ##<img>## Element hinzugefügt. *** **##style##**: CSS-Stil Anweisungen, welche auf das Bild angewendet werden. Beispiele: ##style="float:right;height:50px"## (d.h. das Bild wird rechtsbündig eingebettet mit einer Höhe von 50 Pixeln), ##style="style="display:block;margin-left:auto;margin-right:auto;width:80%"## (Bild wird zentriert dargestellt in einer Breite von 80% des zur verfügung stehenden Platzes). ##style="vertical-align:bottom"## (Der folgende Text startet direkt an unteren Ende des Bildes). *** **##height##**: Die vertikale Grösse des angezeigten Bildes. Der Parameterwert sollte entweder in Bildschirmpixeln angeben werden (Beispiel ##height="80"##) oder in prozentualen Anteilen des Anzeigebereichs (Beispiel ##height="40%"##) *** **##width##**: Die horizontale Grösse des angezeigten Bildes. Der Parameterwert sollte entweder in Bildschirmpixeln angeben werden (Beispiel ##width="120"##) oder in prozentualen Anteilen des Anzeigebereichs (Beispiel ##width="80%"##) *** **##title##**: Der Text, der beim Überfahren den Bildes mit dem Mauszeiger angezeigt wird. Beispiel: ##title="Dies ist ein schönes Bild"## *** **##alt##**: Der Text, welcher //alt//ernativ angezeigt wird, wenn der Browser das Bild nicht darstellen kann. Da dies im HTML eine Pflichtangabe ist, verwendet XWiki den Dateinamen, wenn kein Wert für ##alt## angegeben wurde. Beispiel: alt="Ein beispielhaftes Bild" *** **... und mehr**: Die offizielle Liste aller unterstützten Attribute kann auf der offiziellen [[Seite des HTML-Standards>> https://html.spec.whatwg.org/multipage/embedded-content.html#the-img-element]] (in Englisch) eingesehen werden. === 2.1 Images === |=Funktion|=XWiki Syntax 2.1|=Ergebnis |Bild von Anhang auf aktueller Seite|{{{image:img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Bild von Anhang auf anderer Seite|{{{image:Bereich.Seite@img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Bild mit Parametern|{{{[[image:img.png||width="25" height="25"]]}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]] |Bild mit Bildunterschrift|{{{[[~[~[XWiki~>~>https://www.xwiki.org~]~] unterstützt Bildunterschriften.>>image:img.png]]}}}|(( ([[~[~[XWiki~>~>https://www.xwiki.org~]~] unterstützt Bildunterschriften.>>image:XWiki.XWikiSyntaxImages@img.png]]))) |Bild befindlich an URL|{{{image:http://eine/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Vordefiniertes Piktogramm|{{{image:icon:accept}}}|image:icon:accept {{velocity}}$subHeading XWiki Syntax 2.1 Bild-Spezifikation $subHeading{{/velocity}} {{info}} Der Teil in ##( )## ist erforderlich, während die Teile in ##{ }## optional sind. {{/info}} Das vollständige Format eines Bilder ist entweder **##image~: (Verweis)##** oder **##~[~[{caption>>}image~: (Verweis) {||Parameter}]]##** * **##caption##**: Eine optionale Beschriftung. Kann beliebige XWiki 2.1-Syntax enthalten, aber verschachtelte Link-Syntax muss mit ##~~## maskiert werden. Die Beschriftung wird nur unterstützt, wenn die Bildsyntax der einzige Inhalt eines Absatzes ist. * **##image~:##** Ein erforderlicher Text, welches die folgenden Angaben als Bild kennzeichnet. * **##Verweis##**: Der Verweis auf das anzuzeigende Bild. Der Verweis kann in folgenden Formaten angegeben werden: ** **URL**: Eine URL zu einem externen Bild in dem Format **##http:~/~/pfad/BildName##**. Beispiel: ##http:~/~/example.org/pfad/bild.png## ** **Anhang**: Ein Verweis auf einen Anhang eines XWiki-Dokuments im Format **##~{~{~{wikiName:} Bereich.} Seite@} (BildName)##** *** **##wikiName##**: Ein optionaler Text, welcher den Namen eines Subwikis enthält. Das Bild wird dann in dem entsprechenden Subwiki nachgeschlagen. Beispiel: ##mywiki## *** **##Bereich##**: Der Name eines Bereiches, in dem das Bild nachgeschlagen wird (optional). Wenn kein Bereich angegeben, wird der aktuelle Bereich verwendet. Beispiel: ##Main## *** **##Seite##**: Der Namen einer Seite, an der das Bild angehangen ist (optional). Wird keine Seite angegeben, wird die aktuelle Seite verwendet. Beispiel: ##WebHome## *** **##BildName##**: Ein erforderlicher Text, welcher den Dateinamen des anzuzeigenden Bildes enthält, wie er im Wiki gespeichert ist. ** **Seiten-Anhang**: Ein Verweis in der Form **##pageAttach~:~{~{~{(wikiName):}(seitenNamenListe)/}(anhangName)##** *** **##pageAttach~:##** Eine erforderliche Zeichenfolge, die die Referenz als Anhang einer XWiki-Seite identifiziert. *** **##wikiName##**: Ein optionaler Text, welcher den Namen eines Subwikis enthält. Das Bild wird dann in dem entsprechenden Subwiki nachgeschlagen. Beispiel: ##mywiki## *** **##seitenNamenListe##**: Eine optionale, durch Punkte getrennte Liste von Wiki-Seitennamen. Wenn keine Seite angegeben ist, wird die aktuelle Seite verwendet. Beispiele: ##Main##, ##A/B##, ##A/B/C## *** **##anhangName##**: Eine erforderliche Zeichenfolge, die den Namen des an eine Seite angehängten Bildes enthält, wie es im Wiki gespeichert ist. Beispiel: ##myImage.png## ** **Piktogramme** Ein Verweis mittels des Textes **##{{{(icon:)}}} (iconName)##**. Beispiel: **##icon:accept##** *** **##icon:##** Ein erforderlicher Text, welcher die folgende Angabe als Piktogramm kennzeichnet. Piktogramme können nur aus der vorinstallierten Liste der [[XWiki Icons>>http://www.famfamfam.com/lab/icons/silk/previews/index_abc.png]] ausgewählt werden. *** **##iconName##**: Ein erforderlicher Text mit dem (englischen) Namen des anzuzeigenden Piktogramms. Beispiel: ##accept## ** **Data URI**s in der Form **##{{{(data:)}}} (bilddaten)##**. Beispiel: **##data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4~/~/8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==##** *** **##data:##** Ein erforderlicher Text, welcher die folgende Angabe als Binärdaten zu interpretieren erlaubt, enstprechend dem [['data' URI Schema>>http://de.wikipedia.org/wiki/Data-URL]]. *** **##bilddaten##**: Angabe zu Dateiformat und Codierung, etwa für PNG-Bilder in Base64-codierung ##{{{image/png;base64,}}}## gefolgt von den Binärdaten des Bildes in der angegebenen textuellen Codierung * **##Parameter##**: Eine optionale Liste von durch Leerzeichen getrennten Parametern, die an das Bild durchgereicht werden. Beispiel: ##width="800" height="600" alt="Ein beispielhaftes Bild" title="Dies ist ein schönes Bild"## ** **HTML Attribute**: Alle Attribute, welche im HTML Standard vorgesehen sind, werden zu dem erzeugten ##<img>## Element hinzugefügt. *** **##style##**: CSS-Stil Anweisungen, welche auf das Bild angewendet werden. Beispiele: ##style="float:right;height:50px"## (d.h. das Bild wird rechtsbündig eingebettet mit einer Höhe von 50 Pixeln), ##style="style="display:block;margin-left:auto;margin-right:auto;width:80%"## (Bild wird zentriert dargestellt in einer Breite von 80% des zur Verfügung stehenden Platzes), ##style="vertical-align:bottom"## (Der folgende Text startet direkt an unteren Ende des Bildes). *** **##height##**: Die vertikale Grösse des angezeigten Bildes. Der Parameterwert sollte entweder in Bildschirmpixeln angeben werden (Beispiel ##height="80"##) oder in prozentualen Anteilen des Anzeigebereichs (Beispiel ##height="40%"##) *** **##width##**: Die horizontale Grösse des angezeigten Bildes. Der Parameterwert sollte entweder in Bildschirmpixeln angeben werden (Beispiel ##width="120"##) oder in prozentualen Anteilen des Anzeigebereichs (Beispiel ##width="80%"##) *** **##title##**: Der Text, der beim Überfahren den Bildes mit dem Mauszeiger angezeigt wird. Beispiel: ##title="Dies ist ein schönes Bild"## *** **##alt##**: Der Text, welcher //alt//ernativ angezeigt wird, wenn der Browser das Bild nicht darstellen kann. Da dies im HTML eine Pflichtangabe ist, verwendet XWiki den Dateinamen, wenn kein Wert für ##alt## angegeben wurde. Beispiel: alt="Ein beispielhaftes Bild" *** **... und mehr**: Die offizielle Liste aller unterstützten Attribute kann auf der offiziellen [[Seite des HTML-Standards>> https://html.spec.whatwg.org/multipage/embedded-content.html#the-img-element]] (in Englisch) eingesehen werden. ** **##queryString##**: Ein optionaler Text, welcher als Abfrageparameter an die URL angehangen wird, unter der das Bild vom Server abgeholt wird. Beispiel: ##queryString="width=100&height=800&keepAspectRatio=true"## (**##keepAspectRatio=true##** soll den Server veranlassen, die Seitenverhältnisse des Bildes beizubehalten, wird aber ignoriert, wenn sowohl ##width## als auch ##height## angegeben werden) |
![]() 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##!**) |
![]() Translation 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## ** **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##!**)
= Bearbeiten =
== Bilder == {{comment}}please do not translate the sub headlines{{/comment}} === 1.0 Images === |=Funktion|=XWiki Syntax 1.0|=Ergebnis |Bild von Anhang auf aktueller Seite|((( {{info}}Siehe [[Bildmakro>>http://extensions.xwiki.org/xwiki/bin/view/Extension/Image+Macro+%28Radeox%29]] für Details{{/info}} {{{{image:XWiki.XWikiSyntaxImages@img.png}}}} )))|image:XWiki.XWikiSyntaxImages@img.png |Bild von Anhang auf anderer Seite|{{{{image:img.png|document=Bereich.Seite}}}}|image:XWiki.XWikiSyntaxImages@img.png |Bild mit Parametern|{{{{image:img.png|width=25|height=25}}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]] |Bild befindlich an URL|{{{http://eine/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png === 2.0 Images === |=Funktion|=XWiki Syntax 2.0|=Ergebnis |Bild von Anhang auf aktueller Seite|{{{image:img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Bild von Anhang auf anderer Seite|{{{image:Bereich.Seite@img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Bild mit Parametern|{{{[[image:img.png||width="25" height="25"]]}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]] |Bild mit Bildunterschrift|{{{[[~[~[XWiki~>~>https://www.xwiki.org~]~] unterstützt Bildunterschriften.>>image:img.png]]}}}|(( ([[~[~[XWiki~>~>https://www.xwiki.org~]~] unterstützt Bildunterschriften.>>image:XWiki.XWikiSyntaxImages@img.png]]))) |Bild befindlich an URL|{{{image:http://eine/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png {{velocity}}$subHeading XWiki Syntax 2.0 Bild-Spezifikation $subHeading{{/velocity}} {{info}} Der Teil in ##( )## ist erforderlich, während die Teile in ##{ }## optional sind. {{/info}} Das vollständige Format eines Bilder ist entweder **##image~: (Verweis)##** oder **##~[~[{caption>>}image~: (Verweis) {||Parameter}]]##** * **##caption##**: Eine optionale Beschriftung. Kann beliebige XWiki 2.0-Syntax enthalten, aber verschachtelte Link-Syntax muss mit ##~~## maskiert werden. Die Beschriftung wird nur unterstützt, wenn die Bildsyntax der einzige Inhalt eines Absatzes ist. * **##image~:##** Ein erforderlicher Text, welches die folgenden Angaben als Bild kennzeichnet. * **##Verweis##**: Der Verweis auf das anzuzeigende Bild. Der Verweis kann in folgenden Formaten angegeben werden: ** **URL**: Eine URL zu einem externen Bild in dem Format **##http:~/~/pfad/BildName##**. Beispiel: ##http:~/~/example.org/pfad/bild.png## ** **Anhang**: Ein Verweis auf einen Anhang im Wiki im Format **##~{~{~{wikiName:} Bereich.} Seite@} (BildName)##** *** **##wikiName##**: Ein optionaler Text, welcher den Namen eines Subwikis enthält. Das Bild wird dann in dem entsprechenden Subwiki nachgeschlagen. Beispiel: ##meinwiki## *** **##Bereich##**: Der Name eines Bereiches, in dem das Bild nachgeschlagen wird (optional). Wenn kein Bereich angegeben, wird der aktuelle Bereich verwendet. Beispiel: ##Main## *** **##Seite##**: Der Namen einer Seite, an der das Bild angehangen ist (optional). Wird keine Seite angegeben, wird die aktuelle Seite verwendet. Beispiel: ##WebHome## *** **##BildName##**: Ein erforderlicher Text, welcher den Dateinamen des anzuzeigenden Bildes enthält, wie er im Wiki gespeichert ist. * **##Parameter##**: Eine optionale Liste von durch Leerzeichen getrennten Parametern, die an das Bild durchgereicht werden. Beispiel: ##width="800" height="600" alt="Ein beispielhaftes Bild" title="Dies ist ein schönes Bild"## ** **HTML Attribute**: Alle Attribute, welche im HTML Standard vorgesehen sind, werden zu dem erzeugten ##<img>## Element hinzugefügt. *** **##style##**: CSS-Stil Anweisungen, welche auf das Bild angewendet werden. Beispiele: ##style="float:right;height:50px"## (d.h. das Bild wird rechtsbündig eingebettet mit einer Höhe von 50 Pixeln), ##style="style="display:block;margin-left:auto;margin-right:auto;width:80%"## (Bild wird zentriert dargestellt in einer Breite von 80% des zur verfügung stehenden Platzes). ##style="vertical-align:bottom"## (Der folgende Text startet direkt an unteren Ende des Bildes). *** **##height##**: Die vertikale Grösse des angezeigten Bildes. Der Parameterwert sollte entweder in Bildschirmpixeln angeben werden (Beispiel ##height="80"##) oder in prozentualen Anteilen des Anzeigebereichs (Beispiel ##height="40%"##) *** **##width##**: Die horizontale Grösse des angezeigten Bildes. Der Parameterwert sollte entweder in Bildschirmpixeln angeben werden (Beispiel ##width="120"##) oder in prozentualen Anteilen des Anzeigebereichs (Beispiel ##width="80%"##) *** **##title##**: Der Text, der beim Überfahren den Bildes mit dem Mauszeiger angezeigt wird. Beispiel: ##title="Dies ist ein schönes Bild"## *** **##alt##**: Der Text, welcher //alt//ernativ angezeigt wird, wenn der Browser das Bild nicht darstellen kann. Da dies im HTML eine Pflichtangabe ist, verwendet XWiki den Dateinamen, wenn kein Wert für ##alt## angegeben wurde. Beispiel: alt="Ein beispielhaftes Bild" *** **... und mehr**: Die offizielle Liste aller unterstützten Attribute kann auf der offiziellen [[Seite des HTML-Standards>> https://html.spec.whatwg.org/multipage/embedded-content.html#the-img-element]] (in Englisch) eingesehen werden. === 2.1 Images === |=Funktion|=XWiki Syntax 2.1|=Ergebnis |Bild von Anhang auf aktueller Seite|{{{image:img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Bild von Anhang auf anderer Seite|{{{image:Bereich.Seite@img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Bild mit Parametern|{{{[[image:img.png||width="25" height="25"]]}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]] |Bild mit Bildunterschrift|{{{[[~[~[XWiki~>~>https://www.xwiki.org~]~] unterstützt Bildunterschriften.>>image:img.png]]}}}|(( ([[~[~[XWiki~>~>https://www.xwiki.org~]~] unterstützt Bildunterschriften.>>image:XWiki.XWikiSyntaxImages@img.png]]))) |Bild befindlich an URL|{{{image:http://eine/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Vordefiniertes Piktogramm|{{{image:icon:accept}}}|image:icon:accept {{velocity}}$subHeading XWiki Syntax 2.1 Bild-Spezifikation $subHeading{{/velocity}} {{info}} Der Teil in ##( )## ist erforderlich, während die Teile in ##{ }## optional sind. {{/info}} Das vollständige Format eines Bilder ist entweder **##image~: (Verweis)##** oder **##~[~[{caption>>}image~: (Verweis) {||Parameter}]]##** * **##caption##**: Eine optionale Beschriftung. Kann beliebige XWiki 2.1-Syntax enthalten, aber verschachtelte Link-Syntax muss mit ##~~## maskiert werden. Die Beschriftung wird nur unterstützt, wenn die Bildsyntax der einzige Inhalt eines Absatzes ist. * **##image~:##** Ein erforderlicher Text, welches die folgenden Angaben als Bild kennzeichnet. * **##Verweis##**: Der Verweis auf das anzuzeigende Bild. Der Verweis kann in folgenden Formaten angegeben werden: ** **URL**: Eine URL zu einem externen Bild in dem Format **##http:~/~/pfad/BildName##**. Beispiel: ##http:~/~/example.org/pfad/bild.png## ** **Anhang**: Ein Verweis auf einen Anhang *** **##wikiName##**: Ein optionaler Text, welcher den Namen eines Subwikis enthält. Das Bild wird dann in dem entsprechenden Subwiki nachgeschlagen. Beispiel: ##mywiki## *** **##Bereich##**: Der Name eines Bereiches, in dem das Bild nachgeschlagen wird (optional). Wenn kein Bereich angegeben, wird der aktuelle Bereich verwendet. Beispiel: ##Main## *** **##Seite##**: Der Namen einer Seite, an der das Bild angehangen ist (optional). Wird keine Seite angegeben, wird die aktuelle Seite verwendet. Beispiel: ##WebHome## ** **Seiten-Anhang**: Ein Verweis in der Form **##pageAttach~:~{~{~{(wikiName):}(seitenNamenListe)/}(anhangName)##** *** **##pageAttach~:##** Eine erforderliche Zeichenfolge, die die Referenz als Anhang einer XWiki-Seite identifiziert. *** **##wikiName##**: Ein optionaler Text, welcher den Namen eines Subwikis enthält. Das Bild wird dann in dem entsprechenden Subwiki nachgeschlagen. Beispiel: ##mywiki## *** **##seitenNamenListe##**: Eine optionale, durch Punkte getrennte Liste von Wiki-Seitennamen. Wenn keine Seite angegeben ist, wird die aktuelle Seite verwendet. Beispiele: ##Main##, ##A/B##, ##A/B/C## *** **##anhangName##**: Eine erforderliche Zeichenfolge, die den Namen des an eine Seite angehängten Bildes enthält, wie es im Wiki gespeichert ist. Beispiel: ##myImage.png## ** **Piktogramme** Ein Verweis mittels des Textes **##{{{(icon:)}}} (iconName)##**. Beispiel: **##icon:accept##** *** **##icon:##** Ein erforderlicher Text, welcher die folgende Angabe als Piktogramm kennzeichnet. Piktogramme können nur aus der vorinstallierten Liste der [[XWiki Icons>>http://www.famfamfam.com/lab/icons/silk/previews/index_abc.png]] ausgewählt werden. *** **##iconName##**: Ein erforderlicher Text mit dem (englischen) Namen des anzuzeigenden Piktogramms. Beispiel: ##accept## ** **Data URI**s in der Form **##{{{(data:)}}} (bilddaten)##**. Beispiel: **##data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4~/~/8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==##** *** **##data:##** Ein erforderlicher Text, welcher die folgende Angabe als Binärdaten zu interpretieren erlaubt, enstprechend dem [['data' URI Schema>>http://de.wikipedia.org/wiki/Data-URL]]. *** **##bilddaten##**: Angabe zu Dateiformat und Codierung, etwa für PNG-Bilder in Base64-codierung ##{{{image/png;base64,}}}## gefolgt von den Binärdaten des Bildes in der angegebenen textuellen Codierung * **##Parameter##**: Eine optionale Liste von durch Leerzeichen getrennten Parametern, die an das Bild durchgereicht werden. Beispiel: ##width="800" height="600" alt="Ein beispielhaftes Bild" title="Dies ist ein schönes Bild"## ** **HTML Attribute**: Alle Attribute, welche im HTML Standard vorgesehen sind, werden zu dem erzeugten ##<img>## Element hinzugefügt. *** **##style##**: CSS-Stil Anweisungen, welche auf das Bild angewendet werden. Beispiele: ##style="float:right;height:50px"## (d.h. das Bild wird rechtsbündig eingebettet mit einer Höhe von 50 Pixeln), ##style="style="display:block;margin-left:auto;margin-right:auto;width:80%"## (Bild wird zentriert dargestellt in einer Breite von 80% des zur Verfügung stehenden Platzes), ##style="vertical-align:bottom"## (Der folgende Text startet direkt an unteren Ende des Bildes). *** **##height##**: Die vertikale Grösse des angezeigten Bildes. Der Parameterwert sollte entweder in Bildschirmpixeln angeben werden (Beispiel ##height="80"##) oder in prozentualen Anteilen des Anzeigebereichs (Beispiel ##height="40%"##) *** **##width##**: Die horizontale Grösse des angezeigten Bildes. Der Parameterwert sollte entweder in Bildschirmpixeln angeben werden (Beispiel ##width="120"##) oder in prozentualen Anteilen des Anzeigebereichs (Beispiel ##width="80%"##) *** **##title##**: Der Text, der beim Überfahren den Bildes mit dem Mauszeiger angezeigt wird. Beispiel: ##title="Dies ist ein schönes Bild"## *** **##alt##**: Der Text, welcher //alt//ernativ angezeigt wird, wenn der Browser das Bild nicht darstellen kann. Da dies im HTML eine Pflichtangabe ist, verwendet XWiki den Dateinamen, wenn kein Wert für ##alt## angegeben wurde. Beispiel: alt="Ein beispielhaftes Bild" *** **... und mehr**: Die offizielle Liste aller unterstützten Attribute kann auf der offiziellen [[Seite des HTML-Standards>> https://html.spec.whatwg.org/multipage/embedded-content.html#the-img-element]] (in Englisch) eingesehen werden. ** **##queryString##**: Ein optionaler Text, welcher als Abfrageparameter an die URL angehangen wird, unter der das Bild vom Server abgeholt wird. Beispiel: ##queryString="width=100&height=800&keepAspectRatio=true"## (**##keepAspectRatio=true##** soll den Server veranlassen, die Seitenverhältnisse des Bildes beizubehalten, wird aber ignoriert, wenn sowohl ##width## als auch ##height## angegeben werden) |
![]() 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 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. * **##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##!**) |
![]() Translation 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## ** **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##!**)
= Bearbeiten =
== Bilder == {{comment}}please do not translate the sub headlines{{/comment}} === 1.0 Images === |=Funktion|=XWiki Syntax 1.0|=Ergebnis |Bild von Anhang auf aktueller Seite|((( {{info}}Siehe [[Bildmakro>>http://extensions.xwiki.org/xwiki/bin/view/Extension/Image+Macro+%28Radeox%29]] für Details{{/info}} {{{{image:XWiki.XWikiSyntaxImages@img.png}}}} )))|image:XWiki.XWikiSyntaxImages@img.png |Bild von Anhang auf anderer Seite|{{{{image:img.png|document=Bereich.Seite}}}}|image:XWiki.XWikiSyntaxImages@img.png |Bild mit Parametern|{{{{image:img.png|width=25|height=25}}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]] |Bild befindlich an URL|{{{http://eine/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png === 2.0 Images === |=Funktion|=XWiki Syntax 2.0|=Ergebnis |Bild von Anhang auf aktueller Seite|{{{image:img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Bild von Anhang auf anderer Seite|{{{image:Bereich.Seite@img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Bild mit Parametern|{{{[[image:img.png||width="25" height="25"]]}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]] |Bild mit Bildunterschrift|{{{[[~[~[XWiki~>~>https://www.xwiki.org~]~] unterstützt Bildunterschriften.>>image:img.png]]}}}|(( ([[~[~[XWiki~>~>https://www.xwiki.org~]~] unterstützt Bildunterschriften.>>image:XWiki.XWikiSyntaxImages@img.png]]))) |Bild befindlich an URL|{{{image:http://eine/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png {{velocity}}$subHeading XWiki Syntax 2.0 Bild-Spezifikation $subHeading{{/velocity}} {{info}} Der Teil in ##( )## ist erforderlich, während die Teile in ##{ }## optional sind. {{/info}} Das vollständige Format eines Bilder ist entweder **##image~: (Verweis)##** oder **##~[~[{caption>>}image~: (Verweis) {||Parameter}]]##** * **##caption##**: Eine optionale Beschriftung. Kann beliebige XWiki 2.0-Syntax enthalten, aber verschachtelte Link-Syntax muss mit ##~~## maskiert werden. Die Beschriftung wird nur unterstützt, wenn die Bildsyntax der einzige Inhalt eines Absatzes ist. * **##image~:##** Ein erforderlicher Text, welches die folgenden Angaben als Bild kennzeichnet. * **##Verweis##**: Der Verweis auf das anzuzeigende Bild. Der Verweis kann in folgenden Formaten angegeben werden: ** **URL**: Eine URL zu einem externen Bild in dem Format **##http:~/~/pfad/BildName##**. Beispiel: ##http:~/~/example.org/pfad/bild.png## ** **Anhang**: Ein Verweis auf einen Anhang im Wiki im Format **##~{~{~{wikiName:} Bereich.} Seite@} (BildName)##** *** **##wikiName##**: Ein optionaler Text, welcher den Namen eines Subwikis enthält. Das Bild wird dann in dem entsprechenden Subwiki nachgeschlagen. Beispiel: ##meinwiki## *** **##Bereich##**: Der Name eines Bereiches, in dem das Bild nachgeschlagen wird (optional). Wenn kein Bereich angegeben, wird der aktuelle Bereich verwendet. Beispiel: ##Main## *** **##Seite##**: Der Namen einer Seite, an der das Bild angehangen ist (optional). Wird keine Seite angegeben, wird die aktuelle Seite verwendet. Beispiel: ##WebHome## *** **##BildName##**: Ein erforderlicher Text, welcher den Dateinamen des anzuzeigenden Bildes enthält, wie er im Wiki gespeichert ist. * **##Parameter##**: Eine optionale Liste von durch Leerzeichen getrennten Parametern, die an das Bild durchgereicht werden. Beispiel: ##width="800" height="600" alt="Ein beispielhaftes Bild" title="Dies ist ein schönes Bild"## ** **HTML Attribute**: Alle Attribute, welche im HTML Standard vorgesehen sind, werden zu dem erzeugten ##<img>## Element hinzugefügt. *** **##style##**: CSS-Stil Anweisungen, welche auf das Bild angewendet werden. Beispiele: ##style="float:right;height:50px"## (d.h. das Bild wird rechtsbündig eingebettet mit einer Höhe von 50 Pixeln), ##style="style="display:block;margin-left:auto;margin-right:auto;width:80%"## (Bild wird zentriert dargestellt in einer Breite von 80% des zur verfügung stehenden Platzes). ##style="vertical-align:bottom"## (Der folgende Text startet direkt an unteren Ende des Bildes). *** **##height##**: Die vertikale Grösse des angezeigten Bildes. Der Parameterwert sollte entweder in Bildschirmpixeln angeben werden (Beispiel ##height="80"##) oder in prozentualen Anteilen des Anzeigebereichs (Beispiel ##height="40%"##) *** **##width##**: Die horizontale Grösse des angezeigten Bildes. Der Parameterwert sollte entweder in Bildschirmpixeln angeben werden (Beispiel ##width="120"##) oder in prozentualen Anteilen des Anzeigebereichs (Beispiel ##width="80%"##) *** **##title##**: Der Text, der beim Überfahren den Bildes mit dem Mauszeiger angezeigt wird. Beispiel: ##title="Dies ist ein schönes Bild"## *** **##alt##**: Der Text, welcher //alt//ernativ angezeigt wird, wenn der Browser das Bild nicht darstellen kann. Da dies im HTML eine Pflichtangabe ist, verwendet XWiki den Dateinamen, wenn kein Wert für ##alt## angegeben wurde. Beispiel: alt="Ein beispielhaftes Bild" *** **... und mehr**: Die offizielle Liste aller unterstützten Attribute kann auf der offiziellen [[ === 2.1 Images === |=Funktion|=XWiki Syntax 2.1|=Ergebnis |Bild von Anhang auf aktueller Seite|{{{image:img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Bild von Anhang auf anderer Seite|{{{image:Bereich.Seite@img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Bild mit Parametern|{{{[[image:img.png||width="25" height="25"]]}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]] |Bild mit Bildunterschrift|{{{[[~[~[XWiki~>~>https://www.xwiki.org~]~] unterstützt Bildunterschriften.>>image:img.png]]}}}|(( ([[~[~[XWiki~>~>https://www.xwiki.org~]~] unterstützt Bildunterschriften.>>image:XWiki.XWikiSyntaxImages@img.png]]))) |Bild befindlich an URL|{{{image:http://eine/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png |Vordefiniertes Piktogramm|{{{image:icon:accept}}}|image:icon:accept {{velocity}}$subHeading XWiki Syntax 2.1 Bild-Spezifikation $subHeading{{/velocity}} {{info}} Der Teil in ##( )## ist erforderlich, während die Teile in ##{ }## optional sind. {{/info}} Das vollständige Format eines Bilder ist entweder **##image~: (Verweis)##** oder **##~[~[{caption>>}image~: (Verweis) {||Parameter}]]##** * **##caption##**: Eine optionale Beschriftung. Kann beliebige XWiki 2.1-Syntax enthalten, aber verschachtelte Link-Syntax muss mit ##~~## maskiert werden. Die Beschriftung wird nur unterstützt, wenn die Bildsyntax der einzige Inhalt eines Absatzes ist. * **##image~:##** Ein erforderlicher Text, welches die folgenden Angaben als Bild kennzeichnet. * **##Verweis##**: Der Verweis auf das anzuzeigende Bild. Der Verweis kann in folgenden Formaten angegeben werden: ** **URL**: Eine URL zu einem externen Bild in dem Format **##http:~/~/pfad/BildName##**. Beispiel: ##http:~/~/example.org/pfad/bild.png## ** **Anhang**: Ein Verweis auf einen Anhang im Wiki im Format **##~{~{~{wikiName:} Bereich.} Seite@} (BildName)##** *** **##wikiName##**: Ein optionaler Text, welcher den Namen eines Subwikis enthält. Das Bild wird dann in dem entsprechenden Subwiki nachgeschlagen. Beispiel: ##mywiki## *** **##Bereich##**: Der Name eines Bereiches, in dem das Bild nachgeschlagen wird (optional). Wenn kein Bereich angegeben, wird der aktuelle Bereich verwendet. Beispiel: ##Main## *** **##Seite##**: Der Namen einer Seite, an der das Bild angehangen ist (optional). Wird keine Seite angegeben, wird die aktuelle Seite verwendet. Beispiel: ##WebHome## *** **##BildName##**: Ein erforderlicher Text, welcher den Dateinamen des anzuzeigenden Bildes enthält, wie er im Wiki gespeichert ist. ** **Piktogramme** Ein Verweis mittels des Textes **##{{{(icon:)}}} (iconName)##**. Beispiel: **##icon:accept##** *** **##icon:##** Ein erforderlicher Text, welcher die folgende Angabe als Piktogramm kennzeichnet. Piktogramme können nur aus der vorinstallierten Liste der [[XWiki Icons>>http://www.famfamfam.com/lab/icons/silk/previews/index_abc.png]] ausgewählt werden. *** **##iconName##**: Ein erforderlicher Text mit dem (englischen) Namen des anzuzeigenden Piktogramms. Beispiel: ##accept## ** **Data URI**s in der Form **##{{{(data:)}}} (bilddaten)##**. Beispiel: **##data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4~/~/8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==##** *** **##data:##** Ein erforderlicher Text, welcher die folgende Angabe als Binärdaten zu interpretieren erlaubt, enstprechend dem [['data' URI Schema>>http://de.wikipedia.org/wiki/Data-URL]]. *** **##bilddaten##**: Angabe zu Dateiformat und Codierung, etwa für PNG-Bilder in Base64-codierung ##{{{image/png;base64,}}}## gefolgt von den Binärdaten des Bildes in der angegebenen textuellen Codierung * **##Parameter##**: Eine optionale Liste von durch Leerzeichen getrennten Parametern, die an das Bild durchgereicht werden. Beispiel: ##width="800" height="600" alt="Ein beispielhaftes Bild" title="Dies ist ein schönes Bild"## ** **HTML Attribute**: Alle Attribute, welche im HTML Standard vorgesehen sind, werden zu dem erzeugten ##<img>## Element hinzugefügt. *** **##style##**: CSS-Stil Anweisungen, welche auf das Bild angewendet werden. Beispiele: ##style="float:right;height:50px"## (d.h. das Bild wird rechtsbündig eingebettet mit einer Höhe von 50 Pixeln), ##style="style="display:block;margin-left:auto;margin-right:auto;width:80%"## (Bild wird zentriert dargestellt in einer Breite von 80% des zur Verfügung stehenden Platzes), ##style="vertical-align:bottom"## (Der folgende Text startet direkt an unteren Ende des Bildes). *** **##height##**: Die vertikale Grösse des angezeigten Bildes. Der Parameterwert sollte entweder in Bildschirmpixeln angeben werden (Beispiel ##height="80"##) oder in prozentualen Anteilen des Anzeigebereichs (Beispiel ##height="40%"##) *** **##width##**: Die horizontale Grösse des angezeigten Bildes. Der Parameterwert sollte entweder in Bildschirmpixeln angeben werden (Beispiel ##width="120"##) oder in prozentualen Anteilen des Anzeigebereichs (Beispiel ##width="80%"##) *** **##title##**: Der Text, der beim Überfahren den Bildes mit dem Mauszeiger angezeigt wird. Beispiel: ##title="Dies ist ein schönes Bild"## *** **##alt##**: Der Text, welcher //alt//ernativ angezeigt wird, wenn der Browser das Bild nicht darstellen kann. Da dies im HTML eine Pflichtangabe ist, verwendet XWiki den Dateinamen, wenn kein Wert für ##alt## angegeben wurde. Beispiel: alt="Ein beispielhaftes Bild" *** **... und mehr**: Die offizielle Liste aller unterstützten Attribute kann auf der offiziellen [[ ** **##queryString##**: Ein optionaler Text, welcher als Abfrageparameter an die URL angehangen wird, unter der das Bild vom Server abgeholt wird. Beispiel: ##queryString="width=100&height=800&keepAspectRatio=true"## (**##keepAspectRatio=true##** soll den Server veranlassen, die Seitenverhältnisse des Bildes beizubehalten, wird aber ignoriert, wenn sowohl ##width## als auch ##height## angegeben werden) |
![]() 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 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 [[ === 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. * **##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 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## ** **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 [[ ** **##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##!**) |
![User avatar](/avatar/32/shirahara.png)
Source string comment
The block under "** Icon: A reference in the form ##icon{{{:(}}}iconName)##. Example: ##icon:accept##" is duplicated.
![User avatar](/avatar/32/petrenkonikita112263.png)
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##
== 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##!**)
== Bilder ==
{{comment}}please do not translate the sub headlines{{/comment}}
=== 1.0 Images ===
|=Funktion|=XWiki Syntax 1.0|=Ergebnis
|Bild von Anhang auf aktueller Seite|(((
{{info}}Siehe [[Bildmakro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Image%20Macro%20%28Radeox%29]] für Details{{/info}}
{{{{image:XWiki.XWikiSyntaxImages@img.png}}}}
)))|image:XWiki.XWikiSyntaxImages@img.png
|Bild von Anhang auf anderer Seite|{{{{image:img.png|document=Bereich.Seite}}}}|image:XWiki.XWikiSyntaxImages@img.png
|Bild mit Parametern|{{{{image:img.png|width=25|height=25}}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]]
|Bild befindlich an URL|{{{http://eine/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png
=== 2.0 Images ===
|=Funktion|=XWiki Syntax 2.0|=Ergebnis
|Bild von Anhang auf aktueller Seite|{{{image:img.png}}}|image:XWiki.XWikiSyntaxImages@img.png
|Bild von Anhang auf anderer Seite|{{{image:Bereich.Seite@img.png}}}|image:XWiki.XWikiSyntaxImages@img.png
|Bild mit Parametern|{{{[[image:img.png||width="25" height="25"]]}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]]
|Bild mit Bildunterschrift|{{{[[~[~[XWiki~>~>https://www.xwiki.org~]~] unterstützt Bildunterschriften.>>image:img.png]]}}}|(( ([[~[~[XWiki~>~>https://www.xwiki.org~]~] unterstützt Bildunterschriften.>>image:XWiki.XWikiSyntaxImages@img.png]])))
|Bild befindlich an URL|{{{image:http://eine/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png
{{velocity}}$subHeading XWiki Syntax 2.0 Bild-Spezifikation $subHeading{{/velocity}}
{{info}}
Der Teil in ##( )## ist erforderlich, während die Teile in ##{ }## optional sind.
{{/info}}
Das vollständige Format eines Bilder ist entweder **##image~: (Verweis)##** oder **##~[~[{caption>>}image~: (Verweis) {||Parameter}]]##**
* **##caption##**: Eine optionale Beschriftung. Kann beliebige XWiki 2.0-Syntax enthalten, aber verschachtelte Link-Syntax muss mit ##~~## maskiert werden. Die Beschriftung wird nur unterstützt, wenn die Bildsyntax der einzige Inhalt eines Absatzes ist. Das Bild mit der Beschriftung kann auch in einen Link eingebettet sein. In diesem Fall enthält der Link das Bild, aber nicht die Beschriftung.
* **##image~:##** Ein erforderlicher Text, welches die folgenden Angaben als Bild kennzeichnet.
* **##Verweis##**: Der Verweis auf das anzuzeigende Bild. Der Verweis kann in folgenden Formaten angegeben werden:
** **URL**: Eine URL zu einem externen Bild in dem Format **##http:~/~/pfad/BildName##**. Beispiel: ##http:~/~/example.org/pfad/bild.png##
** **Anhang**: Ein Verweis auf einen Anhang im Wiki im Format **##~{~{~{wikiName:} Bereich.} Seite@} (BildName)##**
*** **##wikiName##**: Ein optionaler Text, welcher den Namen eines Subwikis enthält. Das Bild wird dann in dem entsprechenden Subwiki nachgeschlagen. Beispiel: ##meinwiki##
*** **##Bereich##**: Der Name eines Bereiches, in dem das Bild nachgeschlagen wird (optional). Wenn kein Bereich angegeben, wird der aktuelle Bereich verwendet. Beispiel: ##Main##
*** **##Seite##**: Der Namen einer Seite, an der das Bild angehangen ist (optional). Wird keine Seite angegeben, wird die aktuelle Seite verwendet. Beispiel: ##WebHome##
*** **##BildName##**: Ein erforderlicher Text, welcher den Dateinamen des anzuzeigenden Bildes enthält, wie er im Wiki gespeichert ist.
* **##Parameter##**: Eine optionale Liste von durch Leerzeichen getrennten Parametern, die an das Bild durchgereicht werden. Beispiel: ##width="800" height="600" alt="Ein beispielhaftes Bild" title="Dies ist ein schönes Bild"##
** **HTML Attribute**: Alle Attribute, welche im HTML Standard vorgesehen sind, werden zu dem erzeugten ##<img>## Element hinzugefügt.
*** **##style##**: CSS-Stil Anweisungen, welche auf das Bild angewendet werden. Beispiele: ##style="float:right;height:50px"## (d.h. das Bild wird rechtsbündig eingebettet mit einer Höhe von 50 Pixeln),
##style="style="display:block;margin-left:auto;margin-right:auto;width:80%"## (Bild wird zentriert dargestellt in einer Breite von 80% des zur verfügung stehenden Platzes).
##style="vertical-align:bottom"## (Der folgende Text startet direkt an unteren Ende des Bildes).
*** **##height##**: Die vertikale Grösse des angezeigten Bildes. Der Parameterwert sollte entweder in Bildschirmpixeln angeben werden (Beispiel ##height="80"##) oder in prozentualen Anteilen des Anzeigebereichs (Beispiel ##height="40%"##)
*** **##width##**: Die horizontale Grösse des angezeigten Bildes. Der Parameterwert sollte entweder in Bildschirmpixeln angeben werden (Beispiel ##width="120"##) oder in prozentualen Anteilen des Anzeigebereichs (Beispiel ##width="80%"##)
*** **##title##**: Der Text, der beim Überfahren den Bildes mit dem Mauszeiger angezeigt wird. Beispiel: ##title="Dies ist ein schönes Bild"##
*** **##alt##**: Der Text, welcher //alt//ernativ angezeigt wird, wenn der Browser das Bild nicht darstellen kann. Da dies im HTML eine Pflichtangabe ist, verwendet XWiki den Dateinamen, wenn kein Wert für ##alt## angegeben wurde. Beispiel: alt="Ein beispielhaftes Bild"
*** **... und mehr**: Die offizielle Liste aller unterstützten Attribute kann auf der offiziellen [[Seite des HTML-Standards>> https://html.spec.whatwg.org/multipage/embedded-content.html#the-img-element]] (in Englisch) eingesehen werden.
=== 2.1 Images ===
|=Funktion|=XWiki Syntax 2.1|=Ergebnis
|Bild von Anhang auf aktueller Seite|{{{image:img.png}}}|image:XWiki.XWikiSyntaxImages@img.png
|Bild von Anhang auf anderer Seite|{{{image:Bereich.Seite@img.png}}}|image:XWiki.XWikiSyntaxImages@img.png
|Bild mit Parametern|{{{[[image:img.png||width="25" height="25"]]}}}|[[image:XWiki.XWikiSyntaxImages@img.png||width="25" height="25"]]
|Bild mit Bildunterschrift|{{{[[~[~[XWiki~>~>https://www.xwiki.org~]~] unterstützt Bildunterschriften.>>image:img.png]]}}}|(( ([[~[~[XWiki~>~>https://www.xwiki.org~]~] unterstützt Bildunterschriften.>>image:XWiki.XWikiSyntaxImages@img.png]])))
|Bild befindlich an URL|{{{image:http://eine/url/img.png}}}|image:XWiki.XWikiSyntaxImages@img.png
|Vordefiniertes Piktogramm|{{{image:icon:accept}}}|image:icon:accept
{{velocity}}$subHeading XWiki Syntax 2.1 Bild-Spezifikation $subHeading{{/velocity}}
{{info}}
Der Teil in ##( )## ist erforderlich, während die Teile in ##{ }## optional sind.
{{/info}}
Das vollständige Format eines Bilder ist entweder **##image~: (Verweis)##** oder **##~[~[{caption>>}image~: (Verweis) {||Parameter}]]##**
* **##caption##**: Eine optionale Beschriftung. Kann beliebige XWiki 2.1-Syntax enthalten, aber verschachtelte Link-Syntax muss mit ##~~## maskiert werden. Die Beschriftung wird nur unterstützt, wenn die Bildsyntax der einzige Inhalt eines Absatzes ist. Das Bild mit der Beschriftung kann auch in einen Link eingebettet sein. In diesem Fall enthält der Link das Bild, aber nicht die Beschriftung.
* **##image~:##** Ein erforderlicher Text, welches die folgenden Angaben als Bild kennzeichnet.
* **##Verweis##**: Der Verweis auf das anzuzeigende Bild. Der Verweis kann in folgenden Formaten angegeben werden:
** **URL**: Eine URL zu einem externen Bild in dem Format **##http:~/~/pfad/BildName##**. Beispiel: ##http:~/~/example.org/pfad/bild.png##
** **Anhang**: Ein Verweis auf einen Anhang eines XWiki-Dokuments im Format **##~{~{~{wikiName:} Bereich.} Seite@} (BildName)##**
*** **##wikiName##**: Ein optionaler Text, welcher den Namen eines Subwikis enthält. Das Bild wird dann in dem entsprechenden Subwiki nachgeschlagen. Beispiel: ##mywiki##
*** **##Bereich##**: Der Name eines Bereiches, in dem das Bild nachgeschlagen wird (optional). Wenn kein Bereich angegeben, wird der aktuelle Bereich verwendet. Beispiel: ##Main##
*** **##Seite##**: Der Namen einer Seite, an der das Bild angehangen ist (optional). Wird keine Seite angegeben, wird die aktuelle Seite verwendet. Beispiel: ##WebHome##
*** **##BildName##**: Ein erforderlicher Text, welcher den Dateinamen des anzuzeigenden Bildes enthält, wie er im Wiki gespeichert ist.
** **Seiten-Anhang**: Ein Verweis in der Form **##pageAttach~:~{~{~{(wikiName):}(seitenNamenListe)/}(anhangName)##**
*** **##pageAttach~:##** Eine erforderliche Zeichenfolge, die die Referenz als Anhang einer XWiki-Seite identifiziert.
*** **##wikiName##**: Ein optionaler Text, welcher den Namen eines Subwikis enthält. Das Bild wird dann in dem entsprechenden Subwiki nachgeschlagen. Beispiel: ##mywiki##
*** **##seitenNamenListe##**: Eine optionale, durch Punkte getrennte Liste von Wiki-Seitennamen. Wenn keine Seite angegeben ist, wird die aktuelle Seite verwendet. Beispiele: ##Main##, ##A/B##, ##A/B/C##
*** **##anhangName##**: Eine erforderliche Zeichenfolge, die den Namen des an eine Seite angehängten Bildes enthält, wie es im Wiki gespeichert ist. Beispiel: ##myImage.png##
** **Piktogramme** Ein Verweis mittels des Textes **##{{{(icon:)}}} (iconName)##**. Beispiel: **##icon:accept##**
*** **##icon:##** Ein erforderlicher Text, welcher die folgende Angabe als Piktogramm kennzeichnet. Piktogramme können nur aus der vorinstallierten Liste der [[XWiki Icons>>http://www.famfamfam.com/lab/icons/silk/previews/index_abc.png]] ausgewählt werden.
*** **##iconName##**: Ein erforderlicher Text mit dem (englischen) Namen des anzuzeigenden Piktogramms. Beispiel: ##accept##
** **Data URI**s in der Form **##{{{(data:)}}} (bilddaten)##**. Beispiel: **##data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4~/~/8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==##**
*** **##data:##** Ein erforderlicher Text, welcher die folgende Angabe als Binärdaten zu interpretieren erlaubt, enstprechend dem [['data' URI Schema>>http://de.wikipedia.org/wiki/Data-URL]].
*** **##bilddaten##**: Angabe zu Dateiformat und Codierung, etwa für PNG-Bilder in Base64-codierung ##{{{image/png;base64,}}}## gefolgt von den Binärdaten des Bildes in der angegebenen textuellen Codierung
* **##Parameter##**: Eine optionale Liste von durch Leerzeichen getrennten Parametern, die an das Bild durchgereicht werden. Beispiel: ##width="800" height="600" alt="Ein beispielhaftes Bild" title="Dies ist ein schönes Bild"##
** **HTML Attribute**: Alle Attribute, welche im HTML Standard vorgesehen sind, werden zu dem erzeugten ##<img>## Element hinzugefügt.
*** **##style##**: CSS-Stil Anweisungen, welche auf das Bild angewendet werden. Beispiele: ##style="float:right;height:50px"## (d.h. das Bild wird rechtsbündig eingebettet mit einer Höhe von 50 Pixeln),
##style="style="display:block;margin-left:auto;margin-right:auto;width:80%"## (Bild wird zentriert dargestellt in einer Breite von 80% des zur Verfügung stehenden Platzes),
##style="vertical-align:bottom"## (Der folgende Text startet direkt an unteren Ende des Bildes).
*** **##height##**: Die vertikale Grösse des angezeigten Bildes. Der Parameterwert sollte entweder in Bildschirmpixeln angeben werden (Beispiel ##height="80"##) oder in prozentualen Anteilen des Anzeigebereichs (Beispiel ##height="40%"##)
*** **##width##**: Die horizontale Grösse des angezeigten Bildes. Der Parameterwert sollte entweder in Bildschirmpixeln angeben werden (Beispiel ##width="120"##) oder in prozentualen Anteilen des Anzeigebereichs (Beispiel ##width="80%"##)
*** **##title##**: Der Text, der beim Überfahren den Bildes mit dem Mauszeiger angezeigt wird. Beispiel: ##title="Dies ist ein schönes Bild"##
*** **##alt##**: Der Text, welcher //alt//ernativ angezeigt wird, wenn der Browser das Bild nicht darstellen kann. Da dies im HTML eine Pflichtangabe ist, verwendet XWiki den Dateinamen, wenn kein Wert für ##alt## angegeben wurde. Beispiel: alt="Ein beispielhaftes Bild"
*** **... und mehr**: Die offizielle Liste aller unterstützten Attribute kann auf der offiziellen [[Seite des HTML-Standards>> https://html.spec.whatwg.org/multipage/embedded-content.html#the-img-element]] (in Englisch) eingesehen werden.
** **##queryString##**: Ein optionaler Text, welcher als Abfrageparameter an die URL angehangen wird, unter der das Bild vom Server abgeholt wird. Beispiel: ##queryString="width=100&height=800&keepAspectRatio=true"## (**##keepAspectRatio=true##** soll den Server veranlassen, die Seitenverhältnisse des Bildes beizubehalten, wird aber ignoriert, wenn sowohl ##width## als auch ##height## angegeben werden)