翻訳の概要と進捗状況
hoosan opened this issue · 44 comments
翻訳プロジェクトに参加するために
ドキュメントの翻訳は以下の手順で進めてください。
- 翻訳ページ一覧を確認して、翻訳したい箇所をコメントしてください。
- 翻訳する箇所はintroduction/pages/welcome.adocのように指定してください。また、 翻訳箇所は1ページずつでお願いします。
ただし、翻訳する人が少なく複数宣言しても問題ない場合は複数同時の担当も可とします。 - 翻訳する前に、スタイルガイドに目を通してください。
- 校正や確認が終わったらプルリクエストを出してください。メンテナーが確認して、問題がなければマージされます。
もし、わからないことや質問等がある場合は Discord の #ドキュメント翻訳チャンネルで質問してください。
なお、宣言してから一定期間(目安:3ヶ月)プルリクエストがない場合には、担当を解除させていただきます。
原文のアップデートに応じた修正
原文のドキュメントがアップデートされたページには、
リンク先の diff を参考に翻訳を修正してプルリクを出してください。
修正を開始する前に、修正したい箇所をコメントしてください。
メンテナーへ
コメントの確認からプルリクエストをマージする手順は以下に沿ってください。
コメントを確認した場合
翻訳箇所のコメントを確認した場合、以下のフォーマットに沿って書き換えてください。作業中がわかるように
こちらは一例です。
- [ ] introduction/pages/welcome.adoc (@hoosan):rocket:
翻訳のレビューが終わった場合
翻訳のチェックが終わってプルリクエストがマージされたら、以下のフォーマットに書き換えてください。
翻訳完了がわかるように
マージされた段階でチェックマークをつけるようにしてください。
- [x] introduction/pages/welcome.adoc (@hoosan):tada:
翻訳ページ一覧
ROOT
- ROOT/pages/download.adoc (@hoosan)
🎉 - ROOT/pages/http-middleware.adoc (@hoosan)
🎉 - ROOT/pages/videos-tutorials.adoc (@hoosan)
🎉
Introduction
- introduction/pages/welcome.adoc (@hoosan)
🎉
Samples
- samples/pages/index.adoc (@pontagon333)
🎉 - samples/pages/hackathon-projects.adoc (@hokosugi)
🎉 - samples/pages/hello.adoc (@hokosugi)
🎉 - samples/pages/dao.adoc (@hokosugi)
🎉 - samples/pages/dex.adoc (@hokosugi)
🎉 - samples/pages/nft.adoc (@hokosugi)
🎉 - samples/pages/encrypted-notes.adoc (@hokosugi)
🎉 - samples/pages/host-a-website.adoc (@hokosugi)
🎉 - samples/pages/tokentransfer.adoc (@hokosugi)
🎉
Developers guide
- developers-guide/examples/candid-ui.adoc (@hoosan)
🎉 - developers-guide/pages/basic-syntax-rules.adoc
- developers-guide/pages/reinstalling-dfx.adoc
- developers-guide/pages/cli-reference.adoc (@takuryoo)
🎉 - developers-guide/pages/cli-reference/dfx-build.adoc (@hokosugi)
🎉 - developers-guide/pages/cli-reference/dfx-cache.adoc (@hokosugi)
🎉 - developers-guide/pages/cli-reference/dfx-canister.adoc (@hokosugi)
🎉 - developers-guide/pages/cli-reference/dfx-config.adoc (@hokosugi)
🎉 - developers-guide/pages/cli-reference/dfx-deploy.adoc (@hokosugi)
🎉 - developers-guide/pages/cli-reference/dfx-envars.adoc (@hokosugi)
🎉 - developers-guide/pages/cli-reference/dfx-help.adoc (@hokosugi)
🎉 - developers-guide/pages/cli-reference/dfx-identity.adoc (@hokosugi)
🎉 - developers-guide/pages/cli-reference/dfx-ledger.adoc (@hokosugi)
🎉 - developers-guide/pages/cli-reference/dfx-new.adoc (@hokosugi)
🎉 - developers-guide/pages/cli-reference/dfx-parent.adoc (@hokosugi)
🎉 - developers-guide/pages/cli-reference/dfx-ping.adoc (@hokosugi)
🎉 - developers-guide/pages/cli-reference/dfx-replica.adoc (@hokosugi)
🎉 - developers-guide/pages/cli-reference/dfx-start.adoc (@hokosugi)
🎉 - developers-guide/pages/cli-reference/dfx-stop.adoc (@hokosugi)
🎉 - developers-guide/pages/cli-reference/dfx-upgrade.adoc (@hokosugi)
🎉 - developers-guide/pages/cli-reference/dfx-wallet.adoc (@hokosugi)
🎉 - developers-guide/pages/cli-reference/dfx-generate.adoc (@hokosugi)
🎉 - developers-guide/pages/computation-and-storage-costs.adoc
- developers-guide/pages/concepts/canisters-code.adoc
- developers-guide/pages/concepts/concepts-intro.adoc (@tokuryoo)
🎉 - developers-guide/pages/concepts/data-centers.adoc (@tokuryoo)
🎉 - developers-guide/pages/concepts/governance.adoc (@numtet)
🎉 - developers-guide/pages/concepts/nodes-subnets.adoc (@tokuryoo)
🎉 - developers-guide/pages/concepts/tokens-cycles.adoc (@hoosan)
🎉 - developers-guide/pages/concepts/what-is-IC.adoc (@hoosan)
🎉 - developers-guide/pages/concepts/trust-in-canisters.adoc
- developers-guide/pages/concepts/bitcoin-integration.adoc
- developers-guide/pages/customize-projects.adoc (@tokuryoo)
🎉 - developers-guide/pages/default-wallet.adoc (@tokuryoo)
🎉 - developers-guide/pages/design-apps.adoc (@tokuryoo)
🎉 - developers-guide/pages/glossary.adoc (@hoosan)
🎉 - developers-guide/pages/install-upgrade-remove.adoc (@hoosan)
🎉 - developers-guide/pages/lang-service-ide.adoc
- developers-guide/pages/sample-apps.adoc
- developers-guide/pages/sdk-guide.adoc (@hoosan)
🎉 - developers-guide/pages/troubleshooting.adoc
- developers-guide/pages/tutorials/access-control.adoc (@tokuryoo)
🎉 - developers-guide/pages/tutorials/at-a-glance.adoc
- developers-guide/pages/tutorials/calculator.adoc (@tokuryoo)
🎉 - developers-guide/pages/tutorials/counter-tutorial.adoc
- developers-guide/pages/tutorials/custom-frontend.adoc (@hokosugi)
🎉 - developers-guide/pages/tutorials/define-an-actor.adoc (@pontagon333)
🎉 - developers-guide/pages/tutorials/explore-templates.adoc (@pontagon333)
🎉 - developers-guide/pages/tutorials/hello-location.adoc (@pontagon333)
🎉 - developers-guide/pages/tutorials/intercanister-calls.adoc (@tokuryoo)
🚀 - developers-guide/pages/tutorials/multiple-actors.adoc
- developers-guide/pages/tutorials/multiple-factorial-actors.adoc
- developers-guide/pages/tutorials/my-contacts.adoc (@hokosugi)
🎉 - developers-guide/pages/tutorials/phonebook.adoc
- developers-guide/pages/tutorials/reproducible-builds.adoc
- developers-guide/pages/tutorials/scalability-cancan.adoc
- developers-guide/pages/tutorials/simple-cycles.adoc
- developers-guide/pages/tutorials-intro.adoc (@pontagon333)
🎉 - developers-guide/pages/webpack-config.adoc (@hokosugi)
🎉 - developers-guide/pages/work-with-languages.adoc (@hoosan)
🎉 - developers-guide/pages/working-with-canisters.adoc (@pontagon333)
🎉
Integration
- integration/pages/ledger-quick-start.adoc
Languages
- languages/pages/languages-overview.adoc (@hoosan)
🎉 - languages/pages/motoko-at-a-glance.adoc (@hoosan)
🎉
Operators guide
- operators-guide/pages/ops-guide.adoc
Quickstart
- quickstart/pages/local-quickstart.adoc (@gelgoog999)
🎉 - quickstart/pages/network-quickstart.adoc (@gelgoog999)
🎉 - quickstart/pages/newcomers.adoc (@gelgoog999)
🎉 - quickstart/pages/quickstart-intro.adoc (@gelgoog999)
🎉 - quickstart/pages/quickstart-intro.adoc
🔀 #103 (@hokosugi)🎉 - quickstart/examples/vscode-plugin.adoc (@gelgoog999)
🎉 - quickstart/pages/cycles-faucet.adoc (@hokosugi)
🎉 - quickstart/pages/1-quickstart.adoc (@hokosugi)
🎉 - quickstart/pages/2-quickstart.adoc (@hokosugi)
🎉 - quickstart/pages/3-quickstart.adoc (@hokosugi)
🎉 - quickstart/pages/4-2-convert-ICP-to-cycles.adoc (@hokosugi)
🎉 - quickstart/pages/4-quickstart.adoc (@hokosugi)
🎉 - quickstart/pages/5-quickstart.adoc (@hokosugi)
🎉
Release note
- release-notes/pages/0.6.20-rn.adoc
- release-notes/pages/0.6.21-rn.adoc
- release-notes/pages/0.6.22-rn.adoc
- release-notes/pages/0.6.23-rn.adoc
- release-notes/pages/0.6.24-rn.adoc
- release-notes/pages/0.6.25-rn.adoc
- release-notes/pages/0.6.26-rn.adoc
- release-notes/pages/0.7.0-rn.adoc
- release-notes/pages/0.7.1-rn.adoc
- release-notes/pages/0.7.2-rn.adoc
- release-notes/pages/0.7.7-rn.adoc
- release-notes/pages/0.8.0-rn.adoc
- release-notes/pages/0.8.1-rn.adoc
- release-notes/pages/0.8.2-rn.adoc
- release-notes/pages/0.8.3-rn.adoc
- release-notes/pages/0.8.4-rn.adoc
- release-notes/pages/0.9.0-rn.adoc
- release-notes/pages/0.9.2-rn.adoc
- release-notes/pages/0.9.3-rn.adoc
- release-notes/pages/sdk-release-notes.adoc
Security best practices
- security-best-practices/pages/general-security-best-practices.adoc (@hokosugi)
🎉 - security-best-practices/pages/introduction.adoc (@hokosugi)
🎉 - security-best-practices/pages/rust-canister-development-security-best-practices.adoc (@hokosugi)
🎉 - security-best-practices/pages/web-app-development-security-best-practices.adoc (@hokosugi)
🎉
Token holders
- token-holders/pages/custody-options-intro.adoc (@hokosugi)
🚀 - token-holders/pages/nns-app-quickstart.adoc (@hokosugi)
🚀 - token-holders/pages/seed-donations.adoc (@hokosugi)
🚀 - token-holders/pages/self-custody-quickstart.adoc (@hokosugi)
🚀
Motoko
以下のMotoko に関するドキュメントの翻訳は、Japan-DfinityInfoHub/motoko を fork して実施してください
(Dfinity 公式が、dfinity/motoko にドキュメントを置いているため)
- language-guide/pages/about-this-guide.adoc (@hoosan)
🎉 - language-guide/pages/actor-classes.adoc (@hoosan)
🎉 - language-guide/pages/actors-async.adoc (@hoosan)
🎉 - language-guide/pages/basic-concepts.adoc (@hoosan)
🎉 - language-guide/pages/caller-id.adoc (@hoosan)
🎉 - language-guide/pages/compiler-ref.adoc (@hoosan)
🎉 - language-guide/pages/control-flow.adoc (@hoosan)
🎉 - language-guide/pages/compatibility.adoc (@hoosan)
🎉 - language-guide/pages/cycles.adoc (@hoosan)
🎉 - language-guide/pages/errors.adoc (@hoosan)
🎉 - language-guide/pages/heartbeats.adoc
- language-guide/pages/language-manual.adoc
- language-guide/pages/local-objects-classes.adoc (@hoosan)
🎉 - language-guide/pages/modules-and-imports.adoc (@hoosan)
🎉 - language-guide/pages/motoko-grammar.adoc (@hoosan)
🎉 - language-guide/pages/motoko-introduction.adoc (@hoosan)
🎉 - language-guide/pages/motoko.adoc (@pontagon333)
🎉 - language-guide/pages/mutable-state.adoc (@hoosan)
🎉 - language-guide/pages/overview.adoc
- language-guide/pages/pattern-matching.adoc (@hoosan)
🎉 - language-guide/pages/sharing.adoc (@hoosan)
🎉 - language-guide/pages/structural-equality.adoc (@hoosan)
🎉 - language-guide/pages/style.adoc
- language-guide/pages/upgrades.adoc (@hoosan)
🎉
Rust Guide
以下の Rust Guide に関するドキュメントの翻訳は、Japan-DfinityInfoHub/cdk-rs を fork して実施してください
(Dfinity 公式が、dfinity/cdk-rs にドキュメントを置いているため)
- rust-guide/pages/multiply-dependency.adoc (@hoosan)
🎉 - rust-guide/pages/multiply-dependency.adoc
🔀 #12 (@hoosan)🎉 - rust-guide/pages/rust-counter.adoc (@hoosan)
🎉 - rust-guide/pages/rust-counter.adoc
🔀 #12 (@hoosan)🎉 - rust-guide/pages/rust-intro.adoc (@hoosan)
🎉 - rust-guide/pages/rust-optimize.adoc (@hoosan)
🎉 - rust-guide/pages/rust-profile.adoc (@hoosan)
🎉 - rust-guide/pages/rust-profile.adoc
🔀 #12 (@hoosan)🎉 - rust-guide/pages/rust-quickstart.adoc (@hoosan)
🎉 - rust-guide/pages/rust-quickstart.adoc
🔀 #12 (@hoosan)🎉
Motoko Base
以下の Motoko Base に関するドキュメントの翻訳は、Japan-DfinityInfoHub/motoko-base を fork して実施してください
(Dfinity 公式が、dfinity/motoko-base にドキュメントを置いているため)
- base-libraries/pages/stdlib-intro.adoc (@hoosan)
🎉 - Array.mo
- AssocList.mo
- Blob.mo
- Bool.mo
- Buffer.mo
- CertifiedData.mo
- Char.mo
- Debug.mo
- Deque.mo
- Error.mo
- ExperimentalCycles.mo
- ExperimentalStableMemory.mo
- Float.mo
- Func.mo
- Hash.mo
- HashMap.mo
- Heap.mo
- Int.mo
- Int16.mo
- Int32.mo
- Int64.mo
- Int8.mo
- Iter.mo
- IterType.mo
- List.mo
- Nat.mo
- Nat16.mo
- Nat32.mo
- Nat64.mo
- Nat8.mo
- None.mo
- Option.mo
- Order.mo (@hoosan)
🎉 - Prelude.mo
- Principal.mo
- RBTree.mo
- Random.mo
- Result.mo
- Stack.mo
- Text.mo
- Time.mo
- Trie.mo
- TrieMap.mo
- TrieSet.mo
Candid Guide
以下の Candid Guide に関するドキュメントの翻訳は、Japan-DfinityInfoHub/candid を fork して実施してください
(Dfinity 公式が、dfinity/candid にドキュメントを置いているため)
- candid-guide/pages/candid-concepts.adoc (@hoosan)
🎉 - candid-guide/pages/candid-howto.adoc (@hoosan)
🎉 - candid-guide/pages/candid-intro.adoc (@hoosan)
🎉 - candid-guide/pages/candid-ref.adoc (@hoosan)
🎉 - candid-guide/pages/candid-types.adoc (@hoosan)
🎉
Internet Identity
以下の Internet Identity に関するドキュメントの翻訳は、Japan-DfinityInfoHub/internet-identity を fork して実施してください
(Dfinity 公式が、dfinity/internet-identity にドキュメントを置いているため)
- ic-identity-guide/pages/auth-how-to.adoc (@hoosan)
🎉 - ic-identity-guide/pages/auth-how-to.adoc
🔀 #7 #8 (@hoosan)🎉 - ic-identity-guide/pages/hello-guide.adoc (@hoosan)
🎉 - ic-identity-guide/pages/what-is-ic-identity.adoc (@hoosan)
🎉 - ic-identity-guide/pages/what-is-ic-identity.adoc
🔀 #5 (@hoosan)🎉
Rosetta API
以下の Rosetta API に関するドキュメントの翻訳は、Japan-DfinityInfoHub/ic を fork して実施してください
(Dfinity 公式が、dfinity/ic にドキュメントを置いているため)
ドキュメントの場所は rs/rosseta-api/docs/modules
下です。
- rosetta-api/pages/deploy-new-token.adoc
- rosetta-api/pages/ledger-local-setup.adoc
- rosetta-api/pages/ledger.adoc
- rosetta-api/pages/neuron-lifecycle.adoc
- rosetta-api/pages/staking-support.adoc
- rosetta-api/pages/staking-tutorial.adoc
- rosetta-api/pages/transfers.adoc (@hoosan)
🚀
quickstart/pages/local-quickstart.adoc 書きます
developers-guide/pages/concepts/concepts-intro.adoc 書きます
developers-guide/pages/concepts/nodes-subnets.adoc 書きます。
developers-guide/pages/tutorials-intro.adoc 書きます。
quickstart/pages/quickstart-intro.adoc 書きます。
language-guide/pages/motoko.adoc 書きます。
quickstart/pages/newcomers.adoc 書きます。
quickstart/pages/network-quickstart.adoc 書きます。
developers-guide/pages/tutorials/explore-templates.adoc 書きます。
developers-guide/pages/concepts/data-centers.adoc 書きます。
quickstart/examples/vscode-plugin.adoc 書きます。
developers-guide/pages/tutorials/define-an-actor.adoc 書きます。
integration/pages/ledger-quick-start.adoc 書きます。
developers-guide/pages/cli-reference.adoc 書きます。
developers-guide/pages/tutorials/hello-location.adoc 書きます。
developers-guide/pages/concepts/governance.adoc 書きます
developers-guide/pages/computation-and-storage-costs.adoc 書きます
developers-guide/pages/working-with-canisters.adoc 書きます。
examples/pages/index.adoc 書きます。
developers-guide/pages/tutorials/custom-frontend.adoc を書きます。
docs/developers-guide/tutorials/my-contacts.html の翻訳します。
docs/modules/quickstart/pages/cycles-faucet.adoc
docs/modules/quickstart/pages/host-a-website.adocの翻訳をします。
久しぶりの翻訳ですので軽いところから再開します。
examples/pages/hello.adoc
samples/pages/hackathon-projects.adoc
samples/pages/dao.adoc
samples/pages/dex.adoc
を書きます。
samples/pages/codelabs/simple-nft.adoc
samples/pages/codelabs/static-website.adoc
samples/pages/encrypted-notes.adoc
samples/pages/tokentransfer.adoc
を翻訳します。
samples/pages/nft.adoc を翻訳します。
上記の
samples/pages/codelabs/simple-nft.adoc
samples/pages/codelabs/static-website.adoc
はcodelabsフォルダがすべてHTMLで書かれているため外します。
宜しくおねがいします。
quickstart/pages/1-quickstart.adoc
quickstart/pages/2-quickstart.adoc
quickstart/pages/3-quickstart.adoc
quickstart/pages/4-quickstart.adoc
quickstart/pages/4-2-convert-ICP-to-cycles.adoc
quickstart/pages/5-quickstart.adoc
を翻訳します。宜しくおねがいします。期限は努力目標として5月20日までです。
quickstart/pages/quickstart-intro.adocを翻訳します。
developers-guide/pages/cli-reference/dfx-build.adoc
developers-guide/pages/cli-reference/dfx-cache.adoc
developers-guide/pages/cli-reference/dfx-canister.adoc
developers-guide/pages/cli-reference/dfx-config.adoc
developers-guide/pages/cli-reference/dfx-deploy.adoc
上記を翻訳します。努力目標:6月3日!
developers-guide/pages/cli-reference/dfx-envars.adoc
developers-guide/pages/cli-reference/dfx-generate.adoc
developers-guide/pages/cli-reference/dfx-help.adoc
を翻訳します。目標:6/15
developers-guide/pages/cli-reference/dfx-identity.adocを翻訳します。
developers-guide/pages/design-apps.adoc を翻訳します。
developers-guide/pages/customize-projects.adoc を翻訳します。
developers-guide/pages/cli-reference/dfx-ledger.adoc
developers-guide/pages/cli-reference/dfx-new.adoc
developers-guide/pages/cli-reference/dfx-parent.adoc
を翻訳します。
developers-guide/pages/default-wallet.adoc を翻訳します。
developers-guide/pages/tutorials/access-control.adoc を翻訳します。
developers-guide/pages/cli-reference/dfx-ping.adoc
developers-guide/pages/cli-reference/dfx-replica.adoc
developers-guide/pages/cli-reference/dfx-start.adoc
を翻訳します。
developers-guide/pages/tutorials/calculator.adoc
を翻訳します。
developers-guide/pages/cli-reference/dfx-stop.adoc(済)
developers-guide/pages/cli-reference/dfx-upgrade.adoc
developers-guide/pages/cli-reference/dfx-wallet.adoc
を翻訳します。
security-best-practices/pages/general-security-best-practices.adoc
security-best-practices/pages/introduction.adoc
security-best-practices/pages/rust-canister-development-security-best-practices.adoc
security-best-practices/pages/web-app-development-security-best-practices.adoc
を翻訳します。
developers-guide/pages/tutorials/counter-tutorial.adoc
を翻訳します。
developers-guide/pages/tutorials/intercanister-calls.adoc
を翻訳します。
Token holdersの4つを翻訳します。
- token-holders/pages/custody-options-intro.adoc
- token-holders/pages/nns-app-quickstart.adoc
- token-holders/pages/seed-donations.adoc
- token-holders/pages/self-custody-quickstart.adoc
developers-guide/pages/tutorials/intercanister-calls.adoc
取り下げます。