#mdbook #educational #series

bin+lib triangle-from-scratch

一个关于如何自己动手做东西的教育系列

1 个不稳定版本

0.1.0 2021年1月13日

#797 in 图形 API

Zlib OR Apache-2.0 OR MIT

83KB
1.5K SLoC

从头开始的三角形

这是一个教程仓库

请随意查看源代码,但这个 crate 不在 crates.io 上,项目的“价值”大部分在于解释正在发生什么的 mdbook 文章。

您可以在 GitHub 页面上阅读这本书

项目组织

book_src/ 包含构建 mdbook 的文件(cargo install mdbook && mdbook build --open)。

examples/ 文件夹是基于 mdbook 章节的已完成的、可运行的示例的“存档”。

crate 的库部分(src/lib.rs 和子模块)包含基于 mdbook 章节中所示工作的最易重用的代码。

crate 的二进制部分(src/main.rs)只是一个占位符。这样您就可以在执行工作时最方便地使用 cargo run 来测试事情。在任何给定时刻 main.rs 的实际内容并不重要。所有有价值的代码都保存在完成教程章节时的 example/ 文件中。

许可和贡献

许可

此项目的内容许可为 Zlib OR Apache-2.0 OR MIT

此外,有些人告诉我,源代码许可对于非代码工作,如教程,不是“适当的”。如果您愿意,您可以在 CC BY-SA 4.0 许可下使用项目的非代码部分。(我个人认为,一旦教程涉及到源代码,一切确实变得非常模糊,但我不懂法律,并且我宁愿人们有更多的选择而不是更少的选择。)

对项目的任何贡献都必须在相同的许可条款下提交。

什么是有价值的贡献?

这是一个非常好的问题,我很高兴你问了。

尽管本系列的核心关注于Win32,但我希望能最终涵盖所有三个桌面操作系统(Win/Mac/Linux)。同样,我也希望能支持两大主要移动操作系统(Android/iOS),甚至嵌入式设备也在范围内。

唯一的真正限制是,我对所有这些不同的平台了解不多。如果您熟悉我们尚未有文章的某个平台,并且想要撰写一些内容,请与我联系。最简单的方式是开启一个跟踪问题,或者如果您已经开始了,可以开始一个草案PR。

无运行时依赖