-
Notifications
You must be signed in to change notification settings - Fork 179
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
8c477e9
commit 1be4adc
Showing
12 changed files
with
1,168 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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 >}} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,6 @@ | ||
--- | ||
title: "ダウンロード" | ||
menu_title: "ダウンロード" | ||
mobile_menu_title: "ダウンロード" | ||
layout: downloads | ||
--- |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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/)でも紹介されています。 | ||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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">. |
Oops, something went wrong.