Open xuzhengfu opened 4 years ago
[x] 第一步，访问本书配套学习用书的共享代码仓库（repo）。
[x] 点击右上角的 Fork 按钮，它会从我们的 repo 分叉出一个一模一样的 repo 并加入到你的账号中，这个新的 repo 继承了原 repo 的历史和现状，但它的未来由你来决定。
[x] 在这个新的 repo 的首页上有个绿色的 Clone or download 按钮，点击它会打开一个小的下拉显示，里面有个文本框写有这个 repo 的访问地址，点击它右边的小按钮将其拷贝到系统剪贴板（后面会用）。
[x] 第二步，现在要把属于你的这个分叉 repo 克隆到你自己的机器本地来，由于你顺利完成了环境准备，你的机器上已经有完善的命令行界面和软件包管理工具，还装好了 git，现在可以打开命令行界面进行如下操作：
cd Code
mkdir Code
git clone
↩︎
cd pilot-student
上面的命令会在 <你的用户根目录>/Code 目录下创建一个子目录，然后把学习用书从 GitHub 服务器上克隆到这个目录下。
<你的用户根目录>/Code
python -m pip install --upgrade pip pip install jupyterlab
pip 是 Python 自己的软件包管理工具，它负责安装、删除和管理 Python 浩若烟海的第三方代码库，我们以后会经常用到。上面第一行是更新 pip 自己，因为我们刚装好 Python，通常需要更新一下 pip 自己；第二行则是让 pip 安装 Jupyter Lab 以及所有依赖支持包。
pip
如果在运行上面第二个命令时报错说找不到、不认识 pip 命令，可尝试将 pip 换成 pip3，即运行 pip3 install jupyterlab。
pip3
pip3 install jupyterlab
[x] 某些环境下运行 Jupyter Lab 需要 nodejs，所以建议也安装好。macOS 系统执行：
brew install node
[x] 上述操作都成功后 Jupyter Lab 就准备就绪了，在你克隆好的学习用书目录里运行 jupyter lab ↩︎ 来启动 Jupyter Lab 的服务程序，并打开一个浏览器页面，里面列出了学习用书里的所有 notebook（.ipynb 后缀名的文件），双击就能打开了。
jupyter lab ↩︎
[x] 注意，运行 jupyter lab 的命令行窗口必须保持着，你才能继续在浏览器里使用 Jupyter Lab；如果你用完了，需要退出，在这个命令行窗口按 Control+C 组合键，就会停止 Jupyter Lab 服务，回到命令行交互界面。一般来说不要在 jupyter lab 运行时关闭那个窗口。
如果在 jupyter lab 运行着的时候你需要命令行界面执行一些任务，只要在 ConEmu 里打开一个新的 tab 就可以了，不用动之前的那个。
然后你可以：
[x] 使用 git commit 来把你修改的内容提交到本地仓库（local repo）；
git commit
[x] 使用 git push 来把你本地仓库中新的变化同步到 GitHub 上的远程仓库（remote repo）——这就是你的学习“工作证明（PoW）”。
git push
[x] 学习 Git 与 GitHub 入门教程 。
[x] 关于学习环境的准备，还可参考这个 视频指引。
[x] 如果在学习过程中遇到问题或者发现教材中的错误，可以通过 GitHub 的 Issues 系统提出，这个系统基本上就像一个问答论坛，但它集成了编程相关的能力，让它目的性更强、更容易跟踪问题解决的进度状态。访问我们课程教材的 Issues 页面：https://github.com/neolee/pilot/issues；
[x] 点击右上的 New 按钮来提出问题或者反馈，如果是问题请选择 question 这个 label，如果是关于教材中的错误或者改进建议可以选择 bug 或者 enhancement 这样的 label。
New
[x] 遇到问题的时候也可以到这个页面去搜索一下，看看是不是有人提过，得到了怎样的答案；如果没人提过，那就正好可以由你来提出，所有人也都会从中获益。
2020-02-04 16:24:56 initialize
1. 登录 GitHub
2. 获取你的学习用书
[x] 第一步，访问本书配套学习用书的共享代码仓库（repo）。
[x] 点击右上角的 Fork 按钮，它会从我们的 repo 分叉出一个一模一样的 repo 并加入到你的账号中，这个新的 repo 继承了原 repo 的历史和现状，但它的未来由你来决定。
[x] 在这个新的 repo 的首页上有个绿色的 Clone or download 按钮，点击它会打开一个小的下拉显示，里面有个文本框写有这个 repo 的访问地址，点击它右边的小按钮将其拷贝到系统剪贴板（后面会用）。
[x] 第二步，现在要把属于你的这个分叉 repo 克隆到你自己的机器本地来，由于你顺利完成了环境准备，你的机器上已经有完善的命令行界面和软件包管理工具，还装好了 git，现在可以打开命令行界面进行如下操作：
cd Code进入我们之前创建的子目录（如果还没有建立，可以用mkdir Code来创建）；git clone，在最后有个空格，在空格后粘贴你前面拷贝的，你 fork 的 repo 的地址，然后输入回车↩︎；cd pilot-student进入克隆好的目录中。上面的命令会在
<你的用户根目录>/Code目录下创建一个子目录，然后把学习用书从 GitHub 服务器上克隆到这个目录下。3. 安装和运行 Jupyter Lab
pip是 Python 自己的软件包管理工具，它负责安装、删除和管理 Python 浩若烟海的第三方代码库，我们以后会经常用到。上面第一行是更新pip自己，因为我们刚装好 Python，通常需要更新一下pip自己；第二行则是让pip安装 Jupyter Lab 以及所有依赖支持包。如果在运行上面第二个命令时报错说找不到、不认识
pip命令，可尝试将pip换成pip3，即运行pip3 install jupyterlab。[x] 某些环境下运行 Jupyter Lab 需要 nodejs，所以建议也安装好。macOS 系统执行：
[x] 上述操作都成功后 Jupyter Lab 就准备就绪了，在你克隆好的学习用书目录里运行
jupyter lab ↩︎来启动 Jupyter Lab 的服务程序，并打开一个浏览器页面，里面列出了学习用书里的所有 notebook（.ipynb 后缀名的文件），双击就能打开了。[x] 注意，运行 jupyter lab 的命令行窗口必须保持着，你才能继续在浏览器里使用 Jupyter Lab；如果你用完了，需要退出，在这个命令行窗口按 Control+C 组合键，就会停止 Jupyter Lab 服务，回到命令行交互界面。一般来说不要在 jupyter lab 运行时关闭那个窗口。
如果在 jupyter lab 运行着的时候你需要命令行界面执行一些任务，只要在 ConEmu 里打开一个新的 tab 就可以了，不用动之前的那个。
4. 使用学习用书
然后你可以：
[x] 使用
git commit来把你修改的内容提交到本地仓库（local repo）；[x] 使用
git push来把你本地仓库中新的变化同步到 GitHub 上的远程仓库（remote repo）——这就是你的学习“工作证明（PoW）”。5. 学习 git
[x] 学习 Git 与 GitHub 入门教程 。
[x] 关于学习环境的准备，还可参考这个 视频指引。
5. 问题与反馈
[x] 如果在学习过程中遇到问题或者发现教材中的错误，可以通过 GitHub 的 Issues 系统提出，这个系统基本上就像一个问答论坛，但它集成了编程相关的能力，让它目的性更强、更容易跟踪问题解决的进度状态。访问我们课程教材的 Issues 页面：https://github.com/neolee/pilot/issues；
[x] 点击右上的
New按钮来提出问题或者反馈，如果是问题请选择 question 这个 label，如果是关于教材中的错误或者改进建议可以选择 bug 或者 enhancement 这样的 label。[x] 遇到问题的时候也可以到这个页面去搜索一下，看看是不是有人提过，得到了怎样的答案；如果没人提过，那就正好可以由你来提出，所有人也都会从中获益。
Logging
2020-02-04 16:24:56 initialize