Migrating Docs to new Transifex server

[Nick Bebout]

I'm working on adding our docs to transifex.net which will also involve
branching them for f15.  If for some reason you don't want me to branch
your guide, let me know.  Also, if you have a transifex.net account, let
me know and I'll make you a maintainer so you can push updates to your
pot's to transifex.net

Nick

> Hey all.
>
> As many of you already heard, we are migrating our Transifex server to
> fedora.transifex.net. For more info, please refer to the logistics and
> translation lists.
>
> We have already manually migrated the core Fedora apps (ones we are
> upstream and are affected by the string freeze). The Docs projects
> will need to migrate its projects as well.
>
> Compared to our old setup, we have changed the way project maintainers
> interact with Transifex. We now have a command-line client to push
> source files (POT) & pull translations (PO). Here are the instructions
> on how to manage your docs project.
>
>
> Create your project
> ===================
>
> As an example, I already migrated the release notes:
>
>   http://www.transifex.net/projects/p/fedora-release-notes/
>
> To create your project and setup your client, run the following. This
> only needs to be run once:
>
> - Login or Create account on Transifex.net
> - Create project:
>   Transifex → Projects → Create → MyProjectName
> - Share teams with Fedora Project:
>   Transifex → MyProjectName → Access Control → Outsource → "Fedora
> Project"
> - Push existing translations to the server:
>
>     $ git clone http://git.fedorahosted.org/git/anaconda.git
>     $ cd anaconda
>     $ tx init
>     $ tx set --auto-local -r anaconda.master 'po/<lang>.po' \
>       --source-lang en --source-file po/anaconda.pot
>
> Especially for docs, which have a bunch of POT files, we'll need
> multiple "tx set" commands like this, which we get by running the
> following:
>
>   for POTFILE in `ls pot`; do
>     FILE=$(basename "$POTFILE" .pot)
>     tx set --auto-local -r fedora-docs-relnotes.$FILE --source-language=en
> \
>     --source-file pot/$FILE.pot "<lang>/$FILE.po" --execute
>   done
>
> These commands will create a file called '.tx/config', which tells the
> client what translations to pull from the server and in which local
> files to put them. This will be needed by other Docs people to test,
> so you should commit this file in your repo. Feel free to open it,
> modify and check whether things look correct.
>
>
> Pushing source languages & pulling translations
> ===============================================
>
> Now we can simply push our source files to the server:
>
>   $ tx push --source
>   Pushing translations for resource fedora-docs-relnotes.Amateur_Radio:
>   Pushing source file (pot/Amateur_Radio.pot)
>   ...
>
> Since we want to pre-populate our translations too from our existing
> ones, we do this.
>
>   $ tx push --translations
>   Pushing translations for resource fedora-docs-relnotes.Amateur_Radio:
>   Pushing 'da-DK' translations (file: da-DK/Amateur_Radio.po)
>   ...
>
> Because Publican generates a bunch of unneeded (mostly empty) translation
> files, your push will take a million years and make our server hate you
> forever.
>
> When you are ready to publish a document, you'll need to pull fresh
> translations. To do this, simply run 'tx pull'.
>
> More info:
> http://help.transifex.net/user-guide/client/client-0.4.html#for-developers
>
>
> Your project in the Fedora 15 release
> =====================================
>
> We track the Fedora 15 release here:
>
>   http://www.transifex.net/projects/p/fedora/r/fedora-15/
>
> To include your project in the Fedora 15 release (or a separate Fedora
> Docs),
> a Fedora L10n admin needs to do the following. If you're not a member of
> the
> Fedora L10n Admin team, just ping us and we'll include your project in the
> release.
>
>   Transifex → Fedora Project → Release 15 → Edit → Resources →
> MyProject
>
>
> Downloading translations of a whole release
> ===========================================
>
> We encourage translators to translate using the online editor, since
> it offers many additional features than the offline one. However, we
> sometimes prefer to download translation files, either for offline
> translation or for backup. Translators can pull only the translation
> files they want for a whole release, without worrying about source
> code or other languages (including English). Here's how:
>
>   $ cd my-translations
>   $ tx set --auto-remote
> http://www.transifex.net/projects/p/fedora/r/fedora-15/
>   $ tx pull --language el
>   $ ll translations/*/el.po
>   translations/anaconda.master/el.po
>   translations/usermode.master/el.po
>
> More info:
> http://help.transifex.net/user-guide/client/client-0.4.html#auto-remote
> http://help.transifex.net/user-guide/client/client-0.4.html#for-translators
>
>
> Hope this helps!
>
> -d
>
>
> --
> Dimitris Glezos
>
> Transifex: The Multilingual Publishing Revolution
> http://www.transifex.net/ -- http://www.indifex.com/
> --
> docs mailing list
> docs at lists.fedoraproject.org
> To unsubscribe:
> https://admin.fedoraproject.org/mailman/listinfo/docs