Changes between Version 1 and Version 2 of EntityMacro


Ignore:
Timestamp:
Dec 25, 2008 7:30:17 PM (6 years ago)
Author:
dwclifton
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • EntityMacro

    v1 v2  
    1 = EntityMacro = 
     1= !EntityMacro = 
    22 
    33== Description == 
    44 
    5 The EntityMacro package returns HTML 4.01 numeric character entity references from their corresponding names.  
     5The !EntityMacro package returns HTML 4.01 numeric character entity references 
     6from their corresponding names. 
    67 
    7 == Bugs/Feature Requests ==  
     8The character entity data is straight out of the DTD for HTML 4.01 so if there 
     9are errors or ommissions you can blame it on the W3C, not me. ;-) 
    810 
    9 Existing bugs and feature requests for EntityMacro are  
    10 [report:9?COMPONENT=EntityMacro here]. 
     11See: [http://www.w3.org/TR/1999/REC-html401-19991224/sgml/entities.html Character entity references in HTML 4] for more information. 
    1112 
    12 If you have any issues, create a  
    13 [http://trac-hacks.org/newticket?component=EntityMacro&owner=dwclifton new ticket]. 
     13Calling the macro like so: `[[Entity(name)]]` returns the value. If no name 
     14matches, it returns an empty string. Names are case-sensitive, in other words, 
     15`aacute` is not the same code point as `Aacute`. Keyword syntax is also supported: 
     16`[[Entity(name=name)]]`. 
    1417 
    15 == Download == 
     18The macro is useful in any [WikiFormatting wiki formatted] page. 
    1619 
    17 Download the zipped source from [download:entitymacro here]. 
     20== Installation == 
     21 
     22Download the zipped [http://trac-hacks.org/attachment/wiki/EntityMacro/entitymacro.zip?format=raw source] 
     23Unzip the archive to a temporary location, visit the 0.11 directory and run: 
     24 
     25{{{ 
     26python setup.py bdist_egg 
     27cp dist/*.egg /trac/env/Project/plugins 
     28}}} 
     29 
     30== Configuration == 
     31 
     32Enable the macro in: 
     33 
     34/trac/env/Project/conf/trac.ini: 
     35 
     36{{{ 
     37[components] 
     38entity.* = enabled 
     39}}} 
     40 
     41You may have to restart you Web server. 
     42 
     43== Examples == 
     44 
     45{{{ 
     46[[Entity(raquo)]] 
     47[[Entity(name=raquo)]] 
     48}}} 
     49 
     50Both of these examples will return `»` 
    1851 
    1952== Source == 
    2053 
    21 You can check out EntityMacro from [http://trac-hacks.org/svn/entitymacro here] using Subversion, or [source:entitymacro browse the source] with Trac. 
    22  
    23 == Example == 
    24  
    25 [[Entity(raquo)]] 
    26 [[Entity(name=raquo)]] 
     54 * Browse the source at: [http://github.com/dwclifton/tracentitymacro/tree/master GitHub] 
     55 * Public clone URL: 
     56{{{ 
     57git clone git://github.com/dwclifton/tracentitymacro.git 
     58}}} 
    2759 
    2860== Recent Changes == 
     
    3264== Author/Contributors == 
    3365 
    34 '''Author:''' [wiki:dwclifton] [[BR]] 
    35 '''Contributors:''' 
     66 * '''Author:''' [wiki:dwclifton] 
     67 * '''Contributors:''' The Trac and Python community.