itachicheng.github.io

---

T1 初始化

1. 安装Node.js后，通过npm install hexo-cli -g嵌入hexo。

2. git clone本项目srcbuild分支，同时下载相关node_modules依赖，并通过npm下载相应hexo插件。

   • git clone本项目srcbuild分支

   git clone --recurse-submodules https://github.com/itachiCheng/itachicheng.github.io.git -b srcbuild 

   • 下载相关node_modules依赖

   hexo init blog

   • 拷贝blog/node_modules至itachicheng.github.io目录

   cp -r blog/node_modules/ itachicheng.github.io/

   • npm下载相应hexo插件

   cd ./itachicheng.github.io
   npm install
   npm install --save hexo-renderer-jade hexo-generator-feed hexo-generator-sitemap hexo-browsersync hexo-generator-archive hexo-renderer-pug hexo-renderer-stylus

   • 更新butterfly主题

   cd themes/butterfly/
   git fetch origin dev
   git rebase origin/dev
   cd ../../

   Note: 当前主题fork于jerryc127/hexo-theme-butterfly.git，如果需要个性化，那么请修改.gitsubmodules,自行维护个性化主题修改 。

3. hexo server可以本地拉起localhost:4000的博客服务。

T2 个性化配置

1. 修改_config.butterfly.yml文件，包含各种封面、图片、组件配置。

2. 通过hexo new "My New Post"可以生成Markdown文件以及资料文件夹，资料编辑完成后，可以通过以下方式提交。

   如果希望文章图片同时兼容 Markdown 本地预览和 GitHub Pages 部署，可以将图片放在同名资源目录中，并在 Markdown 中使用 ./文章名/图片名 引用，例如：

   ![DFlash inference overview](./DFlash/dflash-inference.svg)

   本地 Markdown 预览会按源码目录读取 source/_posts/DFlash/ 下的图片；部署时，scripts/post-asset-path.js 会在 Hexo 渲染阶段将该路径改写为文章页面下的 ./图片名，从而匹配 Hexo 生成的 /DFlash/图片名。

   本仓库也提供了一个 Codex skill，用于后续生成论文精读文章和 SVG 图示。其他用户可以在 clone 仓库后安装：

   mkdir -p ~/.codex/skills
   cp -R skills/blog-svg-figures ~/.codex/skills/

   git add -A
   git commit -m "Your Commit" 
   git push origin srcbuild

3. 图片素材可以添加至themes/butterfly/source/img/路径下，素材文件可单独推送至hexo-theme-butterfly仓。

   cd themes/butterfly
   git add -A
   git commit -m "Your Commit"
   git push origin dev

T3 生成部署

1. 重新定位至itachi.github.io文件夹

2. 生成网页并推送部署

   hexo clean
   hexo generate && hexo deploy

T4 分布式协作

1. 拉取最新分支

   # 配置代理（可选）
   git config --global http.proxy http://127.0.0.1:xxxx
   git config --global https.proxy http://127.0.0.1:xxxx
   
   (如本地有未提交更新)
   git stash save as YOUR_NAME
   
   git fetch or git -c http.proxy="127.0.0.1:xxxx" fetch origin
   git rebase origin/srcbuild
   
   (如本地有暂存更新，可能面临解决冲突)
   git stash pop
   

2. commit提交（同T2.2）