Skip to content

Latest commit

 

History

History
134 lines (75 loc) · 7.48 KB

2022-03-04-教小白使用 docsify,搭建一个贼简单的所见即所得博客!.md

File metadata and controls

134 lines (75 loc) · 7.48 KB
title lock
教小白使用 docsify,搭建一个贼简单的所见即所得博客!
need

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

作者:小傅哥
博客:https://bugstack.cn

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

一、前言

看我博客挺好,你也想整一个?

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

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


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

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

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

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

二、docsify 介绍

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

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 点击 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、拓扑图、流程图还是思维导图,总之你需要一个合适的工具来表述你的想法,与沟通者最低成本完成消息传递和确认执行。

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

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

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