diff --git a/source/about.txt b/source/about.txt index 1beb0b0ebe7..395cb9ac15b 100644 --- a/source/about.txt +++ b/source/about.txt @@ -99,6 +99,8 @@ current manual in the :hardlink:`release.txt` file. The most up-to-date, current, and stable version of the manual is always available at "http://docs.mongodb.org/manual/." +.. _meta-contributing: + Contributing to the Documentation ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ diff --git a/source/i18n.txt b/source/i18n.txt new file mode 100644 index 00000000000..71703cac759 --- /dev/null +++ b/source/i18n.txt @@ -0,0 +1,65 @@ +.. this file is hardlinked from translations.html in themes/mongodb +.. _internationalization: + +=================================================== +MongoDB Manual Internationalization and Translation +=================================================== +.. default-domain:: mongodb + +The primary language of the MongoDB Documentation is English +(American English at that) but we recognize the need to provide +documentation in additional languages. + +We are using a service provided by `Smartling `_ +to translate the MongoDB documentation into additional languages. + +If you would like to volunteer to translate the MongoDB documentation, +we need you to complete the +`10gen/MongoDB Contributor Agreement `_. +You will also need to create an account on Smartling at +`translate.docs.mongodb.org `_. + +Please use the same email address you use to ``sign`` the Contributor +agreement when you create the Smartling account. + +We have a Google Group for translators at +`mongodb-translators `_ +You can join the Google Group w/o signing the contributor's agreement +but we will need a signed agreement before I add you to the Smartling +project. + +We currently have the following languages configured: + +- `Arabic `_ +- `Chinese `_ +- `Czech `_ +- `German `_ +- `Spanish `_ +- `French `_ +- `Hungarian `_ +- `Indonesian `_ +- `Italian `_ +- `Japanese `_ +- `Korean `_ +- `Lithuanian `_ +- `Polish `_ +- `Portuguese `_ +- `Romanian `_ +- `Russian `_ +- `Turkish `_ +- `Ukrainian `_ + +If we are missing your language please contact us (through the +``Report a Problem`` link above or by posting to ``mongodb-translators``). + +While the translation effort is currently focused on the web site we are +evaluating how to retrieve the translated phrases for use in other +media. + +.. seealso:: + + - :ref:`meta-contributing` + - `Style and Conventions `_ + - `Documentation Organization `_ + - `Practices and Processes `_ + - `Building and Deploying MongoDB Documentation `_ diff --git a/themes/mongodb/analytics.html b/themes/mongodb/analytics.html index 1ec65dce97c..634c3977716 100644 --- a/themes/mongodb/analytics.html +++ b/themes/mongodb/analytics.html @@ -5,7 +5,7 @@ _gaq.push(['_setAccount', '{{theme_google_analytics}}']); _gaq.push(['_setDomainName', 'docs.mongodb.org']); {%- if (pagename == "meta/401") or (pagename == "meta/403") or (pagename == "meta/404") or (pagename == "meta/410") %} -_gaq.push(['_trackPageview', '/{{theme_manaul_path}}/{{pagename}}/?page=' + document.location.pathname + document.location.search + '&from=' + document.referrer]); +_gaq.push(['_trackPageview', '/{{theme_manual_path}}/{{pagename}}/?page=' + document.location.pathname + document.location.search + '&from=' + document.referrer]); {%- else %} _gaq.push(['_trackPageview']); {%- endif %} diff --git a/themes/mongodb/layout.html b/themes/mongodb/layout.html index ab44216b848..91e628cfe91 100644 --- a/themes/mongodb/layout.html +++ b/themes/mongodb/layout.html @@ -132,7 +132,7 @@
  • Download
  • Drivers
  • Events
  • -
  • International
  • +
  • Translations
  • diff --git a/themes/mongodb/translations.html b/themes/mongodb/translations.html index 3a4215daa37..7bcb6b673e7 100644 --- a/themes/mongodb/translations.html +++ b/themes/mongodb/translations.html @@ -1,16 +1,48 @@ +{# This is one pass at adding national language links to pages but I'm concerned + it is making build take significantly longer. It really shouldn't. But perhaps + hardlinks to the languages and a JS thing to click to "this page in Klingon"? +#} +{%- set nlslangs = { + "ar": "Arabic", + "cn": "Chinese", + "cs": "Czech", + "de": "German", + "es": "Spanish", + "fr": "French", + "hu": "Hungarian", + "id": "Indonesian", + "it": "Italian", + "jp": "Japanese", + "ko": "Korean", + "lt": "Lithuanian", + "pl": "Polish", + "pt": "Portuguese", + "ro": "Romanian", + "ru": "Russian", + "tr": "Turkish", + "uk": "Ukrainian" + } +-%}

    Translations

    +

    About the translation project

      +{% set domain = 'docs.mongodb.org' %} +{%- if pagename == "index" %} +{% set temppagename = "" %} +{% elif file_suffix == '' %} +{% set tempagename = pagename + "/" %} +{% else %} +{% set temppagename = pagename %} +{% endif %} {%- if theme_project == 'manual' %} -
    • Japanese
    • -
    • Chinese
    • - +{% set pageuri = theme_manual_path + "/" + temppagename %} {%- elif theme_project == 'ecosystem' %} -
    • Japanese
    • -
    • Chinese
    • - +{% set pageuri = theme_project + "/" + temppagename %} {%- elif theme_project == 'meta-driver' %} -
    • Japanese
    • -
    • Chinese
    • - +{% set pageuri = theme_project + "/" + theme_manual_path + "/" + temppagename %} {%- endif %} +{%- for lc,lang in nlslangs|dictsort(true): -%} +{%- set lang = nlslangs[lc] -%} +
    • {{lang}}
    • +{% endfor -%}