Presentation on Japanese doc sprint
Upcoming SlideShare
Loading in...5

Presentation on Japanese doc sprint



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

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



Total Views
Views on SlideShare
Embed Views



1 Embed 4 4



Upload Details

Uploaded via as Adobe PDF

Usage Rights

© All Rights Reserved

Report content

Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

  • Full Name Full Name Comment goes here.
    Are you sure you want to
    Your message goes here
Post Comment
Edit your comment

Presentation on Japanese doc sprint Presentation on Japanese doc sprint Presentation Transcript

  • Apache CloudStackJapanese Doc SprintJapanCloudStackUserGroupGo Chiba @go_chiba
  •  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
  •  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
  •  Translatin w/ Transifsx(
  •  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 clone git checkout 4.1# cd cloudstack/docs/publican-cloudstack# ./ rpm –i ~/rpmbuild/RPMS/noarch/publican-cloudstack-0.6-1.el6.noarch.rpmPublishing document
  • 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# ./ tx pull –l ja_JP# publican build --config=publican-all.cfg--formats=html,pdf --langs=ja-JP
  • 6.Check doc book# ls tmp/ja-JP/*Also check PMCmember sebastienspresentation document
  •  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="" />sys-reliability-and-ha.xml: <xi:include href="api-throttling.xml"xmlns:xi="" />api-throttling.xml:6: validity error : ID api-throttlingalready defined
  •  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">
  •  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
  • 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