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

Presentation on Japanese doc sprint

on

  • 532 views

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

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

Statistics

Views

Total Views
532
Views on SlideShare
528
Embed Views
4

Actions

Likes
0
Downloads
0
Comments
0

1 Embed 4

https://twitter.com 4

Accessibility

Categories

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.

Cancel
  • Full Name Full Name Comment goes here.
    Are you sure you want to
    Your message goes here
    Processing…
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(https://www.transifex.com)DisplaysectionsSourcedocumentTranslateddocumentRecommendeddocumentTransifex
  •  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
  • 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
  • 6.Check doc book# ls tmp/ja-JP/*Also check PMCmember sebastienspresentationhttp://www.slideshare.net/sebastiengoasguen/how-to-translate-apache-cloudstack-docsPublishing 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="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
  •  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