c:geo User Guide

User Tools

Site Tools

You are here: c:geo User Guide » c:geo User Guide » Translation of this User Guide
Trace:
en:translation

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
en:translation [2018/07/15 22:04] – Informal adressing lineflyeren:translation [2021/04/06 21:19] (current) – [Requirements] Remove self registration, it was disabled lineflyer
Line 1: Line 1:
 +
 ====== Translation of this User Guide ====== ====== Translation of this User Guide ======
  
Line 6: Line 7:
  
 In order to help translating this user guide, you should have a basic knowledge about Wiki systems, that's all. In order to help translating this user guide, you should have a basic knowledge about Wiki systems, that's all.
- 
 ===== Getting started ===== ===== Getting started =====
  
-After you received an account for this Wiki, you can start your translation by simply opening an existing English page, changing the language to your translation language (using the language selector at top left) and creating this page in your language. If your target language is not listed there, please inform our team to get it enabled.+After you received an approval for this Wiki, you can start your translation by simply opening an existing English page, changing the language to your translation language (using the language selector at top left) and creating this page in your language. If your target language is not listed there, please inform our team to get it enabled.
  
 When you start creating the page, the Wiki system will automatically insert a FIXME placeholder to remind, that the translation of the page is ongoing and will paste the English page underneath. You should use this as a starting point and one-by-one translate the page. When you start creating the page, the Wiki system will automatically insert a FIXME placeholder to remind, that the translation of the page is ongoing and will paste the English page underneath. You should use this as a starting point and one-by-one translate the page.
Line 21: Line 21:
   * At some places in the user guide anchors (initiated with #) are used to reference a certain paragraph on a page from within the page itself but also from other pages (e.g. ''cachedetails#top_bar_menu''). The DokuWiki system automatically enables anchors for all headlines (e.g. ''==== Top Bar Menu ===='') , which is a nice feature in general but can make translation cumbersome, as those anchors will change once you translate these headlines.\\ Therefore we are using just another anchor plugin additionally and used it to define a not-to-be-translated anchor below each headline (e.g. ''%%{{%%anchor:top_bar_menu%%}}%%''). This means that you can freely translate the headlines to your language but do not need to care about anchors used in any links on the page. Just leave the anchor tag unchanged on your translated page.   * At some places in the user guide anchors (initiated with #) are used to reference a certain paragraph on a page from within the page itself but also from other pages (e.g. ''cachedetails#top_bar_menu''). The DokuWiki system automatically enables anchors for all headlines (e.g. ''==== Top Bar Menu ===='') , which is a nice feature in general but can make translation cumbersome, as those anchors will change once you translate these headlines.\\ Therefore we are using just another anchor plugin additionally and used it to define a not-to-be-translated anchor below each headline (e.g. ''%%{{%%anchor:top_bar_menu%%}}%%''). This means that you can freely translate the headlines to your language but do not need to care about anchors used in any links on the page. Just leave the anchor tag unchanged on your translated page.
  
-  * In order to serve different languages the DokuWiki translation plugin uses dedicated namespaces for each language (e.g. ''en:cachedetails'' for English, ''de:cachedetails'' for German). So all your translation pages need to be in or below the namespace representing the ISO-code of your language. This will happen automatically if you start creating the pages as described above. Normally it would also be necessary to change the namespace of every link used within the pages, to target the correct language.\\ We tried to make this obsolete by only using relative links (e.g. ''.:cachedetails'' instead of ''en:cachedetails''). This means all the links you initially have on a new page when starting your translation should already target the namespace of your language, you don't need to change any of them.+  * In order to serve different languages the DokuWiki translation plugin uses dedicated namespaces for each language (e.g. ''en:cachedetails'' for English, ''de:cachedetails'' for German). So all your translation pages need to be in or below the namespace representing the ISO-code of your language. This will happen automatically if you start creating the pages as described above. Normally it would also be necessary to change the namespace of every link used within the pages, to target the correct language.\\ We tried to make this obsolete by only using relative links (e.g. ''.:cachedetails'' instead of ''en:cachedetails''). This means all the links you initially have on a new page when starting your translation should already target the namespace of your language, **you don't need to change any of them**.
  
-  * Please be aware, that most of the screenshots used throughout this guide might need to be localized as well as they are in English only. If you are not able to create the corresponding screenshots, just leave the original image link as it is (an English screenshot will be better than no screenshot at all) but mark it with FIXME.\\ All images which are localized shall be stored below the namespace of that language to allow easy distinction. Additionally all images which need no localization (e.g. icon images) are already stored in the [root] namespace and can be used in all languages.+  * Please be aware, that most of the screenshots used throughout this guide might need to be localized as well as they are in English only. If you are not able to create the corresponding screenshots, just leave the original image link as it is (an English screenshot will be better than no screenshot at all)\\ All images which are localized shall be stored below the namespace of that language to allow easy distinction. Additionally all images which need no localization (e.g. icon images) are already stored in the [root] namespace and can be used in all languages.
  
   * Besides the different content pages, there is also a page called ''sidebar'' which contains the quick navigation links you can see left of the content. To translate this page, simply open the [[en:sidebar|english sidebar]] and start translating this page as initially described.   * Besides the different content pages, there is also a page called ''sidebar'' which contains the quick navigation links you can see left of the content. To translate this page, simply open the [[en:sidebar|english sidebar]] and start translating this page as initially described.
Line 30: Line 30:
  
   * For some languages (e.g. German, Spanish) there is a distinction between formal and informal adressing of the user/reader. We decided to use the informal adressing (e.g. german "du") for this user guide. However you can also translate the pages in a way that no direct adressing of the user/reader is required (e.g. using passive form), while this might not always work.   * For some languages (e.g. German, Spanish) there is a distinction between formal and informal adressing of the user/reader. We decided to use the informal adressing (e.g. german "du") for this user guide. However you can also translate the pages in a way that no direct adressing of the user/reader is required (e.g. using passive form), while this might not always work.
-  * + 
 +  * The user guide at many places (e.g. in tables explaining the different menu items) uses the same wording/strings as they are used within the app. When translating the user guide, you should take care to also use the strings/words which are used in your language in c:geo menus. When a certain menu entry is referenced elsewhere in the guide (within the text) it is usually set in ''quotation marks'' to make the reader aware, that this is a menu wording/string. Also here you should use the wording/string which c:geo uses in your language. 
 + 
 +  * If you modify your translated page and even more important if you modify, please kindly do fill in a short description of the change into the "Edit summary" below the edit window. It will help others a lot, e.g. when keeping track of changes later on which need to be adapted onto the translated pages. We meanwhile activated the enforcement of summary, so you either have to tick "Minor change" or fill in the "Edit summary" before saving. We encourage you to also fill in a summary for minor changes to enhance transparency. 
 + 
 +  * Last but not least: If you become aware of mistakes in the translation of c:geo itself (or are simply willing to also help translating the app itself) you can contribute on https://crowdin.com/project/cgeo 
 ===== Don't be afraid ===== ===== Don't be afraid =====
  
Line 38: Line 44:
  
   * [[internal:playground:playground|A playground, which you can use freely to test formatting or syntax]]   * [[internal:playground:playground|A playground, which you can use freely to test formatting or syntax]]
-  * [[internal:wiki:welcome|A small DokuWiki user guide]] 
   * [[internal:wiki:syntax|DokuWiki Syntax]]   * [[internal:wiki:syntax|DokuWiki Syntax]]
   * [[internal:orphans|A summary of the status of each page. You can find wanted/orphaned pages here.]]   * [[internal:orphans|A summary of the status of each page. You can find wanted/orphaned pages here.]]
 +  * [[internal:changes|List of recent changes]]
  
  
en/translation.1531685084.txt.gz · Last modified: 2018/07/15 22:04 by lineflyer

Page Tools

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Noncommercial-Share Alike 4.0 International
CC Attribution-Noncommercial-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki