Migrate from v1

Update theme

Since v2, you have more methods to install Theme Cupertino, but the old method is still good to use. If you want to change to other methods, go to Get Started.

Then, you need to update your theme according to your installation method.

Use _config.cupertino.yml instead of modifying the submodule

In v2, _config.cupertino.yml is preferred as it’s a more straightforward method to customize your blog.

Add hero

title and subtitle of your blog configuration is no longer used as the hero section of the home page. You need to add the following configuration:

hero:
  title: <blog-title>
  description: <blog-subtitle>

Migrate navigation and footer

Migrate search

hexo-generator-search  is no longer used, you should migrate to Pagefind .

Migrate from saved icons to icon packs

The icons for social media platforms are replaced with Simple Icons  and other icons are now using Bootstrap Icons .

Especially in navigation, those auto icon transformations are deprecated. You should use something like <i class="si si-github"></i> from now on.

Move some modifications to insertions

If you used to modify the source code of Theme Cupertino to add custom <style />, <link /> and so on, they have safer place to reside now.

og_enabled, og_image and og are deprecated

Open Graph generation uses Hexo’s built-in helper open_graph.

Done! Build again to bring the latest features to life.