= Trac.ini Dynamic Option Value Macros =

== Description ==

The IniGetMacro package consists of two macros. The first, '''!IniGet''', returns as plain
text the value of a [http://trac-hacks.org/wiki/TracIni trac.ini] configuration option. The
`trac.ini` file is a simple flat-file database of sections and option/value pairs:

{{{
[section]
name = value
}}}

By calling the macro like so: `[[IniGet(section.name)]]`, it returns the value.
If no option matches, it returns an error message. Some option names themselves
contain periods, this is supported.

The second macro in the package is '''Welcome''', and it returns a level 1 heading
element in the following format:

{{{
<h1 id="welcome">Welcome to the project.name Project</h1>
}}}

Where `project.name` is dynamically inserted in the same manner as !IniGet.

These macros are useful for WikiStart project templates.

== Bugs/Feature Requests == 

Existing bugs and feature requests for IniGetMacro are 
[report:9?COMPONENT=IniGetMacro here].

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=IniGetMacro&owner=dwclifton new ticket].

== Download ==

Download the zipped source from [http://trac-hacks.org/attachment/wiki/IniGetMacro/inigetmacro.zip?format=raw here].

== Source ==

Browse the source: [http://github.com/dwclifton/tracinigetmacro/tree/master][[BR]]
Public clone URL:
{{{
git clone git://github.com/dwclifton/tracinigetmacro.git
}}}

== Example ==

{{{
[[Welcome]]

The [[IniGet(project.name)]] project consists of a...
}}}

== Recent Changes ==

[[ChangeLog(inigetmacro, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:dwclifton][[BR]]
'''Contributors:'''