Changes between Version 34 and Version 35 of WikiTicketCalendarMacro

Timestamp:

Jun 8, 2010, 8:57:03 PM (14 years ago)

Author:

Steffen Hoffmann

Comment:

add hints on macro activation for different versions (see #7213), mention required message catalog compilation, closes #7221

WikiTicketCalendarMacro

@@ -29 +29 @@
 and there's no visible difference to the genuine 0.12 version, if you don't use localization for Trac 0.12. 
 
+Historically the macro code was activated for a long time by
+{{{
+    [components]
+    WikiTicketCalendarMacro.* = enabled
+}}}
+what is still correct for 0.11 branch.
+
+New versions from 0.12 branch and trunk with i18n support have a different code structure due to packaging.[[BR]]
+See i18n/l10n section for an '''[#Abouti18nl10nsupport important hint on egg creation]'''. The statement required for activation has changed as well:
+{{{
+    [components]
+    wikiticketcalendar.* = enabled
+}}}
+
 == Source ==
 
@@ -34 +48 @@
 
 == Example ==
+See [#Download download section] on how to activate your version.
 
 The invocation for the screenshot above is {{{[[WikiTicketCalendar(*,*,true,Wochenberatung/%Y-%m-%d,true,Beratung)]]}}}.[[BR]]
 Excerpt of the source documentation:
 {{{
-    Activate it in 'trac.ini':
-    --------
-    [components]
-    WikiTicketCalendarMacro.* = enabled
-
     Usage
     -----
@@ -73 +83 @@
 But English message texts are still the (POSIX) default. If this isn't your preferred language, you can
  1. look, if it's already available from the [TracPluginTranslation Trac plugin l10n project] at [http://www.transifex.net/projects/p/Trac_Plugin-L10N/c/wikiticketcalendar Transifex] or
- 2. do it yourself (see the [http://trac.edgewall.org/wiki/CookBook/PluginL10N#Dotranslatorswork l10n cookbook page for Trac plugins] for more details).
+ 2. do it yourself (see the [t:wiki:CookBook/PluginL10N#Dotranslatorswork l10n cookbook page for Trac plugins] for more details).
 
 You've done a new translation? Superb! Contributing your translation is highly appreciated.[[BR]]
@@ -82 +92 @@
  [[Image(http://www.transifex.net/projects/p/Trac_Plugin-L10N/c/wikiticketcalendar/chart/image_png, title=Go to Trac_Plugin-L10N project page on Transifex.net, link=http://www.transifex.net/projects/p/Trac_Plugin-L10N/c/wikiticketcalendar/)]]
 Kindly provided by [[Image(http://sw.transifex.net/2/static/charts/images/tx-logo-micro.png, link=http://www.transifex.net/, title=the open translation platform, valign=bottom)]]
+
+Preparing the plugin from source requires the additional step of compiling message catalog files. Walk through:
+{{{
+cd wikiticketcalendarmacro
+python ./setup.py egg_info
+python ./setup.py compile_catalog -f
+python ./setup.py bdist_egg
+}}} 
+If you missed the 3rd step, you'll get an error in the 4th step complaining about missing `locale` directory.
+This is just a side-effect, because there are no complied message catalogs for inclusion into Python egg, hence the whole path is missing.[[BR]]
+To exclude translations marked as `# fuzzy` by the translator, you'll want to omit the extra `-f` argument to message catalog compilation.
+Again, for more details see the [t:wiki:CookBook/PluginL10N#Compileanduseit l10n cookbook page for Trac plugins].
 
 == Recent Changes ==