joshua/dash-docs
1
0
Fork 0
mirror of https://github.com/seigler/dash-docs synced 2025-07-27 01:36:13 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Handle urls translations automatically in pages

Browse source 
Internal page urls are now all declared once in _config.yml for each language
Translators can translate file and anchor urls without needing to manually update all pages
This commit is contained in:
Saivann 2013-04-25 18:32:51 -04:00
parent d44bc95a22
commit 21441d310d
56 changed files with 346 additions and 265 deletions
Download patch file Download diff file Expand all files Collapse all files

13
README.md
View file

@ -29,13 +29,12 @@ Installing dependencies on older Ubuntu and Debian distributions
1. Begin, Run ./_contrib/translate (ISO 639-1 language code) (language name) to create your language. Ex : ./_contrib/translate fr "Français"
2. Texts, Open .html files in the appropriate folder and in _layouts and translate all human readable english dialogs (without touching the html tags and the page id).
3. Links, Update the name of each .html file so that it reflects your language and update the links in the .html files accordingly.
4. Sitemap, Add links to your translated pages in _config.yml under their equivalent english version.
5. Images, Update the few images that contain text with any vector image editing software like Inkscape.
6. Languages, Make sure that the languages are listed in alphabetical order in _config.yml
7. Post, Remove pages that use _posts such as "version-history" and "news". Those are not meant to be translated yet.
8. Press, Remove "press coverage" and "interviewees" in the Press center. The rest can be translated.
9. Preview, Check that texts that are limited in size display nicely. For example, right side buttons and some titles have height or width restrictions. You can preview your work without building the website. Just visit the existing english page, open the javascript console of your browser (CTRL + SHIFT + J on Google Chrome) and copy the following command to make the page editable : document.body.contentEditable=true . This will allow you to edit and preview the page in your browser like a document.
3. Links, Update the name of each .html file so that it reflects your language. Add translated links to your pages in _config.yml.
4. Images, Update the few images that contain text with any vector image editing software like Inkscape.
5. Languages, Make sure that the languages are listed in alphabetical order in _config.yml
6. Post, Remove pages that use _posts such as "version-history" and "news". Those are not meant to be translated yet.
7. Press, Remove "press coverage" and "interviewees" in the Press center. The rest can be translated.
8. Preview, Check that texts that are limited in size display nicely. For example, right side buttons and some titles have height or width restrictions. You can preview your work without building the website. Just visit the existing english page, open the javascript console of your browser (CTRL + SHIFT + J on Google Chrome) and copy the following command to make the page editable : document.body.contentEditable=true . This will allow you to edit and preview the page in your browser like a document.
### Update