Stellar：自定义样式与脚本

颜色、字体、布局和侧栏可以通过主题配置调整。需要额外样式或第三方功能时，可用 inject 加载自己的 CSS 和脚本。

加载自定义 CSS

把自己的 CSS 放到 source/assets/custom.css，在主题配置中加载：

blog/_config.stellar.yml

inject:
  head_end: '<link rel="stylesheet" href="/assets/custom.css">'

inject 提供四个位置：

字段	输出位置	常见用途
`head_begin`	`<head>` 后、主题 meta 前	必须早于主题 Head 内容的声明
`head_end`	`</head>` 前	样式表、meta 与 Head 脚本
`body_begin`	`<body>` 后、页面外壳前	必须先于页面外壳的结构或脚本
`body_end`	`</body>` 前	统计与延后加载脚本

四个字段都只接受字符串，并会原样插入 HTML，不进行解析、格式化或转义，因此只应填写维护者完全信任的内容。页面 Front Matter 也可用同名字段追加本页资源；同一位置总是先输出站点配置，再输出页面内容，中间插入一个换行。Hexo 根 _config.yml 中的 inject 不会被主题读取。

字体、代码与图标

字体通过 @font-face 引入后，在 appearance.typography.font_family 选择。外部代码高亮样式使用 appearance.code_block.highlight_stylesheet，同时确保 Hexo 的代码高亮设置与实际输出匹配。

站点图标库在 source/_data/icons.yml 中定义，菜单和标签通过图标 ID 引用。图标与资源路径先验证存在，再在正文复用。

第三方脚本

统计等第三方脚本可通过 inject.body_end 接入，参数、数据和隐私设置需按服务方说明配置。只有确实要求早于页面内容运行的代码才使用 head_begin 或 body_begin。主题自己的脚本由主题加载，旧版资源字段不再用于替换这些脚本。

若站点构建包含 Babel 或压缩，public/js/runtime/**/*.js 必须保留原生 ESM 及相对导入；普通脚本仍按站点流程处理。

资源未生效时，检查生成 HTML 中的链接与浏览器控制台；同一脚本应避免重复加载。若直接修改主题源码，建议在自己的 Git 分支中保存定制，并执行相关主题检查。