Presentation on Japanese doc sprint

649 views

Published on

My presentation on Japanese doc sprint in Tokyo(Translation for Japanese).

Published in: Technology
0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total views
649
On SlideShare
0
From Embeds
0
Number of Embeds
5
Actions
Shares
0
Downloads
2
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

Presentation on Japanese doc sprint

  1. 1. Apache CloudStackJapanese Doc SprintJapanCloudStackUserGroupGo Chiba @go_chiba
  2. 2.  Go Chiba– Japanse system integrator and supportingcloud technology in Japan– Apache CloudStack Japanese TranslatorTranslating ACS docs on private.And become a one of the ACS committer.– Contactmailto: go.chiba@gmail.comTwitter: @go_chibaIntroduction
  3. 3.  Apache CloudStack have below projects for translating– Document tranlating(Apache CloudStack Docs)– GUI translating(Apache CloudStack UI)– Runbook(Quick Install Guide) translating(Apache CloudStack Runbook)Target
  4. 4.  Translatin w/ Transifsx(https://www.transifex.com)DisplaysectionsSourcedocumentTranslateddocumentRecommendeddocumentTransifex
  5. 5.  Check your translating with Publican(I confirmed on CentOS 6.3)1. Install required tools2. Cone source code from repository and checkout 4.13. Install common contents(e.g. images)# yum install git rpm-build python-setuptools publican# easy_install transifex-client# git clonehttps://git-wip-us.apache.org/repos/asf/cloudstack.git# git checkout 4.1# cd cloudstack/docs/publican-cloudstack# ./gen_rpm.sh# rpm –i ~/rpmbuild/RPMS/noarch/publican-cloudstack-0.6-1.el6.noarch.rpmPublishing document
  6. 6. Publishing document4. Setting transifex client and pull po files5. Running publicanConfig files: all, adminguide, devguide, installation, niciranvp,release-noteFormat : html, html-single, pdf, epub             # cd cloudstack/docs# tx init# ./settx.sh# tx pull –l ja_JP# publican build --config=publican-all.cfg--formats=html,pdf --langs=ja-JP
  7. 7. 6.Check doc book# ls tmp/ja-JP/*Also check PMCmember sebastienspresentationhttp://www.slideshare.net/sebastiengoasguen/how-to-translate-apache-cloudstack-docsPublishing document
  8. 8.  Publicans popular error– Duplicate definitionComent out duplicate definisionfrom cloudstack/docs/en-USapi-throttling.xml:6: validity error : ID api-throttlingalready definedTrouble shooting$ grep <xi:include href="api-throttling.xml" *api-calls.xml: <xi:include href="api-throttling.xml"xmlns:xi="http://www.w3.org/2001/XInclude" />sys-reliability-and-ha.xml: <xi:include href="api-throttling.xml"xmlns:xi="http://www.w3.org/2001/XInclude" />api-throttling.xml:6: validity error : ID api-throttlingalready defined
  9. 9.  Publicans popular error– Reference errorMake sure which file are define ID andadd “<xi:include>” tagconfigure-package-repository.xml:28: validity error : IDREFattribute linkend references an unknown ID "sect-source-buildrpm"1Trouble shooting$ grep <section id="sect-source-buildrpm"> *build-rpm.xml:<section id="sect-source-buildrpm">
  10. 10.  You can report document bugs on JIRA like a code bugs We wellcome your reviewing even if its typos :)– Wrong port number、Miss spell etc…Document bugs
  11. 11. Future of Docs On 4.2…?― You could find some new docsMidonet PluginDocs for GSoC and so on...(But above docs are not fixed yet) We require doc reviewer too!― Integrate fluctuated keywordsVM? Virtual Machine?― Miss copyShould be use “&PRODUCT;” not “CloudPlatform”― Checking URL

×