DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:translate

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:translate [2014-04-18 07:29] – [Discussion] ariaplugin:translate [2022-04-16 18:09] (current) – Update compatible versions (list) 90.226.46.29
Line 6: Line 6:
 email      : viktor@zuiderkwast.se email      : viktor@zuiderkwast.se
 type       : Action type       : Action
-lastupdate : 2013-08-19 +lastupdate : 2022-04-15 
-compatible : Rincewind+compatible : Angua, Adora Belle, Weatherwax, Binky, Ponder Stibbons, Hrun, Detritus, Elenor of Tsort, Frusterick Manners, Greebo, Hogfather, Igor
 depends    :  depends    : 
 conflicts  conflicts 
 similar    : translation similar    : translation
-tags       : language+tags       : language, translation
  
-downloadurl: http://github.com/zuiderkwast/dokuwiki-plugin-translate/zipball/master +downloadurl: https://github.com/zuiderkwast/dokuwiki-plugin-translate/zipball/master 
-bugtracker : http://github.com/zuiderkwast/dokuwiki-plugin-translate/issues +bugtracker : https://github.com/zuiderkwast/dokuwiki-plugin-translate/issues 
-sourcerepo : http://github.com/zuiderkwast/dokuwiki-plugin-translate/+sourcerepo : https://github.com/zuiderkwast/dokuwiki-plugin-translate/
 donationurl:  donationurl: 
  
Line 33: Line 33:
   * Translation links can be inserted automatically or you can insert them manually in your template   * Translation links can be inserted automatically or you can insert them manually in your template
  
 +{{https://i.ibb.co/7KjFkzD/dokuwiki-translate-plugin.gif}}
 ===== Installation ===== ===== Installation =====
  
-Install the plugin using the [[plugin:plugin|Plugin Manager]] and the download URL above, which points to latest version of the plugin. Refer to [[:Plugins]] on how to install plugins manually.+Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.
  
 ===== Examples/Usage ===== ===== Examples/Usage =====
Line 67: Line 68:
  
   * ''language=//(language code)//''   * ''language=//(language code)//''
-  * ''relation['istranslationof']=//(original page id)//''+  * ''relation['istranslationof']=//array of ID => language-code//'' (assumes only single element in the array)
  
 For the original page, its translations are stored in an associative array: For the original page, its translations are stored in an associative array:
Line 82: Line 83:
  
 The code used to check whether a user is allowed to create a page or not is not 100% reliable, because the page name is not known until a name for the translated page has been chosen. If the user has write permission to the current page (or if the user is in the translators group), she/he is assumed to have permission to create translation pages. This affects only whether the "Translate this page" should be visible. The code used to check whether a user is allowed to create a page or not is not 100% reliable, because the page name is not known until a name for the translated page has been chosen. If the user has write permission to the current page (or if the user is in the translators group), she/he is assumed to have permission to create translation pages. This affects only whether the "Translate this page" should be visible.
 +
 +When activated, [[plugin:dblclickedit]] plugin doesn't work anymore.
  
 === ToDo/Wish List === === ToDo/Wish List ===
Line 89: Line 92:
 ===== Discussion ===== ===== Discussion =====
  
-== Problems ==+== issues ==
 I am using this plug-in to develop a multilingual wiki which uses combination of LTR and RTL languages. There are couple of problems need to be considered: I am using this plug-in to develop a multilingual wiki which uses combination of LTR and RTL languages. There are couple of problems need to be considered:
 +
 1- The bullets used for translation links on pages are not in the right place.  1- The bullets used for translation links on pages are not in the right place. 
 +
 +> This is probably easy to fix by adding a ''rtl.css'' file. Patches are welcome! -- //Viktor, 18 April 2014//
 +
 2- when the UI changes to the RTL languages, the translation links are in the first line of the page in the same line with the page content. it is kind of confusing. leaving one line blank on the page didn't help. 2- when the UI changes to the RTL languages, the translation links are in the first line of the page in the same line with the page content. it is kind of confusing. leaving one line blank on the page didn't help.
 +
 +> This is probably easy to fix by adding a ''rtl.css'' file. Patches are welcome! -- //Viktor, 18 April 2014//
 +
 3- The plug in wouldn't let me to uncheck 'insert_translation_links' in the configuration manager page. 3- The plug in wouldn't let me to uncheck 'insert_translation_links' in the configuration manager page.
  
-== suggestions ==+> That's not good. Does it work to change other settings? What version of DokuWiki are you using? -- //Viktor, 18 April 2014// 
 +>> The version I'm using is 2013-12-08  --//Aria, 21 April 2014// 
 + 
 +== suggestions and wish list ==
 1- it would be awesome if we can select any exist page in the target language as a translate page of current language. now we must start any new pages by using translation link. it is hard when you are moderating a multilingual wiki. 1- it would be awesome if we can select any exist page in the target language as a translate page of current language. now we must start any new pages by using translation link. it is hard when you are moderating a multilingual wiki.
 +
 +> The translation/original page relation and language is stored as metadata on both pages. You could use some plugin that allows you to edit the metadata of pages. Otherwise, it's not that hard do copy the text, delete the page, create the page again using the translation form and then paste the contents, is it? -- //Viktor, 18 April 2014//
 +
 2- it would be perfect if we have a option to show translation links in the pages or in the sidemenu. 2- it would be perfect if we have a option to show translation links in the pages or in the sidemenu.
 +
 +> This can be done if you turn off ''insert_translation_links'' and insert the appropriate code for translation links in your template instead. -- //Viktor, 18 April 2014//
 +
 3- It would be pretty if the translation link has a box titeling 'Other Languages', something like MediaWiki. 3- It would be pretty if the translation link has a box titeling 'Other Languages', something like MediaWiki.
  
- +> This can be done if you turn off ''insert_translation_links'' and insert the appropriate code for translation links in your template instead. -- //Viktor, 18 April 2014// 
 + 
 +> Which code would it be? I saw several function in the `helper.php` of the plugin. Is there a specific code that would provide the translations links to our template ??  
 + 
 +4- It would be great to have an obsolete functionality. To tell the user this language may be obsolete and a newer is better. It could also be the opportunity to have an option to invite people to update the translation to be on par. In admin, it would be useful to have a list of obsolete translation as so translator could easily find them. [[https://github.com/zuiderkwast/dokuwiki-plugin-translate/issues/8]]
plugin/translate.1397798954.txt.gz · Last modified: 2014-04-18 07:29 by aria

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