升级指南

本文同时提供以下语言的翻译: English.

从3.x升级至4.x

  1. 将Node.js升级到10.13.0或者更新的版本。

  2. 下载源代码或者从NPM安装Icarus 4.x。 你可以在Icarus快速上手中找到安装指导。 如果你打算通过修改源代码的方式自定义主题,你必须从源代码安装主题。

  3. 运行hexo clean来清理缓存。 按照Icarus的提示安装缺失的依赖软件包:

    命令行
    1
    2
    3
    4
    5
    6
    $ hexo clean
    ...
    ERROR Please install the missing dependencies your Hexo site root directory:
    ERROR npm install --save hexo@^5.0.2 hexo-component-inferno@^0.8.2 hexo-log@^2.0.0 hexo-util@^2.2.0
    ERROR or:
    ERROR yarn add hexo@^5.0.2 hexo-component-inferno@^0.8.2 hexo-log@^2.0.0 hexo-util@^2.2.0
  4. 再次运行hexo clean来让Icarus为你升级主题配置文件。 Icarus会备份并删除themes/icarus/_config.yml文件,然后创建_config.icarus.yml作为新的主题配置文件。 你可以参考_config.icarus.yml.example来了解示例配置.

    命令行
    1
    2
    3
    4
    5
    6
    7
    8
    9
    $ hexo clean
    ...
    WARN Your theme configuration is outdated (3.0.0 < 4.0.0).
    INFO To skip the configuration upgrade, use "--icarus-dont-upgrade-config".
    INFO Backing up theme configuration files...
    INFO themes/icarus/_config.yml => themes/icarus/_config.yml.dc00f8b8f8bc03ede351d711e958dc4b
    INFO Upgrading theme configurations...
    INFO Theme configurations are written to /tmp/_config.icarus.yml.
    INFO Example configurations is at /tmp/_config.icarus.yml.example.
  5. Icarus现在将文章的缩略图和封面图区别对待。 对于有缩略图的所有文章/页面,将其front-matter中的thumbnail:更改为cover:

    post.md
    1
    2
    3
    4
    5
      title: Icarus快速上手
    date: 2020-04-01
    - thumbnail: /gallery/covers/vector_landscape_1.svg
    + cover: /gallery/covers/vector_landscape_1.svg
    ---

    你仍可以在front-matter中设置thumbnail来在文章归档页面以及最新文章挂件中显示小一点的缩略图。

  6. 阅读更新说明最新文档来了解更多新功能的信息.

作者

PPOffice

发布于

2016-01-02

许可协议

CC BY-NC-SA 4.0

Your browser is out-of-date!

Update your browser to view this website correctly.&npsb;Update my browser now

×