[Openstack-i18n] [OpenStack-docs] Status of the RST Documentation Toolchain

Andreas Jaeger aj at suse.com
Thu Apr 16 13:26:37 UTC 2015

On 04/16/2015 03:01 PM, Anne Gentle wrote:
> On Thu, Apr 16, 2015 at 4:42 AM, Ying Chun Guo <guoyingc at cn.ibm.com
> <mailto:guoyingc at cn.ibm.com>> wrote:
>     Hello,
>     There was a meeting with translators in IRC.
>     Andreas Jaeger and Lana Brindley from doc team attended.
>     François Bureau from French team, SungJin Kang from Korean team
>     and myself from Chinese team attended the meeting.
>     Firstly, Andreas confirmed that the tool chain was extendable.
>     The preprocessing of po/pot before translation could be implemented
>     in tools/generatepot-rst.sh.
>     The postprocessing of po after translation could be done either as
>     part of the building process,
>     or as part of the infra scripts -
>     propose_translation_update_manuals.sh .
>     Then we talked about how to translate those strings with rst markups.
>     rst markups are more difficult to identified than XML tags.
>     That's why a translators RST cheat sheet is needed.
>     Andreas and Lana explained some markups to translators.
>     At last, all the attendees from translation teams were fine with the
>     rst conversion.
>     I will continue to maintain the translators cheat sheet.
>     If doc writers introduce new mark ups, don't forget to add to the
>     cheat sheet.
>     The sheet can help the new translators easily understand how to
>     translate.
>     I think we got the agreement to go on.
>     Many thanks to the attendees.
> Wonderful news, thanks to everyone who worked through it together.
> I love the wiki "cheat sheet" and will be using it myself often. Thank
> you Olga for identifying additions, please put them on the wiki page for
> us all to use.
> For next steps, I'd like to have the RST guide published prior to our
> last bug day for Kilo.
> Our remaining tasks are on the wiki page at:
> https://wiki.openstack.org/wiki/Documentation/Migrate#Publishing_User_Guides
> Andreas, does the 17th (tomorrow) work for you? These are the remaining
> steps for publishing:

Anne and myself discussed on IRC, here's the plan on what we do tomorrow:

* Publishing new content, 6:00 UTC or later, ajaeger will approve and do 
fixes as needed:
         Remove entries from .tx/config for guides (ajaeger, done)
         Remove doc/user-guide, doc/user-guide-admin, doc/hot-guide/ 
directories (ajaeger)
         publish new User Guides to proper place (ajaeger)
         Update entries to index.html pages pointing to new content 

* Removal of old content, 12:00 UTC or later, annegentle will approve 
and do fixes as needed:
         Update sitemap.xml (annegentle)
         Add redirects for moved pages removing extra /content/ 
directory (annegentle)
         Remove old pages from /content/ directory for both user-guide 
and user-guide-admin on FTP server (annegentle)

If anything is missing, tell us!

  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, Jennifer Guild, Dilip Upmanyu,
        Graham Norton, HRB 21284 (AG Nürnberg)
     GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126

More information about the Openstack-i18n mailing list