Download as PDF, PPTX
Apache CloudStack Documentation
- 1. #osc12cloud ドキュメンテーションに参加しよう シトリックス・システムズ・ジャパン（株） マーケティング本部 北瀬公彦 @kkitase
- 2. CloudStack Collaboration Conference inラスベガス • 世界中のCloudStackコミュニティが 一同に集まる国際カンファレンス • 11/30 – 12/2 までの間、 ラスベガスのヴェネチアンホテルにて開催 • 50以上のセッション ᵒ アーキテクチャ、プロセス、ドキュメンテー ション、エコシステム、構築系等 ᵒ ハッシュタグ #ccc12 ᵒ 録画は後程アップロードされる予定 ᵒ 全てslideshareにて資料は公開 参考: http://www.aarondelp.com/2012/12/links-to- everything-cloudstack.html
- 3. Apache CloudStack Docウェブサイト http://incubator.apache.org/cloudstack/docs/en-US/index.html
- 4. Pre-Apache CloudStack Docウェブサイト http://docs.cloudstack.org/
- 5. CloudStack ドキュメンテーションの歴史 • 2012年4月にCloudStackをApacheSoftware Foundationに、Citrixが寄贈 • Citrix テクパブチーム、既存のドキュメントを寄贈 • 2012年12月現在、CloudStackはASFのインキュベーションプロジェクト • CloudStackプロジェクトには、様々なドキュメントが既に存在 ᵒ インストールガイド、簡易インストールガイド、管理者ガイド等 ᵒ Word、PDFで生成されている しかし、OSSのプロジェクトでは、 ………… 翻訳しにくい ………… 管理にしくい
- 6. Word/PDF DocbookXMLへ変換中 • Docbook XML採用 • Wordから、Docbook XMLへ変換 – マニュアルで変換してます。。。 • 色んなツールもあったけど、結局カットアンドペーストでやってます。。。 – ooo2sdbk, aka Bellot's Convertisseur: Seems to require a lot of customization; and is in French – pcwTextExportr: Tried, didn’t work – OpenOffice "save as Docbook XML" feature, requires you to download XSLT & find instructions for XML filter: Download links = broken – YAWC: “no longer provide support” = likely converts to an outdated Docbook format – Hire a format conversion service – Automate using OOo SDK • マニュアルも悪くない – ドキュメンテーションのレビューもできる、デザインを改善したり、不要なものを落としたり。。。
- 7.
- 8.
- 9. Publican fedorahosted.org/publican/ • FedoraのプロジェクトでRed Hat社等でマニュアルを生成する際に 使われている – PDFやHTMLフォーマットへ出力 • 翻訳用にPOファイルを生成 • ユーザーガイド jfearn.fedorapeople.org/en- US/Publican/2.7/html/Users_Guide/index.html
- 10. 翻訳しよう！Transifex 最初に言語を作成する場合、 https://www.transifex.com リソースタブ いずれかのリソース projects/p/ACS_DOCS/ 新しい翻訳を追加 でリソースを作成する 言語は、Japanese (japan) ja-JP を指定する
- 11.
- 12. ドキュメントバグを修正しよう！Review Board https://reviews.apache.org/groups/cloudstack 余力があれば、ドキュメントの 修正にもチャレンジしよう。 ドキュメントを修正すれば、 Review Boardにパッチをのせ、 コミッターがその修正をコミッ トするのを待とう。
- 13. 継続的インテグレーションツール Jenkins http://jenkins.cloudstack.org コミット等があれば、 自動的にビルドが行われ PDFが生成される
- 14. リファレンス • ウェブ: – 本家: http://cloudstack.org – 日本語: http://cloudstack.jp • メーリングリスト: – cloudstack-dev@incubator.apache.org – cloudstack-users@incubator.apache.org – 日本語: users@cloudstack.jp • IRC: – #cloudstack on irc.freenode.net • Facebook: – www.facebook.com/groups/cloudstack/ – www.facebook.com/cloudstackjapan • ドキュメントバグのレポートの方法や、貢献について – cwiki.apache.org/confluence/display/CLOUDSTACK/How+to+File+a+Documentation+Bug – cwiki.apache.org/confluence/display/CLOUDSTACK/CloudStack+Documentation+Contributors+Overview – cwiki.apache.org/confluence/display/CLOUDSTACK/Documentation+Team
- 15. ご清聴ありがとうございました。 ドキュメンテーションの参加を お待ちしております!!