Codex 快速索引(liukan6.github.io)

Codex 快速索引(liukan6.github.io)

目的:帮助下次修改时快速定位文件,减少读取时间。

仓库结构(高频)

  • _pages/:主要页面内容(站点页面核心入口)
  • _layouts/:页面布局模板
  • _includes/:可复用片段(页头/页脚/导航等)
  • _sass/:样式源文件(SCSS)
  • _data/:站点数据(YAML)
  • assets/:静态资源(CSS/JS/字体等,若有构建产物)
  • images/:站点图片
  • files/:PDF 等附件
  • _posts/:博文(如使用)
  • _publications/_talks/_teaching/_portfolio/:分类内容集合
  • _drafts/:草稿

关键页面(_pages)

  • _pages/about.html:主页内容(含 Publications、Course Projects、Experience 等)
  • 其他页面:publications.htmltalks.htmlteaching.htmltalkmap.htmlcv.md

关键样式(_sass)

  • _sass/_base.scss:基础样式与通用元素
  • _sass/_page.scss:页面相关样式
  • _sass/_navigation.scss:导航相关样式
  • _sass/_tables.scss:表格样式
  • _sass/_animations.scss:动画样式
  • _sass/_variables.scss:变量与主题色

模板与片段

  • _layouts/default.html:默认布局入口
  • _layouts/single.html:常见内容页布局
  • _includes/head.html_includes/masthead.html_includes/footer.html
  • _includes/author-profile.html_includes/page__hero.html

配置与依赖

  • _config.yml:站点配置
  • Gemfile:Ruby/Jekyll 依赖
  • package.json:前端依赖(若使用)

快速定位建议

  • 页面内容问题:优先看 _pages/ 对应页面
  • 布局结构问题:看 _layouts/ + _includes/
  • 样式问题:看 _sass/(必要时加页面内 <style> 覆盖)
  • 图片/文件缺失:看 images/files/ 路径引用是否正确

最近修改提示

  • _pages/about.html 已加入 .shield 样式,用于取消 shields 链接下划线/边框。