如何制作一个像这样的个人主页

我是采用mkdocs+github repo的方式进行配置的

前置需要的东西包括python环境，安装mkdocs，github创建仓库等这里就不多赘述了

注意：如果想要直接从 http://xxx.github.io 就能访问个人主页，需要在github创建一个名为xxx.github.io的仓库，一个字母都不能改！！

记住几个命令：

mkdocs serve

在创建的本地文件夹目录下使用，即可在127.0.0.1:8000访问到网站

部署到服务器：

mkdocs build

在创建的本地文件夹目录下使用，这个命令会在本地目录下生成一个目录site，这个目录中包含了静态站点的页面内容

mkdocs gh-deploy

远程连接github的仓库与本地的文件夹

mkdocs gh-deploy --config-file ../{learn-mkdocs}/mkdocs.yml --remote-branch master

创建xxx.github.io的步骤，手动连接文件夹与仓库

我这里这个命令就是：

mkdocs gh-deploy --config-file ../mkdocs-site/mkdocs.yml --remote-branch master

上述两个gh-deploy命令：注意需要在xxx.github.io文件夹的目录下git

每次修改网站的时候，直接在mkdocs-site文件夹（可以自己命名）修改完毕并保存后，先使用mkdocs serve命令（修改本地）（这个命令可能较慢，需要稍稍等待一下，不过在本地网站预览，同步完成后就关闭，暂未发现明显异常），再使用mkdocs gh-deploy --config-file ../{learn-mkdocs}/mkdocs.yml --remote-branch master（同步到github） 注意两个命令git的文件夹不同，第一个是在自己创立的mkdocs-site文件夹下，第二个是在xxx.github.io下

我参考了这个文档

你也可以点击 官方教程 进行学习

ps：问问ChatGPT，我创建的时候有很多奇怪的报错，网上搜索没有找到类似案例，而GPT在我的引导下很快地帮我解决了