free-programming-books

:books: Freely available programming books

View the Project on GitHub EbookFoundation/free-programming-books

阅读本文的其他语言版本

贡献者许可协议

请遵循此许可协议参与贡献。

贡献者行为准则

请同意并遵循此行为准则参与贡献。(translations)

概要

  1. 仅仅因为链接“促进下载书籍”并不意味着它指向“免费”书籍。 请仅提供免费内容的链接。 确保您分享的书籍是免费的。 我们不接受“需要”有效电子邮件地址才能访问书籍的链接,但我们欢迎列出这些资源。

  2. 您不需要熟悉 Git:如果您发现一些有趣的东西尚未包含在此存储库中,请打开一个[问题](https://github.com/EbookFoundation/free-programming-books/issues)开始讨论相关主题。
    • 如果你已经知晓Git,请Fork本仓库并提交Pull Request (PR)。
  3. 这里有6种列表,请选择正确的一个:

    • Books :PDF、HTML、ePub、基于一个 gitbook.io的站点、一个Git仓库等等。
    • Courses :课程是一种学习材料,而不是一本书 This is a course
    • Interactive Tutorials :一个交互式网站,它允许用户输入代码或命令并对结果进行评估。例如:Try HaskellTry GitHub
    • Playgrounds : Playgrounds 可能是学习编程的在线交互式网站、游戏或桌面软件。你可以在上面编写、编译、运行或分享代码片段。Playgrounds 通常允许你 fork 代码然后在其中尽情的编写代码。
    • Podcasts and Screencasts :播客和视频。
    • Problem Sets & Competitive Programming :一个网站或软件,让你通过解决简单或复杂的问题来评估你的编程技能,有或没有代码审查,有或没有与其他用户对比结果。
  4. 确保遵循下面的基本准则,并遵循本仓库文件的Markdown规定格式

  5. GitHub Actions 将运行测试,以确保你的列表是 按字母顺序排列 的,并 遵循格式化规则。请 确保 你的更改通过了该测试。

审查和适应过程

为了确保一致性和准确性,我们在将内容从英语版本翻译成其他语言时遵循审查和调整流程。 它的工作原理如下:

  1. 参考英文文件:我们始终参考该文件的英文版本作为信息和指南的主要来源。

  2. 翻译和本地化:译员仔细地将内容翻译成目标语言,同时牢记语言和文化的细微差别。

  3. 审阅:翻译后,文件会经过母语人士的审阅过程,以确保翻译的准确性。

  4. 改编:在某些情况下,特定术语、短语或参考文献可能需要改编以更好地适应目标受众。 译者可以灵活地进行这些调整,同时保留核心信息。

  5. 质量保证:进行最终的质量保证检查,以验证翻译的文档是否连贯、准确且适合文化。

  6. 持续改进:我们鼓励贡献者和读者提供反馈和建议,以不断改进翻译内容。

通过遵循这一流程,我们的目标是提供既忠实于原始内容又与目标受众相关的高质量翻译。

基本准则

规定格式

整体思想为:

举例:

[...]
* [一本很有用的书](http://example.com/example.html)
                                (空行)
                                (空行)
### 电子书种类标题
                                (空行)
* [Another 很有用的书](http://example.com/book.html)
* [Other 有用的书](http://example.com/other.html)

按字母顺序

如果您看到错误的链接,请检查 linter 错误讯息以了解应该交换哪些行。

笔记

虽然基础知识相对简单,但我们列出的资源却多种多样。以下是关于我们如何处理这种多样性的一些说明。

元数据

我们的清单提供了一组最小的元资料:标题、URL、创建者、平台和存取注释。

标题
网址
创作者
平台及接入注意事项

类型

决定资源属于哪个清单的第一条规则是查看资源如何描述自己。如果它称自己为一本书,那么也许它就是一本书。

我们未列出的流派

由于互联网非常庞大,因此我们不将以下内容包括在列表中:

我们的竞争性节目清单对这些例外情况没有那么严格。 仓库的范围由社区决定;如果您想建议更改或新增范围,请使用 issue 提出建议

书籍与其他东西

我们对书本性并不那么挑剔。以下是一些表示资源是一本书的属性:

我们列出的许多书籍不具备这些属性;这可能取决于上下文。

书与课程

有时这些可能很难区分!

课程通常有相关的教科书,我们会将其列在图书列表中。课程包括讲座、练习、测试、笔记或其他教学辅助工具。单个讲座或视频本身并不是一门课程。PowerPoint不是课程。

交互式教程与其他东西

如果您可以将其打印出来并保留其精髓,那么它就不是交互式教程。

自动化