目录
jinzhongjia

docs(course): 优化表述与修正措辞 (#259)

  • docs(course): 优化表述与修正措辞
  • 调整 build-system.md 中并发编译相关描述,使语义更准确
  • 优化 package_management.md 对官方包管理器的介绍
  • 改进 install-environment.md 关于 Zig 发布周期的说明
  • 精简 hello-world.md 中 main 函数和 print 函数的说明,提升可读性
  • 修改 prologue.md 中关于“为何学习 low level 语言”的表述
  • style(update): 优化发行说明表述
  • 修改 0.12.0 版本说明,使语句更简洁易读
  • 优化 0.13.0 版本锁实现描述,提升表达准确性
  • 修正 0.14.0 版本目标修复说明中的措辞
  • docs(readme): 修正文档标点和格式
  • 将“开发命令:”修改为“开发命令:”
  • 修复文档末尾缺失换行符问题
  • feat(docs): 优化基础类型与环境配置文档表达
  • 修正多处语句表述,使语言更准确流畅
  • 统一术语与格式,提升文档一致性
  • 优化编辑器与安装环境相关说明,增强可读性
  • 补充部分命令用法与示例,便于新手理解
  • 修正部分技术细节描述,确保内容准确
  • feat(course): 优化 hello world 教程内容与表达
  • 改进整体表述,使语言更简洁易懂
  • 明确区分调试与生产环境下的输出方式
  • 增加对缓冲区与线程安全输出的说明
  • 丰富代码解析,补充格式化字符串与参数讲解
  • 补充相关提示与外部学习资源链接
  • chore(deps): 更新依赖版本
  • 升级 @types/node 至 24.0.10
  • 升级 prettier 至 3.6.2
  • docs(basic): 修正文档格式与空行一致性
  • 统一部分 Markdown 文件的结尾换行符
  • 为列表前增加空行,提升可读性
  • 保持文档风格一致,便于后续维护
  • docs(basic): 优化基础类型与高级类型章节中文表述
  • 优化数组、枚举、结构体、指针、切片、字符串、向量、联合类型等基础与高级类型文档的中文表述

  • 统一术语表达,提升可读性与准确性

  • 修正部分技术细节描述,使其更贴合 Zig 语言规范

  • 增强示例注释,便于初学者理解

  • 补充部分章节的提示与说明,完善文档结构

  • 优化变量声明、错误处理、可选类型、流程控制等章节的中文表达

  • 统一术语,调整部分章节标题,更符合中文技术文档习惯

  • 修正部分示例代码的描述与注释

  • 增强对 Zig 语言特性的解释,便于中文读者理解

  • 细化零大小类型相关内容,完善类型系统介绍

  • 统一“零位类型”为“零大小类型”,并补充相关示例说明

  • 全面提升文档中文表达质量,便于后续维护与推广

  • feat(advanced): 优化 Zig 汇编方式与内联汇编表述
  • 明确区分外部汇编与内联汇编两种方式
  • 优化内联汇编定义,使表述更准确易懂
  • style: 修正文档标点和列表格式
  • 统一中文句号为全角
  • 修正无序列表缩进,使用标准 markdown 语法
  • 保持内容一致性,提升可读性
  • fix(docs): 修正文档中的错别字与表述不当
  • 统一术语表述,如“效验和”改为“校验和”
  • 修正英文单词拼写错误(如 vedio→video、tunk→trunk、finisho→finish)
  • 优化部分语句表达,使其更通顺准确
  • 补充或调整部分引用和注释内容
  • 规范部分格式和标点用法
  • docs(examples): 修正 I/O 多路复用描述中的格式
  • 将“文件描述符”改为斜体以统一格式
  • 优化文档可读性
  • chore(deps): 更新开发依赖版本
  • 升级 @types/node 至 24.0.10
  • 升级 prettier 至 3.6.2
  • fix(update): 修正文档错别字与术语不一致
  • 统一“三重”术语为“三元组”
  • 修正“tokenizer”为“标记器”
  • 修复“deflat e”为“deflate”
  • 更正“a comptime var”为“comptime var
  • 修改“不在允许”为“不再允许”
  • 去除 Compile.installHeader 多余空格
  • 修正变量名拼写错误 dep_foor_bardep_foo_bar
14天前452次提交
目录README.md

Zig 语言圣经

autocorrect build check deploy pdf

Zig is a general-purpose programming language and toolchain for maintaining robust, optimal and reusable software.

Zig 是一种通用的编程语言和工具链,用于维护健壮、最优和可重用的软件

Cover Image

Zig 语言圣经 是一份开源的 Zig 语言综合教程,旨在为中文 Zig 爱好者提供一份高质量的学习资源,内容涵盖从基础语法到高级特性的方方面面。

✨ 内容特色

本教程覆盖了 Zig 学习和实践中的多个重要领域:

  • 环境配置: 指导如何安装和配置 Zig 开发环境。
  • 基础入门: 包括变量、类型、流程控制、错误处理等基础知识。
  • 高级主题: 深入探讨 comptime、异步、内存管理、C 语言交互等高级特性。
  • 工程实践: 涵盖构建系统、包管理、单元测试和代码风格指南。
  • 版本示例: 提供与 Zig 不同版本相对应的代码示例。

🚀 如何阅读

本项目使用 VitePress 构建。您可以直接在本地启动开发服务器以阅读最新内容:

bun i # 安装依赖
bun dev # 启动热更开发服务

🤝 参与贡献

欢迎各位志同道合的“道友”参与贡献本文档,并一起壮大 zig 中文社区!

贡献方法:

  • Fork 本文档仓库
  • 创建一个新的分支,请勿直接使用主分支进行修改
  • 发起 Pull Request
  • 等待 Review
  • 合并到上游仓库,并由 GitHub Action 自动构建

开发命令:

bun i # 安装依赖
bun dev # 启动热更开发服务
bun format # 运行 prettier, zig fmt 和 autocorrect 格式化程序
bun run build # 构建产物
bun run preview # 运行预览

[!NOTE] 请自行安装 bun (建议也安装 autocorrect,并且在提交前运行 bun format

[!NOTE] 本文档所使用的构建工具为 bunjs,在提交时请勿将其他 nodejs 的包管理工具的额外配置文件添加到仓库中。

如需要更新依赖,请参照此处 Lockfile 先设置 git 使用 bun 来 diff 文件!

关于
4.7 MB
邀请码