简单说了如何使用
Docsify
将自己的写的markdown
文件变成可浏览的网站,但那只是在本地,只能自己看到,这显然是无法满足我们的。
这次我们来说说如何将他们部署到可访问的网站上的,你可能此刻就在我部署的 github pages
上阅读本篇文章。
当然使用 gitee pages
也是可以的,两者的操作几乎一致。
直入主题:
- 在 github 上创建一个仓库
- 将 本地文件上传至 github 仓库
- 通过 github pages 部署
- 访问测试
🪐创建一个 github 仓库
🌅将本地文件 push 至 github 仓库
将我们本地的 docsify 初始化的项目及写好的文章等,push 至 github 仓库。
我的本地目录就是这样的,docs 就是我用docsify 创建的项目,稍后我们就是将这整个文件夹上传至 github 。
git init ## 初始化一个 git 本地仓库 git add file ## 添加需要 push 的文件或文件夹 git commit -m "first commit" ## 提交到暂存区 git branch -M main ## 将本地的分支名改为 main 因为现在 github 的主分支名是 main 而不是master git branch ## 此命令可查看本地名称 git remote add origin https://github.com/ningzaichun/nzc_blog.git ## 关联远程仓库 git push -u origin main ## push 至远程仓库
push
完 github
上的状态
🌝使用 github pages 部署
点击下面的 choose a them
可以选择自己的发布样式
之后还会跳转一下,直接点击就好了,忘记截了,最后反正记得 save
就好.
会弹出这样的一个提示消息,证明就完事啦.
回到code页面会出现一个这样的.
gh-pages 已经在五分钟前 push 了.当我框起来的那个地方,变成 active
就表示已经部署完成,可以进行访问了.
这点有一些延迟,稍等一会刷新一下即可.
我们的链接在哪里勒?
直接点击这个 github pages
进去是这样一个界面.
直接点击这个 view deployment
就可以访问啦.
🌁关于 Push 更新问题
就是你将你本地的更新推送上去了,但是你访问 github pages
仍然是你未更新前的那个页面。
可能产生的原因:
- 本身
github pages
官方文档有说,可能会存在延迟之类的问题。 - 可能是浏览器缓存问题,可以试着清除再访问。
- 可能是
github server
所在时区的问题,这点是在google
搜到的。
还可以尝试以下解决方法,直接在网页版上更改一下文件的空格,回车之类的,提交commit
,再次触发更新。
🏂自言自语
花费了一些时间,写了这几篇文章,虽然都是一些非编程类的东西,但是对于我自己仍然是新知识,是让我有收获的。
在使用 github pages 和 docsify
的过程中,其实还了解到很多其他的知识,如 CDN 加速、DNS 污染、计算机如何通信、解析等等关于计算机网络的一些知识。
耐心期待我们下一次的相见吧。