How We Continuously Translate Tech Docs

How We Continuously Translate Tech Docs

Talked at Tokyo Rubyist Meetup in 08/16/2016.
https://trbmeetup.doorkeeper.jp/events/49120

Briefly explain about problems to translate tech documents like RailsGuides (1,500pages+) and RailsTutorial (700pages+), and sharing knowledges and experiences how we're trying to keep them up-to-date, which includes how we get a commit bit from rails/rails documentation team and how we make money from free online documents in order to continuously translate with communities.

「Railsチュートリアル (700p)」や「Railsガイド (1,500p)」といった大型の技術ドキュメントを翻訳するときの問題点や、継続的に翻訳するために試行錯誤している現状について共有します。また、Railsの公式ドキュメントチームからコミット権をもらった経緯や、無料で公開しているドキュメントでどういったビジネス展開が可能かについてもお話しします。

YassLab - Having a Good Life with OpenSource ;)
http://yasslab.jp/

Fffb9af58e08cf384f2a8c1c40c3d38d?s=128

Yohei Yasukawa

August 16, 2016
Tweet

Transcript

  1. )PX8F$POUJOVPVTMZ 5SBOTMBUF5FDI%PDVNFOUT :BTT-BC

  2. *`NDPGPVOEFSPG3BJMT5FDI%PDT 5SBOTMBUJPO1SPKFDUTJODF

  3. *`NDPGPVOEFSPG3BJMT5FDI%PDT 5SBOTMBUJPO1SPKFDUTJODF 700P 1,500P

  4. Printed Edition (¥30,000/book )

  5. In Japan, you can find them by googling ’Rails’

  6. Often-used by Ruby communities and help many Rails learners in

    Japan
  7. so got an award by Matz in 2014

  8. ܧଓత຋༁γεςϜ Continuous Translation System

  9. A translation system that keeps translated tech documents always up-to-date

  10. by reducing costs,

  11. by making money,

  12. UPCF"-8":4GSFTIEPDT

  13. Origin Translate API Heroku Gumroad HTML PDF / EPUB Intermediate

    Format Scaffold Basic Translation Figure of the system ᶃ ᶅ ᶄ
  14. Heroku Gumroad HTML PDF / EPUB ᶃ ᶅ ᶆ ᶄ

    ᶇ Translation part Origin Intermediate Format Scaffold Basic Translation Translate API
  15. Heroku Gumroad HTML ຋༁نൣͷ࡞੒ (ॳճͷΈ) PDF / EPUB ᶃ ᶅ

    ᶆ ᶄ ᶇ Selling part Intermediate Format Translate API Origin
  16. Heroku Gumroad HTML PDF / EPUB Monitoring / Feedback Origin

    Intermediate Format Scaffold Basic Translation ᶃ ᶅ ᶄ Translate API
  17. NFSHFVQTUSFBNTDSJQU

  18. &BTJFSUPDPNQBSF  FBTJFSUPTFOEGFFECBDLT

  19. .JTUBLFTBSF1VMM3FRVFTU$IBODF

  20. 0OFPGVTHPUrails docs DPNNJUCJU

  21. :PVDBOCFJO3BJMT0SHBOJ[BUJPO

  22. None
  23. :PVOFWFSLOPXXIFOUIFOFYU QFSTPOXIPTUBSUTKVTUpYJOHB NJTTQFMMJOHJOUIFEPDVNFOUBUJPO FOETVQJNQMFNFOUJOHUIFOFYU HSFBUGFBUVSF #VUZPVTUBOEBDIBODFUPpOEPVU JGZPVTNJMFBOETBZUIBOLZPVGPS XIBUFWFSTNBMMDPOUSJCVUJPOUIBU HFUTUIFNPUJWBUJPOqPXJOH

  24. JP docs EN docs Code Going Step by Step

  25. Heroku Gumroad HTML PDF / EPUB Build a scaffold of

    translation Origin Intermediate Format Scaffold Basic Translation ᶅ ᶄ ᶃ Translate API
  26. Google’s one is great for start. TRANSLATOR TOOLKIT (But NOT

    good for continuous updates because it costs a lot and can’t automate)
  27. TRANSLATION MEMORY Tech for Re-using Translation Cut into a segment

    Translate by segment
  28. TRANSLATION MEMORY But no APIs provided by GTT Cut into

    a segment Translate by segment
  29. Heroku Gumroad HTML PDF / EPUB Continuous Updates Translate API

    Intermediate Format Scaffold Basic Translation Origin ᶃ ᶅ ᶄ
  30. TRANSLATION MEMORY GTT can export TMX file Cut into a

    segment Translate by segment
  31. yasslab / konjak Handle TMX and Get a diff

  32. INTEGRATE W/ API e.g. Send it to Google Translate API

  33. INTEGRATE W/ API Or, you can use Gengo API, too.

  34. SAMPLE OUTPUT

  35. So, integrate them into one web service, named Gitlate.

  36. Register original repo and target branch Preview

  37. Automatically collect new commits that need to translate by hand

    (or by API) Preview
  38. Translate only updated parts Preview

  39. Send your commit as a PR Preview

  40. We’re planning on releasing this
 as a web service for

    other OSS projects Preview
  41. Scaffold Basic Translation Heroku Gumroad HTML PDF / EPUB Intermediate

    Format Origin Generate HTML / Test / Deploy ᶆ ᶇ Translate API
  42. TEST FOR CONTENTS

  43. GENERATE HTML

  44. LINK TO YOUR PRODUCT

  45. Scaffold Basic Translation Heroku Gumroad HTML PDF / EPUB Intermediate

    Format Origin Generate Ebook / Test / Deploy ᶇ ᶆ Translate API
  46. MARKDOWN -> REVIEW

  47. yasslab / hamidashi Test if printed outside area

  48. GENERATE EBOOK

  49. PUBLISH ON GUMROAD

  50. from http://railsguides.jp/

  51. DEMO: Ebook Edition

  52. Over 1,000 pages (PDF)

  53. Other experimental ways to sell contents

  54. 5-DAYS BLOCK SEMINAR

  55. RECORDED VER. (32H)

  56. SELLING @ COMIC MARKET YOUR_COUPON_CODE

  57. Heroku Gumroad HTML PDF / EPUB Origin Translate API Intermediate

    Format Scaffold Basic Translation ᶃ ᶅ ᶆ ᶄ ᶇ
  58. Heroku Gumroad HTML PDF / EPUB Origin Translate API Intermediate

    Format Scaffold Basic Translation ᶃ ᶅ ᶆ ᶄ ᶇ 'FFECBDL 6QEBUF "UUSBDU 4FMM
  59. ༧ࢉΛ૿΍͢ (VJEFT 5VUPSJBM

  60. ܧଓత຋༁γεςϜ Continuous Translation System

  61. by reducing costs,

  62. by making money,

  63. UPCF"-8":4GSFTIEPDT

  64. /PUBOPOFTIPUUSBOTMBUJPOQSPKFDU  CVUCFBDPOUJOVPVTMZSVOOBCMFQSPKFDU Be Continuous

  65. )PX8F$POUJOVPVTMZ 5SBOTMBUF5FDI%PDVNFOUT :BTT-BC

  66. provided by http://yasslab.jp/