Migrating Docs to new Transifex server

[Nick Bebout]

Apparently that link won't work.

You can use http://nb.fedorapeople.org/docs.html  although it will not be
totally up to date, I'll try to update it frequently.

Nick

> The following link will show you the status of moving docs translations to
> transifex.net
>
> If you'd like maintainer access to any of them on transifex.net, let me
> know.  maintainer access is necessary for you to be able to push new pot's
> to the server.  Translator access is managed through the "fedora" project,
> not through each's doc's teams.
>
> https://spreadsheets.google.com/a/bebout.net/pub?hl=en&hl=en&key=0AujK8fFAjHezdEdsNlNrTnJpZGdWbUdlbzVxaE45elE&single=true&gid=0&output=html
>
>> 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
>>
>>
>> --
>> docs mailing list
>> docs at lists.fedoraproject.org
>> To unsubscribe:
>> https://admin.fedoraproject.org/mailman/listinfo/docs
>>
>
>
> --
> docs mailing list
> docs at lists.fedoraproject.org
> To unsubscribe:
> https://admin.fedoraproject.org/mailman/listinfo/docs
>