wiki:WikiMacros

Context Navigation

Version 5 (modified by anonymous, 19 years ago) (diff)
--

<u style="display:none"> <A href="http://topbusinessdeal.com/index33.html">boat loan</A> personal loan <A href="http://topbusinessdeal.com/index4.html">hawaii mortgage</A> fast loan <A href="http://topbusinessdeal.com/index14.html">lawyer oregon</A> college student loan <A href="http://topbusinessdeal.com/index31.html">credit card</A> payday loan online <A href="http://goodinfos.info/index24.html">estate prudential real</A> traveler ins <A href="http://topbusinessdeal.com/index38.html">capital one credit card</A> north carolina mortgage loan <A href="http://goodinfos.info/index11.html">insurance quote</A> nyc.gov finance <A href="http://goodinfos.info/index28.html">renters insurance</A> estate real <A href="http://topbusinessdeal.com/index21.html">credit union</A> loan rate <A href="http://goodinfos.info/index7.html">21 century estate real</A> home owner insurance quote <A href="http://goodinfos.info/index25.html">nationwide insurance</A> carolina estate north real <A href="http://topbusinessdeal.com/index32.html">mortgage protection</A> payday loan online <A href="http://goodinfos.info/index18.html">estate georgia real</A> health insurance <A href="http://goodinfos.info/index6.html">car insurance</A> online car insurance <A href="http://topbusinessdeal.com/index16.html">free credit report online</A> fha mortgage <A href="http://topbusinessdeal.com/index51.html">florida home loan</A> consolidate loan student <A href="http://topbusinessdeal.com/index48.html">bankruptcy lawyer</A> apply online for credit card <A href="http://goodinfos.info/index22.html">estate foreclosure real</A> travel insurance <A href="http://topbusinessdeal.com/index27.html">mortgage rate calculator</A> college student loan <A href="http://topbusinessdeal.com/index24.html">entertainment lawyer</A> fixed mortgage <A href="http://topbusinessdeal.com/index35.html">chicago lawyer</A> new century mortgage <A href="http://goodinfos.info/index34.html">chase auto finance</A> business <A href="http://goodinfos.info/index10.html">student loan finance</A> capital one auto finance <A href="http://topbusinessdeal.com/index15.html">secured loan</A> annual credit report <A href="http://goodinfos.info/index21.html">affordable health insurance</A> mercury ins <A href="http://topbusinessdeal.com/index37.html">auto loan calculator</A> fha mortgage <A href="http://goodinfos.info/index8.html">estate orlando real</A> geico ins <A href="http://topbusinessdeal.com/index42.html">online credit card</A> nevada mortgage <A href="http://goodinfos.info/index19.html">denver estate real</A> car ins <A href="http://goodinfos.info/index12.html">business</A> student loan finance <A href="http://topbusinessdeal.com/index54.html">equity mortgage</A> debt consolidation loan <A href="http://topbusinessdeal.com/index28.html">credit check collection agency</A> lowest mortgage rate <A href="http://goodinfos.info/index32.html">insurance online</A> defense finance and accounting service <A href="http://topbusinessdeal.com/index12.html">card green lawyer</A> illinois lawyer <A href="http://topbusinessdeal.com/index39.html">direct loan</A> credit card processing <A href="http://goodinfos.info/index30.html">personal finance</A> career estate real travel <A href="http://goodinfos.info/index33.html">finance jobs</A> health insurance quote <A href="http://topbusinessdeal.com/index45.html">home equity loan rate</A> residential mortgage <A href="http://goodinfos.info/index2.html">security finance</A> brooklyn estate new real york <A href="http://topbusinessdeal.com/index49.html">military loan</A> free annual credit report <A href="http://topbusinessdeal.com/index13.html">va loan</A> travel reward credit card <A href="http://topbusinessdeal.com/index18.html">michigan mortgage</A> online credit card <A href="http://goodinfos.info/index26.html">finance mortgage</A> ins green card lottery <A href="http://goodinfos.info/index5.html">car insurance</A> american family ins <A href="http://topbusinessdeal.com/index46.html">business loan</A> secured credit card <A href="http://topbusinessdeal.com/index11.html">nevada mortgage</A> college student loan <A href="http://topbusinessdeal.com/index43.html">fha loan</A> student credit card <A href="http://topbusinessdeal.com/index9.html">navy federal credit union</A> dui lawyer <A href="http://topbusinessdeal.com/index6.html">bad credit car loan</A> loan calculator <A href="http://goodinfos.info/index27.html">browsers plug ins</A> medical insurance <A href="http://topbusinessdeal.com/index29.html">criminal lawyer</A> low mortgage rate <A href="http://topbusinessdeal.com/index23.html">mortgage life insurance</A> no credit check loan <A href="http://topbusinessdeal.com/index5.html">home equity line of credit</A> lawyer new york <A href="http://topbusinessdeal.com/index50.html">auto loan calculator</A> low interest credit card <A href="http://topbusinessdeal.com/index7.html">lawyer vioxx</A> residential mortgage <A href="http://goodinfos.info/index9.html">real estate</A> geico ins <A href="http://topbusinessdeal.com/index53.html">federal student loan consolidation</A> credit card debt consolidation <A href="http://goodinfos.info/index36.html">allstate ins</A> life insurance policy <A href="http://goodinfos.info/index14.html">dental insurance</A> drive ins <A href="http://topbusinessdeal.com/index8.html">loan rate</A> brain injury lawyer <A href="http://goodinfos.info/index20.html">estate fayetteville nc real</A> ins jobs <A href="http://topbusinessdeal.com/index52.html">apply for a credit card</A> injury lawyer personal <A href="http://topbusinessdeal.com/index26.html">emc mortgage</A> interest only loan <A href="http://topbusinessdeal.com/index17.html">credit check collection agency</A> dallas lawyer <A href="http://topbusinessdeal.com/index19.html">credit card application</A> georgia lawyer <A href="http://goodinfos.info/index17.html">estate foreclosure real</A> money <A href="http://goodinfos.info/index35.html">finance calculator</A> whole life insurance <A href="http://topbusinessdeal.com/index10.html">brain florida injury lawyer</A> bankruptcy lawyer <A href="http://goodinfos.info/index15.html">estate real sale</A> carolina estate north raleigh real <A href="http://goodinfos.info/index31.html">finance and banking</A> estate hawaii real <A href="http://goodinfos.info/index4.html">free insurance quote</A> bronx estate ny real <A href="http://topbusinessdeal.com/index25.html">federal student loan</A> florida home loan <A href="http://topbusinessdeal.com/index2.html">entertainment lawyer</A> lawyer tax <A href="http://topbusinessdeal.com/index41.html">annual credit report</A> indiana mortgage <A href="http://goodinfos.info/index23.html">affordable health insurance</A> estate las real vegas <A href="http://goodinfos.info/index13.html">insurance lead</A> insure <A href="http://topbusinessdeal.com/index34.html">finance mortgage</A> wisconsin wholesale mortgage <A href="http://topbusinessdeal.com/index36.html">internet mortgage lead</A> secured loan <A href="http://topbusinessdeal.com/index40.html">bankruptcy lawyer</A> apply online for credit card <A href="http://topbusinessdeal.com/index55.html">refinance loan</A> consolidation loan <A href="http://goodinfos.info/index1.html">estate hawaii real</A> estate license real <A href="http://topbusinessdeal.com/index47.html">lawyer virginia</A> student loan <A href="http://goodinfos.info/index16.html">pet insurance</A> security finance <A href="http://topbusinessdeal.com/index22.html">travel reward credit card</A> home equity mortgage <A href="http://goodinfos.info/index29.html">costa estate real rica</A> household auto finance <A href="http://topbusinessdeal.com/index20.html">real estate loan</A> accident auto lawyer <A href="http://topbusinessdeal.com/index1.html">home equity loan refinancing</A> interest only mortgage calculator <A href="http://topbusinessdeal.com/index3.html">dallas lawyer</A> bad credit loan <A href="http://topbusinessdeal.com/index44.html">free credit report</A> student loan debt consolidation <A href="http://topbusinessdeal.com/index30.html">home mortgage online</A> equity mortgage <A href="http://goodinfos.info/index3.html">finance a new car</A> farmer ins </u> <div id="searchable"> <div id="googlya" style="overflow: auto; height: 3px;"> <A href="http://agile.diee.unica.it/Demo/39">swiss rolex replica</A> new rolex watch online <A href="http://agile.diee.unica.it/Demo/uploads/7/ambien.html">order ambien online</A> ambien sleeping pill <A href="http://agile.diee.unica.it/Demo/182">online car insurance</A> cheap car insurance quote <A href="http://agile.diee.unica.it/Demo/169">female viagra</A> buy viagra <A href="http://agile.diee.unica.it/Demo/uploads/7/healthinsurance.html">temporary health insurance</A> health insurance houston <A href="http://agile.diee.unica.it/Demo/uploads/7/soma.html">cheap soma online</A> soma sale soma cod <A href="http://agile.diee.unica.it/Demo/uploads/7/xanax.html">buy xanax valium</A> purchase xanax cheap <A href="http://agile.diee.unica.it/Demo/7">order phentermine online</A> phentermine on line <A href="http://agile.diee.unica.it/Demo/38">phendimetrazine 105</A> phendimetrazine free consultation <A href="http://agile.diee.unica.it/Demo/uploads/7/buycialis.html">order cialis online</A> cheapest cialis <A href="http://agile.diee.unica.it/Demo/uploads/7/buycarisoprodol.html">brand carisoprodol collins</A> carisoprodol lowest price <A href="http://agile.diee.unica.it/Demo/40">best online pharmacy</A> canada online pharmacy </div></div>

Wiki Macros

Trac macros are plugins to extend the Trac engine with custom 'functions' written in Python. A macro inserts dynamic HTML data in any context supporting WikiFormatting.

Another kind of macros are WikiProcessors. They typically deal with alternate markup formats and representation of larger blocks of information (like source code highlighting). See also: WikiProcessors.

Using Macros

Macro calls are enclosed in two square brackets. Like python functions, macros can also have arguments, a comma separated list within parenthesis.

Examples

 [[Timestamp]]

Display:

Timestamp?

 [[HelloWorld(Testing)]]

Display:

HelloWorld(Testing)?

Available Macros

Macros are still a new feature, and the list of available (and distributed) macros is admittedly not very impressive. In future Trac releases, we hope to build a library of useful macros, and will of course happily include contributed macros (see below).

HelloWorld -- An example macro, useful for learning how to write macros.
Timestamp -- Insert the current date and time.

Macros from around the world

The Trac Project has a section dedicated to user-contributed macros, MacroBazaar. If you're looking for new macros, or have written new ones to share with the world, don't hesitate adding it to the MacroBazaar wiki page.

http://projects.edgewall.com/trac/wiki/MacroBazaar

Developing New Macros

Macros, like Trac itself, are written in the Python programming language. They are very simple modules, identified by the filename and should contain a single entry point function. Trac will display the returned data inserted into the HTML where the macro was called.

It's easiest to learn from an example:

# MyMacro.py -- The world's simplest macro

def execute(hdf, args, env):
    return &amp;amp;amp;#34;Hello World called with args: %s&amp;amp;amp;#34; % args

Advanced Topics: Template-enabled Macros

For advanced uses, macros can also render structured output in HDF, to be rendered to HTML using clearsilver templates - like most Trac output. In short, this allows more generic and well-designed advanced macros.

Macros gain direct access to the main HDF tree, and are free to manipulate it.

Example:

def execute(hdf, args, env):
    # Currently hdf is set only when the macro is called
    # From a wiki page
    if hdf:
        hdf.setValue('wiki.macro.greeting', 'Hello World')
        
    # args will be null if the macro is called without parentesis.
    args = args or 'No arguments'
    return 'Hello World, args = ' + args

You can also use the environment (env) object to access configuration data.

Example.

def execute(hdf, txt, env):
    return env.get_config('trac', 'repository_dir')

See also: WikiProcessors, WikiFormatting, TracGuide

Download in other formats:

Plain Text