TracIni macro on trac.edgewall.org shows plugin options

[eblot]

Documentation on trac.edgewall.org should reflect Trac documentation, as a user guide reference.

The [[TracIni]] macro used in TracIni page displays options for Bitten, as Bitten is used on http://trac.edgewall.org
However this is unrelated to the Trac project and should not appear in TracIni page.

[eblot]

It might be useful that the [[TracIni]] macro takes an extra argument, to enable or disable display of plugin options. Not sure how to implement this feature though ;-)

[nkantrowitz]

I thought we had agreed a while ago to not use the macro version on here so that users could actually edit the documentation and whatnot. For example, we should start to add documentation for new 0.11 options ahead of time.

[eblot]

Replying to nkantrowitz:

I thought we had agreed a while ago to not use the macro version on here so that users could actually edit the documentation and whatnot. For example, we should start to add documentation for new 0.11 options ahead of time.

Dunno but both current and 0.11 TracIni pages are using this macro at the moment.

[cboos]

Well, we could simply warn in the TracIni page here that the [bitten] and [spam-filter] sections are only meant for use by those plugins.

Also, copying the content of the macro documentation from the source code to the TracIni page seems quite error prone. Better suggest to contribute enhancement to the documentation as patches or in a discussion section.

[cmlenz]

Replying to eblot:

Replying to nkantrowitz:

I thought we had agreed a while ago to not use the macro version on here so that users could actually edit the documentation and whatnot.

Yeah, I thought so too. Otherwise, how would we do proper versioning of the page?

Anyway, now that we have a bazillion options it's probably too cumbersome indeed :/

[cboos]

An alternative would be to embed the output of the TracIni macro as produced for a given version in an #!html block.

[cboos]

Version dependent output saved in 0.10/TracIni@2 and TracIni@110.

This takes care of the only special case needed, i.e. here on t.e.o. The shipped TracIni page should continue to contain a simple call to [[TracIni]].