DOCSEARCHbyAlgolia
Submit Docs

Butterfly Theme for Hexo

website·Indexed 30 days ago

https://butterfly.js.org/

Documentation and guides for the Butterfly theme for Hexo, featuring release notes from version 4.8.0 through 5.6, customization tutorials for code coloring (hljs and Prismjs), sidebar widget sorting, and tag plugins for tabs, buttons, and mermaid diagrams.

Tokens
75.4K
Snippets
631
Records
780
Agent score
65%

What's inside Butterfly

  1. Migrate to Butterfly v5.0

    Upgrading to version 5.0 introduces breaking changes due to the integration and renaming of several settings. Users must reconfigure their _config.yml file. Key changes include:

    • Introduction of macstyle setting (replacing mac and mac light theme settings).
    • Integrated search-related settings.
    • Modified code block settings.
    • New layout options for homepage posts.
    • Introduction of a "Shuoshuo" page.
    • Compatibility with hexo-blog-encrypt plugin.
    # Reconfigure _config.yml according to v5.0 specifications

  2. Migrate to Butterfly 5.0 (Breaking Changes)

    Upgrading to Butterfly 5.0 requires a full reset/reconfiguration of the _config.yml file due to the integration of multiple settings and changes in configuration naming. Key changes include:

    • Introduction of macstyle setting (replacing mac and mac light).
    • Integration of search-related settings.
    • New layout configurations for home page articles.
    • Addition of a 'Say' (說說) page.
    • Support for hexo-blog-encrypt plugin.
    • New sidebar interface design.
    • Updated Giscus and Utterances JS settings.

  3. Configure article introduction display on homepage

    The auto_excerpt setting has been replaced by index_post_content. This allows you to choose how the article introduction is displayed on the homepage using three different methods.
    index_post_content:
  method: 3 # 1: description, 2: both (description or auto_excerpt), 3: auto_excerpt (default)
  length: 500 # Required if method is 2 or 3

  4. Configure homepage article content display

    Use the index_post_content configuration to determine how article introductions are displayed on the homepage. You can choose between showing the description, an auto-excerpt, both, or disabling the introduction entirely.
    index_post_content:
  method: 3 # 1: description, 2: both, 3: auto_excerpt (default), false: do not show
  length: 500 # Required if method is 2 or 3

  5. Migrate to Butterfly v5.0

    Upgrading to version 5.0 requires a reconfiguration of the _config.yml file due to the integration and renaming of several settings. Key changes include:

    • Introduction of macstyle setting (replacing mac and mac light theme settings).
    • Integration and modification of search-related settings.
    • Modified code block settings.
    • New layout options for homepage posts.
    • Introduction of a "Shuoshuo" page.
    • Compatibility with hexo-blog-encrypt plugin.

  8. Migrate to Butterfly v5.0

    Upgrading to Butterfly version 5.0 introduces breaking changes due to the integration and renaming of several settings. Users must reconfigure their _config.yml file. Key changes include the introduction of the macstyle setting (replacing mac and mac light theme settings), modified code block settings, and integrated search-related settings.

  9. Migrate to Butterfly v5.0

    Upgrading to Butterfly version 5.0 requires a reconfiguration of the _config.yml file due to the integration and renaming of several settings. Key changes include:

    • Introduction of macstyle setting (replacing mac and mac light theme settings).
    • Integration of search-related settings.
    • Modified code block settings.
    • New layout options for homepage posts.
    • Introduction of a "Shuoshuo" page.
    • Compatibility with the hexo-blog-encrypt plugin.

  10. Migrate to Butterfly 5.0

    Upgrading to Butterfly 5.0 requires a full reconfiguration of the _config.yml file because multiple settings were integrated and several configuration names were changed. Key changes include the introduction of macstyle (replacing mac and mac light themes), a new 'Say' (說說) page, and a redesigned sidebar interface.

  11. Migrate to Butterfly version 5.0

    Upgrading to version 5.0 introduces breaking changes due to the integration and renaming of several settings. Users must reconfigure their _config.yml file. Key changes include: the introduction of macstyle (replacing mac and mac light theme settings), modified code block settings, and integrated search-related settings.

  12. Migrate to Butterfly v5.0

    Upgrading to version 5.0 involves breaking changes due to the integration and renaming of several settings. Users must reconfigure their _config.yml file. Key changes include:

    • Introduction of macstyle setting (replacing mac and mac light theme settings).
    • Integration of search-related settings.
    • Modified code block settings.
    • New layout options for homepage posts.
    • Introduction of a "Shuoshuo" page.
    • Compatibility with hexo-blog-encrypt plugin.