在Github写博客（blog），fastpages搭建入门，10分钟建站

时间：2023-08-06 14:54:01 | 来源：网站运营

时间：2023-08-06 14:54:01 来源：网站运营

在Github写博客（blog），fastpages搭建入门，10分钟建站：

写在前面

很多人都知道Github Pages可以用来搭建网站，也可以搭建个人博客，而且不用写繁琐的HTML、CSS等代码，只要用Markdown格式就行。当然，国内的CSDN，cnblogs这些也都可以。

但是毕竟md还是需要一定的代码语言基础，如果没有基础，那么可以来试试fastpages。它支持直接上传word文档、Jupyter文件，当然也依旧支持Markdown格式文本。

如果你经常写python，你应该会很熟悉Jupyter Notebook。它是一个可以在网页（服务器）实时运行python并显示结果的平台。

如果你没有用过Jupyter，那我强烈建议你试用一下，我保证，你会爱上它的。

案例展示

话不多说，先看看效果吧。它完美适配不同机型屏幕尺寸，避免了HTML的各种烦恼。

这个网站基于 fastai/fastpages（Jeremy Howard & Hamel Husain） 项目的中文汉化版 建立。

如果你喜欢这个网站，并且想要搭建一个属于自己的博客，请继续读下去吧。

不要忘了给我点个赞喏！

操作指导

零基础也不要怕，按着步骤来一定没问题，10分钟就能搭建一个属于自己的网站。如果还有问题也没关系，给我留言吧。建议全程使用电脑操作。

第一步，注册并登陆。（1分钟）访问github.com，如果已经有账号，点击sign in登录，没有则点sign up注册。不要对英文感到惧怕，简单的操作用百度翻译就可以解决。

第二步，复制博客模板。（1分钟）访问 https://github.com/EasonQYS/fastpagesJupyter 可以看到已经汉化好的模板，可以点击Star图标鼓励一下作者。

继续往下滑。看到README文档，就是这个项目的基本介绍啦。

再往下滑，看到“初始化指导”部分，点击蓝色字，即可生成自己的博客网站。

点击后进入下一个页面，在第一个红框内输入blog，代表这个仓库（repository，repo）是你的博客。你的博客网页地址将是 {你的github用户名}.http://github.io/blog。你可能会有疑惑，那 {你的github用户名}.http://github.io 这个网址能不能访问呢？目前还不行，我们之后会谈到。如果想了解，可以跳到最后一节 外层静态网页。

如果你对github比较熟悉，你也可以输入其他名字。点击第二个红框生成，这需要大约20秒。成功后，你的邮箱会收到一封邮件。

第三步，配置博客密钥对。（3分钟）打开邮件，可以看到三个有蓝色的链接。下面将依次介绍。

点击第一个链接，选择RSA和4096，点击生成（Generate-SSH-Keys），就会可到两串字符。。保持页面，记该页面为（*）。

点击第二个链接，点击添加new secret。复制（*）中的Private Key至Value栏，包含"---BEGIN RSA PRIVATE KEY---" 和 "--END RSA PRIVATE KEY---"。在Name栏填写SSH_DEPLOY_KEY（只能是这个名字）。点Add secret保存。

点击第三个链接，点击添加deploy key。复制（*）中的Public Key至key栏，name栏随意填写，例如填写key。请注意勾选Allow write access。点击Add key保存设置。（这里可能需要输入一次github密码）

完成后如图所示，点击Options，下滑找到GitHub Pages，source选择gh-pages branch（如果没有可以先选择master branch，稍后自动生成gh-pages branch后可以再修改）。等待一段时间，GitHub Pages栏生成一个网址，点击即可访问该网站。

第四步，配置相关文件。（3分钟）点击Code，找到_config.yml，点击它。

再点击下图红框，进入修改模式。需要修改的部分已在图中标注。

如果自己购买了域名，除了在这里配置外，还需要修改CNAME文件，写入域名。可以参考vvboard项目的设置。

第五步，访问博客网站。（2分钟）确认GitHub Pages设置的source选择gh-pages branch。访问{你的github用户名}.http://github.io/blog。看看是不是正常显示了，如果还没有，可能网页还在生成中。耐心等待一下。你可以在Actions查看处理进度。

更新博客

网站搭好了，怎么发博客呢？

只要把文件上传到指定文件夹下就行了。

先说一下文件命名格式：YYYY-MM-DD-文件名（支持中文）.后缀

要注意：很容易将YYYY-MM-DD-的最后一个破折号落下。 并且，破折号后面的一个字符只能是文字而不能是符号。

如果是word文档，那么一定要注意后缀是.docx。将其是上传至_word目录下。如果找不到这个目录，就要看看Branch是不是选择的master。

同理，Jupyter文件上传至_notebooks目录下。这里对文件第一个单元格内容有要求。第一个单元格必须是markdown格式的单元格。内容如下（可以缺省其中几行）：

# "标题"> "概要"- toc: true- badges: true- comments: true- categories: [fastpages, jupyter]- image: images/some_folder/your_image.png- author: A & B其中的categories是博客的标签，有的网站也称之为tags，不同tags以英文逗号分隔。

有的朋友会在文档中插入图片。这里值得说明的一点是，由于博客用于网页留言，直接插入本地图片是无效的，需要类似md文件那样引用图片，语句如下：

![](https://www.fast.ai/images/fastai_paper/show_batch.png "Credit: https://www.fast.ai/2020/02/13/fastai-A-Layered-API-for-Deep-Learning/")引号内的内容将会以图注的形式出现在图片下方，可以省略。

如果是Markdown文件。类似Jupyter也要有表头。格式如下：

--- title: "标题" summary: "概要" toc: true comments: true image: images/some_folder/your_image.png categories: [fastpages, jupyter] ---

外层静态网页

在github页面右上角点击加号，选择New repository。输入{你的github用户名}.http://github.io，点击Create repository。

默认的主页就是README.md文件，你可以编辑它修改你的主页。如果你精通HTML+CSS，你也可以写一个index.html上传到该目录下。

点击Settings，往下滑，看到Github Pages绿色栏的√，表示网页已成功建立，你可以访问试试。

如果想建立子网站，只要在当前目录下建立新目录，并在里面添加新的Markdown文件（如about/README.md）或HTML文件即可。也可以在根目录下添加about.html。

可以参考这里：

当然，这样的管理可能会造成混乱。我们可以利用不同的仓库（repo）之间相互独立的特性，

在该仓库仅保留简要的页面以及相关链接，在相应的仓库建立子网站，这样管理可以更加有效。

如果你觉得喜欢的话，可以给我点个赞喏！