Skip to content

Commit

Permalink
Merge pull request patriciogonzalezvivo#385 from ShinghoiXu/master
Browse files Browse the repository at this point in the history
add Chinese support for appendix
  • Loading branch information
patriciogonzalezvivo authored Nov 4, 2022
2 parents 65551f0 + fad9ec3 commit 0e0c727
Show file tree
Hide file tree
Showing 5 changed files with 200 additions and 0 deletions.
33 changes: 33 additions & 0 deletions appendix/00/README-ch.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
## 如何离线阅读此书?

假如你在计划一次长途旅行,并且你打算通过此书在旅途中自学一些着色器相关的知识。在这种情况下,你在你的电脑上可以搞一份本地版的这本书,并运行一个本地服务器。

要这么搞的话你只需要PHP,Python 3以及一个git客户端。在MacOS和树莓派设备上,Python已经预装好了,但是你仍然需要自行安装PHP和一个git客户端。具体操作如下:

**MacOSX** 上请确保你已经安装了 [homebrew](http://brew.sh/) 然后在你的终端上输入如下指令:

```bash
brew update
brew upgrade
brew install git php
```

**树莓派** 上请确保你已经安装了 [Raspbian](https://www.raspberrypi.org/downloads/raspbian/), 一个为树莓派开发的基于Debian的Linux发行版本,然后执行如下指令:

```bash
sudo apt-get update
sudo apt-get upgrade
sudo apt-get install git-core glslviewer php
```

一旦你把一切装好之后你只需要这么做:

```bash
cd ~
git clone --recursive https://github.com/patriciogonzalezvivo/thebookofshaders.git
cd thebookofshaders
git submodule foreach git submodule init && git submodule update
php -S localhost:8000
```

然后打开你的浏览器,打开 [`http://localhost:8000/`](http://localhost:8000/)
18 changes: 18 additions & 0 deletions appendix/01/README-ch.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
## 如何在树莓派上运行示例程序?

几年前,假设每个人都有一台有图形处理单元的计算机是一个大胆的想法。 现在,大多数计算机都有 GPU,但对于工作坊或课堂的要求来说,这仍然是个很高的标准。

多亏了 [树莓派基金会](http://www.raspberrypi.org/), 一种新型的小型廉价计算机(每台约35美元)已被引入课堂。更重要的是,就本书的需求而言,[树莓派](http://www.raspberrypi.org/)配备了一个不错的可以直接从控制台访问的Broadcom GPU。我做了一个 [叫作**glslViewer**的灵活的GLSL实时编程工具](https://github.com/patriciogonzalezvivo/glslViewer),它可以运行这本书里全部的示例。当用户保存对其代码的更改时,该编程工具还具有自动更新的能力。这是啥意思? 就是说,你可以编辑着色器,每次保存时,着色器都会重新编译并渲染。

通过制作本书的本地副本(详情见上一章节) 并 [安装好`glslViewer`](https://github.com/patriciogonzalezvivo/glslViewer),用户可以使用`glslviewer`运行示例。此外,通过使用 `-l` 标志,它们可以在你用任何文本编辑器(例如 `nano``pico``vi``vim``emacs`)来修改代码的时候在屏幕角落渲染示例。如果用户通过ssh或sftp协议连接,这也有效。

在树莓派上装完 [Raspbian](https://www.raspberrypi.org/downloads/raspbian/)——一个为树莓派开发的基于Debian的Linux发行版本——之后,要在树莓派上装好搞好这一切,只需要登陆系统,输入如下指令:

```bash
sudo apt-get update
sudo apt-get upgrade
sudo apt-get install git-core glslviewer
cd ~
git clone https://github.com/patriciogonzalezvivo/thebookofshaders.git
cd thebookofshaders
```
72 changes: 72 additions & 0 deletions appendix/02/README-ch.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,72 @@
## 如何打印这本书?

假设你不想浏览示例或与示例进行交互,而只想要一本绝佳的、老派的、可以在海滩上或通勤到城市的路上阅读的纸质书。在这种情况下,你可以把这本书打印出来。


#### 安装glslViewer

要打印这本书,你首先需要对其进行转换。为此,你会需要 [`glslViewer`](https://github.com/patriciogonzalezvivo/glslViewer)——一个控制台着色器工具,它将编译着色器示例并将其转换为图像。

**MacOSX** 上请确保你已经安装了 [homebrew](http://brew.sh/) 然后在你的终端上输入如下指令:

```bash
brew install glslviewer
```

**树莓派** 上请确保你已经安装了 [Raspbian](https://www.raspberrypi.org/downloads/raspbian/), 一个为树莓派开发的基于Debian的Linux发行版本,然后执行如下指令:

```bash
sudo apt-get update
sudo apt-get upgrade
sudo apt-get install git-core glslviewer
```

#### 安装Python 3,Latex Engine和Pandoc

为了将 Markdown 章节解析为 Latex,然后转换为PDF文件,我们将使用 Xetex Latex Engine 和 Pandoc。

**MacOSX** 上:

下载并安装 MacTeX :

```bash
brew cask install mactex-no-gui
```

然后安装 [Pandoc](http://johnmacfarlane.net/pandoc/) 和 Python 3:

```bash
brew install pandoc python
```

**树莓派** (Raspbian)上:

```bash
sudo apt-get install texlive-xetex pandoc python2.7
```

#### 将书编译成pdf并打印

现在您已经拥有了所需的一切,是时候克隆 [本书的库](https://github.com/patriciogonzalezvivo/thebookofshaders) 并编译本书了。

为此,请再次打开你的终端并输入:

```bash
cd ~
git clone https://github.com/patriciogonzalezvivo/thebookofshaders.git
cd thebookofshaders
make clean pdf
```

如果一切顺利,你将看到一个 `book.pdf` 文件,你可以在自己喜欢的设备上阅读或打印该文件。

#### 将书编译成 epub 以供电子阅读器使用

```bash
cd ~
git clone https://github.com/patriciogonzalezvivo/thebookofshaders.git
cd thebookofshaders
make clean epub
```

生成的 `book.epub` 可以直接使用,也可以使用转换器(例如 Calibre)转换为 `.mobi` 文件以供 Kindle 阅读。
62 changes: 62 additions & 0 deletions appendix/03/README-ch.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
## 我怎样共创这本书?
感谢您愿意合作! 您有很多方法可以参与其中:

- 翻译内容
- 改进 [```词汇表``` 部分](https://github.com/patriciogonzalezvivo/thebookofshaders/tree/master/glossary)
- 编辑内容
- 通过 [在线编辑器](http://editor.thebookofshaders.com/) 分享您的着色器示例到____

### 翻译内容

这本书是用 [Markdown 语言](https://daringfireball.net/projects/markdown/syntax) 编写的,因此很容易编辑和修改。

1. 首先请到 [位于 ```github.com/patriciogonzalezvivo/thebookofshaders``` github库](https://github.com/patriciogonzalezvivo/thebookofshaders)。 你会注意到内容在 ```README.md``` 和其他以大写字母命名的文件中,例如:```TITLE.md``````SUMMARY.md``` 等。还要注意文件名称末尾的两个字母表示着它们所使用的语言,例如:```README-jp.md``````README-es.md``` 等。

2. Fork这个库并将其克隆到您的计算机中。

3. 复制你要翻译的文件内容。 别忘了在你正在翻译的文件名末尾加上两个表示着它们所使用的语言的字母。

4. 逐行翻译内容(见**翻译须知**)。

5. 测试它 (见 **测试**)。

6. 推送到你自己的 github fork 然后发起一个 [Pull Request](https://help.github.com/articles/using-pull-requests/)

#### 翻译须知

不要擦除或修改嵌入的示例内容,示例如下:

```html
<div class="codeAndCanvas" data="grid-making.frag"></div>
```

or

```html
<div class="simpleFunction" data="y = mod(x,2.0);"></div>
```

#### 测试

开始在本地存储库文件夹中运行本地 PHP 服务器:

```bash
php -S localhost:8000
```

然后在您的浏览器中搜索 ```localhost:8000``` 转到您正在翻译的章节并添加 ```?lan=``` 后跟您用来标记您要翻译的语言的两个字母。

例如,如果你正在将章节 ```03``` 翻译成法语,你一直在使用文件 ```03/README-fr.md```,你可以通过以下方式对其进行测试: ``` http://localhost:8000/03/?lan=fr```

### 改进词汇表部分

本章节正在开发中。 我们很高兴听取您关于如何使其成为所有人的好工具的想法。 给我们发送消息到 [@bookofshaders](https://twitter.com/bookofshaders)

### 编辑内容

我们都是人类。 如果您看到某些不对劲的地方,说出来并提出一个Pull Request或提交一个issue。 多谢!

### 分享你的着色器示例

您会看到很多指向 [在线编辑器](http://editor.thebookofshaders.com/) 的链接以及它的嵌入实例。
一旦您编写了让您感到自豪的代码,请单击“导出”(或 `````` 图标),然后复制“URL to code...”。 将其发送到 [@bookofshaders](https://twitter.com/bookofshaders)[@kyndinfo](https://twitter.com/kyndinfo)。 我们期待看到它并将其添加到 [示例库部分](https://thebookofshaders.com/examples/)
15 changes: 15 additions & 0 deletions appendix/README-ch.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
# 附录

1. [如何离线阅读此书?](00/)

2. [如何在树莓派上运行示例程序?](01/)

3. [如何打印这本书?](02/)

4. [我怎样共创这本书?](03/)

5. [给那些从JS语言过来的人的介绍](04/) [Nicolas Barradeau](http://www.barradeau.com/)

6. [向量导论](05/) by ...

7. [插值导论](06) by ...

0 comments on commit 0e0c727

Please sign in to comment.