小傅哥 bugstack 虫洞栈

# 教小白使用 docsify，搭建一个贼简单的所见即所得博客！

作者：小傅哥
博客：https://bugstack.cn (opens new window)

沉淀、分享、成长，让自己和他人都能有所收获！😄

# 一、前言

看我博客挺好，你也想整一个？

有粉丝伙伴问小傅哥，你那博客：https://bugstack.cn (opens new window) 挺好的我也想整一个，面试写到简历上还能加分，也是给自己建设影响力的东西。

不过我没有自己的域名，也没有一些云服务器，还不太会前端的玩意。之后搞的太复杂我又没有时间维护，那有没有简单点的方式，就能搞一个这样博客呢？

那当然有哇，你傅哥玩过的博客类型那可多了去了，包括：hexo、vuepress、jekyll、docsify等，这些都能满足你搭建博客的需求。但能满足小白使用的，我强烈推荐 docsify 这货简直是傻白甜都能使用，直接在 GitHub/Gitee 维护一个文档仓库，就可以拥有一个漂亮、简单、好用，易于维护和所见即所得的博客。

为什么不用 CSDN、掘金、简书？

当然可以用(扩大影响力)，只不过这些都不是原稿存放平台，你的内容输出需要被随心所欲的维护和积累，以及将来需要的时候还可以放置到任何一个其他平台。而你写在 GitHub 仓库，就是最原始的那一份，其他的都是备份传播，这样更有益于你来沉淀、积累和分享。

接下来小傅哥就教你构建这样一个博客，因为我已经帮你准备好了博客模板，所以在这个过程中，你只要跟着步骤，点点点，就部署完事了。那整吧，咱们走起！

# 二、docsify 介绍

docsify 可以快速帮你生成文档网站。不同于 GitBook、Hexo 的地方是它不会生成静态的 .html 文件，所有转换工作都是在运行时。如果你想要开始使用它，只需要创建一个 index.html 就可以开始编写文档并直接部署在 GitHub Pages。官网：https://docsify.js.org/#/zh-cn (opens new window)

# 1. 目录结构

  • docsify 的目录结构配置非常简单，如果你不需要修改的话，只是 md 目录编写文档，在 _sidebar.md 配置文章路径即可。
  • index.html 用于配置一些网站的基础信息，包括：网站采集、留言板、地址等。
  • _coverpage.md 用于配置博客首页的介绍信息和网站Logo等

# 2. md 说明

# 三、快速搭建博客

这里给大家提供 GitHub/Gitee 两种仓库来搭建博客，方便有些小白访问 GitHub 费劲也能用 Gitee 搭建博客。

# 1. GitHub Page

  • 优点：规范、部署不限制、自由度高、配置域名不收费
  • 缺点：国内访问速度慢、仓库不能设置私有

# 1.1 第一步：Fork

打开 https://github.com/fuzhengwei/fuzhengwei.github.io (opens new window) 点击 fork 到自己的仓库。

# 1.2 第二步：配置

  • 点击 Setting 进入 General 配置工程名称页面。
  • 注意：你必须把 fuzhengwei.github.io 修改为你的名称 xxx.github.io 这里的 xxx 就是你的GitHub的名称，也是 https://github.com/{xxxx} 链接后面的名称，不要修改错了，否则你就失败了。

# 1.3 第三步：开启

  • 点击 Setting 进入 Page 页面
  • 按照上图修改博客资源空间到 docs 文件夹下，这个步骤是选择博客空间地址，记得不要配置错了。

# 1.4 第四步：访问

好了，当你在配置后看到已经提醒你 Your site is published at https://fuzhengwei.github.io/ 证明你成功了，你可以访问自己的博客地址了。PS：这里要 xuewei 的等一下，因为初始化有一个过程，正在编译稍后就可以访问了。

# 2. Gitee Page

  • 优点：访问速度快、博客仓库可以设置私有
  • 缺点：不能配置自己的域名，需要上传身份信息后才可以使用

# 2.1 第一步：导入

与使用 GitHub 不同，这里是在 Gitee 中导入博客仓库，如下：

# 2.2 第二步：配置

  • 从 服务 的 Gitee Pages 进入即可进入配置博客页面。
  • 不过由于大家基本都是初次使用 Gitee Pages 它会要求你上传认证信息，一天内审核完成。

# 2.3 第三步：认证

  • 如果你到了这个页面，可以提交资料后，第二天再继续了。

# 2.4 第四步：开启

  • 如果以上步骤都完事了，接下来你就可以开启自己的博客了，同样会给你一个博客地址，每次上传新的文章点击更新即可。

# 四、总结

程序员，为什么要写博客？

我，软件工程毕业？ 上学时觉得，毕了业就是开发工程师，但没想到工作些年还成了 PPT 工程师。

为啥呢？因为写代码只是作为一个程序员的最基本能力，如果还想继续在这条路上往前走，就需要有；提炼逻辑能力，制定标准手段、落地执行方案，而这一步步的推进都需要，就是将你的思考转换为可以看得见的内容，无论它是PPT、拓扑图、流程图还是思维导图，总之你需要一个合适的工具来表述你的想法，与沟通者最低成本完成消息传递和确认执行。

那么对于程序员来说，这个代码之外的能力成长，更好的方式则是编写博客、记录分享、积累沉淀，通过这样一个过程来不断的完善自己在内容表述上的能力，以及拓宽和拉伸自己的技术栈体系。

好嘞，现在你也拥有了一个可以像维护代码仓库一样的文档博客，并且随着你的学习过程，不断的完善、补充、沉淀，慢慢你终将会成为一名优秀的码农大佬。加油！

如果你已经搭建好了，可以在评论区留下你的博客地址哦！

← 免费1年服务器，部署个ChatGPT专属网页版！ →