基于Github Pages+docsify，我花了一个小时建立了我的个人博客，写了这篇文章。
效果:
封面
内容页
体验:就个人博客而言，作者折腾了很多，用过WordPress、Typecho、Hexo等。，而且主机也用过免费GitPages或者付费VPS，最后都不了了之。原因要么是VPS到期懒得续费，要么是数据迁移存在各种阵痛。博客要么基于动态，比如WordPress需要一个数据库，要么基于静态，比如Hexo。一旦完成迁移，您将面临一大堆数据库数据。最后挖掘了我的两个核心需求:免费和易移植，所以Github Pages+docsify完全满足了我的需求。
免费：Github Pages本来就是免费的易移植：docsify是基于js将md文档转换成html，计算在客户端，不在服务器端，服务器只用存md，这个就很舒服了，以后你的博客数据不会是一堆数据库数据或者html代码，而是具有可读性的md文档，下面详细介绍一下
Docsify不同于Hexo、Jekyll、Hugo等一般的博客盒子。它支持Markdown格式，对程序员的博主非常友好。MD格式的博客将直接放上去，而不是生成html文件，框架本身将在运行时解析并呈现为html页面。
准备工作/即将开始工作
1.git环境，github帐户
在windows下安装git。在这个简单的git教程中可以看到Git的介绍和安装。
因为我们要用github页面来部署我们的应用，请先注册你的Github账号，官网:Github。
2.有一个节点环境
在Windows下安装节点环境
简单来说。
去官网下载nodejs：https://nodejs.org/en/，安装好npm设置代理或镜像，不然因为周所周知的原因会慢到你可能无法想象设置代理，按照实际情况来# http代理npm config set proxy=http://127.0.0.1:8087npm config set registry=http://registry.npmjs.org# https代理npm config set https-proxy http://server:port# 设置用户名或密码，没有就不管npm config set proxy http://username:password@server:portnpm confit set https-proxy http://username:password@server:port# 取消代理npm config delete proxynpm config delete https-proxy设置镜像（推荐），如果没有代理，可以设置个国内镜像# 设置淘宝镜像npm config set registry https://registry.npm.taobao.org# 验证成功没npm config get registry
3.简单说明一下步骤。
使用docsify命令生成文档站点在github上部署站点
Docsify官网
地址:https://docsify.js.org/#/ Docsify官网
使用docsify命令生成文档网站。
安装docsify-cli工具
建议安装docsify-cli工具，可以方便文档网站的创建和本地预览。
npm i docsify-cli -g
因为我们已经安装了节点环境，所以直接打开CMD窗口执行上面的命令就好了。
初始化项目
docsify init ./docsindex.html 入口文件README.md 会做为主页内容渲染.nojekyll 用于阻止 GitHub Pages 会忽略掉下划线开头的文件
启动项目并预览效果。
在这里，您可以启动项目并查看效果。使用以下命令启动项目:
docsify serve docs
流程输入:http://localhost:3000
1.配置左侧导航栏。
不建议对其进行配置。如果进行了配置，则无法显示当前文章的目录。
在docs目录下新建一个_sidebar.md的md文件，内容如下:
- 我的博客 ?- [第一章节](blog/博客搭建.md)
在index.html文件中配置它。将以下句子添加到嵌入的js脚本中:
loadSidebar: true
2.配置一个盖子。
该例程与上面配置的左侧导航栏相同。
首先新建一个_coverpage.md的md文件，里面的内容就是你封面的内容。
# Myblogs> 我的博客[CSDN](https://blog.csdn.net/xxx)[滚动鼠标](#introduction)
然后修改index.xml文件中的js脚本配置，添加一句话:
coverpage: true
3.配置主页
其实就是docs目录下README.md文件的内容。
我们一直忽略他，这是默认的:
换一个，贴上你牛逼的经历或者标签。
# 个人简介
部署到Github
登录github账户，建立仓库
创建一个本地仓库并将其推送到github
在这里右键单击git Bash，打开Git命令行来初始化一个存储库，并将所有博客文件提交到Git本地存储库。
涉及的命令如下:
git init // 初始化一个仓库git add -A // 添加所有文件到暂存区，也就是交给由git管理着git commit -m "myblogs first commit" // 提交到git仓库，-m后面是注释git remote add origin https://github.com/xxx/myblogs.gitgit push -u origin ***ster // 推送到远程myblogs仓库
按照上面的命令顺序。毫不奇怪，我们的本地博客已经同步到github。
使用Github页面
在myblogs warehouse下，选择Settings选项，找到GitHub Pages选项卡，并选择Source下的***ster branch/docs文件夹选项。可以结束了。
本文来自水洗晴空投稿，不代表舒华文档立场，如若转载，请注明出处：https://www.chinashuhua.cn/24/613713.html
微信扫一扫 
