lets-translate-nostr

Transcript

1. Nostrを翻訳しよう！ Let’s translate Nostr! 2023-12-08 電子馬@erechorse
2. $ whoami 電子馬@erechorse Hobbyist Engineer. 本職: 機械系の大学院生 趣味: 🏇/ ⛷/ 💻 Nostr履歴: ログボbotを作ったりしていた Nostrって？: 「永遠のハッカソン会場」
3. おさらい: Nostrとは、NIPsとは？ Nostr stands for Notes and Other Stuff Transmitted by Relays NIPs stands for Nostr Implementation Possibilities NIPsには01から番号が振られている
4. おさらい: Nostrとは、NIPsとは？ 例: NIP-23 NIP-23 ====== Long-form Content ----------------- `draft` `optional` This NIP defines `kind:30023` (a _parameterized replaceable event_) for long-form text content, generally referred to as "articles" or "blog posts". `kind:30024` has the same structure as `kind:30023` and is used to save long form drafts. "Social" clients that deal primarily with `kind:1` notes should not be expected to implement this NIP. ### Format ...
5. なぜ、Nostrを翻訳するのか？
6. ハードルを下げてすそ野を広げたい
7. 歴史に学ぶ 明治の知識人は、外来語を日本語に訳す ことで知見を広めた Liberty: 自由 Competition: 競争 Speech: 演説 英語圏でない人が、母国語で学べる環境 は大事 福沢諭吉
8. NIPs翻訳の現状 これまではscrapbox.io/nostrで管 理されていた 利点 誰でも編集に参加できる 操作が非常にシンプル 欠点 一回訳されると放置され、最新 版に追従できない 議論が難しい
9. 翻訳方法の選定 Crowdin: SaaSの翻訳プラットフォームで、ファイルやGitHub上のリポジトリを 多人数で翻訳できる 利点: 知識がなくても翻訳さえできれば参加は容易 欠点: GitHubのコードを翻訳するにはリポジトリのオーナーであることが前提 Git&GitHub: NIPsリポジトリをフォークして訳文に書き換えるだけ 利点: GitHub Actionsなどの組み合わせで自由度がある(後述) 欠点: Gitの知識が必要 参考: オープンソースドキュメント翻訳プラットフォームとしての GitHub (React 日本語ド キュメントの例)
10. Forkの意味？ GitHubには公式にフォーク機能がある。目的は？ 他のユーザのプロジェクトへの変更を提案する 他のユーザのプロジェクトを自分のアイディアの出発点として活用する nostr-protocol/nipsからの派生を明示したければ、フォークするのが望ましい しかし、nostr-ja/nips-jpにプルリクを送りたいのにデフォルトが元リポジトリに向いてしま ったり、前者を前提としたような仕様となっている 多少煩雑だが、翻訳リポジトリに sync ブランチを作り、そこで原文を追従する ` `
11. 勘所: 原文への追従 原文は結構な頻度で更新されているので、翻訳文も追従する必要がある 1日1回、 sync ブランチがbotによって更新される このとき、コンフリクトマーカーを手動で剥がす ` `
12. textlintによる自動チェック 表記ゆれ対策にtextlintという校正ツールを使用 「、」「。」の統一、冗長な表現の排除など GitHub Actionsに組み込むことで自動チェック
13. Nostrを翻訳しよう
14. NIPs翻訳の効能 Gitさえ初歩的な操作ができれば、あとは翻訳するだけ NIPs翻訳すると何がうれしい？ 今、Nostrでやりたいことが何も思いつかなくても、NIPs翻訳なら今すぐにできる 💪 翻訳時にNIPを注意深く読んだら新しいサービスのアイデアが生まれるかも 💡 さらに、メンテナになればNIPs最新版に追従できる 🏃
15. やってみた感想 初めてまともにメンテナとして活動を始めた 事務作業は多いけど、協力して活動するのはとても楽しい ✨ GitHubの活動履歴に毎日草が生えるようになりました 🚀
16. 今後も頑張ります！ SPECIAL THANKS: @darashi @jiftechnify @omi @rira224 @s3-odara @SnowCait のす婚も(？)