NEXT

这是 Fewu 3 的默认主题。受 Fuwari 主题 启发。

English

安装

通过 fewu-cli

推荐此方式

安装 fewu-cli:

pnpm add fewu-cli

初始化工作区：

pnpm fewu init

下载主题和依赖：

pnpm i

通过 NPM

pnpm add @fewu-swg/fewu-theme-next

通过 Git

git clone https://github.com/fewu-swg/fewu-theme-next themes/next

处理依赖：

pnpm add @fewu-swg/fewu-deployer-sass @fewu-swg/fewu-renderer-pug @fortawesome/free-brands-svg-icons @material-symbols/svg-600

或将此 package.json 复制到工作区下，然后执行 pnpm i：

{
  "dependencies": {
    "@fewu-swg/fewu-deployer-sass": "^1.0.5",
    "@fewu-swg/fewu-renderer-pug": "^1.2.0",
    "@fortawesome/free-brands-svg-icons": "^6.7.2",
    "@material-symbols/svg-600": "^0.31.9"
  }
}

功能

• 支持多语言（目前有zh-CN,fr,en(默认)的语言文件）
• 支持亮暗主题（自动切换）
• 支持页内导航（类Pjax）
• 响应式布局
• 评论系统（支持giscus）
• 文章目录
• Open Graph 协议

依赖项

• (npm) @fewu-swg/fewu-deployer-sass
• (npm) @fewu-swg/fewu-renderer-pug
• (npm) @fortawesome/free-brands-svg-icons
• (npm) @material-symbols/svg-600

文章特性

以下所有属性都应写在 front-matter 中，并仅对当前文章生效。

hidden: Boolean: 文章是否隐藏（无法阻止文章显示在分类/标签下）。

disable_comment: Boolean: 是否禁用评论插件（Giscus）。

disable_adjacent: Boolean: 是否关闭临近文章导航（NextPage）。

配置

自定义导航栏

添加 theme_next.additional_navs (Record<string,string>) 到你的配置文件中, 键(导航名)必须是字符串, 值为URL或对象。若为URL，值将被直接填入href，若为对象则参下。

默认情况下, 若语言文件中包含键, 则键会被翻译. 以 ^ 开头的键将不会被翻译, ^ 将在生成时被移除.

theme_next:
  additional_navs:
    ^About: /posts/about.md # 不会翻译
    About: /posts/about.md # 会翻译
    GitHub:
      isExternal: true # 控制是否使用页内导航
      title: GitHub # 标题，不会翻译
      url: https://github.com/ # URL

强调色

添加 theme_next.accent_color (Number) 以定义默认强调色。

theme_next:
  accent_color: 250 # 默认蓝色

头图

添加 theme_next.banner ({url: string; credit: string; credit_url: string}) 来自定义头图

如果 theme_next.banner.url 不存在，那么将不会展示头图。

如果 theme_next.banner.credit 存在，将会展示版权标识，如果 theme_next.banner.credit_url 也存在，那么标识将会指向此 URL。

theme_next:
  banner:
    url: /banner.webp # URL
    credit:
    credit_url: