Return-Path: X-Original-To: apmail-incubator-cloudstack-commits-archive@minotaur.apache.org Delivered-To: apmail-incubator-cloudstack-commits-archive@minotaur.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 9CEF1DB55 for ; Wed, 26 Sep 2012 06:13:56 +0000 (UTC) Received: (qmail 44273 invoked by uid 500); 26 Sep 2012 06:13:56 -0000 Delivered-To: apmail-incubator-cloudstack-commits-archive@incubator.apache.org Received: (qmail 44138 invoked by uid 500); 26 Sep 2012 06:13:55 -0000 Mailing-List: contact cloudstack-commits-help@incubator.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: cloudstack-dev@incubator.apache.org Delivered-To: mailing list cloudstack-commits@incubator.apache.org Received: (qmail 44117 invoked by uid 99); 26 Sep 2012 06:13:55 -0000 Received: from tyr.zones.apache.org (HELO tyr.zones.apache.org) (140.211.11.114) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 26 Sep 2012 06:13:55 +0000 Received: by tyr.zones.apache.org (Postfix, from userid 65534) id 6A69B3BA4D; Wed, 26 Sep 2012 06:13:55 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit From: ke4qqq@apache.org To: cloudstack-commits@incubator.apache.org X-Mailer: ASF-Git Admin Mailer Subject: [3/3] git commit: updating docs on how to handle l10n Message-Id: <20120926061355.6A69B3BA4D@tyr.zones.apache.org> Date: Wed, 26 Sep 2012 06:13:55 +0000 (UTC) updating docs on how to handle l10n Project: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/commit/82f10664 Tree: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/tree/82f10664 Diff: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/diff/82f10664 Branch: refs/heads/master Commit: 82f106646f39341de7f2b07fb40c48af5408d90b Parents: bfc79f5 Author: David Nalley Authored: Wed Sep 26 02:09:13 2012 -0400 Committer: David Nalley Committed: Wed Sep 26 02:09:13 2012 -0400 ---------------------------------------------------------------------- docs/README.txt | 22 +++++++++++++++++++++- 1 files changed, 21 insertions(+), 1 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/82f10664/docs/README.txt ---------------------------------------------------------------------- diff --git a/docs/README.txt b/docs/README.txt index 7fcfff8..41bf749 100644 --- a/docs/README.txt +++ b/docs/README.txt @@ -111,9 +111,29 @@ LOCALIZATION ---------------------------------- -Localized versions of the documentation files can be stored in appropriately named subdirectories parallel to en-US. The language code names to use for these directories are listed in Publican documentation, http://jfearn.fedorapeople.org/en-US/Publican/2.7/html/Users_Guide/appe-Users_Guide-Language_codes.html. +Localized versions of the documentation files can be stored in appropriately +named subdirectories parallel to en-US. The language code names to use for +these directories are listed in Publican documentation, +http://jfearn.fedorapeople.org/en-US/Publican/2.7/html/Users_Guide/appe-Users_Guide-Language_codes.html. For example, Japanese XML files would be stored in the docs/ja-JP directory. +Localization currently happens using Transifex and you can find the strings +to be translated at this location: +https://www.transifex.com/projects/p/ACS_DOCS/ + +In preparation for l10n, authors and docs folks must take not of a number of +things. +All .xml files must contain a translatable string. tags are not enough. +All new .xml files must have a corresponding entry in docs/.tx/config +Filenames should be less than 50 characters long. + +To generate new POT files and upload source do the following: +publican update_pot --config=./publican-all.cfg +tx push -s + +To receive translated files from publican, run the following command: +tx pull + ----------------------------------