Changes between Version 5 and Version 6 of TracWikiNegotiatorPlugin

Dec 8, 2008 5:41:17 AM (6 years ago)

Update page for ver 1.6.


  • TracWikiNegotiatorPlugin

    v5 v6  
    55This plugin provides content negotiation mechanism for Trac wiki 
    6 pages.  With this plugin, your trac site can provides multiple localized 
    7 pages for users. 
     6pages.  With this plugin, your trac site can provides localized pages 
     7for users. 
     9A live example site is [ here]. 
    1011== Bugs/Feature Requests ==  
    2425You can check out TracWikiNegotiatorPlugin from [ here] using Subversion, or [source:tracwikinegotiatorplugin browse the source] with Trac. 
    26 == How to Install == 
     27== Install == 
    2729Build egg file and place it appropriate place 
     59Note that `TitleIndex` macro and `TOC` macro (by tractoc plugin) is 
     60overridden by enabling this plugin. To use original macro, you should 
     61disable new macro explicitly. See [#BonusMacro Bonus Macro] for 
     62more detail. 
    5865== How to Use == 
     88== Language Menu == 
     90By using this plugin, you can see new language menu bar above the 
     91wiki context navigation menu. It displays available languages 
     92on this site automatically by finding language suffixes of wiki pages. 
     94You can select language via this menu. Because it is holded in the session 
     95information, you can walk with the language without re-selection. 
     97The selected language are displayed underlined and bolded on the 
     98menu. If specific language content is not availabe, the language item 
     99in the menu is grayed. 
     101There are 5 kind of display styles: 
     103 `simple`:: 
     104   Solid menu bar above the wiki context navigation menu. 
     105   This is default style. 
     106 `ctxnav`:: 
     107   Like `simple` but displayed on the right of the wiki context menu. 
     108   It looks like a one of the context menu item. 
     109 `button`:: 
     110   Button faced selection menu. 
     111 `tab`:: 
     112   Tabbed page style of selector. 
     113 `none`:: 
     114   Hide language menu. 
     116The style of language menu can be changed by `menu_style` option: 
    81123==  Bonus Macro == 
    85127The former is an alternative macro of `TitleIndex`. 
    86128The later is an alternative of `TOC` macro. 
    87 (see [th:wiki:TocMacro] in Trac-Hacs for more detail) 
     129(see [th:wiki:tocmacro tocmacro] in Trac-Hacs for more detail) 
     131And this plugin has the definitions to override original 
     132`TitleIndexMacro` and `TOCMacro` automatically.  
     133'''So you do not need to edit wiki pages to use both two new macros'''. 
     134If you want to disable new feature and use original, 
     135disable new macros explicitly in `trac.ini` like this: 
     138wikinegotiator.macros.titleindexmacro = disabled 
     139wikinegotiator.macros.tocmacro = disabled 
    89142=== `MultiLangTitleIndex` === 
    90143The differences against `TitleIndex` are: 
    91  * Display in one line for variants like: "* WikiStart (ja, en, other)". 
     144 * Display in one line for variants like: "* !WikiStart (ja, en, other)". 
    92145 * List pages in two columns: one is for user's pages, one is for 
    93146   system provided pages. System pages are the pages made by trac. 
    97150It is useful for the site having many localized pages. 
    98 You can use it by editing `TitleIndex` page. 
     152'''This feature is automatically enabled''' by overriding `TitleIndexMacro` 
     153when this plugin is enabled. 
    100155=== `NTOC` === 
    101 If you installed and enabled `TOC` macro on Trac 0.11 (or later), 
    102 `NTOC` macro is also enabled. It is delived macro from `TOC` so all 
    103 the features in `TOC` macro are available and plus handling lang 
    104 suffixed pages better. 
     156`NTOC` macro delives `TOC` macro, so all the features in `TOC` macro 
     157are available except handling lang suffixed pages. 
    106158If you specify normal page name without explicit lang suffix  
    107 (i.e. `!WikiStart`), `NTOC` look up localized page for language same to  
     159(i.e. `WikiStart`), `NTOC` look up localized page for language same to  
    108160parent page the macro is put on. If not exist, look up localized page 
    109161for preferred langs. If not found, use specified name as is. 
    114166suffixed pages. 
    116 So, `TOC` can be simply replaced to `NTOC`. 
     168'''This feature is automatically enabled''' by overriding `TOCMacro`  if available 
     169when this plugin is enabled. 
    118172== Recent Changes ==