---
title: ドキュメント翻訳から始めるOSS推し活
tags:  #oss #翻訳 #ドキュメント  
author: [星影](https://www.docswell.com/user/unsoluble_sugar)
site: [Docswell](https://www.docswell.com/)
thumbnail: https://bcdn.docswell.com/page/YE9W3WV3E3.jpg?width=480
description: エンジニア達の「完全に理解した」Talk #55 の発表スライドです。 Warudo Handbook（公式ドキュメント）の日本語翻訳をしている話をしました。 https://easy2.connpass.com/event/323524/
published: October 02, 24
canonical: https://www.docswell.com/s/unsoluble_sugar/5R2QEN-2024-10-02-174747
---
# Page. 1

![Page Image](https://bcdn.docswell.com/page/YE9W3WV3E3.jpg)

ドキュメント翻訳から始める
OSS推し活
@unsoluble_sugar
2024/07/30
エンジニア達の「完全に理解した」Talk #55


# Page. 2

![Page Image](https://bcdn.docswell.com/page/GE8NMNPL7D.jpg)

自己紹介
@unsoluble_sugar
Illustration by @ssm_a_u
➢
Unleashed Inc. / CTO
➢
Easy Easy / Organizer - PR
➢
Tech Hunter / Blogger, Engineer
➢
Tech Team Journal / Writer


# Page. 3

![Page Image](https://bcdn.docswell.com/page/LELP3P1Q7R.jpg)

Developer eXperience Day 2024 講演レポート
Tech Team Journal をチェック！
https://ttj.paiza.jp


# Page. 4

![Page Image](https://bcdn.docswell.com/page/4JM4D45K7W.jpg)

OSS推し活、
してますか？
「OSS推し活」とは
OSSで推し活をすることです


# Page. 5

![Page Image](https://bcdn.docswell.com/page/PJRW4W3679.jpg)

この勉強会で推しソフトを紹介している者だ
https://speakerdeck.com/unsoluble_sugar/vmagicmirror-completely-understood
https://speakerdeck.com/unsoluble_sugar/rvc-with-vcclient-completely-understood


# Page. 6

![Page Image](https://bcdn.docswell.com/page/PEXP2P4D7X.jpg)

2020年…おめシスのOSSホームページ企画に参加
https://qiita.com/unsoluble_sugar/items/120f0856d497ef96010e


# Page. 7

![Page Image](https://bcdn.docswell.com/page/3EKDMDZDJD.jpg)

反省点
https://qiita.com/unsoluble_sugar/items/120f0856d497ef96010e


# Page. 8

![Page Image](https://bcdn.docswell.com/page/L73RYRDPJ5.jpg)

最近の推し「Warudo」
https://warudo.app


# Page. 9

![Page Image](https://bcdn.docswell.com/page/87DY5YP37G.jpg)

ソフトは日本語化済み
ドキュメントの
日本語翻訳がない状態


# Page. 10

![Page Image](https://bcdn.docswell.com/page/VJP6G6NPE8.jpg)

リポジトリ公開されていたので現状確認
https://github.com/HakuyaLabs/warudo-docs/issues/13


# Page. 11

![Page Image](https://bcdn.docswell.com/page/2EV363KV7Q.jpg)

リポジトリオーナー、Warudo開発者から返信
https://github.com/HakuyaLabs/warudo-docs/issues/13


# Page. 12

![Page Image](https://bcdn.docswell.com/page/57G3N3Q1JL.jpg)

やるぞ
ドキュメント
翻訳


# Page. 13

![Page Image](https://bcdn.docswell.com/page/4EQ5Q5KNJP.jpg)

まずは
コントリビューター
向けページの対応
機械翻訳の内容を修正


# Page. 14

![Page Image](https://bcdn.docswell.com/page/KJ49N9P371.jpg)

Metaの静的サイトジェネレーター「Docusaurus」
https://docusaurus.io/


# Page. 15

![Page Image](https://bcdn.docswell.com/page/LE1K5K9ZJG.jpg)

環境構築
➢
Node.js（LTS）
yarnコマンドを使うよ
➢
GitHub Desktop
もちろんコマンドや他GUIソフトでも良いよ
➢
VS Code
宗教戦争反対


# Page. 16

![Page Image](https://bcdn.docswell.com/page/GEWD5DQ6J2.jpg)

作業の流れ
➢
リポジトリの fork &amp; clone
https://github.com/HakuyaLabs/warudo-docs/
➢
作業 branch 切る
➢
local 環境で起動&amp;翻訳作業
yarn start:all
➢
commit 内容を push
➢
pull request 投げる
➢
問題なければ merge &amp; 反映
ページ下部に名前が載るよ


# Page. 17

![Page Image](https://bcdn.docswell.com/page/47ZGNGWRE3.jpg)

英語、中国語テキスト見ながら実際に画面操作して翻訳


# Page. 18

![Page Image](https://bcdn.docswell.com/page/YJ6Y8YG17V.jpg)

日本語UIスクショ撮るよ！


# Page. 19

![Page Image](https://bcdn.docswell.com/page/GJ5G9GVLJ4.jpg)

連携アプリの日本語UIスクショも撮るよ！！


# Page. 20

![Page Image](https://bcdn.docswell.com/page/LE3RYRDD75.jpg)

約100ページ
あります
✌(’ω’✌ )三✌(’ω’)✌三(
✌’ω’)✌
情報量の多いページは１万字超え


# Page. 21

![Page Image](https://bcdn.docswell.com/page/8EDY5YP2EG.jpg)

３割くらい対応完了。Zennに経過記録
https://zenn.dev/unsoluble_sugar/scraps/94ef02ee3bc0d7


# Page. 22

![Page Image](https://bcdn.docswell.com/page/V7P6G6NLJ8.jpg)

ドキュメントから完全に理解していくぞ


# Page. 23

![Page Image](https://bcdn.docswell.com/page/2JV363K6EQ.jpg)

～issue例～
日本語検索の問題
カタカナ検索ができない！？
（絶望）
https://github.com/HakuyaLabs/warudo-docs/issues/26


# Page. 24

![Page Image](https://bcdn.docswell.com/page/5EG3N3Q27L.jpg)

当初採用されていた検索プラグインの仕様
●


# Page. 25

![Page Image](https://bcdn.docswell.com/page/4JQ5Q5K97P.jpg)

Algolia DocSearchへ移行して解決


# Page. 26

![Page Image](https://bcdn.docswell.com/page/K749N9KRE1.jpg)

～issue例～
プロトコル名称について
混乱を招く表記の修正
https://x.com/ElvCatDev/status/1665261111338471424
https://github.com/HakuyaLabs/warudo-docs/pull/53


# Page. 27

![Page Image](https://bcdn.docswell.com/page/LJ1K5KXV7G.jpg)

～issue例～
リンク切れ修正
誤字脱字
typo
小さなcommitも貢献のうち
https://github.com/HakuyaLabs/warudo-docs/pull/58


# Page. 28

![Page Image](https://bcdn.docswell.com/page/GJWD5DN372.jpg)

OSSによる貢献
【開発者】
助かる
【VTuber】
輝く
【リスナー】
輝く推しが見られる
【ワイ】
知見を得られる
開発者に喜んでもらえる
推しソフトのユーザーが増えていく様子を楽しめる
VTuber&amp;リスナーの楽しげな姿が見られる
色んなクリエイターに出会える
全人類
Happy!


