====== Translation3 Plugin ======

---- plugin ----
description: Another translation plugin based on plugin:translation and plugin:multilingual. Merged back.
author     : Tomasz Tomasik
email      : scx.mail@gmail.com
type       : syntax, action
lastupdate : 2010-12-05
compatible : Lemming
depends    : 
conflicts  : translation
similar    : translation, multilingual
tags       : !obsolete

downloadurl: https://github.com/scx/dokuwiki-plugin-translation/zipball/master
bugtracker : https://github.com/scx/dokuwiki-plugin-translation/issues
sourcerepo : https://github.com/scx/dokuwiki-plugin-translation/
donationurl: 
----

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]]**.


===== Download and Installation =====

Repositories:
  * [[https://github.com/scx/dokuwiki-plugin-translation/|New repo]]
  * [[http://scx.isgreat.org/dokuwiki/translation3/|Old repo]]


===== Changes =====
  * 2010-11-05: 1.0 First public version.
  * 2010-12-05: 1.1 +Menu: DropDown List with Current Flag; Change repo to github
  * 2010-12-10: Merge this fork back in to Translation Plugin.

Development halted. [[Translation]] Plugin is recommended.

===== Screenshots ====

See [[plugin:translation3:screenshots|page with screenshots]] to get an impression of:
  * Dropdown list
  * Horizontal list
  * Switcher using Flags icons
  * Adding description above switcher
  * Adding an explanation link to that description

These features are integrated todays into [[Translation]] Plugin.

 
See also [[plugin:translation#Configuration|translation plugin configuration]] and [[plugin:translation#Usage|translation plugin usage]].


===== Advantages =====
Advantages over the:

  * [[plugin:translation]] - (after merge no differences were left)
    * support for flags (similar to [[plugin:multilingual]], but faster rendering)
    * support for local about translation page (and global)
    * show/hide link to about translation page
    * show/hide description "Translations of this page" in current language
    * improved CSS styles

  * [[plugin:multilingual]]
    * good work with redirections
    * support for change wiki ui language (language of the user interface may be switched in foreign language namespaces)
    * support for dropdown list
    * 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 selected or all namespaces (like [[plugin:translation]])
    * support for local and global about translation page
    * support for link to about translation page
    * support for description "Translations of this page" in current language
    * all advantages of [[plugin:translation|Translation plugin]] (version 2010-07-18/2010-11-05)

===== Comparison of translation plugins ====
Not up to date anymore. e.g. Translation3 is merged into Translation. Date: end 2010

^ Plugin ^ [[plugin:multilingual|Multilingual]] ^ [[plugin:translation|Translation]] ^ [[plugin:translation2|Translation2]] ^ [[plugin:translation3|Translation3]] ^
^ Author |Daniel Stonier | Andreas Gohr | Markus Birth | Tomasz Tomasik |
^ First version | 2009-02-11 | 2007-06-04 | 2009-02-12 | 2010-11-05 |
^ Last updated | 2009-02-11 | 2010-07-18 | 2009-02-12 | 2010-12-05 |
^ Compatibility | DW 2008-05-05 | DW 2009-12-25 | DW 2009-12-25 -/+ | DW 2009-12-25 |
^ 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]] | |
^ Position in template | ''breadcrumbs'' | ''breadcrumbs'' | | ''breadcrumbs'' |
^ Popularity | 3 24/10128 | 340/10128 | 19/10128 | 0/10128 |
^ Global translation | Yes | Yes | Yes | Yes |
^ Local translation | No | No | No | No |
^ Allow limited namespaces |  | Yes (''translationns'') | | Yes (''translationns'') |
^ Exceptions (config) | Yes (''skiptrans'') | Yes (''skiptrans'') | | Yes (''skiptrans'') |
^ Exceptions (page) | | <code>~~NOTRANS~~</code> | | <code>~~NOTRANS~~</code> |
^ Warn about outdated translations | No | Yes (''checkage'') | | Yes (''checkage'') |
^  Language integration  ^^^^^
^ Change wiki ui lang | Not work :?: (''use_browser_lang'') | Yes (''translateui'') | | Yes (''translateui'') |
^ Start page redirection | Buggy | Yes (''redirectstart'') | | Yes (''redirectstart'') |
^  Menu  ^^^^^
^ List | Yes (''flags'' off) | Yes (''dropdown'' off) | | Yes (''dropdown'' & ''flags'' off) |
^ DropDown List | No | Yes (''dropdown'') | | Yes (''dropdown'') |
^ DropDown List with Flag | No | No | | Yes (''dropdown2'' & ''flags'') |
^ Flags | Yes (''flags'') | No | | Yes (''flags'') |
^ Blank flag | Not work | | | Yes (''blankflag'') |
^  __About translation__ page(s) and description  ^^^^^
^ __About translation__ page | Not work :?: (''about'') | Yes (''about'') | | Yes (''about'') |
^ Global __about translation__ page | | Yes | | Yes |
^ 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:
  * [[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:translation|Translation]] - in my opinion the best plugin for global translation
  * [[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]]) is now merged back to Translation.



===== Known bugs =====
It isn't possible to install/use both [[plugin:translation]] and [[plugin:translation3]].