fix links in mdbook

zigcc · Oct 5, 2023 · 0c8d3d8 · 0c8d3d8
1 parent f9b302a
commit 0c8d3d8
Show file tree

Hide file tree

Showing 12 changed files with 33 additions and 19 deletions.
diff --git a/00-preface.md b/00-preface.md
@@ -1,5 +1,5 @@
 # 前言
 
-欢迎阅读 Zig 编程语言入门指南《学习 Zig》。本指南旨在让你轻松掌握 Zig。本指南假定你已有编程经验，但并非使用任何特定语言。
+欢迎阅读 Zig 编程语言入门指南《学习 Zig》。本指南旨在让你轻松掌握 Zig。本指南假定你已有编程经验，语言不限。
 
 Zig 目前正在紧锣密鼓地开发中，Zig 语言及其标准库都在不断发展。本指南以最新的 Zig 开发版本为目标。不过，部分代码有可能编译不通过。如果你下载了最新版本的 Zig，但在运行某些代码时遇到问题，请提 [issue](https://github.com/karlseguin/blog/issues)。
diff --git a/01-installing-zig.md b/01-installing-zig.md
@@ -1,4 +1,4 @@
-> 原文地址：https://www.openmymind.net/learning_zig/#install
+> 原文地址：<https://www.openmymind.net/learning_zig/#install>
 
 # 安装 Zig
 

diff --git a/02-language-overview-part1.md b/02-language-overview-part1.md
@@ -1,4 +1,4 @@
-> 原文地址：https://www.openmymind.net/learning_zig/language_overview_1/
+> 原文地址：<https://www.openmymind.net/learning_zig/language_overview_1>
 
 # 语言概述 - 第 1 部分
 

diff --git a/03-language-overview-part2.md b/03-language-overview-part2.md
@@ -1,4 +1,4 @@
-> 原文地址：https://www.openmymind.net/learning_zig/language_overview_2/
+> 原文地址：<https://www.openmymind.net/learning_zig/language_overview_2>
 
 # 语言概述 - 第二部分
 

diff --git a/04-style-guide.md b/04-style-guide.md
@@ -1,4 +1,4 @@
-> 原文地址：https://www.openmymind.net/learning_zig/style_guide/
+> 原文地址：<https://www.openmymind.net/learning_zig/style_guide>
 
 # 代码风格和规范
 

diff --git a/05-pointers.md b/05-pointers.md
@@ -1,4 +1,4 @@
-> 原文地址：https://www.openmymind.net/learning_zig/pointers/
+> 原文地址：<https://www.openmymind.net/learning_zig/pointers>
 
 # 指针
 

diff --git a/06-stack-memory.md b/06-stack-memory.md
@@ -1,4 +1,4 @@
-> 原文地址：https://www.openmymind.net/learning_zig/stack_memory/
+> 原文地址：<https://www.openmymind.net/learning_zig/stack_memory>
 
 # 栈内存
 

diff --git a/07-heap-memory-and-allocator.md b/07-heap-memory-and-allocator.md
@@ -1,6 +1,6 @@
-> 原文地址：https://www.openmymind.net/learning_zig/heap_memory/
+> 原文地址：<https://www.openmymind.net/learning_zig/heap_memory>
 
-# 堆内存和分配器（Allocator）
+# 堆和分配器 Heap & Allocator
 
 迄今为止，我们所接触到的一切都有个限制，需要预先知道大小。数组总是有一个编译时已知的长度（事实上，长度是类型的一部分）。我们所有的字符串都是字符串字面量，其长度在编译时是已知的。
 

diff --git a/08-generics.md b/08-generics.md
@@ -1,4 +1,4 @@
-> 原文地址：https://www.openmymind.net/learning_zig/generics/
+> 原文地址：<https://www.openmymind.net/learning_zig/generics>
 
 # 泛型 Generics
 

diff --git a/09-coding-in-zig.md b/09-coding-in-zig.md
@@ -1,4 +1,4 @@
-> 原文地址：https://www.openmymind.net/learning_zig/coding_in_zig/
+> 原文地址：<https://www.openmymind.net/learning_zig/coding_in_zig>
 
 # 实战
 

diff --git a/10-conclusion.md b/10-conclusion.md
@@ -1,11 +1,11 @@
-> 原文总结：https://www.openmymind.net/learning_zig/conclusion/
+> 原文总结：<https://www.openmymind.net/learning_zig/conclusion>
 
 # 总结
 
-有些读者可能会认出我是各种『The Little $TECH Book』 的作者，并想知道为什么这本书不叫『The Little Zig Book』。事实上，我不确定 Zig 是否适合『小』这个范畴。部分挑战在于，Zig 的复杂性和学习曲线会因个人背景和经验的不同而大相径庭。如果你是一个经验丰富的 C 或 C++ 程序员，那么简明扼要地总结一下这门语言可能就可以了，但这样的话，你可能会依赖于[Zig 语言官方文档](https://ziglang.org/documentation/master/)。
+有些读者可能会认出我是各种『The Little $TECH Book』 的作者（译者注：原作者还写过 [The Little Go Book](https://github.com/karlseguin/the-little-go-book)、[The Little MongoDB Book](https://github.com/karlseguin/the-little-mongodb-book)），并想知道为什么这本书不叫『The Little Zig Book』。事实上，我不确定 Zig 是否适合『小』这个范畴。部分挑战在于，Zig 的复杂性和学习曲线会因个人背景和经验的不同而大相径庭。如果你是一个经验丰富的 C 或 C++ 程序员，那么简明扼要地总结一下这门语言可能就够了，你可能会更需要[Zig 的官方文档](https://ziglang.org/documentation/master/)。
 
-虽然我们在本指南中涉及了很多内容，但仍有大量内容我们尚未触及。我不希望这让你气馁或不知所措。所有语言都是多层次的，你现在有了一个基础和参考，可以开始掌握这些语言。坦率地说，我没有涉及的部分我根本就不太理解，无法解释。但这并不妨碍我在 Zig 中使用和构建有意义的东西，比如一个流行的 [HTTP 服务器](https://github.com/karlseguin/http.zig)。
+虽然我们在本指南中涉及了很多内容，但仍有大量内容我们尚未触及。我不希望这让你气馁或不知所措。所有语言的学习都是循序渐进的，通过本教程，你有了一个良好基础，也可以把它当作参数资料，可以开始学习 Zig 语言中更高级的功能。坦率地说，我没有涉及的部分我本身就理解有限，因此无法很好的解释。但这并不妨碍我使用 Zig 编写有意义的东西，比如一个流行的 [HTTP 服务器](https://github.com/karlseguin/http.zig)。
 
-我确实想强调一件完全被略过的事情。这可能是你已经知道的事情，但 Zig 与 C 代码配合得特别好。因为生态系统还很年轻，标准库也很小，所以在某些情况下，使用 C 库可能是最好的选择。例如，Zig 标准库中没有正则表达式模块，使用 C 语言库就是一个合理的选择。我曾为 SQLite 和 DuckDB 编写过 Zig 库，这很简单。如果你基本遵循了本指南中的所有内容，应该不会有任何问题。
+我确实想强调一件完全被略过的事情。这可能是你已经知道的事情，即 Zig 与 C 代码配合得特别好。因为 Zig 的生态还很年轻，标准库也很小，所以在某些情况下，使用 C 库可能是最好的选择。例如，Zig 标准库中没有正则表达式模块，使用 C 语言库就是一个合理的选择。我曾为 SQLite 和 DuckDB 编写过 Zig 库，这很简单。如果你基本遵循了本指南中的所有内容，应该不会有任何问题。
 
 希望本资料对你有所帮助，也希望你能在编程过程中获得乐趣。
diff --git a/README.md b/README.md
@@ -1,12 +1,26 @@
 # [Learning Zig](https://www.openmymind.net/learning_zig/) 中文翻译
 
-> 在线阅读地址：https://zigcc.github.io/learning-zig
+> 在线阅读地址：<https://zigcc.github.io/learning-zig>
 
-本系列教程最初由 [karlseguin](https://github.com/karlseguin) 用户编写，行文流畅，讲述的脉络由浅入深，深入浅出，是入门 Zig 的非常不错的选择。
+《学习 Zig》系列教程最初由 [Karl Seguin](https://github.com/karlseguin) 编写，该教程行文流畅，讲述的脉络由浅入深，深入浅出，是入门 Zig 非常不错的选择。因此，[Zig 中文社区](https://zigcc.github.io/)将其翻译成中文，便于在中文用户内阅读与传播。
 
-因此，[Zig 中文社区](https://zigcc.github.io/)将其翻译成中文，便于在中文用户内阅读与传播，初次接触 Zig 的用户可以按序号依次阅读，对于有经验的 Zig 开发者可按需阅读。
+初次接触 Zig 的用户可以按序号依次阅读，对于有经验的 Zig 开发者可按需阅读感兴趣的章节。
 
-如果发现拼写错误或翻译不流畅的地方，欢迎提交 [issue](https://github.com/zigcc/learning-zig/issues) 汇报，或直接提 [Pull Request](https://github.com/zigcc/learning-zig/pulls) 改进。
+## 关于原作者
+
+[Karl Seguin](https://www.linkedin.com/in/karlseguin/) 在多个领域有着丰富经验，前微软 MVP，他撰写了大量文章，是多个微软公共新闻组的活跃成员。现居新加坡。他还是以下教程的作者：
+
+- [The Little Go Book](https://github.com/karlseguin/the-little-go-book)
+- [The Little Redis Book](https://github.com/karlseguin/the-little-redis-book)
+- [The Little MongoDB Book](https://github.com/karlseguin/the-little-mongodb-book)
+
+可以在 <http://openmymind.net> 找到他的博客，或者通过 [@karlseguin](http://twitter.com/karlseguin) 在 Twitter 上关注他。
+
+## 翻译原则
+
+技术文档的翻译首要原则是准确，但在准确的前提下如何保证『信、达、雅』？这是个挑战，在翻译本教程时，在某些情况下会根据上下文进行意译，便于中文读者阅读。
+
+如果你发现拼写错误或翻译不流畅的地方，欢迎提交 [issue](https://github.com/zigcc/learning-zig/issues) 汇报，或直接提 [Pull Request](https://github.com/zigcc/learning-zig/pulls) 改进。
 
 最后，感谢翻译者的无私贡献。❤️️