[[PageOutline(2-5,Contents,pullout)]] = Character Entity Macro = == Description == The !EntityMacro package returns HTML 4.01 numeric character entity references from their corresponding names. The character entity data is straight out of the DTD for HTML 4.01 so if there are errors or ommissions you can blame it on the W3C, not me. ;-) See: [http://www.w3.org/TR/1999/REC-html401-19991224/sgml/entities.html Character entity references in HTML 4] for more information. Calling the macro like so: `[[Entity(name)]]` returns the value. If no name matches, it returns an empty string. Names are case-sensitive, in other words, `aacute` is not the same code point as `Aacute`. Keyword syntax is also supported: `[[Entity(name=name)]]`. The macro is useful in any [WikiFormatting wiki formatted] page. == Installation == Download the zipped [/attachment/wiki/EntityMacro/entitymacro.zip?format=raw source]. Unzip the archive to a temporary location, visit the 0.11 directory and run: {{{ python setup.py bdist_egg cp dist/*.egg /trac/env/Project/plugins }}} == Configuration == Enable the macro in: /trac/env/Project/conf/trac.ini: {{{ [components] entity.* = enabled }}} You may have to restart you Web server. == Examples == {{{ [[Entity(raquo)]] [[Entity(name=raquo)]] }}} Both of these examples will return `»` == Source == * Browse the source at: [http://github.com/dwclifton/tracentitymacro/tree/master GitHub] * Public clone URL: {{{ git clone git://github.com/dwclifton/tracentitymacro.git }}} == Recent Changes == [[ChangeLog(entitymacro, 3)]] == See Also == The WikiGoodiesPlugin support for displaying smileys, HTML 4.0 entities (named entities and numerical entities), automatic replacement of common text idioms by their corresponding symbols (e.g. arrows, fractions, etc.).... == Author/Contributors == * '''Author:''' [wiki:dwclifton] * '''Maintainer:''' [wiki:dwclifton] * '''Contributors:''' The Trac and Python community.