#eimage

The full syntax for displaying an image is:

{{#eimage:image|options|caption}}

Refer to http://www.mediawiki.org/wiki/Help:Images for detailed descriptions. Below is a list of options available in EImage:

First parameter, URL of the image to display. If a raw URL is entered, you will need to also specify the width and height. If you want use image from local wiki, we can use Magic word {{filepath:…}}, which can be parametrized. For example:

{{#eimage:{{filepath:image.svg}}|{{#eimgh:image.svg}}x{{#eimgw:image.svg}}px|frameless|link={{fullurl:image.svg}}}}

Next usable options:

Format : border or frameless

Resizing : {width}x{height}px

Horizontal alignment : one of inline and/or left, right, center, none

Position : inline, displays the image(+frame) inline instead of as a floating block (it overrides the float option). Works best with none. Useful for displaying multiple thumbnails on one line.

Vertical alignment : one of baseline, sub, super, top, text-top, middle, bottom, text-bottom

Link : link={target} Currently only links that start with http/https/ftp are supported.

These options change the defaults for all annotations in an image (not all images). If no annotations are used, these are ignored:

Horizontal alignment : aalign=

Background color : abg= (default is transparent)

Font family : afamily=

Font size : asize=

Font weight : aweight=

Font style : astyle=

Font shadow : ashadow=

Font color : acolor=

Line height : aheight=

Last position parameter is accepted every as alternative note of image.

Some examples:

{{#eimage:http://upload.wikimedia.org/wikipedia/mediawiki/e/e1/Eimage_example.png|410x579px}}

If wiki has configured by Manual:$wgForeignFileRepos using images from another wiki, i.e. commons.wikimedia.org, we can use function #epath

{{#eimage:https://upload.wikimedia.org{{#epath:File:Wikimedia Hackathon Prague 2019 - Group Photo - CLK - cropped.jpg}}|200x400px}}

If use local image, you can use functions #earea:

{{#eimage:{{filepath:localimage.svg}}|{{#earea:localimage.svg}}px}}

or #eimgh and #eimgw, which can be use wit combination with parserfunctions, for dynamic resize.

{{#eimage:{{filepath:image.svg}}|{{#eimgh:image.svg}}x{{#eimgw:image.svg}}px|frameless|link=https://example.com/}}

#eimagea

Each image can have any number of annotations. In the {{#eimage}} tag use the annot= option to specify an annotation. The value of annot= is another function called {{#eimagea}}. Below are the options available for {{#eimagea}}:

• Horizontal alignment option: one of left, right, center, justify, inherit
• Background color option: bg=
• Font parameters :

family : family=

size : size=

weight : weight=

style : style=

shadow : shadow=

• Font color : color=
• Line height : height=

If a parameter does not match any of the other possibilities, it is assumed to be the annotation text. Annotations support wiki-formatting.

Some examples:

{{#eimage:{{filepath:background-image.jpg}}|200px|acolor=white|This is image from wiki repository
   |annot={{#eimagea:10x20|This is an annotation.}}
   |annot={{#eimagea:20x40|size=20|A bigger annotation.}}
   |annot={{#eimagea:30x60|'''Bold Annotation'''}}
   |annot={{#eimagea:40x80|shadow=-1px -1px 0 #000, 1px -1px 0 #000, -1px 1px 0 #000, 1px 1px 0 #000|Shadowed Annotation}}
   |annot={{#eimagea:50x100|[http://google.com Linked annotation]}}
   |annot={{#eimagea:60x120|right|This is a long and right justified anotation.}}
}}

#eibox

It's rework my Template:block (wikicode) into PHP code. Derrivated from Template:Image in July 2020. For now it's usable without background image support. In the future it replace the #eimage function, which use absolute measure and depends on the obsolete variable $wgAllowImgTag. Next example demonstrate using #eibox:

{{#eibox:none|30|right|color=red|Content of the right box}}{{#eibox:none|30|left|color=blue|Content of the left box.}}
Text, which is placed between red and blue box…
{{#eibox:none|100|color=green|}}
Text which continued after the green box.

Next code, was used by my Template:block:

{{block|30|right|color=red|Content of the right box}}{{block|30|left|color=blue|Content of the left box.}}
Text, which is placed between red and blue box…
{{block|100|color=green|}}
Text which continued after the green box.

#eimg

The function #eimg extend #eibox. Use similary syntax, which is based on my Template:Image, originated on the original wiki syntax used by MW to the image insert. In simply form is very easy for use..

{{#eimg:image.jpg}}

Compare with the MW syntax:

[[Image:image.jpg]]

But typically using MW syntax is more complexity:

[[Image:image.jpg|200px|right|Comment to image in bubble.]]

But proble with the MW syntax is that doesn't allow set the size percentage. It was my start idea for Template:Image create. The following code does almost the same thing as MW code, but sets the percentage width.

{{Image|image.jpg|10|right|Comment to image in the bubble.}}

In June 2020, the functionality of the template was extended with the possibility of cropping by external wrapper crop.php. Cropping is a basic functionality for my wiki. It non sense for me do manually crop of the image, and after upload it, then I can do it by the extension EImage on-the-fly, using the original source by need. For now use my wiki about hundreds clips generated on-the-fly by PHP script 'crop.php'.

But I gradually replace this with the #eimg function, because use cache, which decrease processor load. For now the EImage support JPEG, GIF, PNG, SVG, PDF and DJVU format. Toto je stejný kód uvedený výše, realizovaný přes #eimg:

{{#eimg:image.jpg|10|right|Comment to image in the bubble.}}

For more examples using see my test pages:

• https://www.thewoodcraft.org/wiki/index.php/P%C3%ADskovi%C5%A1t%C4%9B
• https://www.thewoodcraft.org/wiki/index.php/test-eimage