个人主页编辑

part1：配置环境与下载模板

前情提要：我是一个不会github的小白，而且不仅仅是对github没有认知，我也没有网页编辑的经历，只是会码一些latex代码。偶然间看到马涛同学的个人主页，也就想自己也尝试一下，顺便在这个过程接触github的使用（之前使用仅限于downlowd一些模板）。这是第一次尝试做个人主页，很多东西也并不完善，chirpy模板的各个功能还在逐步探索过程中。在主页配置的过程中特别感谢马涛同学的帮助，也借助了许多Chatgpt提供的建议。这一份文档主要是记录整个配置个人主页的过程，以便于将来自己复盘和指导其他朋友部署了静态博客网站。(适用于Windows系统)

主页基于的Jekyll模板（专门用来创建个人博客或个人主页的静态网站生成站，将 Markdown 文件、HTML 文件和布局模板组合成一个静态网站）是Jekyll-Theme-Chirpy，另有一位国科大的学长在知乎上对这一模板做了简要的中文介绍，在他的个人主页上给出了自己的个性化方案，对我的主页建设非常有帮助。

正式安装：由于我之前并没有使用Github管理代码的习惯，所以我需要在Github上面注册一个账号，访问Git官网下载并安装Git（并不知道它的实际功能）。安装好Git之后可以在Windows的命令提示符（win+R打开cmd）输入git –version以检查是否安装成功。本地我的代码编辑器多用的是Visual Studio Code，还需要下载Github Desktop以方便本地与线上仓库的互通。在github中的chirpy模板中点击use this template并选择create a new repository，将这个模板命名为username.github.io，并设置为public的状态。（或者直接把chirpy模板fork到自己的仓库）仓库还需要设置Github Actions。

除此以外还有一些内容需要下载，如在Ruby官网下载合适的Ruby（作用未知），在命令提示符界面运行ridk install，在安装的选项中选择MSYS2 and MINGW development toolchain。之后就需要在相应的有效路径下安装依赖项，即打开 Git Bash将Chirpy模板克隆到本地：git clone https://github.com/cotes2020/jekyll-theme-chirpy.git ，进入克隆下来的 jekyll-theme-chirpy 目录：cd jekyll-theme-chirpy。运行gem install bundler，bundle install，这会根据 Gemfile 安装所有所需的 gem。最后检查Jekyll是否下完了也可以再执行jekyll -v。在下载过程遇到可能存在的问题记得还需要检查自己的代理，代理开关与否也影响了下载是否顺利。

在具体的操作过程中我是使用Github Desktop实现对模板的克隆和后续将本地修改完的代码版本提交到Github的线上仓库，操作比较简便清晰，有机会以后会对一块的领域进一步补充。

part2：模板中个性化内容

整体主页的语言是使用markdown。需要修改的部分主要集中在_config.yml，assets主文件夹里img放置所需要用的图片，PDF文件夹中上传需要插入的文件。tab文件夹里的md主要是个人信息的设置，而在_posts里面则收纳每一份文档内容。

编辑完成后的预览方法： 在vscode打开文件夹，终端里选择bash环境，输入bundle exec jekyll serve，等待响应后在网页端打开http://127.0.0.1:4000/

编辑完成后上传到Github仓库的方法： 利用Desktop commit to main，在Fetch origin区块里出现上行箭头时代表可以提交到仓库，还需要在repo的actions里面检查提交的代码修改是否正确，打勾则说明已经完成了编辑，在主页上可以表现出来。

大文件的传输方法：有待探索

这里还有一份Typest模板可以参考学习： https://ruriko.moe

需要更改的地方：
1评论区自己配置
2网页在浏览器中的小图标 https://chirpy.cotes.page/posts/customize-the-favicon/\