[OpenStack-docs] [Openstack-i18n] How is openstack-manuals/common-rst updated?

KATO Tomoyuki tomo at dream.daynight.jp
Thu Oct 15 22:45:31 UTC 2015


Hi Akihiro, Andreas,

Ahhhhhh... this must be a bug (I made...).

Cause:
  The tool is simply adding the new strings to common-rst [1].
  So, the unused strings are remaining...

Background (from my understand):
  Each document uses the common contents.
  However, each document has the different exclude_patterns,
  because Sphinx warns if there are unused files.
  Therefore, each document has a partial common-rst file,
  not a whole common-rst.

Solution:
  ... I don't have a good idea as of now...
  Add a new document that contains all common file?
    OpenStack Common Guide (dummy, just to create pot file :)

I will re-consider the situation.
Any idea is welcome.

Regards,
KATO Tomoyuki

[1] https://github.com/openstack/openstack-manuals/blob/master/tools/generatepot-rst.sh#L69
[2] https://github.com/openstack/openstack-manuals/blob/master/doc/install-guide/source/conf.py#L99

> Thanks Andreas,
> 
> It seems I ran "tox -e generatepot-rst" on an unrelated doc.
> Now it works.
> 
> Regarding the problem that I see obsolete strings in the common-rst
> pot, I will investigate more.
> There is no need to rush, but it is worth fixed soon.
> 
> Akihiro
> 
> 2015-10-16 2:24 GMT+09:00 Andreas Jaeger <aj at suse.com>:
> > On 10/15/2015 07:02 PM, Akihiro Motoki wrote:
> >>
> >> Hi team,
> >>
> >> During translation of common-rst in Zanata,
> >> I found a bit odd entries in
> >> openstack-manuals/doc/common-rst/source/locale/common-rst.pot.
> >>
> >> When and how is openstack-manuals/common-rst updated?
> >>
> >> For example, we see the following in common-rst.pot:
> >> ---
> >> #: ../common/app_support.rst:3
> >> msgid "Community support"
> >> msgstr ""
> >>
> >> #: ../common/app_support.rst:5
> >> msgid "Community Support"
> >> msgstr ""
> >> ----
> >>
> >> However, we actually have only the first entry in common-rst/*.rst:
> >> ---
> >> $ grep -r 'Community Support' doc/common-rst/*.rst
> >> $ grep -r 'Community support' doc/common-rst/*.rst
> >> doc/common-rst/app_support.rst:Community support
> >> ---
> >>
> >> If you look at app_support.rst, we have only the first one.
> >> Where does the second one come from?
> >>
> >> In tools/generatepot-rst.sh, processing on 'common-rst' is skipped.
> >> I wonder which script we update common-rst.pot.
> >
> >
> > generatepot-rst.sh generates the file in every invocation, just run "tox -e
> > generatepot-rst -- user-guide"
> >
> > A git status afterwards will show:
> > ...
> >         modified:   doc/common-rst/source/locale/common-rst.pot
> >         modified:   doc/user-guide/source/locale/user-guide.pot
> >
> >
> > Just the invocation "
> > tox -e generatepot-rst -- common-rst" is skipped
> >
> > Still that does not answer your initial question why the line is there
> > twice. Debugging is welcome,
> >
> > Andreas
> > --
> >  Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
> >   SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
> >    GF: Felix Imendörffer, Jane Smithard, Graham Norton,
> >        HRB 21284 (AG Nürnberg)
> >     GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126


More information about the OpenStack-docs mailing list