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
account, let
me know and I'll make you a maintainer so you can push updates to your
pot's to
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(a)lists.fedoraproject.org
To unsubscribe:
https://admin.fedoraproject.org/mailman/listinfo/docs