Glypheer User Guide
Contents
You can include hieroglypghs within articles or in comments. To include a hieroglyphic character simply enclose it within '.glypheer_shortcode_text(hieroglyphs,'',' ').' tags like this [hieroglyphs]A1[/hieroglyphs]. Even better you can include a full
Manuel de Codage style string and it will be parsed so that all the relevant hieroglyphs can be scaled and displayed. For example
[hieroglyphs]Htp:t*p
[/hieroglyphs] will display:
Although our inspiration was
WikiHiero by Guillaume Blanchard was and we support the
basic MDC syntax covered by Wikihiero, Kate Phizackerley design a new parser which means we can offer a number of extensions.
Groups allow a change to the natural order of cadrats within a composite hieroglyph, for instance p*(t:Z4):pt These are partially implemented. In that example, the p cadat is top-aligned rather than centred to the midline of the (t:Z4). There is also a danger that heights may be incorrectly calculated and nesting is not permitted. The syntax isn't checked so you
must ensure that openin and closing parentheses are matched in a pair within any hieroglyph. Given these limitations, the use of cadrat groups is supported within articles, but not within comments.
Damage to a hierogyph is traditionally represented by shading overlaid on its image. Shading is indicated in the Manual de Codage by the # character. Shading may be turned on or off between any two glyphs by using the -#- syntax so that A1-#-G39-#-A1 would shade only the middle glyph. As well as shading whole glyphs, it is possible to shade only particular quadrants or two adjacent quadrants as shown in the table below.
At present we don't support trailing modfiers (eg A1#) to indicate shading of a single glyph.
| Syntax | Output | Description |
| <-C12\-#-C2-N36:ms*s*s-#-> | | Indicates damage to the whole glyphs |
| <-C12\-#1234-C2-N36:ms*s*s-#-> | | Alternative format for indicating damage to whole glyphs |
| <-C12\-#1-C2-#-N36:ms*s*s-> | | Indicates damage to the top left quadrant. |
| <-C12\-#2-C2-#-N36:ms*s*s-> | | Indicates damage to the top right quadrant. |
| <-C12\-#3-C2-#-N36:ms*s*s-> | | Indicates damage to the bottom left quadrant. |
| <-C12\-#4-C2-#-N36:ms*s*s-> | | Indicates damage to the bottom right quadrant. |
| <-C12\-#12-C2-#-N36:ms*s*s-> | | Indicates damage to the top half. |
| <-C12\-#34-C2-#-N36:ms*s*s-> | | Indicates damage to the bottom half. |
| <-C12\-#13-C2-#-N36:ms*s*s-> | | Indicates damage to the lefthand half. |
| <-C12\-#24-C2-#-N36:ms*s*s-> | | Indicates damage to the righthand half. |
It's possible to swap directly between two types of shading, so for instance #24-A1-#13-B1 is allowed and displays damage to the righthand side of the first hieroglyph and to the lefthand side of the second hieroglyph as shown. Shading is implemented using CSS so it's applied in the browser and correct display in IE6 is not guaranteed.
Rotation is specified by typing \r? or \t? after the glyph.
| Syntax | Output | Description |
| A1 | | Displays the glyph in natural orientation |
| A1\ or A1\t0 | | Flips the glyph horizontally (mirroring) |
| A1\r1 | | Rotates the glyph 90° anti-clockwise |
| A1\r2 | | Rotates the glyph 180° anti-clockwise |
| A1\r3 | | Rotates the glyph 270° anti-clockwise |
| A1\t1 | | Rotates the glyph 90° clockwise, with a horizontal flip |
| A1\t2 | | Rotates the glyph 180° clockwise, with a horizontal flip |
| A1\t3 | | Rotates the glyph 2270° clockwise, with a horizontal flip |
Rotation is available for all singular glyphs or for individual cadrats within composite hieroglyphs. It is not possible in the current version to rotate an entire composite hierogyph.
On this site you may prefer to use specify the degrees using the
Projet Rosette syntax, for example G39/r90 to rotate the glyph image< 90° anti clockwise. The minus symbol - is used a separator within MDC, so clockwise rotations using /t instead as shown in the table.
| Syntax | Output | Description |
| G39 | | Displays the glyph in natural orientation |
| G39/t0 | | Flips the glyph horizontally (mirroring) |
| G39/r90 | | Rotates the glyph 90° anti-clockwise |
| G39/r180 | | Rotates the glyph 180° anti-clockwise |
| G39/270 | | Rotates the glyph 270° anti-clockwise |
| G39/t90 | | Rotates the glyph 90° clockwise, with a horizontal flip |
| G39/t180 | | Rotates the glyph 180° clockwise, with a horizontal flip |
| G39/t270 | | Rotates the glyph 270° clockwise, with a horizontal flip |
By default output is presented on a stave of about 40px in height. To adjust the size, use [hieroglyphs scale="125"]A1[/hieroglyphs] for example to increase the size to 125% of normal size ie to 50px height. The % sign should
not be used.
In addition to the basic, default set of hieroglyph images © S Rosmorduc, G Watson and J Hirst , we also offer a set of coloured hieroglyphs © Neoklis Kyriazis. To access this set, use the format [hieroglyphs output="color"]D:t:N17[/hieroglyphs]. There are no coloured glyphs for cartouches: images will be substituted automatically from the default set where necessary. Some glyph images have been edited to adjust white space.It's also possible to swap between glyph sets during display using the $b and $r directives to select black and red sets respectively. $b and $r should awlays be placed between separators, like -$r- or *$b* The Kyriazis coloured set of hieroglyphs is treated as the "red" sister of the default image set. Instead of the output= option you can use "classic" MDC notation to select the coloured glyphs by starting the MDC string with $r-
For example n:T:r-$r-nTr-i-$b-A1-G5 will place two coloured glyphs into an otherwise black set of hieroglyphs:
The latest version also includes provision for the NewGardiner font by Mark-Jan Nederhof. (This font is only licensed for non-commercial use and might not be available on other sites using our Egyptological Hieroglyph WordPress Plugin.) To access this set use the format [hieroglyphs output="newgardiner"]D:t:N17[/hieroglyphs]. Red hieroglyphs using the font are also available by specifying newgardiner-red or by using the $r directive. At present support for the font is incomplete with cartouches and rotation missing. Processing the font uses a lot of server resources. Please use the standard images rather then this font whenever possible.
Generally the easiest way to display text is to place it outside the tags; however, for consistency with other implementations of Manuel de Codage we support the +l directive (to turn text mode on) and +s to restore glyph display. Unlike most other implementations, we continue to parse the text according to the the normal MDC syntax which allows spacing of a translation to approximate that of the glyphs themselves. To prevent encoding of a phoneme you should prefix it with a $dollar; sign so that $Http will display Http but Http would display R4. It is not possible to display * - or :
Plugin Version
Egyptological Hieroglyphs from Egyptological Online Version 0.6
| Author: | ©Kate Phizackerley 2010 |
| Component versions: | Help = 0.21a, Phonemes = 1.02, Rotation Engine = 1.3, Stateful Parser = 0.71 |
| Download:Not yet available. Will be uploaded to WordPress Repository |
| Licensing: | Plugin code (excludes Rotation Engine) available under GPL. Rotation Engine - all rights reserved and not available for distribution. |
If you are looking for technical information, please refer to the separate guide for developers.
By Kate