Skip to content

Commit

Permalink
Add ja translation
Browse files Browse the repository at this point in the history
  • Loading branch information
eltociear authored and kristoff-it committed Jul 26, 2022
1 parent 8c477e9 commit 1be4adc
Show file tree
Hide file tree
Showing 12 changed files with 1,168 additions and 0 deletions.
3 changes: 3 additions & 0 deletions config.toml
Original file line number Diff line number Diff line change
Expand Up @@ -81,3 +81,6 @@ DefaultContentLanguage = "en"
[languages.ar]
languageName = "عربی"
weight = 2
[languages.ja]
languageName = "日本語"
weight = 2
130 changes: 130 additions & 0 deletions content/_index.ja.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,130 @@
---
title: ホーム
mobile_menu_title: "ホーム"
---
{{< slogan get_started="始めましょう" docs="ドキュメント" notes="変更点" lang="ja" >}}
Zigは、**堅牢****最適**、および**再利用可能**なソフトウェアをメンテナンスするための汎用プログラミング言語およびツールチェインです。
{{< /slogan >}}

{{< flexrow class="container" style="padding: 20px 0; justify-content: space-between;" >}}
{{% div class="features" %}}

# ⚡ シンプルな言語
プログラミング言語の知識をデバッグするよりも、アプリケーションのデバッグにフォーカスしてください。

- 隠された制御フローはありません。
- 隠されたメモリ割り当てはありません。
- プリプロセッサ、マクロもありません。

# ⚡ コンプタイム
コンパイル時のコード実行と遅延評価に基づくメタプログラミングへの新しいアプローチ。

- コンパイル時に任意の関数を呼び出します。
- ランタイムオーバーヘッドなしに型を値として操作します。
- コンプタイムはターゲットアーキテクチャをエミュレートします。

# ⚡ Zigでメンテナンス
C/C++/Zigのコードベースを段階的に改善することができます。

- Zigを依存性ゼロのドロップインC/C++コンパイラとして使用し、すぐにクロスコンパイルをサポートします。
- `zig build`を活用し、全てのプラットフォームで一貫した開発環境を構築します。
- C/C++プロジェクトにZigのコンパイルユニットを追加することができます。

{{% flexrow style="justify-content:center;" %}}
{{% div %}}
<h1>
<a href="learn/overview/" class="button" style="display: inline;">詳細な概要</a>
</h1>
{{% /div %}}
{{% div style="margin-left: 5px;" %}}
<h1>
<a href="learn/samples/" class="button" style="display: inline;">その他のコードサンプル</a>
</h1>
{{% /div %}}
{{% /flexrow %}}
{{% /div %}}
{{< div class="codesample" >}}

{{% zigdoctest "assets/zig-code/index.zig" %}}

{{< /div >}}
{{< /flexrow >}}


{{% div class="alt-background" %}}
{{% div class="container" style="display:flex;flex-direction:column;justify-content:center;text-align:center; padding: 20px 0;" title="コミュニティ" %}}

{{< flexrow class="container" style="justify-content: center;" >}}
{{% div style="width:25%" %}}
<img src="/ziggy.svg" style="max-height: 200px">
{{% /div %}}

{{% div class="community-message" %}}
# Zigのコミュニティは分散型
誰でも自由に、コミュニティが集う場を立ち上げ、メンテナンスすることができます。
「公式」「非公式」という概念はありませんが、それぞれの集いの場には、モデレーターやルールがあります。

<div style="">
<h1>
<a href="https://github.com/ziglang/zig/wiki/Community" class="button" style="display: inline;">すべてのコミュニティを見る</a>
</h1>
</div>
{{% /div %}}
{{< /flexrow >}}
<div style="height: 50px;"></div>

{{< flexrow class="container" style="justify-content: center;" >}}
{{% div class="main-development-message" %}}
# 主な開発内容
Zigのリポジトリは[https://github.com/ziglang/zig](https://github.com/ziglang/zig)にあります。ここでは、イシュー・トラッカーもホストしており、提案についても議論しています。
コントリビュータはZigの[行動規範](https://github.com/ziglang/zig/blob/master/.github/CODE_OF_CONDUCT.md)を遵守することが求められます。
{{% /div %}}
{{% div style="width:40%" %}}
<img src="/zero.svg" style="max-height: 200px">
{{% /div %}}
{{< /flexrow >}}
{{% /div %}}
{{% /div %}}


{{% div class="container" style="display:flex;flex-direction:column;justify-content:center;text-align:center; padding: 20px 0;" title="Zigソフトウェア財団" %}}
## ZSFは501(c)(3)の非営利法人です。

Zigソフトウェア財団は、Zigの生みの親であるAndrew Kelleyが2020年に設立した非営利法人で、Zigの言語開発を支援することを目的としています。現在、ZSFは少数のコア・コントリビュータに競争力のある料金で有償の仕事を提供することができます。将来的には、より多くのコア・コントリビュータにこのオファーを拡大できるようにしたいと考えています。

Zigソフトウェア財団は、寄付金によって運営されています。

<h1>
<a href="zsf/" class="button" style="display:inline;">詳しく</a>
</h1>
{{% /div %}}


{{< div class="alt-background" style="padding: 20px 0;">}}
{{% div class="container" title="スポンサー" %}}
# 企業スポンサー
以下の企業は、Zig Software財団に直接的な資金援助を行っています。

{{% sponsor-logos "monetary" %}}
<a href="https://pex.com" rel="noopener nofollow" target="_blank"><picture>
<picture>
<source srcset="/pex-white.svg" media="(prefers-color-scheme: dark)">
<img src="/pex-dark.svg">
</picture>
</a>
<a href="https://coil.com" rel="noopener nofollow" target="_blank"><picture>
<picture>
<source srcset="/coil-logo-white.svg" media="(prefers-color-scheme: dark)">
<img src="/coil-logo-black.svg">
</picture>
</a>
{{% /sponsor-logos %}}

# GitHubスポンサー
[Zigをスポンサー](zsf/)してくださる方々のおかげで、このプロジェクトは企業の株主ではなく、オープンソースコミュニティに対して説明責任を果たすことができるのです。特に、月々200ドル以上でZigのスポンサーになってくださっている方々は素晴らしい方々です:

{{< ghsponsors >}}

このセクションは、毎月月初に更新されます。
{{% /div %}}
{{< /div >}}
6 changes: 6 additions & 0 deletions content/download/_index.ja.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
---
title: "ダウンロード"
menu_title: "ダウンロード"
mobile_menu_title: "ダウンロード"
layout: downloads
---
61 changes: 61 additions & 0 deletions content/learn/_index.ja.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,61 @@
---
title: "学ぶ"
menu_title: "学ぶ"
mobile_menu_title: "学ぶ"
toc: false
layout: single
---

# 学ぶ
このセクションでは、Zigを全く知らない状態から、その哲学を理解するために役立つリソースをリストアップしています。

## ドキュメント
{{% learn_docs %}}

## はじめに
これらはすべて、さまざまなバックグラウンドを持つプログラマーを対象としたZigの入門書です。

- [詳細な概要](overview/)
ここでは、システム・プログラミングの観点から、Zigの詳細な機能概要を説明します。
- [C++、D、Rustがあるのに、なぜZigなのか](why_zig_rust_d_cpp/)
C++、D、RustプログラマのためのZigの紹介です。
- [コード例](samples/)
Zigのコードがどのように見えるかを感じるためのスニペットのリストです。
- [ツール](tools/)
Zigコードを書くのに便利なツールの一覧です。


## 始めましょう
Zigでプログラミングを始める準備ができたら、このガイドで環境を整えましょう。

- [始めましょう]({{< ref "getting-started.md" >}})

## オンライン学習リソース
- [Zigを学ぶ](https://ziglearn.org)
[Sobeston](https://github.com/sobeston)によるZigの構造的な紹介。
- [Ziglings](https://github.com/ratfactor/ziglings)
小さな壊れたプログラムを修正することでZigを学ぶ。

## 関連する動画やブログ記事
- [Zig 1.0への道のり](https://www.youtube.com/watch?v=Gv2I7qTux7g) [video]
[Andrew Kelley](https://andrewkelley.me)による、Zigとその哲学を紹介するビデオ。
- [ZigのLLVMとの新しい関係](https://kristoff.it/blog/zig-new-relationship-llvm/)
Zigセルフホストコンパイラの構築に向けた作業についてのブログ記事。[lwn.netの記事](https://lwn.net/Articles/833400/)でも紹介されています。


















136 changes: 136 additions & 0 deletions content/learn/getting-started.ja.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,136 @@
---
title: 始めましょう
mobile_menu_title: "始めましょう"
toc: true
---

## タグ付きリリースかナイトリービルドか?
Zigはまだv1.0に到達しておらず、現在のリリースサイクルはLLVMの新リリースに連動しており、その周期は6ヶ月程度となっています。
現実的には、**Zigのリリースは間隔が開きがちで、現在の開発スピードからするといずれ陳腐化する**と言われています。

タグ付きバージョンを使ってZigを評価するのは良いのですが、もしZigが好きでもっと深く知りたいと思ったら
**ナイトリービルドにアップグレードすることをお勧めします**
そうすれば、助けを得るのがより簡単になるからです:[ziglearn.org](https://ziglearn.org)のようなサイトは、上記の理由から master ブランチを追跡しています。

Zigのバージョンを切り替えるのはとても簡単で、同時に複数のバージョンをシステム上に存在させることも可能です。Zigのリリースは自己完結型のアーカイブで、システムのどこにでも配置することができます。


## Zigをインストールする
### 直接ダウンロード
これが最もストレートなZigの入手方法です:[Downloads](/download)ページから、あなたのプラットフォーム用のZigバンドルを取得し、
ディレクトリに解凍して`PATH`に追加すれば、どの場所からでも`zig`を呼び出すことができるようになります。

#### WindowsでのPATHの設定
Windowsでパスを設定するには、Powershellインスタンスで次のコードのスニペットのうち**1つ**を実行します。
この変更をシステム全体に適用するか(管理者権限でPowershellを実行する必要があります)、自分のユーザーだけに適用するかを選択します。
また、**必ず、あなたのZigのコピーがある場所を指すようにスニペットを変更してください**
`C:`の前の`;`はタイプミスではありません。

システム全体(**管理者** Powershell):
```
[Environment]::SetEnvironmentVariable(
"Path",
[Environment]::GetEnvironmentVariable("Path", "Machine") + ";C:\your-path\zig-windows-x86_64-your-version",
"Machine"
)
```

ユーザーレベル(Powershell):
```
[Environment]::SetEnvironmentVariable(
"Path",
[Environment]::GetEnvironmentVariable("Path", "User") + ";C:\your-path\zig-windows-x86_64-your-version",
"User"
)
```
完了後、Powershellインスタンスを再起動します。

#### Linux、macOS、BSDでのPATHの設定
zigバイナリの場所をPATH環境変数に追加してください。

これは通常、シェルのスタートアップスクリプト(`.profile`, `.zshrc`, ...)にexport行を追加することで行われます。
```bash
export PATH=$PATH:~/path/to/zig
```
終了後、スタートアップファイルを`source`するか、シェルを再起動します。




### パッケージマネージャ
#### Windows
Zigは[Chocolatey](https://chocolatey.org/packages/zig)で使用できます。
```
choco install zig
```

#### macOS

**Homebrew**
最新のタグ付きリリース:
```
brew install zig
```

Git masterブランチからの最新ビルド:
```
brew install zig --HEAD
```

**MacPorts**
```
port install zig
```
#### Linux
ZigはLinux用の多くのパッケージマネージャにも含まれています。[こちら](https://github.com/ziglang/zig/wiki/Install-Zig-from-a-Package-Manager)には最新のリストがありますが、
パッケージによっては古いバージョンのZigがバンドルされている場合があることに留意してください。

### ソースからのビルド
[こちら](https://github.com/ziglang/zig/wiki/Building-Zig-From-Source)には、
Linux、macOS、Windows用のZigをソースからビルドする方法についての詳細情報が掲載されています。

## 推奨ツール
### シンタックスハイライターとLSP
主要なテキストエディタは、Zigのシンタックスハイライトをサポートしています。
バンドルされているものもあれば、プラグインをインストールする必要があるものもあります。

もし、Zigとエディタとのより深い統合に興味があるなら、
[zigtools/zls](https://github.com/zigtools/zls)をチェックアウトしてください。

他にどんなものがあるか興味がある方は、[ツール](../tools/)のセクションをチェックしてみてください。

## Hello Worldを実行する
インストールが正しく完了すれば、シェルからZigコンパイラを呼び出すことができるはずです。
それでは、最初のZigプログラムを作ってテストしてみましょう!

プロジェクトディレクトリに移動し、実行します:
```bash
mkdir hello-world
cd hello-world
zig init-exe
```

これが出力されるはずです:
```
info: Created build.zig
info: Created src/main.zig
info: Next, try `zig build --help` or `zig build run`
```

`zig build run`を実行すると、実行ファイルがコンパイルされて実行され、最終的に以下のような結果になります:
```
info: All your codebase are belong to us.
```

おめでとうございます!これでZigのインストールは完了です!

## 次のステップ
**[学ぶ](../) セクションにある他のリソースもチェックし**、あなたのバージョンのZigのドキュメントを見つけてください(注意:ナイトリービルドは `master` ドキュメントを使うべきです)、
そして、[ziglearn.org](https://ziglearn.org)を読んでみてください。

Zigは若いプロジェクトであり、残念ながら、すべてのことについて広範な文書や学習資料を作成する能力はまだありません。
したがって、行き詰まったときに助けを得るために[既存のZigコミュニティのいずれかに参加すること](https://github.com/ziglang/zig/wiki/Community)や、
[Zig SHOWTIME](https://zig.show)といった取り組みも検討してみてください。

最後に、もしあなたがZigを楽しんでいて開発のスピードアップに貢献したいとお考えなら、[Zigソフトウェア財団への寄付をご検討ください](../../zsf)
<img src="../../heart.svg" style="vertical-align:middle; margin-right: 5px">.
Loading

0 comments on commit 1be4adc

Please sign in to comment.