企业官网建设流程全解析

自学是门手艺两种版本怎么选？从 clone 到读完的 5 步完整指南

【免费下载链接】the-craft-of-selfteachingOne has no future if one couldn't teach themself.项目地址: https://gitcode.com/GitHub_Trending/th/the-craft-of-selfteaching

《自学是门手艺》（the-craft-of-selfteaching）给了 47 章 Notebook 版（.ipynb）和 Markdown 版（.md），内容一致，读法不同。结论：先读 markdown/ 目录里的 .md 建立全书框架，要动手跑代码时再切根目录的 .ipynb。

对号入座：3 种读者场景各读哪版

先对号，再动手。

两版内容同源：Markdown 版由 Notebook 版批量转换而来，以 .ipynb 为准，转换过程记录在 markdown/README.md。想动手的读者可以先看这张图——这就是 JupyterLab 里运行 .ipynb 的状态，每个格子都可直接执行。

从 clone 到读完：5 步操作路径

第 1 步，把仓库拿到本地。仓库是只读的，克隆下来直接读：

git clone https://gitcode.com/GitHub_Trending/th/the-craft-of-selfteaching

第 2 步，通读 Markdown 版。从 markdown/01.preface.md 开始，顺序跟着 markdown/TOC.md 走，先把 Part 1 的 7 个编程基础章读完。这一遍的目标是建立全书框架，不用跑代码。

第 3 步，装好环境切 Notebook 版。按附录 T-appendix.jupyter-installation-and-setup.md 配好 JupyterLab（JupyterLab 是一个在浏览器里写、跑 Python 的工具），然后启动：

jupyter lab

第 4 步，逐章打开 .ipynb 敲代码。从 Part.1.E.1.entrance.ipynb 开始，每个代码单元格亲手敲一遍。Part.1.G 内嵌了 Python 官方教程 The Python Tutorial，文档页长这样，可配合它自带的搜索功能查函数：

第 5 步，检验读没读懂。全书 308 个代码单元格、533 条执行输出都预存在 .ipynb 里。每读完一章，把该章代码重跑一遍，输出和预存的一致，才算真读完。书里还设计了"工作证明"（Proof of Work，借用比特币术语，指可被验证的实际行动）机制，细节见 markdown/02.proof-of-work.md。

这 3 个坑，读之前先避开 💡

坑 1：.md 里图片全是裂的。现象：手机打开 .md，正文都在，图全挂。原因：Markdown 版的图片链接指向仓库的远端图片地址，断网就加载不出来。怎么办：改读同名 .ipynb，图片内嵌在单元格里，离线也能看。

坑 2：.ipynb 比 .md 大一个量级。现象：Part.1.E.7.files.ipynb 约 171 KB，对应的 .md 只有约 13 KB，下载和打开都慢。原因：533 条执行输出全部存在 notebook 里。怎么办：不用跑一遍才看得到结果——输出已在文件内，点开单元格直接看。

坑 3：跳着读，越读越懵。现象：直接翻 Part 3 的类和装饰器，满屏不认识的词。原因：全书存在大量"过早引用"（后文概念在前文就冒头），Part.1.F 专门讲怎么应对。怎么办：严格按 markdown/TOC.md 的顺序读，撞到引用再回头查。

收尾：今天就能做的第一件事

One has no future if one couldn't teach themself.

两个版本分的是工，不是争位：.md 负责让你读懂，.ipynb 负责让你做出来。现在就可以做的一件事：打开 markdown/01.preface.md，今晚把前言和 02.proof-of-work 这两章读完。

【免费下载链接】the-craft-of-selfteachingOne has no future if one couldn't teach themself.项目地址: https://gitcode.com/GitHub_Trending/th/the-craft-of-selfteaching