ToB企服应用市场:ToB评测及商务社交产业平台
标题:
MkDocs+Github搭建个人博客
[打印本页]
作者:
曂沅仴駦
时间:
2024-5-22 05:02
标题:
MkDocs+Github搭建个人博客
写在前面
在实验过Hugo、Jekyll等博客框架后,我最终选择了MkDocs+Github的方案,主要出于以下几点考虑:
博客内容可基于Markdown写作,不需要掌握html等别的语法。
发布简单,只需几个命令就可以摆设好本地框架,更新也很方便。
页面简洁,大概对追求美观的用户而言还有提升空间,但对我完全充足了。
本博客所需底子:
markdown语法
命令行操作
python情况
github利用
什么是MkDocs
MkDocs是一个静态网站生成器,它专门为构建项目文档而设计。它的焦点优势在于速度、简单性和美观度。想象一下,你有一个项目,需要为它创建文档,而MkDocs能帮你轻松搞定这统统。
官网所在:
https://www.mkdocs.org/
新手教程:
https://www.mkdocs.org/getting-started/
用户手册:
https://www.mkdocs.org/user-guide/
搭建本地页面
安装
首先,请确保你的电脑已安装python情况,之后就可以基于pip安装mkdocs:
pip install mkdocs
复制代码
接下来运行mkdocs --version确认安装是否成功。
创建站点
运行以下命令:(dir_name可以自由命名)
mkdocs new dir_name
复制代码
这行命令将会在当前目次下创建一个新文件夹dir_name,文件夹中包罗:
子目次docs: 博客的焦点内容(.md文件)就包含在此目次下
设置文件mkdocs.yml:暂时不用动它
然后进入dir_name文件夹,运行mkdocs serve,命令行中会表现Serving on http://...,即可在本地访问该站点。
设置文件修改
可以通过编辑mkdocs.yml来修改页面格式,示比方下:
site_name: Elsy's Blog
theme:
name: readthedocs
nav:
- 主页: index.md
- 关于: aboutme.md
复制代码
利用Github发布在线网页
在dir_name下运行mkdocs build,这会生成一个新文件夹site,其中包含了静态站点的页面内容。
在Github上新建一个仓库。
将本地dir_name文件夹与Github新建仓库连接。
在dir_name下运行mkdocs gh-deploy,成功运行后命令行会表现"Your documentation should shortly be available at : ..."
网络不好时大概需要多运行反复,而且很大概有点延迟2333
更新网页:在本地docs文件夹下编辑完md文档后,命令行中执行mkdocs gh-deploy即可
版权声明:本文接纳
知识共享 4.0 许可证
(署名-非贸易性利用-克制演绎)
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!更多信息从访问主页:qidao123.com:ToB企服之家,中国第一个企服评测及商务社交产业平台。
欢迎光临 ToB企服应用市场:ToB评测及商务社交产业平台 (https://dis.qidao123.com/)
Powered by Discuz! X3.4