DokuWiki

It's better when it's simple

User Tools

Site Tools

Trace:
plugin:translation3

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
plugin:translation3 [2010-12-05 18:15] – [Comparison of translation plugins] 79.184.44.181plugin:translation3 [2023-10-30 23:32] (current) – Klap-in
Line 1: Line 1:
-====== Translation3 plugin ======+====== Translation3 Plugin ======
  
 ---- plugin ---- ---- plugin ----
-description: Another translation plugin based on plugin:translation and plugin:multilingual+description: Another translation plugin based on plugin:translation and plugin:multilingual. Merged back.
 author     : Tomasz Tomasik author     : Tomasz Tomasik
 email      : scx.mail@gmail.com email      : scx.mail@gmail.com
 type       : syntax, action type       : syntax, action
-lastupdate : 2010-11-05 +lastupdate : 2010-12-05 
-compatible : 2009-12-25+compatible : Lemming
 depends    :  depends    : 
 conflicts  : translation conflicts  : translation
 similar    : translation, multilingual similar    : translation, multilingual
-tags       : language+tags       : !obsolete
  
 downloadurl: https://github.com/scx/dokuwiki-plugin-translation/zipball/master downloadurl: https://github.com/scx/dokuwiki-plugin-translation/zipball/master
-bugtracker : # eg. http://github.com//dokuwiki-plugin-translation3/issues +bugtracker : https://github.com/scx/dokuwiki-plugin-translation/issues 
-sourcerepo : http://github.com/scx/dokuwiki-plugin-translation/+sourcerepo : https://github.com/scx/dokuwiki-plugin-translation/
 donationurl:  donationurl: 
 ---- ----
  
-This is a fork of [[plugin:translation|translation plugin]] (also have some features from [[plugin:multilingual|multilingual plugin]]). This plugin shows a list of available translations for a page.+In December 2010 the extras added to this fork (based on features of [[plugin:multilingual|multilingual plugin]]) are merged back to the [[Translation]] plugin. After that development on this fork is halted, so the Translation plugin is recommended! Go to **[[translation|translation plugin]]**.
  
-There are a few limitations: 
-  * separate namespaces are used to store translations 
-  * translated pages need to have the same [[:pagename]] as the main language page 
- 
-See also [[#Advantages|advantages]] and [[#Comparison of translation plugins|comparison of translation plugins]]. 
  
 ===== Download and Installation ===== ===== Download and Installation =====
  
-Download and install the plugin using the [[plugin:plugin|Plugin Manager]] using the URL given above. Refer to [[:Plugins]] on how to install plugins manually. +Repositories: 
- +  * [[https://github.com/scx/dokuwiki-plugin-translation/|New repo]]
-URL:+
   * [[http://scx.isgreat.org/dokuwiki/translation3/|Old repo]]   * [[http://scx.isgreat.org/dokuwiki/translation3/|Old repo]]
-  * [[http://scx.isgreat.org/dokuwiki/translation3/translation.zip|translation.zip]] in old repo 
-  * [[https://github.com/scx/dokuwiki-plugin-translation/|New repo]] 
-  * [[https://github.com/scx/dokuwiki-plugin-translation/zipball/master|Current version]] in new repo 
  
-===== Installation ===== 
-Similar to [[plugin|translation]] (version 2009-10-25) or [[plugin|multilingual]] (version 2009-02-11). 
-  * Download and install the plugin through the [[plugin:Plugin]] Manager. 
-  * Configure it through the [[plugin:config|Config Manager]] 
-  * Add the following code in your template's ''main.php'' (or put it in a ''lib/tpl/default/pageheader.html'' file for the default template) 
  
-<code php> +===== Changes ===== 
-<?php +  * 2010-11-05: 1.0 First public version. 
- $translation_plugin = &plugin_load('syntax','translation'); +  * 2010-12-05: 1.1 +Menu: DropDown List with Current Flag; Change repo to github 
- if ( $translation_plugin ) { +  * 2010-12-10: Merge this fork back in to Translation Plugin.
- if ( !plugin_isdisabled($translation_plugin->getPluginName() ) ) { +
- print $translation_plugin->_showTranslations(); +
- } +
- } +
-?> +
-</code>+
  
-//Note:// add this piece of code not at the top or the bottom of ''main.php'' but instead in-between where it makes the best optical impression. You need to experiment a bit to find the best spot.+Development halted. [[Translation]] Plugin is recommended.
  
-In default template it should be beetwen: +===== Screenshots ====
-<code php> +
-    <?php if($conf['breadcrumbs']){?> +
-    <div class="breadcrumbs"> +
-      <?php tpl_breadcrumbs()?> +
-      <?php //tpl_youarehere() //(some people prefer this)?> +
-</code> +
-and +
-<code php> +
-    </div> +
-    <?php }?>+
  
-    <?php if($conf['youarehere']){?> +See [[plugin:translation3:screenshots|page with screenshots]] to get an impression of: 
-    <div class="breadcrumbs"> +  * Dropdown list 
-      <?php tpl_youarehere() ?> +  * Horizontal list 
-    </div> +  * Switcher using Flags icons 
-    <?php }?> +  * Adding description above switcher 
-</code>+  * Adding an explanation link to that description
  
-If you have several themes or skins installed you need to add this piece of code into each ''main.php'' to allow the translation-plugin for every skin. +These features are integrated todays into [[Translation]] Plugin.
- +
-===== Configuration ===== +
-You should use [[plugin:config|Config Manager]] or edit ''conf/local.php'' configuration file. +
- +
-<code php> +
-$conf['plugin']['translation']['translations']  = 'pl,en,fr,de,it';                     // available languages, should be ISO language two letter code +
-$conf['plugin']['translation']['translationns'] = '';                                   // namespace where to activate translation (recommended: empty) +
-$conf['plugin']['translation']['skiptrans']     = '^:(plugin|template):';               // what to skip (regexp) +
-$conf['plugin']['translation']['dropdown']      = 0;                                    // use a dropdown list, recommended for more than 5 languages +
-$conf['plugin']['translation']['translateui']   = 1;                                    // translate the wiki user interface too +
-$conf['plugin']['translation']['flags']         = 1;                                    // use flags (images) instead of ISO code (text), not work with dropdown list  +
-$conf['plugin']['translation']['description']   = 0;                                    // display text similar to "Translations of this page" (in current wiki language) +
-$conf['plugin']['translation']['blankflag']     = 1;                                    // use blank flag image if flag not exist (instead of text) +
-$conf['plugin']['translation']['translateui']   = 1;                                    // translate wiki ui language in language namespaces +
-$conf['plugin']['translation']['redirectstart'] = 1;                                    // redirect start page into a language namespace using browser language detection +
-$conf['plugin']['translation']['checkage']      = 1;                                    // show notice on possible outdated translations +
-$conf['plugin']['translation']['about']         = 'translation:about';                  // page describing the translation process to users +
-$conf['plugin']['translation']['showabout']     = 0;                                    // show link to about translation page +
-$conf['plugin']['translation']['localabout']    = 1;                                    // use localized version of about page (instead of one global about translation page) +
-</code> +
- +
-See: [[#Config|configuration using Config Manager]] +
- +
-Screenshots related to ''dropdown'': +
-  * [[#Menu: DropDown List|Menu: DropDown List]] +
-  * [[#Desc: only link left|Desc: only link left]] +
-Screenshots related to ''flags'': +
-  * [[#Menu: Flags|Menu: Flags]] +
-  * [[#Menu: Flags with blank flag|Menu: Flags with blank flag]] +
-  * [[#Desc: description with link|Desc: description with link]] +
-  * [[#Desc: description without link|Desc: description without link]] +
-  * [[#Desc: only link right|Desc: only link right]] +
-Screenshots related to dropdown off and''flags'' off (both): +
-  * [[#Menu: List|Menu: List]] +
- +
-Screenshots related to ''blankflag'': +
-  * [[#Menu: Flags with blank flag|Menu: Flags with blank flag]] +
-Screenshots related to ''blankflag'' off: +
-  * [[#Menu: Flags|Menu: Flags]] +
- +
-Screenshots related to ''description'': +
-  * [[#Desc: description with link|Desc: description with link]] +
-  * [[#Desc: description without link|Desc: description without link]] +
- +
-Screenshots related to ''description'' off: +
-  * [[#Desc: only link right|Desc: only link right]] +
- +
-Screenshots related to ''showabout'': +
-  * [[#Desc: description with link|Desc: description with link]] +
-  * [[#Desc: only link right|Desc: only link right]] +
- +
-Screenshots related to ''showabout'' off: +
-  * [[#Desc: description without link|Desc: description without link]]+
  
 + 
 See also [[plugin:translation#Configuration|translation plugin configuration]] and [[plugin:translation#Usage|translation plugin usage]]. See also [[plugin:translation#Configuration|translation plugin configuration]] and [[plugin:translation#Usage|translation plugin usage]].
-===== Changes ===== 
-No changes, first public version (2010-11-05). 
- 
-===== Screenshots ==== 
-[[plugin:translation3:screenshots|large screenshots]] 
- 
-==== Config ==== 
-{{http://img257.imageshack.us/img257/5619/configd.png?500|config in Configuration Manager}} 
- 
-==== Menu ==== 
- 
-=== Menu: DropDown List === 
-{{http://img263.imageshack.us/img263/607/78299554.png?500|menu: dropdown list}} 
- 
-=== Menu: List === 
-{{http://img820.imageshack.us/img820/5548/menulist.png?500|menu: list}} 
- 
-=== Menu: Flags === 
-{{http://img577.imageshack.us/img577/2356/menuflags.png?500|menu: flags}} 
- 
-=== Menu: Flags with blank flag === 
-{{http://img294.imageshack.us/img294/3469/menuflagsblankflag.png?500|menu: flags with blank flag}} 
- 
-==== Desc ==== 
- 
-=== Desc: description with link === 
- 
-{{http://img258.imageshack.us/img258/7080/descdescriptionwithlink.png?500|desc: description with link}} 
- 
-=== Desc: description without link === 
- 
-{{http://img139.imageshack.us/img139/3604/descdescriptionwithoutl.png?500|desc: description without link}} 
- 
-=== Desc: only link right === 
  
-{{http://img688.imageshack.us/img688/5919/desconlylinkright.png?500|desc: only link right}} 
  
 ===== Advantages ===== ===== Advantages =====
 Advantages over the: Advantages over the:
  
-  * [[plugin|translation]] +  * [[plugin:translation]] - (after merge no differences were left) 
-    * support for flags (similar to [[plugin|multilingual]], but faster rendering)+    * support for flags (similar to [[plugin:multilingual]], but faster rendering)
     * support for local about translation page (and global)     * support for local about translation page (and global)
     * show/hide link to about translation page     * show/hide link to about translation page
Line 178: Line 61:
     * improved CSS styles     * improved CSS styles
  
-  * [[plugin|multilingual]]+  * [[plugin:multilingual]]
     * good work with redirections     * good work with redirections
     * support for change wiki ui language (language of the user interface may be switched in foreign language namespaces)     * support for change wiki ui language (language of the user interface may be switched in foreign language namespaces)
Line 184: Line 67:
     * faster rendering flags (not use ''html_wikilink'', which may be slow for images)     * faster rendering flags (not use ''html_wikilink'', which may be slow for images)
     * support for non-ISO languages in flag mode (text or blank flag image)     * support for non-ISO languages in flag mode (text or blank flag image)
-    * support for selected or all namespaces (like [[plugin|translation]])+    * support for selected or all namespaces (like [[plugin:translation]])
     * support for local and global about translation page     * support for local and global about translation page
     * support for link to about translation page     * support for link to about translation page
Line 191: Line 74:
  
 ===== Comparison of translation plugins ==== ===== Comparison of translation plugins ====
-^ Plugin ^ [[plugin:flex|FLEX]] ^ [[plugin:multilingual|Multilingual]] ^ [[plugin:translation|Translation]] ^ [[plugin:translation2|Translation2]] ^ [[plugin:translation3|Translation3]] ^ +Not up to date anymore. e.g. Translation3 is merged into Translation. Date: end 2010 
-^ Author | Vincent Tscherter | Daniel Stonier | Andreas Gohr | Markus Birth | Tomasz Tomasik | + 
-^ First version | 2010-02-15 | 2009-02-11 | 2007-06-04 | 2009-02-12 | 2010-11-05 | +^ Plugin ^ [[plugin:multilingual|Multilingual]] ^ [[plugin:translation|Translation]] ^ [[plugin:translation2|Translation2]] ^ [[plugin:translation3|Translation3]] ^ 
-^ Last updated | 2010-02-15 | 2009-02-11 | 2010-07-18 | 2009-02-12 | 2010-12-05 | +^ Author |Daniel Stonier | Andreas Gohr | Markus Birth | Tomasz Tomasik | 
-^ Compatibility | DW 2010-12-25+ | DW 2008-05-05 | DW 2009-12-25 | DW 2009-12-25 -/+ | DW 2009-12-25 | +^ First version | 2009-02-11 | 2007-06-04 | 2009-02-12 | 2010-11-05 | 
-^ Demo | | [[http://snorriheim.dnsdojo.com/doku/doku.php/en:cooking:cooking|Yes]] | | [[http://wiki.birth-online.de/software/php/dw-translation2-plugin|Yes]] | | +^ Last updated | 2009-02-11 | 2010-07-18 | 2009-02-12 | 2010-12-05 | 
-^ Position in template | ''breadcrumbs'' | ''breadcrumbs'' | ''breadcrumbs'' | | ''breadcrumbs'' | +^ Compatibility | DW 2008-05-05 | DW 2009-12-25 | DW 2009-12-25 -/+ | DW 2009-12-25 | 
-^ Popularity | 3/10128 | 24/10128 | 340/10128 | 19/10128 | 0/10128 | +^ Demo | [[http://snorriheim.dnsdojo.com/doku/doku.php/en:cooking:cooking|Yes]] | dokuwiki.org | [[http://wiki.birth-online.de/software/php/dw-translation2-plugin|Yes]] | | 
-^ Global translation | No | Yes | Yes | Yes | Yes | +^ Position in template | ''breadcrumbs'' | ''breadcrumbs'' | | ''breadcrumbs'' | 
-^ Local translation | Yes | No | No | No | No | +^ Popularity | 3 24/10128 | 340/10128 | 19/10128 | 0/10128 | 
-^ Allow limited namespaces | | | Yes (''translationns'') | | Yes (''translationns'') | +^ Global translation | Yes | Yes | Yes | Yes | 
-^ Exceptions (config) | - | Yes (''skiptrans'') | Yes (''skiptrans'') | | Yes (''skiptrans'') | +^ Local translation | No | No | No | No | 
-^ Exceptions (page) | - | | <code>~~NOTRANS~~</code> | | <code>~~NOTRANS~~</code> | +^ Allow limited namespaces |  | Yes (''translationns'') | | Yes (''translationns'') | 
-^ Warn about outdated translations | | No | Yes (''checkage'') | | Yes (''checkage'') | +^ Exceptions (config) | Yes (''skiptrans'') | Yes (''skiptrans'') | | Yes (''skiptrans'') | 
-^  Language integration  ^^^^^^ +^ Exceptions (page) | | <code>~~NOTRANS~~</code> | | <code>~~NOTRANS~~</code> | 
-^ Change wiki ui lang | | Not work :?: (''use_browser_lang'') | Yes (''translateui'') | | Yes (''translateui'') | +^ Warn about outdated translations | No | Yes (''checkage'') | | Yes (''checkage'') | 
-^ Start page redirection | | Buggy | Yes (''redirectstart'') | | Yes (''redirectstart'') | +^  Language integration  ^^^^^ 
-^  Menu  ^^^^^^ +^ Change wiki ui lang | Not work :?: (''use_browser_lang'') | Yes (''translateui'') | | Yes (''translateui'') | 
-^ List | | Yes (''flags'' off) | Yes (''dropdown'' off) | | Yes (''dropdown'' & ''flags'' off) | +^ Start page redirection | Buggy | Yes (''redirectstart'') | | Yes (''redirectstart'') | 
-^ DropDown List | | No | Yes (''dropdown'') | | Yes (''dropdown'') | +^  Menu  ^^^^^ 
-^ DropDown List with Flag | | No | No | | Yes (''dropdown2'' & ''flags'') | +^ List | Yes (''flags'' off) | Yes (''dropdown'' off) | | Yes (''dropdown'' & ''flags'' off) | 
-^ Flags | | Yes (''flags'') | No | | Yes (''flags'') | +^ DropDown List | No | Yes (''dropdown'') | | Yes (''dropdown'') | 
-^ Blank flag | | Not work | | | Yes (''blankflag'') | +^ DropDown List with Flag | No | No | | Yes (''dropdown2'' & ''flags'') | 
-^  __About translation__ page(s) and description  ^^^^^^ +^ Flags | Yes (''flags'') | No | | Yes (''flags'') | 
-^ __About translation__ page | - | Not work :?: (''about'') | Yes (''about'') | | Yes (''about'') | +^ Blank flag | Not work | | | Yes (''blankflag'') | 
-^ Global __about translation__ page | - | | Yes | | Yes | +^  __About translation__ page(s) and description  ^^^^^ 
-^ Multilang __about translation__ pages | - | | No | | Yes (''localabout'') | +^ __About translation__ page | Not work :?: (''about'') | Yes (''about'') | | Yes (''about'') | 
-^ Show/hide link to __about__ page | - | | Always show | | Yes (''showabout'') | +^ Global __about translation__ page | | Yes | | Yes | 
-^ Show/hide description | - | | Always show | | Yes (''description'') |+^ Multilang __about translation__ pages |  | No | | Yes (''localabout'') | 
 +^ Show/hide link to __about__ page  | | Always show | | Yes (''showabout'') | 
 +^ Show/hide description             | | Always show | | Yes (''description'') |
  
 Notes: Notes:
-  * [[plugin:flex|FLEX]] - good for local translation, not good tested by me+  * [[plugin:flex|FLEX]] - good for local translation, not good tested by me. //FLEX Plugin is deleted from repository.//
   * [[plugin:multilingual|Multilingual]] - similar to [[plugin:translation|Translation]], a little buggy (problems with redirections, possible slow images rendering)   * [[plugin:multilingual|Multilingual]] - similar to [[plugin:translation|Translation]], a little buggy (problems with redirections, possible slow images rendering)
   * [[plugin:translation|Translation]] - in my opinion the best plugin for global translation   * [[plugin:translation|Translation]] - in my opinion the best plugin for global translation
   * [[plugin:translation2|Translation2]] - not work for me :-/   * [[plugin:translation2|Translation2]] - not work for me :-/
-  * [[plugin:translation3|Translation3]] - my plugin, based on [[plugin:translation|Translation]] (also have some features from [[plugin:multilingual|Multilingual]]) +  * [[plugin:translation3|Translation3]] - my plugin, based on [[plugin:translation|Translation]] (also have some features from [[plugin:multilingual|Multilingual]]) is now merged back to Translation.
-===== See also ===== +
-  * [[plugin|translation]] +
-  * [[plugin|multilingual]]+
  
-===== Known bugs ===== 
-I didn't change original author (see [[plugin:translation]], which my plugin is based). 
-I think it should be merged with original plugin. 
  
-> *sigh* was it really necessary to have yet another for of the same plugin? why not send patches, or better fork at github and send pull requests?  --- [[user>andi]] //2010/11/05 14:59// 
- 
->> +1  --- [[user>bug]] //2010/11/05 16:19// 
- 
->>> I forked project at github. See [[https://github.com/scx/dokuwiki-plugin-translation|this]]. 
  
 +===== Known bugs =====
 It isn't possible to install/use both [[plugin:translation]] and [[plugin:translation3]]. It isn't possible to install/use both [[plugin:translation]] and [[plugin:translation3]].
- 
-===== Requests/Issues ===== 
-Section for [[plugin:translation3|Translation3 plugin]] users. 
plugin/translation3.1291569304.txt.gz · Last modified: 2010-12-05 18:15 by 79.184.44.181
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki

Global DokuWiki Links