Slide 1
Slide 1 text
@unsoluble_sugar
2024/07/30
エンジニア達の「完全に理解した」Talk #55
ドキュメント翻訳から始める
OSS推し活
Slide 2
Slide 2 text
自己紹介
@unsoluble_sugar
➢ Unleashed Inc. / CTO
➢ Easy Easy / Organizer - PR
➢ Tech Hunter / Blogger, Engineer
➢ Tech Team Journal / Writer
Illustration by @ssm_a_u
Slide 3
Slide 3 text
Developer eXperience Day 2024 講演レポート
https://ttj.paiza.jp
Tech Team Journal をチェック！
Slide 4
Slide 4 text
OSS推し活、
してますか？
「OSS推し活」とは
OSSで推し活をすることです
Slide 5
Slide 5 text
この勉強会で推しソフトを紹介している者だ
https://speakerdeck.com/unsoluble_sugar/rvc-with-vcclient-completely-understood
https://speakerdeck.com/unsoluble_sugar/vmagicmirror-completely-understood
Slide 6
Slide 6 text
2020年…おめシスのOSSホームページ企画に参加
https://qiita.com/unsoluble_sugar/items/120f0856d497ef96010e
Slide 7
Slide 7 text
反省点
https://qiita.com/unsoluble_sugar/items/120f0856d497ef96010e
Slide 8
Slide 8 text
最近の推し「Warudo」
https://warudo.app
Slide 9
Slide 9 text
ソフトは日本語化済み ドキュメントの
日本語翻訳がない状態
Slide 10
Slide 10 text
リポジトリ公開されていたので現状確認
https://github.com/HakuyaLabs/warudo-docs/issues/13
Slide 11
Slide 11 text
リポジトリオーナー、Warudo開発者から返信
https://github.com/HakuyaLabs/warudo-docs/issues/13
Slide 12
Slide 12 text
やるぞ
ドキュメント
翻訳
Slide 13
Slide 13 text
まずは
コントリビューター
向けページの対応
機械翻訳の内容を修正
Slide 14
Slide 14 text
Metaの静的サイトジェネレーター「Docusaurus」
https://docusaurus.io/
Slide 15
Slide 15 text
環境構築
➢ Node.js（LTS）
yarnコマンドを使うよ
➢ GitHub Desktop
もちろんコマンドや他GUIソフトでも良いよ
➢ VS Code
宗教戦争反対
Slide 16
Slide 16 text
作業の流れ
➢ リポジトリの fork & clone
https://github.com/HakuyaLabs/warudo-docs/
➢ 作業 branch 切る
➢ local 環境で起動&翻訳作業
yarn start:all
➢ commit 内容を push
➢ pull request 投げる
➢ 問題なければ merge & 反映
ページ下部に名前が載るよ
Slide 17
Slide 17 text
英語、中国語テキスト見ながら実際に画面操作して翻訳
Slide 18
Slide 18 text
日本語UIスクショ撮るよ！
Slide 19
Slide 19 text
連携アプリの日本語UIスクショも撮るよ！！
Slide 20
Slide 20 text
約100ページ
あります
✌(’ω’✌ )三✌(’ω’)✌三(
✌’ω’)✌
情報量の多いページは１万字超え
Slide 21
Slide 21 text
３割くらい対応完了。Zennに経過記録
https://zenn.dev/unsoluble_sugar/scraps/94ef02ee3bc0d7
Slide 22
Slide 22 text
ドキュメントから完全に理解していくぞ
Slide 23
Slide 23 text
～issue例～
日本語検索の問題
カタカナ検索ができない！？
（絶望）
https://github.com/HakuyaLabs/warudo-docs/issues/26
Slide 24
Slide 24 text
当初採用されていた検索プラグインの仕様
●
Slide 25
Slide 25 text
Algolia DocSearchへ移行して解決
Slide 26
Slide 26 text
～issue例～
プロトコル名称について
混乱を招く表記の修正
https://x.com/ElvCatDev/status/1665261111338471424
https://github.com/HakuyaLabs/warudo-docs/pull/53
Slide 27
Slide 27 text
～issue例～
リンク切れ修正
誤字脱字
typo
小さなcommitも貢献のうち
https://github.com/HakuyaLabs/warudo-docs/pull/58
Slide 28
Slide 28 text
OSSによる貢献 全人類
Happy!
【VTuber】
輝く
【ワイ】
知見を得られる
開発者に喜んでもらえる
推しソフトのユーザーが増えていく様子を楽しめる
VTuber&リスナーの楽しげな姿が見られる
色んなクリエイターに出会える
【開発者】
助かる
【リスナー】
輝く推しが見られる