翻訳の状況は、翻訳の概要と進捗状況の issues を確認してください。
Dfinity のドキュメントは AsciiDoc によって書かれており、Antora を用いてビルドされています。 ローカル環境でドキュメントをビルドして確認できるように、以下の手順で Antora をインストールします。
Antora のインストールには Node が必要です。
Windows 10 の場合には WSL2 上にインストールすることをお勧めします。
Mac OS の場合には Homebrew でインストールするのが良いと思います。
Node のインストールができたら、Antora のインストールを行います。 ここではグローバル環境にインストールする手順を説明します。
$ npm i -g @antora/[email protected] @antora/[email protected]
以下のコマンドでインストールできていることを確認します。
$ antora -v
2.3.x
などのバージョン名が表示されれば OK です。
まずは、このリポジトリを右上から Fork してください。
そして、リポジトリをクローンします。your
には、あなたの GitHub のユーザーネームを入れてください。
$ git clone https://github.com/your/docs
$ cd docs
翻訳作業を行うためのブランチを作成します。ここでは、例として introduction/pages/welcome.adoc
を翻訳するためのブランチを作成します。
$ git checkout -b introduction/pages/welcome.adoc
これで、翻訳を始める準備は完了です。エディタを使って、翻訳箇所のファイルを編集します。
スタイルガイドに目を通してください。 わからないことがあれば Discord の#ドキュメント翻訳チャネルで質問してください。
エディタとしては VSCode を推奨します。 AsciiDoc の拡張機能を入れると少し幸せになれるかもしれません。
翻訳した文章を確認するために、手順 1 で導入した Antora を用いてローカルビルドします。
$ antora local-antora-playbook.yml
のコマンドを叩くと、ビルドが実行されます。
ビルド後、build/site/docs
以下の html ファイルを直接開きます。
open build/site/docs/introduction/welcome.html
ブラウザが開き、翻訳が反映されていることが確認できます。
翻訳が終わったら、ローカルリポジトリにコミットしたあと、自分のリモートリポジトリにプッシュします。 なるべく1つのコミットにまとめていただければありがたいですが、難しければそのままでも OK です。
$ git add modules/introduction/pages/welcome.adoc
$ git commit -m "translated: introduction/pages/welcome.adoc"
$ git push origin introduction/pages/welcome.adoc
最後に、Github からプルリクを出します。 このとき、出し先が Japan-DfinityInfoHub/docs になるようにします。 間違えて本家の dfinity/docs に出してしまわないように気をつけてください。
以上です!メンテナーがレビューをして問題なければマージされます。
Special thanks to these wonderful people (emoji key):
hoosan |
You can get started right away by downloading the Internet Computer Software Development Kit (SDK) and cloning an existing sample project or by exploring the documentation. Check out the links below to begin building smart contract canisters to run on the Internet Computer:
- Get the SDK Download the SDK for the Internet Computer.
- Quick Start Deploy your first app on the Internet Computer.
- Examples Repository Explore on your own in the examples repository.
- Language Guide Explore the Motoko programming language.
- Videos Watch the Building Applications for the Internet Computer: Fundamentals video series.
The Internet Computer blockchain is removing the limitations from smart contract software with a network that scales its capacity with demand and serves interactive web content directly to end users. If you are interested in learning more about the project, you can connect with other developers in the community through the Developer Forum and follow us on social media for information about upcoming events and new developments.
If you would like to contribute to the documentation, see our CONTRIBUTING and CODE OF CONDUCT to get started.