Transifex: translations missing from guide repo

[Nathan Thomas]

Hi all,

I've received bug report BZ#714735  about the Bulgarian translation of
the Live Image Guide. There's no folder for Bulgarian in the Live Image
Guide git repo, and when I run 'tx pull -all', the Bulgarian translation
isn't pulled (same with the Czech translation, and maybe a few others).
Is there anything I need to do to set up these translations in the git
repo?

Also, I've noticed that some languages have two entries in the Transifex
list - for example, Dutch has 'nl' and 'nl_NL'. In some cases a lot of
work is going into the short-named translation (e.g. 'nl'), but only
changes made to the long-named translation (e.g. 'nl-NL') seem to be
pulled to the git repo when I run 'tx pull'.

See
https://www.transifex.net/projects/p/fedora-readme-live-images/resource/F...

Thanks
Nathan

[Dimitris Glezos]

On Mon, Jun 20, 2011 at 10:10 PM, Nathan Thomas
<nathan(a)afternoondust.co.uk&gt; wrote:
>  I've received bug report BZ#714735  about the Bulgarian
> translation of
>  the Live Image Guide. There's no folder for Bulgarian in the Live Image
>  Guide git repo, and when I run 'tx pull -all', the Bulgarian translation
>  isn't pulled (same with the Czech translation, and maybe a few others).
>  Is there anything I need to do to set up these translations in the git
>  repo? 
The file pull works for me:

 $ tx init
 $ tx set --auto-remote
https://www.transifex.net/projects/p/fedora-readme-live-images/resource/F...
 $ tx pull --lang bg,cz_CZ
 $ ls translations/fedora-readme-live-images.Fedora_Live_Images/*po
 translations/fedora-readme-live-images.Fedora_Live_Images/bg.po
 translations/fedora-readme-live-images.Fedora_Live_Images/cs_CZ.po

>  Also, I've noticed that some languages have two entries in the
> Transifex
>  list - for example, Dutch has 'nl' and 'nl_NL'. In some cases a lot of
>  work is going into the short-named translation (e.g. 'nl'), but only
>  changes made to the long-named translation (e.g. 'nl-NL') seem to be
>  pulled to the git repo when I run 'tx pull'. 
Good point. I'll open a separate thread for this.

-d


-- 
Dimitris Glezos

Transifex: The Multilingual Publishing Revolution
http://www.transifex.net/ -- http://www.indifex.com/

[Nathan Thomas]

Thanks Dimitris, I had tx-client configured correctly, but for some
reason the bg and cs_CZ files aren't being pulled when I run 'tx pull
--all'. If I specify the languages with --lang a folder is created with
the Article_Info.po, Author_Group.po, and Revision_History.po files, but
in both cases the main po file was put in a separate folder called
'translations', with a filename '<lang>.po' instead of
'Fedora_Live_Images.po'.

Is this a change to Publican/Transifex that I've missed? How do I get
Publican to build using the file in the 'translations' folder? At the
moment when I run 'publican build' as per
https://fedoraproject.org/wiki/Publishing_a_document_with_Publican#Prepar..., it simply
falls back to using the en-US Fedora_Live_Images.po.

Thanks,
Nathan

On Mon, 2011-06-20 at 22:51 +0300, Dimitris Glezos wrote:

>  On Mon, Jun 20, 2011 at 10:10 PM, Nathan Thomas
>  <nathan(a)afternoondust.co.uk&gt; wrote:
>  > I've received bug report BZ#714735  about the Bulgarian translation of
>  > the Live Image Guide. There's no folder for Bulgarian in the Live Image
>  > Guide git repo, and when I run 'tx pull -all', the Bulgarian translation
>  > isn't pulled (same with the Czech translation, and maybe a few others).
>  > Is there anything I need to do to set up these translations in the git
>  > repo?
>  
>  The file pull works for me:
>  
>   $ tx init
>   $ tx set --auto-remote
>
> https://www.transifex.net/projects/p/fedora-readme-live-images/resource/F...
>   $ tx pull --lang bg,cz_CZ
>   $ ls translations/fedora-readme-live-images.Fedora_Live_Images/*po
>   translations/fedora-readme-live-images.Fedora_Live_Images/bg.po
>   translations/fedora-readme-live-images.Fedora_Live_Images/cs_CZ.po
>  
>  > Also, I've noticed that some languages have two entries in the Transifex
>  > list - for example, Dutch has 'nl' and 'nl_NL'. In some cases a lot
> of
>  > work is going into the short-named translation (e.g. 'nl'), but only
>  > changes made to the long-named translation (e.g. 'nl-NL') seem to be
>  > pulled to the git repo when I run 'tx pull'.
>  
>  Good point. I'll open a separate thread for this.
>  
>  -d
>  
>  
>  -- 
>  Dimitris Glezos
>  
>  Transifex: The Multilingual Publishing Revolution
>  http://www.transifex.net/ -- http://www.indifex.com/ 

-- 
! Please note my new email address !
My blog: http://afternoondust.wordpress.com
Twitter: nlt_1840

[Dimitris Glezos]

On Tue, Jun 21, 2011 at 12:13 AM, Nathan Thomas <nathan(a)afternoondust.co.uk&gt;
wrote:
>  Thanks Dimitris, I had tx-client configured correctly, but for some reason
>  the bg and cs_CZ files aren't being pulled when I run 'tx pull --all'. If I
>  specify the languages with --lang a folder is created with the
>  Article_Info.po, Author_Group.po, and Revision_History.po files, but in both
>  cases the main po file was put in a separate folder called 'translations',
>  with a filename '<lang>.po' instead of 'Fedora_Live_Images.po'.
Can you please report using the Feedback button at the right-side of
the website?

>  Is this a change to Publican/Transifex that I've missed? How do I
> get
>  Publican to build using the file in the 'translations' folder? At the moment
>  when I run 'publican build' as per
>  https://fedoraproject.org/wiki/Publishing_a_document_with_Publican#Prepar...,
>  it simply falls back to using the en-US Fedora_Live_Images.po. 
You can use Transifex Client to pull translated resources from Transifex to
your local files. By configuring it properly you can, for example, download
"Resource X, Italian" to a local file called
"mydir/anotherdir/myfile-it-IT.xml".

I believe someone else from the Docs team can answer questions about Publican.
A good plan would be for a person who has played around with the tools to setup
a wiki page explaining how to get a doc localized. It should be as easy as
running a couple of commands and committing ``.tx/config`` to your repo.

-d


>  On Mon, 2011-06-20 at 22:51 +0300, Dimitris Glezos wrote:
>
>  On Mon, Jun 20, 2011 at 10:10 PM, Nathan Thomas <nathan(a)afternoondust.co.uk&gt;
>  wrote:
>  > I've received bug report BZ#714735  about the Bulgarian translation of the
>  > Live Image Guide. There's no folder for Bulgarian in the Live Image Guide
>  > git repo, and when I run 'tx pull -all', the Bulgarian translation
> isn't
>  > pulled (same with the Czech translation, and maybe a few others).  Is there
>  > anything I need to do to set up these translations in the git repo?
>
>  The file pull works for me:
>
>   $ tx init $ tx set --auto-remote
>  
> https://www.transifex.net/projects/p/fedora-readme-live-images/resource/F...
>   $ tx pull --lang bg,cz_CZ $ ls
>   translations/fedora-readme-live-images.Fedora_Live_Images/*po
>   translations/fedora-readme-live-images.Fedora_Live_Images/bg.po
>   translations/fedora-readme-live-images.Fedora_Live_Images/cs_CZ.po
>
>  > Also, I've noticed that some languages have two entries in the Transifex
>  > list - for example, Dutch has 'nl' and 'nl_NL'. In some cases a lot
> of work
>  > is going into the short-named translation (e.g. 'nl'), but only changes
>  > made to the long-named translation (e.g. 'nl-NL') seem to be pulled to the
>  > git repo when I run 'tx pull'.
>
>  Good point. I'll open a separate thread for this.
>
>  -d
>
>
>  -- Dimitris Glezos
>
>  Transifex: The Multilingual Publishing Revolution http://www.transifex.net/
>  -- http://www.indifex.com/
>
>  -- ! Please note my new email address !  My blog:
>  http://afternoondust.wordpress.com Twitter: nlt_1840 -- docs mailing list
>  docs(a)lists.fedoraproject.org To unsubscribe:
>  https://admin.fedoraproject.org/mailman/listinfo/docs 


--
Dimitris Glezos

Transifex: The Multilingual Publishing Revolution
http://www.transifex.net/ -- http://www.indifex.com/

[Nathan Thomas]

On Tue, 2011-06-21 at 12:55 +0300, Dimitris Glezos wrote:

>  On Tue, Jun 21, 2011 at 12:13 AM, Nathan Thomas
> <nathan(a)afternoondust.co.uk&gt;
>  wrote:
>  >
>  > Thanks Dimitris, I had tx-client configured correctly, but for some reason
>  > the bg and cs_CZ files aren't being pulled when I run 'tx pull --all'.
> If I
>  > specify the languages with --lang a folder is created with the
>  > Article_Info.po, Author_Group.po, and Revision_History.po files, but in both
>  > cases the main po file was put in a separate folder called 'translations',
>  > with a filename '<lang>.po' instead of
> 'Fedora_Live_Images.po'.
>  
>  Can you please report using the Feedback button at the right-side of
>  the website? 


Which bit would you like me to report, the bit about '--all' not pulling
all languages, or the bit about tx client downloading the main .po file
to a 'translations' folder instead of the appropriate '<lang-code>
folder?

Is the main .po file meant to go in the 'translations' folder now? I'm
not sure the current version of Publican (2.5) supports this behaviour,
which means we can't publish translations for any Fedora documentation
at the moment. CC'ing in Jeff Fearn, the Publican developer/maintainer -
can you confirm this Jeff?

Many thanks,
Nathan

[Dimitris Glezos]

On Tue, Jun 21, 2011 at 3:49 PM, Nathan Thomas
<nathan(a)afternoondust.co.uk&gt; wrote:
>  On Tue, 2011-06-21 at 12:55 +0300, Dimitris Glezos wrote:
>
>  On Tue, Jun 21, 2011 at 12:13 AM, Nathan Thomas <nathan(a)afternoondust.co.uk&gt;
>  wrote:
> >
> > Thanks Dimitris, I had tx-client configured correctly, but for some reason
> > the bg and cs_CZ files aren't being pulled when I run 'tx pull --all'.
> If
> > I
> > specify the languages with --lang a folder is created with the
> > Article_Info.po, Author_Group.po, and Revision_History.po files, but in
> > both
> > cases the main po file was put in a separate folder called 'translations',
> > with a filename '<lang>.po' instead of
> 'Fedora_Live_Images.po'.
>
>  Can you please report using the Feedback button at the right-side of
>  the website?
>
>  Which bit would you like me to report, the bit about '--all' not pulling all
>  languages, or the bit about tx client downloading the main .po file to a
>  'translations' folder instead of the appropriate '<lang-code> folder?
You can report anything that sounds like a bug. The first one sounds
like one. The second one doesn't -- it's just a configuration option
of your client. Refer to the docs for more info and how you can use
the client:

 http://help.transifex.net/user-guide/client/
 http://lists.fedoraproject.org/pipermail/docs/2011-February/013109.html

Fellow Docs owners who have already successfully set up Tx-client can
also help. Here is an example config file from relnotes.

 https://fedorahosted.org/release-notes/browser/.tx/config

>  Is the main .po file meant to go in the 'translations' folder
> now? 
No. Transifex (and Tx-client v0.5) fully support the Publican
directory structure.

-d


-- 
Dimitris Glezos

Transifex: The Multilingual Publishing Revolution
http://www.transifex.net/ -- http://www.indifex.com/