一些命令和Butterfly配置追番插件

1. 安装插件

首先，需要在 Hexo 项目中安装 hexo-bilibili-bangumi 插件。运行以下命令：

1
npm install hexo-bilibili-bangumi --save

2. 修改配置

配置文件

接着，在 Hexo 项目的主配置文件 _config.yml 中，添加 bangumi 配置项。请注意，这个配置项应该写在站点的配置文件中，而 不是 主题的配置文件。

打开 _config.yml，找到合适的位置（通常是在文件末尾），并添加以下配置：

1
2
3
4
5
6
7
8
9
10
11
bangumi:
  enable: true             # 是否启用番剧功能
  path:                    # 番剧页面路径，默认是 bangumis/index.html
  vmid:                    # 哔哩哔哩番剧页面的 vmid（uid）
  title:                   # 页面标题
  quote:                   # 页面顶部的一段话，支持 HTML 语法
  show: 1                  # 初始显示页面状态：0 - 想看, 1 - 在看, 2 - 看过，默认是 1
  loading:                 # 图片加载完成前的 loading 图片
  metaColor:               # meta 部分字体颜色（简介上方）
  color:                   # 简介字体颜色
  webp: true               # 番剧封面是否使用 WebP 格式，默认为 true，WebP 格式图片大小比普通格式小

解释

  • enable: 是否启用番剧功能，设置为 true 启用，false 禁用。
  • path: 番剧页面的路径。默认为 bangumis/index.html，但可以根据需要修改。
  • vmid: 获取哔哩哔哩番剧页面的 vmid，即用户的 UID。
  • title: 设置该番剧页面的标题。
  • quote: 设置页面顶部的一段描述，可以使用 HTML 语法。
  • show: 初始显示状态，分别为 0（想看）、1（在看）、2（看过）。
  • loading: 可以设置加载前显示的占位图（例如：GIF 动画或图片）。
  • metaColor: 设置番剧简介的 meta 部分字体颜色。
  • color: 设置番剧简介部分的字体颜色。
  • webp: 是否使用 WebP 格式的封面图，默认 true，如果浏览器支持 WebP，则使用该格式。如果需要确保兼容性，可以设置为 false。

获取 vmid

进入应用【设置】页面，点击【账号资料】。 4/5 进入应用【账号资料】页面，点击【UID】。

3. 配置路径

在 Hexo 的 source 目录下，创建一个文件夹来存放番剧页面，举例来说，可以命名为 bilibili。然后修改配置中的 path，使其指向该路径。例如：

image-20241122194508600 
1
path: bilibili/index.html

4. 引用页面

为了在网站的导航栏或者其他地方引用番剧页面，可以使用以下方法：

1
追番: /bilibili/ || fas fa-tv

这段代码会在页面中生成一个链接，指向你设置的番剧页面（例如 /bilibili/）。

5. 使用插件更新番剧数据

在 Hexo 生成静态文件之前，执行以下命令来更新番剧数据：

1
hexo bangumi -u

这个命令会自动从哔哩哔哩拉取最新的番剧信息并更新。

如果你需要删除已经存储的数据，可以使用以下命令：

1
hexo bangumi -d

6. 生成和部署

更新完番剧数据后，继续运行以下命令生成并部署你的博客：

1
2
hexo generate    # 生成静态文件
hexo deploy      # 部署到你的服务器或平台

7. 完整示例

假设你的配置如下：

1
2
3
4
5
6
7
8
9
10
11
bangumi:
  enable: true
  path: bilibili/index.html
  vmid: 12345678
  title: 我的追番
  quote: "<p>这里是我喜欢的番剧，一起来看看吧！</p>"
  show: 1
  loading: /images/loading.gif
  metaColor: "#ff6347"
  color: "#ffffff"
  webp: true

在 source/bilibili/index.html 中，你将展示从哔哩哔哩拉取的番剧列表。你可以在网站的导航栏中添加如 追番: || /bilibili/ || 来引用它。

8. 注意事项

  • 公开追番列表：确保你的哔哩哔哩追番列表是公开的，否则插件无法正常获取到你的番剧数据。
  • WebP 格式：WebP 图片格式通常比 JPEG 或 PNG 小得多，但需要浏览器支持。在 Safari 上，WebP 格式的图片无法显示，因此需要谨慎使用。

Hexo 常用命令

1. bangumi

  • 功能: 生成番剧相关的页面（即哔哩哔哩番剧信息）供 Hexo 使用。
  • 使用场景: 如果你安装了 hexo-bilibili-bangumi 插件并配置了相关信息，这个命令会生成番剧页面，展示你正在追的番剧列表。

示例:

1
2
hexo bangumi -u    # 更新番剧数据
hexo bangumi -d    # 删除番剧数据

2. cinema

  • 功能: 生成关于哔哩哔哩影院的信息页面。
  • 使用场景: 如果你需要在 Hexo 中展示哔哩哔哩的电影相关内容，可以使用这个命令来生成相应的页面。

3. clean

  • 功能: 清除生成的文件和缓存。
  • 使用场景: 如果你想要清理项目中的生成文件或缓存，可以使用此命令。这对于调试或重新生成内容时特别有用。

示例:

1
hexo clean

4. config

  • 功能: 获取或设置 Hexo 配置。
  • 使用场景: 可以通过此命令查看或修改 Hexo 项目的配置文件（通常是 _config.yml）。它可以帮助你快速查看配置项或更改它们。

示例:

1
2
hexo config     # 查看当前配置
hexo config key value   # 设置某个配置项的值

5. deploy

  • 功能: 部署你的 Hexo 网站到服务器。
  • 使用场景: 当你生成了静态页面后，可以使用此命令将网站内容发布到远程服务器（如 GitHub Pages、Netlify 等）。

示例:

1
hexo deploy

6. game

  • 功能: 生成与游戏相关的页面。
  • 使用场景: 如果你在 Hexo 中集成了关于游戏的页面或数据，使用此命令来生成这些页面。

7. generate

  • 功能: 生成静态文件。
  • 使用场景: 当你修改了博客内容或配置后，需要使用此命令生成网站的静态页面。它会根据你的内容和布局生成 HTML 文件。

示例:

1
hexo generate   # 生成所有静态文件

8. help

  • 功能: 获取命令帮助信息。
  • 使用场景: 当你需要查看 Hexo 的命令用法或某个命令的详细信息时，可以使用 help 命令。

示例:

1
hexo help

9. init

  • 功能: 创建一个新的 Hexo 文件夹。
  • 使用场景: 如果你从头开始创建一个新的 Hexo 博客，可以使用此命令来初始化一个新的 Hexo 项目。

示例:

1
hexo init new-blog  # 初始化一个名为 new-blog 的 Hexo 博客

10. list

  • 功能: 列出站点的相关信息。
  • 使用场景: 你可以通过这个命令查看 Hexo 项目的基本信息，如博客的所有者、站点路径等。

示例:

1
hexo list

11. migrate

  • 功能: 将现有网站的数据迁移到 Hexo。
  • 使用场景: 如果你从其他博客平台（如 WordPress）迁移到 Hexo，可以使用此命令进行数据导入。

示例:

1
hexo migrate wordpress  # 从 WordPress 迁移

12. new

  • 功能: 创建一个新的博客文章。
  • 使用场景: 当你想要写一篇新的博客文章时，可以使用这个命令自动创建一篇草稿文章，并将其放置在 _drafts 文件夹中。

示例:

1
hexo new post "My First Post"  # 创建一篇名为 "My First Post" 的新文章

13. publish

  • 功能: 将草稿文章从 _drafts 文件夹移动到 _posts 文件夹。
  • 使用场景: 如果你已经在草稿中创建了一篇文章并准备发布，可以使用此命令将其移动到正式的 _posts 文件夹。

示例:

1
hexo publish "My First Post"  # 发布名为 "My First Post" 的文章

14. render

  • 功能: 使用渲染器插件渲染文件。
  • 使用场景: 当你想要单独渲染某些文件（例如 Markdown 或其他格式的文件）时，可以使用这个命令。

示例:

1
hexo render source/_posts/my-post.md  # 渲染指定的文件

15. server

  • 功能: 启动本地开发服务器。
  • 使用场景: 如果你想在本地预览你的 Hexo 博客，可以使用此命令启动本地服务器。

示例:

1
hexo server   # 启动服务器，通常访问 http://localhost:4000

16. version

  • 功能: 显示 Hexo 的版本信息。
  • 使用场景: 当你想查看当前安装的 Hexo 版本时，使用此命令。

示例:

1
hexo version

全局选项解释

  1. --config

    • 功能: 指定配置文件。
    • 使用场景: 如果你想使用自定义的配置文件（例如，_config_custom.yml），而不是默认的 _config.yml。

    示例:

    1
    hexo generate --config _config_custom.yml

  2. --cwd

    • 功能: 指定当前工作目录。
    • 使用场景: 如果你的 Hexo 项目不在默认的当前目录，可以使用此选项来指定项目路径。

    示例:

    1
    hexo generate --cwd /path/to/hexo/project

  3. --debug

    • 功能: 显示详细的调试信息。
    • 使用场景: 当你遇到问题需要更详细的日志信息时，可以启用调试模式。

    示例:

    1
    hexo generate --debug

  4. --draft

    • 功能: 显示草稿文章。
    • 使用场景: 在生成或部署之前，如果你想查看所有草稿文章，可以使用此选项。

    示例:

    1
    hexo server --draft

  5. --safe

    • 功能: 禁用所有插件和脚本。
    • 使用场景: 在调试时禁用插件和脚本，确保 Hexo 仅使用基本的功能。

    示例:

    1
    hexo generate --safe

  6. --silent

    • 功能: 隐藏控制台输出。
    • 使用场景: 如果你不希望在执行命令时显示任何输出，可以使用此选项。

    示例:

    1
    hexo generate --silent

通过这些命令和选项，你可以有效地管理 Hexo 项目，生成页面，发布内容，调试和配置博客。