[[PageOutline(2-5,Contents,pullout)]] = Display option values for trac.ini == Description This is a macro that allows a Trac wiki author to insert the value of a {{{trac.ini}}} configuration option into a page. The IniGetMacro package consists of two macros. The first, `IniGet`, returns as plain text the value of a [TracIni trac.ini] configuration option. The `trac.ini` file is a simple flat-file database of sections and option/value pairs: {{{#!ini [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: {{{#!html

Welcome to the project.name Project

}}} In this example `project.name` is dynamically inserted in the same manner as !IniGet. The example above is the default behavior. However, Welcome also supports from zero to two arguments that allow the user to specify the prefix and/or suffix strings. Both standard and dictionary keyword methods are supported. When using the standard method, then the order is important, but when using the keyword method it is not. You cannot mix both methods. These macros are useful for WikiStart project templates. === Other examples {{{ [[Welcome]] [[Welcome()]] [[Welcome(This is the,Project)]] [[Welcome(prefix=This is the,suffix=Project)]] [[Welcome(suffix=Super Cool Project)]] [[Welcome(,Super Cool Project)]] The [[IniGet(project.name)]] project is designed to track and document software defects. }}} == Bugs/Feature Requests Existing bugs and feature requests for IniGetMacro are [report:9?COMPONENT=IniGetMacro here]. If you have any issues, create a [/newticket?component=IniGetMacro new ticket]. [[TicketQuery(component=IniGetMacro,group=type,format=progress)]] == Download Download the zipped source from [export:inigetmacro here]. == Source You can check out IniGetMacro from [/svn/inigetmacro here] using Subversion, or [source:inigetmacro browse the source] with Trac. == Installation Install this plugin using setup.py and copying the egg to the plugins directory: {{{#!sh python setup.py bdist_egg cp dist/*.egg /trac/env/Project/plugins }}} Enable the macros in `/trac/env/Project/conf/trac.ini`: {{{#!ini [components] iniget.* = enabled welcome.* = enabled }}} You may need to restart your web server. == Recent Changes [[ChangeLog(inigetmacro, 3)]] == Author/Contributors '''Author''': [wiki:dwclifton] [[BR]] '''Maintainer''': [[Maintainer]] [[BR]] '''Contributors''':