This repository has been archived by the owner on Jan 5, 2025. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
* 翻訳準備 * CIスクリプト修正
- Loading branch information
Showing
6 changed files
with
137 additions
and
110 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 was deleted.
Oops, something went wrong.
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,10 @@ | ||
| # 対訳表 | ||
|
|
||
| | 英語 | 日本語 | | ||
| | --- | --- | | ||
|
|
||
|
|
||
| # 英語表現をそのまま用いている単語 | ||
|
|
||
| | 用語 | | ||
| | --- | |
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 |
|---|---|---|
| @@ -1,34 +1,69 @@ | ||
| # Lean Language Reference | ||
| # Lean Language Reference 日本語訳 | ||
|
|
||
| The Lean Language Reference is intended as a comprehensive, precise description of Lean. It is first and foremost a reference work in which Lean users can look up detailed information, rather than a tutorial for new users. | ||
| * [原文](https://lean-lang.org/doc/reference/latest/) | ||
| * [原文のソースコード](https://github.com/leanprover/reference-manual) | ||
| * [対訳表](/GLOSSARY.md) | ||
|
|
||
| This new reference has been rebuilt from the ground up in Verso. This means that all example code is type checked, the source code contains tests to ensure that it stays up-to-date with respect to changes in Lean, and we can add any features that we need to improve the documentation. Verso also makes it easy to integrate tightly with Lean, so we can show function docstrings directly, mechanically check descriptions of syntax against the actual parser, and insert cross-references automatically. | ||
| ## 翻訳する際のルール | ||
|
|
||
| ### 方針 | ||
|
|
||
| ## Reading the Manual | ||
| * なるべく直訳を心がける。 | ||
| * 読みやすさの観点から以下は直訳から変えて良い。 | ||
| * 文構造の変更 | ||
| * 原文で1文だったところを2文に分ける | ||
| * 文の前半と後半を入れ替える | ||
| * 代名詞の明確化 | ||
| * `it`や`that`等で記述されている中で読んだときにわかりづらそうな箇所 | ||
| * 助動詞のニュアンスの変更 | ||
| * `can`で書かれている文章で「～ができます」などの訳し方が日本語的に自然でない場合等 | ||
| * 受動態⇔能動態 | ||
| * 特に無生物主語だったり、主語がyouの場合など | ||
| * 和訳箇所の前後や文脈に無い情報は基本的に入れない。 | ||
| * 訳注は以下の場合に記載する。 | ||
| * 最新情報に対する記述が古くなっている場合 | ||
| * 記述が間違っている場合 | ||
| * 文意を把握するにあたって記述および情報が足りていない場合 | ||
|
|
||
| The latest release of this reference manual can be read [here](https://lean-lang.org/doc/reference/latest/). | ||
| ### 表記ルール | ||
|
|
||
| For developers: | ||
| * The output of building the current state of the `main` branch can be read [here](https://lean-reference-manual-review.netlify.app/). | ||
| * Each pull request in this repository causes two separate previews to be generated, one with extra information that's only useful to those actively working on the text, such as TODO notes and symbol coverage progress bars. These are posted by a bot to the PR after the first successful build. | ||
| * 文体は常に敬体（です・ます調）とする。 | ||
| * 英文をコメントアウトして、その直下に和訳を書く。 | ||
| * 和訳文を改行すると、その位置に空白が入ってしまうので段落内で改行しない。 | ||
| * 句読点には `、` `。` を用いる。 | ||
| * 英数字には半角を用いる。 | ||
| * 記号の全角・半角は『[JTF日本語標準スタイルガイド（翻訳用）](https://www.jtf.jp/tips/styleguide)』の「3 記号の表記と用途」に準拠する。 | ||
| * 全角：`、` `。` `・` `：` `！` `？` `～` `（` `）` `「` `」` `『` `』` | ||
| * 半角：`/` `,`（数字の桁区切り）`.`（小数点）`-` `"` `` ` `` ` `（スペース） | ||
| * 同格の語句の並列には中黒 `・` を用いる。 | ||
| * カタカナ複合語の区切りには中黒を用いない。ただし、人名や熟語など、同格の語句の並列と誤解される可能性の低い箇所では中黒を用いてもよい。 | ||
| * 原文で `_` を用いて強調表示されている単語は、`**和訳単語**（元の英単語）`と訳す。ただし、専門用語ではない単語や、文が強調表示されている場合は、英語を併記しない。 | ||
| * 原文例：`This pattern is called _structural recursion_.` | ||
| * 和訳例：`このパターンは**構造的再帰**（structural recursion）と呼ばれます。` | ||
| * 3音以上のカタカナ語の末尾の長音記号「ー」は省く。 | ||
| * カタカナ語のままで違和感のない用語はカタカナ語のまま使う。 | ||
| * 原則として全角文字列とアルファベットまたはインラインコードとが隣接した場合は半角スペースを入れるが、見た目の字幅が小さな全角記号（`？` と `～` を除く全ての全角記号）の前後では半角スペースを入れない。 | ||
| * 全角文字列と数字が隣接した場合も半角スペースを入れない。 | ||
|
|
||
| ## Building the Reference Manual Locally | ||
| ## 翻訳に貢献したい方へ | ||
|
|
||
| To build the manual, run the following command: | ||
| * 競合を防ぐため、翻訳開始したとき、ファイルごとに draft PR を出してください。 | ||
| * 1つのPRに含める変更は少なめにしてください。 | ||
|
|
||
| ## ローカルでのビルド方法 | ||
|
|
||
| 1. TeX Live と Python をインストールする | ||
|
|
||
| 2. 下記コマンドでビルドする | ||
|
|
||
| ``` | ||
| lake exe generate-manual --depth 2 | ||
| ``` | ||
|
|
||
| Then run a local web server on its output: | ||
| 3. 下記コマンドでローカルでサーバを立てる | ||
|
|
||
| ``` | ||
| python3 -m http.server 8880 --directory _out/html-multi & | ||
| ``` | ||
|
|
||
| Then open <http://localhost:8880> in your browser. | ||
|
|
||
| ## Contributing | ||
|
|
||
| Please see [CONTRIBUTING.md](CONTRIBUTING.md) for more information. | ||
|
|
||
| 4. ブラウザで <http://localhost:8880> にアクセスする |
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,34 @@ | ||
| # Lean Language Reference | ||
|
|
||
| The Lean Language Reference is intended as a comprehensive, precise description of Lean. It is first and foremost a reference work in which Lean users can look up detailed information, rather than a tutorial for new users. | ||
|
|
||
| This new reference has been rebuilt from the ground up in Verso. This means that all example code is type checked, the source code contains tests to ensure that it stays up-to-date with respect to changes in Lean, and we can add any features that we need to improve the documentation. Verso also makes it easy to integrate tightly with Lean, so we can show function docstrings directly, mechanically check descriptions of syntax against the actual parser, and insert cross-references automatically. | ||
|
|
||
|
|
||
| ## Reading the Manual | ||
|
|
||
| The latest release of this reference manual can be read [here](https://lean-lang.org/doc/reference/latest/). | ||
|
|
||
| For developers: | ||
| * The output of building the current state of the `main` branch can be read [here](https://lean-reference-manual-review.netlify.app/). | ||
| * Each pull request in this repository causes two separate previews to be generated, one with extra information that's only useful to those actively working on the text, such as TODO notes and symbol coverage progress bars. These are posted by a bot to the PR after the first successful build. | ||
|
|
||
| ## Building the Reference Manual Locally | ||
|
|
||
| To build the manual, run the following command: | ||
|
|
||
| ``` | ||
| lake exe generate-manual --depth 2 | ||
| ``` | ||
|
|
||
| Then run a local web server on its output: | ||
| ``` | ||
| python3 -m http.server 8880 --directory _out/html-multi & | ||
| ``` | ||
|
|
||
| Then open <http://localhost:8880> in your browser. | ||
|
|
||
| ## Contributing | ||
|
|
||
| Please see [CONTRIBUTING.md](CONTRIBUTING.md) for more information. | ||
|
|