On 04/16/2015 03:01 PM, Anne Gentle wrote:
On Thu, Apr 16, 2015 at 4:42 AM, Ying Chun Guo <guoyingc@cn.ibm.com <mailto:guoyingc@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 (annegentle) * 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 -- 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