4.9.0 (2023/06/06)

Feature

1. Adapted to mermaid v10

2. When the screen is larger than 2000px, the display area is increased

3. Header and footer can be configured to add black translucent masks

1
2
3
4

+# Add mask to header or footer
+mask:
+  header: true
+  footer: true

4. Latest comments in artalk are now called directly through the API

5. Latest comments and comment count in waline are now called directly through the API

6. Clicking the chat button in the lower right corner again will close the chat

7. Adapted to the new version of artalk

8. Supports random order of friend links

Fix

1. Fixed the bug of inline mathjax causing scrolling

2. Fixed the bug that when top_img is a color, the top of the reading mode still shows the color

3. Fixed the bug that the sub of subtitle configuration did not take effect

Improvement

1. Updated hexo-renderer-stylus

2. Beautification optimization of hr to avoid affecting the layout of third-party plugins

3. Optimized mediumZoom

4. Fine-tuned the homepage

5. When the latest comments are configured, there will be no error if comments are not configured

6. Optimized tidio, crisp, daovoice, messenger, and chatra code

4.8.5 (2023/05/09)

Features

1. Artalk supports clicking to open large images.
2. After setting to switch between light and dark mode with the system, comments and mermaid will also switch colors accordingly.
3. Artalk's latest comments now read the avatar CDN and default avatar from the Artalk configuration.

Fixes

1. Fixed the bug where Artalk could not get the latest comments.
2. Fixed the bug where the code block could not be copied when the copy button was clicked before the block was expanded.

Improvements

1. Code and performance optimization.
2. Artalk now gets the comment count by using loadCountWidget instead of LoadCountWidget.

4.8.1 (2023/04/10)

Fix

1. Fixed a bug where the theme's JavaScript could not be loaded when the internal_provider of the CDN was set to jsdelivr.

4.8.0 (2023/04/10)

Breaking Change

1. Removed Gitter integration.

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22

   -# gitter -# https://gitter.im/ -gitter: - enable: false - room: 2. Renamed parameters in the CDN options section. ```diff CDN: option: - # algolia_search_v4: - # instantsearch_v4: - # fancybox_css_v4: - # fancybox_v4: - # fontawesomeV6: + # algolia_search: + # instantsearch: + # fancybox_css: + # fancybox: + # fontawesome:

Feature

1. Configurable color for social media icons.

2. Added support for rendering music scores using abcjs library.

   1 2 3 4 5 6

   +# abcjs (樂譜渲染) +# See https://github.com/paulrosen/abcjs +# --------------- +abcjs: + enable: false + per_page: true

3. Updated to support the latest version of typed.js.

4. Implemented Algolia search, clicking on search results now redirects to the corresponding page.

5. Refactored local search

   1 2 3 4 5 6 7 8 9 10

   # Local search local_search: enable: false # Preload the search data when the page loads. preload: false + # Show top n results per article, show all results by setting to -1 + top_n_per_article: 1 + # Unescape html strings to the readable one. + unescape: false CDN:

6. Upgraded fancybox to version 5.

7. Updated Facebook JavaScript version.

8. CDN configuration now includes versioning for local links.

9. Added support for customizing the JS address of the giscus commenting system.

   1 2 3

   CDN: option: + giscus: xxxxx

10. Added the ability to customize the switch time for dark mode.

    1 2 3 4 5

    # dark mode darkmode: + # Set the light mode time. The value is between 0 and 24. If not set, the default value is 6 and 18 + start: # 8 + end: # 22

Fix

1. Fixed a bug where the search content was covered by the system search box in Safari.
2. Fixed a bug where the fullpage loading displayed a scrollbar.
3. Fixed an issue where the limit was not effective when card_tags.color was set to true.
4. Fixed a bug where the image identification was incorrect due to the uppercase suffix when setting an image.
5. Fixed an issue where pace.js was triggered by the addition of an anchor when archor was enabled.

Improvement

1. When the browser width is greater than 2000px, the card width changes from 1500px to 1700px.
2. When beautify is not enabled, hr displays the default style.
3. When mobile Safari is in landscape mode, the webpage displays in full screen.
4. The social icon rotates 180 degrees on hover.
5. Optimized viewport SEO.
6. Code optimization.

4.7.0 (2023/02/20)

Feature

1. The card_tags can be configured with orderby and order parameters.

   1 2 3 4 5 6 7 8

   aside: card_tags: enable: true limit: 40 # if set 0 will show all color: false + orderby: random # Order of tags, random/name/length + order: 1 # Sort of order. 1, asc for ascending; -1, desc for descending sort_order: # Don't modify the setting unless you know how it works

2. The tag page supports configuring the orderby and order parameters.

3. Add docsearch.

   1 2 3 4 5 6 7 8

   +# Docsearch +# https://docsearch.algolia.com/ +docsearch: + enable: false + appId: + apiKey: + indexName: + option:

4. Local search, clicking on the content of an article will also redirect to the corresponding page.

5. The gallery tag plugin adds support for retrieving JSON.

Fix

1. Fixed a bug where there was no spacing in the aside card after setting card_author and card_announcement to false.
2. Fixed an issue where the latest comments in artalk could not be loaded.
3. Fixed a bug where waline's CSS was not loaded in pjax mode.
4. Fixed a bug in local search where certain symbols could not be searched.

Improvement

1. Refactored getCSS function.
2. Reduced the size of the scroll bar.

hideToggle 4.6.1 (2023/01/18)

Breaking Change

1. Configurable parameters for typed.js

   1 2 3 4 5 6 7 8 9 10

   subtitle: - # Effect Speed Options - startDelay: 300 # time before typing starts in milliseconds - typeSpeed: 150 # type speed in milliseconds - backSpeed: 50 # backspacing speed in milliseconds - # loop - loop: true + # Customize typed.js + # https://github.com/mattboldt/typed.js/#customization + typed_option:

Fix

1. Fixed bug where typeJSFn was being assigned multiple times.
2. Fixed bug where the title had a shadow after fixing the status bar.
3. Fixed bug where the gallery tag truncated the image link, causing a 404 error when loading the image.
4. Fixed bug where clicking on certain scroll-up buttons after fixing the navigation bar would result in the target section being obscured by the navigation bar.
5. Fixed bug where the table of contents (toc) was being obscured after fixing the navigation bar.

Improvement

1. When switching between simplified and traditional Chinese, the lang attribute of the HTML will be changed.

4.6.0 (2023/01/15)

Breaking Change

1. Optimization of cover display #1101

   When the cover is set to false or no value is obtained for the cover, the background of the related recommended articles and pagination buttons on the article page will be displayed in the theme color.

Feature

1. toc can be set to show preview progress

   1 2	toc: + scroll_percent: true

2. Added preview progress display to the bottom right button

   1 2	+# show scroll percent in scroll-to-top button +rightside_scroll_percent: true

3. Cover can be configured with color/gradient color, etc.

4. default_cover can be configured with color.

5. Navigation bar settings: hide blog name / set logo / set fixed navigation bar # 1150 #1104

   1 2 3 4

   +nav: + logo: # image + display_title: true + fixed: false # fixed navigation bar

6. BuSuanZi (a website traffic analysis tool) can be configured with CDN #1132

7. Added lazy loading to gallery tag plugin, added lazyload rowHeight and limit attribute configuration

8. Updated plugins.yml

Fix

1. Fixed bug where hexo-log couldn't be loaded #1102
2. Fixed bug where special characters didn't display results when using local search
3. Fixed bug where colors with "/" in the header image and footer configuration couldn't be displayed
4. Fixed bug where code blocks still displayed colored backgrounds in reading mode (custom code blocks) #1139
5. Fixed bug where avatars of friend links may not be displayed when lazy loading is enabled and friend link data is imported using flink_url #1146
6. Fixed bug where waline js was loaded repeatedly under pjax

Improvement

1. When setting the date as a relative date, the date format of the article and the latest comment are unified as year, month, and day.
2. Fixed bug where special characters didn't display results when using local search
3. Added explanatory text to the article pagination buttons when hovering over them with the mouse
4. The display order of the top image on the article page is top_img > cover > default_top_img
5. Modified configuration file comments
6. Optimized the scroll position of search result display
7. Search results will not split words when wrapping
8. Canonical link is generated based on the configuration

Remove

1. Removed cnzz analytics

   1 2 3

   -# CNZZ Analytics -# https://www.umeng.com/ -cnzz_analytics:

Fix

1. Fixed a bug where inline mathjax formulas caused excessive line spacing.
2. Fixed a bug where mathjax overflowed the screen instead of displaying a scrollbar after updating to a new version.

Improvement:

1. Avoided configuration errors caused by not updating theme files.
2. Updated plugins.yml.

4.5.0 (2022/10/21)

Breaking Change

1. Open_Graph_meta setting change, allowing configuration of additional parameters

   1 2 3 4

   -Open_Graph_meta: true +Open_Graph_meta: + enable: true + option:

2. Preloader setting change, adding pace.js loading animation bar

   1 2 3 4 5 6 7 8 9

   -preloader: false +preloader: + enable: false + # source + # 1. fullpage-loading + # 2. pace (progress bar) + source: 1 + # pace theme (see https://codebyzach.github.io/pace/) + pace_css_url:

3. Anchor setting change, allowing separate configuration for button and automatic update of anchor, setting button icon, and setting button always show

   1 2 3 4 5 6 7

   -anchor: false +anchor: + button: + enable: false + always_show: false + icon: # the unicode value of Font Awesome icon, such as '\3423' + auto_update: false # when you scroll in post, the URL will update according to header id.

Feature

1. Update Facebook sdk to v15

Fix

1. Fix throttle function invocation method #1075
2. Fix bug in controlling loadFBComment error #1066
3. Fix layout inconsistency issue when screen width is 768px #1032

Improvement

1. Add additional characters to traditional and simplified Chinese conversion #1076
2. Local preview, refresh of friendly link page, content will not be duplicated
3. Update plugins.yml

Remove

1. Remove meta keywords

4.4.0 (2022/08/18)

Feature

1. Added Facebook Messenger plugin for online chat

   1 2 3 4

   +messenger: + enable: false + pageID: + lang: zh_TW # Language en_US/zh_CN/zh_TW and so on

2. Added Artalk comment function

   1 2 3 4 5

   +artalk: + server: + site: + visitor: false + option:

3. Added parameter configuration for typing effect on homepage

   1 2 3 4 5 6 7

   subtitle: ... + # Effect Speed Options + startDelay: 300 # time before typing starts in milliseconds + typeSpeed: 150 # type speed in milliseconds + backSpeed: 50 # backspacing speed in milliseconds ...

Fix

1. Fixed bug where Facebook comments were not loading correctly after opening anchor
2. Fixed bug where Facebook comment count was not loading
3. Fixed bug where subdirectory hover did not have rounded corners #965

4.3.1 (2022/06/27)

Fix

1. Fixed a bug where the read count wouldn't display when comments were set to false but the option to show comment count was enabled.
2. Fixed the bug with finding archive titles.

4.3.0 (2022/06/24)

Breaking Change

1. Hide aside setting for archives has been changed.

   1 2 3 4

   aside: - archive: true + display: + archive: true

2. Adapt to disqusjs 3.0.

Feature

1. The number of articles displayed on sub-archive pages will no longer show the total number of articles, but the corresponding number of sub-archive articles.

2. Added loading display for some data loading.

3. Added the ability to hide aside on tag and category pages.

   1 2 3 4

   aside: + display: + tag: true + category: true

4. Clicking on the archive date will now jump to the page, and the title will display the date instead of the word "Archive".

5. Adapted to the upgrade of katex and removed katex copy-tex.css.

6. Added one-click configuration for CDN using cdnjs.

7. Added one-click configuration for CDN using unpkg.

8. Added the ability to set version and custom format for CDN.

   1 2 3

   CDN: + version: false + custom_format:

9. Added support for Remark42 comment system.

   1 2 3 4 5 6

   +# Remark42 +# https://remark42.com/docs/configuration/frontend/ +remark42: + host: # Your Host URL + siteId: # Your Site ID option:

Fix

1. Algolia search returns no results.
2. When the comment system is enabled, busuanzi's page_pv does not display.
3. Custom sorting for sidebar archive cards is not working correctly.

Improvement

1. Modified the class name of the note icon to avoid overriding the theme style by third-party icons.

4.2.2 (2022/05/19)

1
2
3
4
5

fix: Fixed a bug where the comment count for the Valine plugin on the homepage only showed for the first article.
fix: Fixed a bug where third-party plugin local resources could not be loaded in subdirectories.
fix: Fixed a bug where the page_pv of busuanzi did not display when the comment system was enabled.
fix: Fixed a bug where using mermaid to jump under pjax would cause a reload.
improvement: Optimized Twikoo comments to not call the API when there is no comment count container. #897

4.2.1 (2022/05/11)

Fix

1. Fixed a bug where mathjax fonts were missing when CDN configuration was set to local.

4.2.0 (2022/05/02)

Breaking Change

1. Adapted waline to V2

   1 2 3 4

   CDN: - waline: + waline_js: + waline_css:

2. Changed visitor in waline to pageview

   1 2 3

   waline: - visitor: false + pageview: false

3. Added the ability to configure CDN for local files and separate configuration for theme files and third-party files

   1 2 3 4 5 6 7 8 9 10

   CDN: + # The CDN provider of internal scripts + # option: local/jsdelivr + # Dev version cannot choose jsdelivr + internal_provider: local + # The CDN provider of third party scripts + # option: local/jsdelivr + # when set it to local, you need to install hexo-butterfly-extjs + third_party_provider: jsdelivr + option:

4. Removed CDN configuration for utterances, giscus, addtoany, and busuanzi

Feature

1. Added article content display and highlighting to algolia search

2. Increased the display area for search content

3. Added preload and CDN configuration for local search

   1 2 3 4

   local_search: enable: false + preload: false + CDN:

4. Updated social-share CDN version

5. Added support for hiding sidebar on archive pages

   1 2	aside: + archives: true

6. Added the ability to configure author hyperlink for post copyright module

   1 2	post_copyright: + author_href:

Fix

1. Fixed bug where mathjax was not displaying correctly
2. Fixed rendering issue with related recommendations when title contains HTML keywords

Improvement

1. Unified the display of search titles as 'Search'
2. Changed the logo for algolia search to instantsearch
3. Prevented automatic search on first entry to algolia search
4. Added ellipsis recognition to search content
5. Adjusted spacing issues caused by share buttons
6. HTML/CSS optimization

4.1.0 (2022/02/13)

Breaking Change

1. Upgrade fontawesome to v6 #689

   1 2 3

   CDN: - fontawesome: + fontawesomeV6:

Feature

1. Add rounded corners to snackbar
2. Add flink tag plugin

Fix

1. Fix bug where clicking outside of toc causes console error
2. Fix bug where Facebook Comments cannot be used #787
3. Fix translation missing for chat_btn #791
4. Fix bug where local search doesn't work when content is set to false #764
5. Fix bug where Mermaid chart elements have excessive height #773
6. Fix bug where share buttons on article page don't take up full width on navigation page #765

Improvement

1. Improve semantic toggle tag plugin
2. Change toc background color in dark mode

4.0.1 (2022/01/16)

Improvement: Optimized animation of the bottom right button under pjax.

Fix: Fixed a bug where the page setting aside as true would cause a JavaScript error.

Fix: Fixed a bug where the position of the bottom right button was being blocked on some pages.

Fix: Fixed a bug where compressing HTML code would cause an error on the friend link page.

Fix: Fixed a bug where sliding the side menu on Safari would collapse it.

4.0.0 (2022/01/15)

Breaking Change

1. Simplified configuration for comments.

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29

   disqusjs: - apikey: - api: - nocomment: # display when a blog post or an article has no comment attached - admin: - adminLabel: + option: gitalk: - language: en # en, zh-CN, zh-TW, es-ES, fr, ru - perPage: 10 # Pagination size, with maximum 100. - distractionFreeMode: false # Facebook-like distraction free mode. - pagerDirection: last # Comment sorting direction, available values are last and first. - createIssueManually: false # Gitalk will create a corresponding github issue for your every single page automatically valine: - pageSize: 10 # comment list page size - lang: en # i18n: zh-CN/zh-TW/en/ja - placeholder: Please leave your footprints # valine comment input placeholder (like: Please leave your footprints) - guest_info: nick,mail,link # valine comment header info (nick/mail/link) - recordIP: false # Record reviewer IP - bg: # valine background - emojiCDN: # emoji CDN - enableQQ: false # enable the Nickname box to automatically get QQ Nickname and QQ Avatar - requiredFields: nick,mail # required fields (nick/mail) waline: - avatar: monsterid # gravatar style https://zh-tw.gravatar.com/site/implement/images/#default-image - avatarCDN: # Gravatar CDN baseURL

2. Page supports table of contents (TOC) #636

   1 2 3 4

   toc: - enable: true + post: true + page: false

3. Delete the "hide_sidebar_menu_child" configuration and directly configure it in the menu #640

   1 2	-# Hide the child menu items in mobile sidebar -hide_sidebar_menu_child: false

4. Completely remove jQuery

   1 2	CDN: - jquery: https://cdn.jsdelivr.net/npm/jquery@latest/dist/jquery.min.js

5. Remove Tencent Analytics

   1 2 3

   -# Tencent Analytics ID -# https://mta.qq.com -tencent_analytics:

6. photofigcaption and fancybox prioritize displaying the "title" attribute of the image, followed by the "alt" attribute #683

7. Support new comment name format, the theme will handle the case sensitivity, and the old format will still be compatible

8. Remove Botian API, note the change in order

   1 2 3

   # source: 1 Call a sentence from Hitokoto (Simplified Chinese) https://hitokoto.cn/ # source: 2 Call a sentence (Simplified Chinese) http://yijuzhan.com/ # source: 3 Call today's poem (Simplified Chinese) https://www.jinrishici.com/

9. Remove the font-size of HTML and use the default size of the browser

Feature

1. Update fancybox to version 4

   1 2 3 4 5

   CDN: - fancybox_css: https://cdn.jsdelivr.net/npm/@fancyapps/fancybox@latest/dist/jquery.fancybox.min.css - fancybox: https://cdn.jsdelivr.net/npm/@fancyapps/fancybox@latest/dist/jquery.fancybox.min.js + fancybox_css_v4: + fancybox_v4:

2. Customize the order of the bottom-right buttons #680

   1 2 3 4

   +rightside_item_order: + enable: false + hide: # readmode,translate,darkmode,hideAside + show: # toc,chat,comment

3. Display the website data, show the quantity as 0 when the tags and categories are 0, instead of hiding it

4. Set a height limit for code blocks, the expand button will not disappear after expanding, and can be clicked to collapse again #637

5. Selectively disable lightbox for images #636

6. Add lightbox to Twikoo comments with images

7. Upgrade Facebook comment JS to version 11

8. Set TOC simple_style to display for individual articles #631

9. Add a black overlay to the top image of pages #671

10. Update UI for homepage pagination

11. Change the theme CSS from using "rem" to "em" or "px"

12. Remove the font adjustment button in the bottom-right corner

    1 2	-# Change font size -change_font_size: false

13. Add a new tag plugin, timeline #644

14. Remove CDN from the configuration file, default CDN will no longer be displayed in config

15. Replace Justified Gallery with flickr-justified-gallery

    1 2 3 4 5

    CDN: - justifiedGallery_js: https://cdn.jsdelivr.net/npm/justifiedGallery/dist/js/jquery.justifiedGallery.min.js - justifiedGallery_css: https://cdn.jsdelivr.net/npm/justifiedGallery/dist/css/justifiedGallery.min.css + flickr_justified_gallery_js: + flickr_justified_gallery_css:

16. After switching to dark mode, mermaid will also switch to the dark theme

    1 2 3 4 5 6 7

    mermaid: enable: true # built-in themes: default/forest/dark/neutral - theme: default + theme: + light: default + dark: dark

17. Mermaid displays correctly after compressing HTML code

18. Mermaid can be used in hidden attribute tag plugins

19. Local search can handle JSON #684

20. Fine-tune the UI of the bottom-right buttons

21. Change the display effect of the list after beautifying the article #693 #686

22. Upgrade Algolia to v4

    1 2 3 4 5

    CDN: - algolia_search: https://cdn.jsdelivr.net/npm/instantsearch.js@2.10.5/dist/instantsearch.min.js - algolia_search_css: https://cdn.jsdelivr.net/npm/instantsearch.js@2.10.5/dist/instantsearch.min.css + algolia_search_v4: + instantsearch_v4:

23. Add loading display for local search database loading and searching

24. Anchor can be opened on any page, not just post pages

25. Clicking on the article title will jump to the beginning of the article for reading #653

26. TOC can be set to expand all #709

    1 2	toc: + expand: false

27. Add a new comment system, Giscus

    1 2 3 4 5 6 7 8 9 10 11 12 13

    +# Giscus +# https://giscus.app/ +giscus: + repo: + repo_id: + category_id: + theme: + light: light + dark: dark + option: CDN: + giscus:

28. Fetch URL for the friend link list

29. Adjust spacing for TOC, add vertical line to identify direct child elements as closed #723

30. Configurable scrollbar color

    1 2	theme_color: + scrollbar_color: "#49b1f5"

31. Beautify Firefox browser scrollbar

32. Add blueimp_md5 configuration to CDN

    1 2	CDN: + blueimp_md5:

Fix

1. Fix the bug where the thumbnail image of fancybox is displayed with lazyload enabled
2. Fix the bug where the UI is offset due to font size being too large or too small
3. Fix the bug where self-built page images do not have blur effect
4. Fix the bug where the UI of the navigation bar may become disordered when the window size changes
5. Fix the bug where Twikoo comments under pjax may retrieve comments from the previous post #678
6. Fix the bug where rightside blocks content and prevents it from being clicked
7. Fix the bug where mermaid fails to load on certain pages (when there is an element with id "mermaid")
8. Fix the bug where the search box does not automatically focus
9. Fix the bug where an error occurs when comments are not configured for use
10. Fix the bug where TOC is displayed off-screen on small devices
11. Fix the bug where the reward popup is triggered around the reward button
12. Fix the bug where the recent comments time in Waline only shows "just now" (when running with Docker) #730
13. Fix the bug where utterances displays incorrectly when issue_term is set to url and og:title
14. Fix the bug where the latest comments module still shows when the comment configuration is set to Livere and Facebook Comments

Improvement

1. Optimize the subtitle code, when source is set to false and sub is not configured, it will read the subtitle from the Hexo configuration file without using escape characters
2. Prevent iOS from zooming in when clicking on the search box
3. Remove the limitation of only clicking the button to expand the sidebar menu #640
4. Modify the title size on article pages when there is no top image
5. Optimize the UI of the 404 page
6. Set transparent image as the default placeholder for lazyload
7. Optimize CSS
8. Optimize lazyload blur effect appearance
9. Move the exit button for reading mode to the bottom-right corner on mobile devices
10. Fine-tune UI
11. Prevent some browsers from zooming in when clicking the bottom-left button
12. Add title display when hovering over the content of the latest comments
13. Remove hover effect on buttons

3.8.4 (2021/09/18)

Fix

1. Fixed a bug that caused the inlineImg tag to display incorrectly after opening photofigcaption. (Issue #667)
2. Fixed a bug where local search would not work if the search plugin was configured to not search article content. (Issue #666)
3. Fixed a bug that could cause incorrect links to related articles. (Issue #549)

Improvement

1. Adjusted the scrollbar color for code blocks. (Issue #651)
2. When an image does not have a figcaption, the figcaption code will not be added.

3.8.3 (2021/07/30)

Fix

1. Fixed a bug where the avatarCDN setting in the Waline comment system was not working.

3.8.2 (2021/07/20)

Fix

1. Fixed a bug (#616) where the footer was not displaying at the bottom in some browsers.

Improvement

1. Updated configuration file comments (#613).

3.8.1 (2021/07/10)

Fix

1. Fixed the bug where inline mathjax had a scrollbar.
2. Fixed the bug where the avatar in the friendly links had the Medium Zoom lightbox (#607).
3. Fixed the bug where the avatar in the friendly links had the FancyBox lightbox (#607).

Dependencies

1. update hexo-renderer-pug

3.8.0 (2021/07/04)

Breaking Change

1. The title of archives is now obtained from the menu configuration.

2. Removed the option to choose the comment service for the latest comments. It now defaults to the first comment service in the configuration.

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17

   newest_comments: enable: false sort_order: # Don't modify the setting unless you know how it works limit: 6 storage: 10 # unit: mins, save data to localStorage avatar: true - # You can only choose one, or neither - valine: false - github_issues: - enable: false - repo: - disqus: - enable: false - forum: - api_key: - twikoo: false - waline: false

3. Changed the way widgets are written and added the ability to add non-sticky area widgets.

Feature

1. Modified the icon for the latest comments.

2. Adapted waline colors to match the theme color.

3. Added waline avatarCDN configuration (also updates the latest comments).

   1 2 3

   waline: ... +avatarCDN： # Gravatar CDN baseURL

4. Upgraded facebook comment js to v10.

Fix

1. Fixed the bug where the avatar for the friend links and aside were not displayed properly under lazyload blur.
2. Fixed the bug where some code blocks were still expanded after setting highlight_shrink to true (#602).
3. Fixed the bug where mathjax caused the list to lose its style (#586).
4. Fixed the bug where mathjax on the article page caused overlapping display due to small font size (#587).
5. Fixed the bug where the footer did not align to the bottom when the content was too short.

Improvement

1. UI optimization.
2. Adjusted waline font size and avatar effects.
3. Optimized pjax.
4. Reduced lag by setting background-attachment to scroll for the homepage on Apple devices.
5. The 404 page no longer displays the right side.

3.7.8 (2021/06/05)

Breaking Change

1. Removed the emojiCDN and emojiMaps configurations for waline.

Fix

1. Fixed bugs that occurred when upgrading to waline 1.x.

3.7.7 (2021/05/11)

Improvement

1. Adapted to the new version of waline's dark mode.

3.7.6 (2021/05/09)

Fix

1. Fixed a bug where pjax would throw an error when the title/blog name contains an apostrophe.

Improvement

1. Adjusted the CSS.

3.7.5 (2021/05/05)

Breaking Change

1. Optimization of site_verification, manual configuration required

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21

   -# Google Webmaster tools verification setting -# See: https://www.google.com/webmasters/ -google_site_verification: -# Bing Webmaster tools verification setting -# See: https://www.bing.com/webmaster/ -bing_site_verification: -# Baidu Webmaster tools verification setting -# See: https://ziyuan.baidu.com/site/ -baidu_site_verification: -# 360 Webmaster tools verification setting -# see http://zhanzhang.so.com/ -qihu_site_verification: -# Yandex Webmaster tools verification setting -# see https://webmaster.yandex.com/ -yandex_site_verification: +site_verification:

2. Optimization of lazyload (added Gaussian blur transition effect, expanded lazyload configuration range, applied placeholder image to the entire site)

   1 2 3 4 5 6

   lazyload: enable: false - post: /img/loading.gif + field: site # site/post + placeholder: /img/loading.gif + blur: false

Feature

1. Added tags plugin - label

Fix

1. Fixed bug where after opening an anchor, the article page would redirect to the homepage with the hash of the last title of the article added to the homepage URL
2. Fixed bug where after opening an anchor, navigating to the previous/next page in the browser would result in a 404 error (the URL hash of the article page became undefined under pjax)
3. Fixed bug where lazyload would report undefined error close #532

Improvement

1. Optimization of 404 page under pjax
2. Optimization of button tags plugin

3.7.1 (2021/03/30)

Fix

1. Fixed the bug where the URL format for the latest comments on GitHub issues was not being retrieved correctly.
2. Fixed the bug where Disqus and DisqusJS were unable to load when the title contained an apostrophe.

3.7.0 (2021/03/18)

Breaking Change

1. Changed the syntax for subdirectories to match that of parent directories.

2. Removed Artitalk (If needed, please install hexo-butterfly-artitalk instead)

   1 2 3 4 5 6 7 8 9

   -# Artitalk -# see https://artitalk.js.org/ -artitalk: - appId: - appKey: - option: CDN: -artitalk: https://cdn.jsdelivr.net/npm/artitalk

3. Updated the JavaScript and CSS CDN for katex_copytex.

   1 2 3 4 5

   -katex_copytex: https://cdn.jsdelivr.net/npm/katex-copytex@latest/dist/katex-copytex.min.js -katex_copytex_css: https://cdn.jsdelivr.net/npm/katex-copytex@latest/dist/katex-copytex.min.css +katex_copytex: https://cdn.jsdelivr.net/npm/katex@latest/dist/contrib/copy-tex.min.js +katex_copytex_css: https://cdn.jsdelivr.net/npm/katex@latest/dist/contrib/copy-tex.css

Feature

1. Added the ability to set a code height limit and display an expand button.

   1	+highlight_height_limit: false # unit: px

2. prismjs can now be configured with code_word_wrap.

3. Added the kbd style #507.

4. Added article view count configuration provided by waline, valine, and twikoo #502.

   1 2 3 4 5 6

   valine: + visitor: false waline: + visitor: false twikoo: + visitor: false

5. Added HexoPlusPlus_Talk (requires installation of hexo-butterfly-hpptalk).

6. Added the inlineImg plugin for tags.

7. Added option configuration for gitalk.

   1 2 3

   gitalk: createIssueManually: false # Gitalk will create a corresponding github issue for your every single page automatically + option:

Fix

1. Fixed the bug where prismjs was auto-wrapping on iOS Safari.
2. Fixed the bug where the default code size was not changing with font size changes.
3. Fixed the bug where unrecognized languages in prismjs were displaying "null" instead of code.
4. Fixed the issue where running with no configuration would report "null" at runtime.

Improvement

1. Home page tabs will now scroll to the article section #519.
2. Optimized CSS and simplified custom code color CSS configuration.
3. Made the search hover effect consistent with other directories.
4. Adapted Baidu statistics for pjax #516.
5. When both the article page cover and default_img are not configured, it will read the default_top_img parameter.
6. Changed one API to use HTTPS.
7. Optimized pug code.

3.6.2 (2021/02/03)

Fix

1. Fixed a bug where mathjax and katex were not loading JavaScript.

3.6.1 (2021/02/01)

Fixes

1. Fixed an issue where a scroll bar appeared on the article page with a table of contents on non-iOS devices.
2. Fixed an issue on non-iOS devices where the relative positioning of elements inside the layout tag, such as position: fixed, would be altered.

3.6.0 (2021/01/30)

Feature

1. Added comment count display on the homepage.

   1 2 3 4

   comments: ... count: false # Display comment count in post's top_img + card_post_count: false # Display comment count in Home Page

2. Updates to the latest comments.

   1. <a> tags will display [link].
   2. <img> tags will display [image].
   3. <pre><code> tags will display [code].
   4. The URL obtained from github-issues will now link to the corresponding article instead of the issues page.
   5. Added datetime attribute to the time element.
   6. When obtaining avatars from Waline, it will first check if the avatar attribute for QQ is available in the Waline database.
   7. Changed the display time for some comments to the update time.

3. Changed the "View More" button in the aside section to an icon displayed in the top right corner.

4. Added configuration for the cache time of the latest comments.

   1 2 3 4 5

   newest_comments: enable: false sort_order: # Don't modify the setting unless you know how it works limit: 6 + storage: 10 # unit: mins, save data to localStorage

5. Added post_pagination configuration (can be disabled/configured for pagination logic).

   1 2 3 4 5 6

   +# post_pagination (pagination) +# value: 1 || 2 || false +# 1: The 'next post' will link to old post +# 2: The 'next post' will link to new post +# false: disable pagination +post_pagination: 1

6. Changed the copyright in the top right corner of the article to a copyright icon.

7. Added configuration to disable all top_img banners.

   1 2	+# Disable all banner image +disable_top_img: false

8. Added post_edit configuration.

   1 2 3 4 5 6 7

   +# Post edit +# Easily browse and edit blog source code online. +post_edit: + enable: false + # url: https://github.com/user-name/repo-name/edit/branch-name/subdirectory-name/ + # For example: https://github.com/jerryc127/butterfly.js.org/edit/main/source/ + url:

Fix

1. Fixed a bug where the icon text in the sliding submenu on the article page was not displayed (#481).
2. Fixed a bug where page elements would appear blurry and then clear when entering the page on Chrome (#479).
3. Fixed a bug where the background color of code blocks in read mode was not displayed correctly in dark mode.
4. Fixed a bug where the donation button would have abnormal hover effects due to excessive text (#473).
5. Fixed a bug where inline elements (emoticons/images) in comments would become block elements (line breaks).
6. Fixed a bug where the highlight in the toc would be on the previous element when clicking on the toc.
7. Fixed a bug where the donation image link would be incorrect in subdirectories.
8. Fixed a bug where clicking to close the random feature would not work.
9. Fixed a bug where the menu would not be properly styled when the device was rotated horizontally.
10. Fixed a bug where the 404 page would not be redirected under pjax.
11. Fixed a bug where the Twikoo comment count would throw an error due to regional issues.
12. Fixed a bug where background images with parentheses in the URL would not be displayed.

Improvement

1. Limited the meta description to 150 characters (#480).
2. Optimized and restructured the Pug code.
3. Optimized the Pug conditionals.
4. Added title display to the friendly links interface (when top_img is set to false).
5. Upgraded the Facebook comment SDK version.
6. Improved the display of the toc so that the navigation bar does not overlap the toc when scrolling up (#472).
7. Changed Pangu to render on the entire site.
8. Optimized the latest comments JavaScript.
9. Adjusted the margin of the Readmode title.
10. Fine-tuned the box-shadow for card hover effects.
11. Added hover effect to the 404 page card.
12. Removed some unnecessary code.

Remove

1. Removed Baidu push (Baidu has deprecated it) and Baidu transformation.

   1 2 3 4 5

   -# Disable Baidu transformation on mobile devices -disable_baidu_transformation: true -# Baidu Push -baidu_push: false

2. Removed fragment_cache configuration (enabled by default).

   1 2	-# Caches the contents in a fragment, speed up the generation -fragment_cache: true

3.5.1 (2020/12/31)

Feature

1. Added region configuration to Twikoo.

Fix

1. Fixed a bug in Twikoo where the latest comments were not being displayed in the Guangzhou region.
2. Fixed a bug in Waline where the background setting was not being applied.
3. Fixed a bug in Twikoo where an error occurred when entering the post page in the Guangzhou region.

3.5.0 (2020/12/30)

Feature

1. Added a close button for the aside personal profile widget.

   1 2 3 4 5 6 7 8 9 10

   aside: ... card_author: enable: true description: button: + enable: true icon: fab fa-github text: Theme GitHub link: https://github.com/jerryc127/hexo-theme-butterfly

2. Added Cloudflare Analytics.

   1 2 3

   +# Cloudflare Analytics +# https://www.cloudflare.com/zh-tw/web-analytics/ +cloudflare_analytics:

3. Added Microsoft Clarity.

   1 2 3

   +# Microsoft Clarity +# https://clarity.microsoft.com/ +microsoft_clarity:

4. Improved readmode.

5. Added custom widgets for the aside section.

6. Added sorting for aside widgets (only applicable to page and sticky).

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

   aside: ... card_recent_post: + sort_order: # Don't modify the setting unless you know how it works card_categories: + sort_order: # Don't modify the setting unless you know how it works card_tags: + sort_order: # Don't modify the setting unless you know how it works card_archives: + sort_order: # Don't modify the setting unless you know how it works card_webinfo: + sort_order: # Don't modify the setting unless you know how it works newest_comments: enable: true + sort_order: # Don't modify the setting unless you know how it works

7. Added option configuration for twikoo.

   1 2 3 4 5 6

   # Twikoo # https://github.com/imaegoo/twikoo -twikoo: +twikoo: + envId: + option:

8. Added Waline comments.

   1 2 3 4 5 6 7 8

   +# waline - A simple comment system with backend support fork from Valine +# https://waline.js.org/ +waline: + serverURL: # Waline server address url + avatar: monsterid # gravatar style https://zh-tw.gravatar.com/site/implement/images/#default-image + emojiCDN: # emoji CDN + bg: /img/comment_bg.png # waline background + option:

9. Added display of Waline comment count.

10. Added latest comments module for Waline.

    1 2 3 4

    newest_comments: enable: true ... + waline: false

Improvement

1. Added anchor tags to the latest comment URLs.

2. Optimized the HTML structure.

3. Replaced LeanCloud with Valine for the "newest_comments" feature, removed its configuration, and updated it to read Valine's configuration.

   1 2 3 4 5 6 7 8 9 10

   # Aside widget - Newest Comments newest_comments: ... - leancloud: - enable: false - appId: # leancloud application app id - appKey: # leancloud application app key - serverURL: # This configuration is suitable for domestic custom domain name users, overseas version will be automatically detected (no need to manually fill in) - default_avatar: # mp/identicon/monsterid/wavatar/retro/robohash/blank + valine: false

3.4.2 (2020/12/27)

Fix

1. Fixed a bug (#462) where there was a conflict between opening gitalk comments and the table of contents (toc).
2. Fixed an issue where jQuery was still being loaded in some interfaces.
3. Fixed a bug that caused medium zoom to throw errors.

3.4.1 (2020/12/15)

Fix

1. The update fixes a bug where buttons do not respond when the tabs plugin is set to -1.

3.4.0 (2020/12/13)

Breaking Change

1. Removed jQuery

Feature

1. Configurable option to add CSS prefixes

   1 2	+# Add the vendor prefixes to ensure compatibility +css_prefix: true

2. Added random configuration for click text effect

   1 2 3 4 5 6 7 8 9

   ClickShowText: enable: false text: - I - LOVEeeeeeeeeeeeee - YOU fontSize: 15px + random: true mobile: false

3. Added font adjustment button in the bottom right corner

   1 2	+# Change font size +change_font_size: true

4. Added latest comments from Twikoo

   1 2 3 4

   newest_comments: enable: true .... + twikoo: true

5. Added display of Twikoo comment count

6. Added concise mode for table of contents

   1 2 3 4

   toc: enable: true number: true + style_simple: false

Fix

1. Fixed a bug where links would not work when using the justifiedGallery CDN (relative links) in subdirectories.
2. Fixed an issue where the bottom-right button would not display correctly when there was no scrollbar.
3. Fixed a bug where the pangu configuration for posts would still take effect across the entire website.
4. Fixed a positioning issue with the table of contents (toc) when resizing.

Improvement

1. Added lazyload to the latest comment avatars.
2. Optimized the display of the latest comments, showing "No comments" when there are none.
3. Changed the method of obtaining toc clicks to use document.getElementById to prevent issues with certain characters causing navigation problems.
4. If supported by the browser, scroll will now use the native scrolling method.
5. Improved search functionality.
6. Optimized HTML formatting.
7. When there is no scrollbar, the rightside will now be displayed directly.
8. Slightly adjusted the margin of the toc on mobile devices.
9. Added asynchronous loading for fontawesome and Google fonts.
10. Reduced the brightness of ads in night mode.
11. When setting aside mobile to false, toc will still be displayed.

Remove

1. Removed ICP configuration. If needed, please use the custom_text configuration.
2. Removed unnecessary language files.

3.3.0 (2020/10/28)

Breaking Change

1. Only supports hexo 5.0.0 and above versions.
2. No longer supports the butterfly.yml syntax.

Feature

1. Added option settings for Valine:

   1 2	valine: + option:

2. Changed toc to display as aside and removed sidebar:

   1. Modified toc UI for mobile.

   2. Removed toc auto_open configuration:

      1 2 3 4

      toc: enable: true number: true - auto_open: true # auto open the sidebar

   3. Optimized the effect and timing of the toc on mobile.

   4. Added the ability to store aside state in localStorage.

3. Centered article titles.

4. Configurable hiding/showing of aside and added button to expand or collapse aside:

   1 2 3 4 5

   aside: enable: true + hide: false + button: true mobile: true # display on mobile

5. Added Twikoo comments:

   1

   +twikoo:

Improvements

1. Improved display of note tags in read mode.
2. Streamlined CSS and JS.
3. Optimized pjax.
4. Changed article page title to h1 for SEO purposes.
5. Changed canonical to use the function provided by Hexo.
6. Optimized ICP SEO #393.
7. Increased the width of the sidebar.
8. Adjusted HTML structure, changed mobile-sidebar to sidebar/search.
9. The scroll-to-comment button now only appears on the comment page.

Fixes

1. Fixed a bug where mermaid wouldn't display properly after website compression.
2. Fixed a bug where the content of an article wouldn't display in read mode when top_img was set to false.
3. Fixed a bug where the background image of valine would move from left to right when it appeared again.
4. Fixed a bug where disqusjs wouldn't fallback when the API wasn't set.

Removals

1. Removed unnecessary search configurations.
2. Removed Douban configuration. If needed, please use hexo-butterfly-douban.
3. Removed redundant CSS and Pug.

3.2.0 (2020/09/28)

Breaking Change

1. Renamed canvas_ribbon_piao to canvas_fluttering_ribbon:

   1 2 3 4

   -canvas_ribbon_piao: +canvas_fluttering_ribbon: enable: false mobile: false

2. Removed special effect JS and switched to CDN import.

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21

   CDN: # background effect - canvas_ribbon: /js/third-party/canvas-ribbon.js - canvas_ribbon_piao: /js/third-party/piao.js - canvas_nest: /js/third-party/canvas-nest.js + canvas_ribbon: https://cdn.jsdelivr.net/npm/butterfly-extsrc@1/dist/canvas-ribbon.min.js + canvas_fluttering_ribbon: https://cdn.jsdelivr.net/npm/butterfly-extsrc@1/dist/canvas-fluttering-ribbon.min.js + canvas_nest: https://cdn.jsdelivr.net/npm/butterfly-extsrc@1/dist/canvas-nest.min.js # effect - activate_power_mode: /js/third-party/activate-power-mode.js - fireworks: /js/third-party/fireworks.js - click_heart: /js/third-party/click_heart.js - ClickShowText: /js/third-party/ClickShowText.js + activate_power_mode: https://cdn.jsdelivr.net/npm/butterfly-extsrc@1/dist/activate-power-mode.min.js + fireworks: https://cdn.jsdelivr.net/npm/butterfly-extsrc@1/dist/fireworks.min.js + click_heart: https://cdn.jsdelivr.net/npm/butterfly-extsrc@1/dist/click-heart.min.js + ClickShowText: https://cdn.jsdelivr.net/npm/butterfly-extsrc@1/dist/click-show-text.min.js

Feature

1. Added the ability to configure whether or not to display the content/description of homepage articles.

   1 2 3 4 5 6 7 8

   # Display the article introduction on homepage # 1: description # 2: both (if the description exists, it will show description, or show the auto_excerpt) # 3: auto_excerpt (default) +# false: do not show the article introduction index_post_content: method: 3 length: 500 # if you set method to 2 or 3, the length need to config

2. Added the ability to configure whether to display the date or relative time for homepage and post pages.

   1 2 3 4 5 6

   post_meta: page: # Home Page + date_format: relative # date/relative to display the date or relative time post: + date_format: relative # date/relative to display the date or relative time

3. Added the ability to configure the top image (leave it empty for default color, specify a color in HEX/RGB/color word/gradient, or provide an image link, or set it to false to hide the top image).

4. Added the ability to configure the footer background (leave it empty for default color, specify a color in HEX/RGB/color word/gradient, provide an image link, or set it to true to use the same top image).

5. Added the ability to configure the website background (specify a color in HEX/RGB/color word/gradient, or provide an image link).

6. Added the ability to configure top images for individual tags using the tag_per_img configuration.

   1	+tag_per_img:

7. Added the ability to configure top images for individual categories using the category_per_img configuration.

   1	+category_per_img:

8. Optimized the note tag (customizable icon and style override).

9. In night mode, when the background color/top image/footer background is set to a color, it no longer forces black but instead applies a dimming overlay.

10. Added mobile settings for certain effects (activate_power_mode/fireworks/click_heart/ClickShowText).

    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17

    activate_power_mode: ... + mobile: false fireworks: ... + mobile: true -click_heart: false +click_heart: + enable: false + mobile: false ClickShowText: enable: false ... + mobile: false

11. Added the Artitalk comment plugin.

    1 2 3 4 5 6 7 8 9

    +# Artitalk +# see https://artitalk.js.org/ +artitalk: + appId: + appKey: + option: CDN: + artitalk: https://cdn.jsdelivr.net/npm/artitalk

12. Added the ability to disable webpage entrance animation.

    1 2	+# Enter transitions (enable webpage entrance animation) +enter_transitions: true

Improvements

1. The preloader will now load on every page under pjax.
2. Modified the logic to prevent errors caused by users setting up two lightboxes (only one is allowed).
3. Improved time display (e.g. just now, a few minutes ago, a few hours ago, a few days ago, a few months ago).
4. Removed unnecessary language files and CSS.
5. Open_Graph has been replaced with the built-in hexo generator.
6. When hidden sections are not configured, the settings button in the bottom left corner will disappear.
7. Added slide effect to expand/collapse categories in the aside section.
8. Dark mode font color has been darkened.
9. Optimized navigation entry to fix bugs where some users couldn't see the navigation in local testing.
10. Updated the latest comments to use REST API calls instead of JS SDK calls for Leancloud. The application no longer needs to be the same as Valine.
11. Added error output for the latest comments.
12. When tags are set to display in color, the font size will now vary based on the number of articles with that tag.
13. Adjusted the font size of the tags and categories pages when the width is less than 768.
14. Adjusted the categorization of theme files.
15. Valine background image will now be hidden when clicking on the comment box.

Fixes

1. Fixed an issue where pjax would not work when the description was not set in hexo's _config file.
2. Fixed a bug where the text effect on mouse click would cause a scrollbar when the text was too long.
3. Fixed a bug where local search article links were not redirecting properly.

Remove

1. Removed anime js and integrated it into the js file of fireworks.

   1 2	CDN: - anime: https://cdn.jsdelivr.net/npm/animejs@latest/anime.min.js

2. Deleted unnecessary language files.

chore

1. update hexo-renderer-stylus to 2.0.1

3.1.1 (2020/09/06)

Fix

1. Fixed a bug where 'hour' was not found after closing the last push date.
2. Fixed a bug where JavaScript errors occurred in older versions of Safari when PrismJS was enabled.

3.1.0 (2020/08/31)

Breaking Change

1. Only supports hexo versions 4.2.0 and above.
2. butterfly.yml now uses deepMerge to merge with the _config file instead of replacing it.

Feature

1. Adapted prismjs for hexo 5.0.0, including code themes and various features.

2. Adapted prismjs caption for hexo 5.1.0.

3. Mobile sidebar submenus can now be hidden.

   1 2	+# Hide the child menu items in mobile sidebar +hide_sidebar_menu_child: false

4. Added smooth scrolling effect when clicking on toc when the width is less than 1024.

5. Configurable font size and changed code-font to code-font-family in the configuration.

   1 2 3 4 5 6

   font: + global-font-size: + code-font-size: font-family: - code-font: + code-font-family:

6. Changed some CSS from 'px' to 'em' to adapt to changes in font size values.

7. Added exclude configuration for pjax.

   1 2 3 4

   -pjax: false +pjax: + enable: false + exclude:

8. Added cnzz_analytics.

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18

   # Analysis # -------------------------------------- # Baidu Analytics # https://tongji.baidu.com/web/welcome/login baidu_analytics: # Google Analytics # https://analytics.google.com/analytics/web/ google_analytics: # Tencent Analytics # https://mta.qq.com/ tencent_analytics: #500727214 +# CNZZ Analytics +# https://www.umeng.com/ +cnzz_analytics:

9. Changed Tencent Analytics to Tencent Mobile Analytics and adapted it for pjax.

10. Added position sticky to aside.

11. Changed the way addtoany items are written.

    1 2 3 4 5 6 7 8 9 10 11

    addtoany: enable: false - item: - - facebook - - twitter - - wechat - - sina_weibo - - facebook_messenger - - email - - copy_link +item: facebook,twitter,wechat,sina_weibo,facebook_messenger,email,copy_link

12. Added display of last update time and post count configuration to aside.

    1 2 3 4 5 6

    aside: - card_webinfo: true + card_webinfo: + enable: true + post_count: true + last_push_date: true

13. Added newest comments widget to aside.

    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17

    +newest_comments: + enable: false + limit: 6 + avatar: true + leancloud: + enable: false ++ appId: # leancloud application app id + appKey: # leancloud application app key + serverURL: # This configuration is suitable for domestic custom domain name users, overseas version will be automatically detected (no need to manually fill in) + default_avatar: mp # mp/identicon/monsterid/wavatar/retro/robohash/blank + github_issues: + enable: false + repo: + disqus: + enable: false + forum: + api_key:

Improvements

1. Changed the layout of "archives" and "card-post" to use flexbox.
2. Added a scroll offset of 60px when scrolling up to avoid the navigation bar blocking the content.
3. Switched from using cookies to store data to using localStorage.
4. Made it possible to configure individual theme colors in the settings, instead of having to enable all of them.
5. Adjusted the display of "webinfo" when the width is small.
6. Adjusted the padding of content in the "aside" section.
7. When using Pjax, the page will now scroll to the last viewed position when refreshed.
8. Fixed a bug where mathjax content was overflowing the screen.
9. Made some CSS adjustments and HTML optimizations.
10. Removed the theme-color configuration in the PWA, now using the default generated meta theme-color.
11. Added "view more" links to "card-categories" and "card-archives".
12. Changed the code names to be all uppercase.

Fix

1. Fixed a bug where the configuration of "canvas_nest" was not being applied.
2. Fixed a bug where the "rightsize-bottom" configuration was not working.
3. Fixed a bug where code blocks had a background in dark mode when rendering was disabled.
4. Fixed a bug where code blocks in the "tags-toggle" plugin were displayed as a single line.
5. Fixed a bug where code blocks in the "tags-toggle" plugin were compressed to a single line when rendering was disabled.
6. Fixed a bug in the "modern" style where the "note" plugin did not have a background color and the text was not clear in dark mode when tags were not used.
7. Fixed a bug where the corners of article covers on the homepage had small white edges in dark mode.
8. Fixed a bug in the "note" plugin where code blocks were displaying a background color.
9. Fixed a bug where the scroll percentage of the table of contents was inaccurate.
10. Fixed a bug where an error was thrown when comments were not configured.
11. Fixed a bug where related article covers were not displayed in subdirectories of the website.

Remove

1. Removed the font zoom in/out buttons.
2. Removed the default code theme.

3.0.1 (2020/08/11)

Fix

1. Fixed a bug where the navigation sidebar did not have the entrance effect.
2. Fixed a bug in versions below Hexo 5.0.0 where the table of contents (TOC) did not scroll when encountering Chinese characters.
3. Fixed bugs related to using Open Graph meta and Livere simultaneously under pjax. The source page displayed in the Livere comment backend was different from the actual page.

3.0.0 (2020/08/05)

Fix

1. Fixed a bug where lazyload was not working on the article page.
2. Fixed another bug where lazyload was not working on the article page.

3.0.0-RC2 (2020/08/01)

Breaking Change

1. Added support for dual comment system configuration/comment configuration organization/comment lazyload.

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37

   +comments: + # Up to two comments system, the first will be shown as default + # Choose: Disqus/Disqusjs/Livere/Gitalk/Valine/Utterances/Facebook Comments + use: + # - Valine + # - Disqus + text: true # Display the comment name next to the button + # lazyload: The comment system will be load when comment element enters the browser's viewport. + # If you set it to false, the comment count will be invalid + lazyload: false + count: false # Display comment count in top_img disqus: - enable: false - count: false # dispaly comment count in top_img disqusjs: - enable: false - count: false # dispaly comment count in top_img livere: - enable: false gitalk: - enable: false - count: false # dispaly comment count in top_img valine: - enable: false # if you want use valine,please set this value is true - count: false # dispaly comment count in top_img utterances: - enable: false facebook_comments: - enable: false - count: false

2. Organized the footer configuration and modified some language. #279

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20

   -since: 2020 -footer_custom_text: -footer_copyright: true -ICP: - enable: false - url: - text: - icon: /img/icp.png +footer: + owner: + enable: true + since: 2020 + custom_text: + copyright: true # Copyright of theme and framework + ICP: # Chinese ICP License + enable: false + url: + text: + icon: /img/icp.png

3. Removed the 'Add Bookmark' feature and added a configurable button.

   1 2 3 4 5 6 7 8

   aside: card_author: enable: true description: + button: + icon: fab fa-github + text: Follow Me + link: https://github.com/xxxxxx

4. Added a character limit configuration for the copied copyright, only adding copyright information if it exceeds a certain number of characters.

   1 2 3 4 5 6

   copy: enable: true - copyright: false + copyright: + enable: false + limit_count: 50

5. Added the ability to sort aside recent posts by publish date or update date.

   1 2 3 4 5

   aside: card_recent_post: enable: true limit: 5 # if set 0 will show all + sort: date # date or updated

6. Updated the CDN for typed.js/meting.

   1 2 3 4 5

   -typed: https://cdn.jsdelivr.net/npm/typed.js -meting_js: https://cdn.jsdelivr.net/npm/meting@1.2.0/dist/Meting.min.js +typed: https://cdn.jsdelivr.net/npm/typed.js/lib/typed.min.js +meting_js: https://cdn.jsdelivr.net/gh/metowolf/MetingJS@1.2/dist/Meting.min.js

Feature

1. Added an outdated notice for posts.

   1 2 3 4 5 6 7 8

   +# Displays outdated notice for a post +noticeOutdate: + enable: false + style: flat # style: simple/flat + limit_day: 500 # When will it be shown + position: top # position: top/bottom + message_prev: It has been + message_next: days since the last update, the content of the article may be outdated.

2. Added a new code block color scheme for Mac light.

3. Added the ability to configure copyright for individual posts.

4. Adjusted the display of category names in card-category to fit in one line.

5. Improved the traditional and simplified Chinese conversion, including the conversion of placeholders.

6. Introduced CSS variables to reduce CSS file size.

7. Added Pjax [Beta] support.

   1 2 3 4

   +# Pjax [Beta] +# It may contain bugs and unstable, give feedback when you find the bugs. +# https://github.com/MoOx/pjax +pjax: false

8. Added support for the third-party chat service Crisp.

   1 2 3 4 5

   +# crisp +# https://crisp.chat/en/ +crisp: + enable: false + website_id:

9. Added auto ad configuration for Google AdSense to reduce unnecessary JavaScript loading.

   1 2 3 4 5 6

   google_adsense: enable: false + auto_ads: true js: https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js client: enable_page_level_ads: true

10. When post_asset_folder is set to true, the top_img and cover of a post can directly reference images in the same-named folder by just specifying the image name and extension. #270

11. Added Yandex Webmaster tools verification configuration.

    1 2 3

    +# Yandex Webmaster tools verification setting +# see https://webmaster.yandex.com/ +yandex_site_verification:

12. Added the ability to configure whether post-meta displays text.

    1 2 3 4 5 6 7 8 9 10 11

    post_meta: page: # Home Page date_type: created # created or updated or both categories: true # true or false tags: false # true or false + label: true # true or false post: date_type: both # created or updated or both categories: true # true or false tags: true # true or false + label: true # true or false

13. Adjusted the display of post-meta on mobile devices and added support for displaying categories.

14. Changed the scrollbar color of code blocks to match the code theme.

15. Added lazyload for avatars and reward images.

16. Improved the loading speed of highlight-tool.

17. Added the ability to switch themes for disqus/disqusjs/facebook comments with the night mode button.

18. Upgraded mathjax to version 3.

19. pangu.js now only renders the body-wrap area.

20. Limited the font size increase and decrease to a range of 10px to 20px.

21. Updated the Google Analytics code (gtag).

22. Removed blueimp_md5 js.

    1	-blueimp_md5: https://cdn.jsdelivr.net/npm/blueimp-md5/js/md5.min.js

23. Made minor adjustments to the night mode and reading mode.

Fix

1. Fixed a bug where the button in the bottom right corner was being blocked by the button tag plugin.
2. Fixed a bug where opening photofigcaption caused interface distortion in the gallery.
3. Fixed a bug where the tabs plugin conflicted with the aplayer plugin.
4. Adjusted the spacing of the aplayer.
5. Fixed a bug where the highlight_shrink and toc in the article's front-matter caused JavaScript errors when empty.
6. Fixed a bug where using the BUTTON tag nested in other tags resulted in different styles due to the generation of extra br tags.
7. Fixed a bug where mobile-sidebar couldn't scroll on some devices.
8. Fixed a bug where text overflowed in certain elements on the article page.
9. Adjusted the layout when card-category has a shrink button.
10. Fixed a bug where loading files failed when configuring PWA parameters and the website is in a subdirectory.
11. Fixed a bug where the hexo douban plugin showed null images when clicking on the previous/next page.
12. Adapted to hexo 5.0.0 and fixed a bug where toc didn't jump when clicked.
13. Adapted to hexo 5.0.0 and fixed a bug where toc didn't scroll with the article.
14. Fixed a bug where the requiredFields setting in Valine was ineffective when set to empty.
15. Adjusted the margin of ol, ul, and li in the mobile interface.
16. Fixed a bug where the width of Facebook comments was not 100% on mobile.
17. Fixed a bug where share.js shared articles with the same image.
18. Removed the underline of the a tag when the note tag plugin is set to modern.
19. Corrected some incorrect HTML structures.
20. Fixed a bug where the alt attribute of fancybox displayed as undefined.
21. Fixed a bug where the ICP text in the footer with a blue background was unclear when hovered.

3.0.0-RC1 (2020/06/16)

Breaking Change

1. Starting from version 3.0, IE browser is no longer supported.

2. Forced to use fontawesome v5 (this will affect some custom icons, please replace them with v5 icons).

   1 2 3 4 5 6 7 8 9 10

   -# fontawesome icons -# By default, fontawesome v4 icons are used -fontawesome_v5: - enable: false CDN: - # fontawesome - fontawesome_v4: https://cdn.jsdelivr.net/npm/font-awesome@latest/css/font-awesome.min.css - fontawesome_v5: https://cdn.jsdelivr.net/npm/@fortawesome/fontawesome-free/css/all.min.css + fontawesome: https://cdn.jsdelivr.net/npm/@fortawesome/fontawesome-free/css/all.min.css

3. Changes in _config.yml

   1. Simplified baidu_push/instantpage/click_heart/readmode/footer_copyright/medium_zoom/fancybox configurations.

      1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28

      -baidu_push: - enable: false -instantpage: - enable: true -click_heart: - enable: false -readmode: - enable: true -footer_copyright: - enable: true -medium_zoom: - enable: false -fancybox: - enable: true +baidu_push: false +instantpage: true +click_heart: false +readmode: true +footer_copyright: true +medium_zoom: false +fancybox: true

   2. Changed runtimeshow's start_date to publish_date.

      1 2 3 4

      runtimeshow: enable: true - start_date: 6/7/2018 00:00:00 + publish_date: 6/7/2018 00:00:00

   3. Renamed laibili to LiveRe.

      1 2 3 4

      -laibili: +livere: enable: false uid:

   4. Changed hr to hr_icon, which can be used to cancel the icon.

      1 2 3 4 5 6

      # Horizontal line -hr: +hr_icon: enable: true icon: # Unicode of the icon on fontawesome icon-top:

   5. Changed loading_bg to error_img, and moved post-loading to lazyload.

      1 2 3 4 5 6 7 8 9

      -lodding_bg: +error_img: flink: /img/friend_404.gif # Image after 404 post_page: /img/404.jpg # Image after 404 - post: /img/loading.gif # Loading animation lazyload: enable: true + post: /img/loading.gif # Loading animation

   6. Pangu's field configuration can only be set to site/post.

      1 2 3 4

      pangu: enable: true - field: page # page/post + field: site # site/post

   7. Integrated auto_open_sidebar into toc.

      1 2 3 4 5 6 7 8

      toc: enable: true number: true + auto_open: true # auto open the sidebar -# auto open the sidebar in 'post' -auto_open_sidebar: - enable: true

   8. Removed enable configuration for font.

      1 2 3 4 5 6 7 8

      # Global font font: - enable: false - font-family: Lato, Helvetica Neue For Number, -apple-system, BlinkMacSystemFont, Segoe UI, Roboto, PingFang SC, Hiragino Sans GB, MicrMicrosoft YaHei", Helvetica Neue, Helvetica, Arial, sans-serif - code-font: consolas, Menlo, "PingFang SC", "Microsoft YaHei", monospace, Helvetica Neue For Number + font-family: + code-font:

   9. Removed some configurations.

      1 2 3 4 5 6 7

      valine: - notify: false # valine mail notify (true/false) Deprecated in v1.4.0+ - verify: false # valine verify code (true/false) Deprecated in v1.4.0+ translate: - # Blog URL - cookieDomain: 'https://xxx/'

   10. Removed twitter_meta configuration.

       1 2 3

       -# Automatically add styles to Twitter shares -# -https://i.loli.net/2019/09/08/qm3RfvUCKbct1Wz.png -twitter_meta: true

Feature

1. Table width now occupies the full width of the display.

2. Added system Dark Mode switch monitoring. The theme will switch immediately when the system switches to Dark Mode.

3. card_description now supports HTML writing.

4. Dark Mode and Light Mode switch button icons have been changed.

5. Adapted to the built-in Pullquote tag in Hexo.

6. Added dns-prefetch to the links for Baidu Push.

7. Set canonical to be generated by default and no longer provide configuration.

   1 2	-# Avoid duplicate URLs and SEO dispersion -canonical: true

8. Added defer to the instantpage JavaScript loading.

9. Added zIndex configuration to fireworks.

   1 2 3

   fireworks: enable: false + zIndex: 9999 # -1 or 9999

10. New Tag Plugin - button.

11. New Tag Plugin - tabs.

12. Configurable justifiedGallery CDN.

    1 2 3 4

    CDN: + # justifiedGallery + justifiedGallery_js: https://cdn.jsdelivr.net/npm/justifiedGallery/dist/js/jquery.justifiedGallery.min.js + justifiedGallery_css: https://cdn.jsdelivr.net/npm/justifiedGallery/dist/css/justifiedGallery.min.css

13. New design for the 404 page.

14. aplayer js/css can now be configured in the front-matter of the post to prevent inserting code on every page.

    1 2 3 4 5

    CDN: + # aplayer + aplayer_css: https://cdn.jsdelivr.net/npm/aplayer/dist/APlayer.min.css + aplayer_js: https://cdn.jsdelivr.net/npm/aplayer/dist/APlayer.min.js + meting_js: https://cdn.jsdelivr.net/npm/meting@1.2.0/dist/Meting.min.js

15. Added online chat services (chatra/tidio/daovoice/gitter) and the ability to replace the original chat button with a theme chat button.

    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30

    +# Chat Button [recommend] +# It will create a button in the bottom right corner of website, and hide the origin button +chat_btn: false +# The origin chat button is displayed when scrolling up, and the button is hidden when scrolling down +chat_hide_show: false +# chatra +# https://chatra.io/ +chatra: + enable: false + id: +# tidio +# https://www.tidio.com/ +tidio: + enable: false + public_key: +# daovoice +# http://daovoice.io/ +daovoice: + enable: false + app_id: +# gitter +# https://gitter.im/ +gitter: + enable: false + room:

16. Configurable distance between rightside button and the bottom.

    1 2	+# Distance between the right bottom button and the bottom (default unit is px) +rightside-bottom:

17. Changed lazyload service provider.

    1 2 3

    CDN: -lazyload: https://cdn.jsdelivr.net/npm/lozad/dist/lozad.min.js +lazyload: https://cdn.jsdelivr.net/npm/vanilla-lazyload/dist/lazyload.iife.min.js

18. Added expand/collapse button to card-categories.

    1 2 3 4 5

    aside: card_categories: enable: true limit: 8 # if set 0 will show all + expand: none # none/true/false

19. Changed auto_excerpt to index_post_content, and added three methods to choose from.

    1 2 3 4 5 6 7 8 9 10 11 12

    -# Automatic excerpt -auto_excerpt: - enable: true - length: 150 +# Display the article introduction on homepage +# 1: description +# 2: both (if the description exists, it will show description. or show the auto_excerpt) +# 3: auto_excerpt (default) +index_post_content: + method: 3 + length: 500 # if you set method to 2 or 3, the length need to config

20. Can individually set auto_open: false in the post to turn off the automatic opening of the sidebar.

21. Optimized friend links interface code, added category description, and made category name and description optional. Changed the format of the friend links yml (the old format is still valid).

22. Added highlight_shrink to the front-matter of the post/page (true or false).

23. Code box optimization

    1. Adjusted some code colors
    2. Added a code theme called "mac"
    3. Code box themes now support customization

24. Removed code highlighting in reading mode

25. Updated js/css versions of disqusjs, added nocomment configuration

    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17

    disqusjs: enable: false shortname: siteName: apikey: - api: https://disqus.skk.moe/disqus/ # No need to modify API address in most cases + api: + nocomment: # Display when a blog post or an article has no comment attached admin: adminLabel: count: false # Display comment count in top_img CDN: - disqusjs: https://cdn.jsdelivr.net/npm/disqusjs@1.2/dist/disqus.js - disqusjs_css: https://cdn.jsdelivr.net/npm/disqusjs@1.2/dist/disqusjs.css + disqusjs: https://cdn.jsdelivr.net/npm/disqusjs@1/dist/disqus.js + disqusjs_css: https://cdn.jsdelivr.net/npm/disqusjs@1/dist/disqusjs.css

26. Added link configuration for rewards / Changed reward format (old format still works) #240

    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

    # Reward button reward: enable: true QR_code: - - itemlist: - img: /img/wechat.jpg - text: WeChat - - itemlist: - img: /img/alipay.jpg - text: Alipay + - img: /img/wechat.jpg + link: + text: WeChat + - img: /img/alipay.jpg + link: + text: Alipay

27. Removed JS-COOKIES

    1 2	CDN: - js_cookies: https://cdn.jsdelivr.net/npm/js-cookie/dist/js.cookie.min.js

28. Added ability to configure whether TOC (Table of Contents) is displayed for articles, even if toc is set to false in the configuration

Fix

1. Fixed alignment issues with sidebar directory collapse/expand icons
2. Modified some language (zh-CN/zh-TW/en)
3. Fixed bugs where clicking on card-categories and card-archives didn't navigate
4. Fixed bugs where social media links generated incorrect addresses when the website was in a subdirectory
5. Fixed bug where Pagination didn't occupy full width for the last article
6. Fixed bug where recommended articles layout didn't display correctly on Microsoft Edge (old version)
7. Fixed bug where font in black code box was not clear in reading mode #223
8. Fixed bug where preconnect //fonts.googleapis.com was loaded when blog_title_font was not set to a Google font
9. Fixed bug where setting copy to false prevented code copying
10. Adjusted reading mode
11. Fixed bugs where some compression software reported errors when compressing HTML

2.3.5 (2020/05/01)

Feature

1. Added the ability to configure the beautify feature to apply to the entire site or just the post pages (#218).

   1 2 3 4 5

   beautify: enable: true + field: post # site/post title-prefix-icon: '\f0c1' title-prefix-icon-color: '#F47466'

2. Updated the lazyload JavaScript library.

   1 2 3 4 5 6 7 8 9 10

   -lazyload: - enable: true +lazyload: true CDN: - lazyload: https://cdn.jsdelivr.net/npm/lazysizes@latest/lazysizes.min.js + lazyload: https://cdn.jsdelivr.net/npm/lozad/dist/lozad.min.js

3. Added the ability to configure anchors for articles.

   1 2 3

   + # anchor + # when you scroll in post , the url will update according to header id. + anchor: false

Fix

1. Fixed a bug where an error "Cannot read property 'trim' of undefined" would occur when a menu icon was not set.
2. Fixed a bug where the meta description was not properly escaped when automatically generating the first 200 characters of an article.
3. Fixed a bug where images were not displayed when using `` after enabling lazyload.
4. Fixed a bug where only 8 tags were displayed on the tags page.
5. Fixed a bug where local images were not displayed when the blog root was not '/'.
6. Fixed a bug where replacing the URL hash caused the page to jump.

2.3.0(2020/04/26)

Breaking Change

1. Added Facebook Comments

   1 2 3 4 5 6 7 8 9 10

   +# Facebook Comments Plugin +# https://developers.facebook.com/docs/plugins/comments/ +facebook_comments: + enable: false + app_id: + user_id: # optional + pageSize: 10 # The number of comments to show + order_by: social # social/time/reverse_time + lang: en_US # Language en_US/zh_CN/zh_TW and so on + count: false

2. Added page loading animation Preloader #193

   1 2	+# Loading Animation +preloader: false

3. Configurable aside card-tags to show color or not/aside subtitle is configurable, priority is given to the configured content, if not available, show page subtitle #191 / Configurable parameters added to aside widget/aside widget's Categories, Tags, post, Archives can be configured with limit/Integrate announcement configuration into aside

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38

   aside: enable: true mobile: true # Whether to show aside content on mobile pages (display width < 768px) position: right # left or right - card_author: true - card_announcement: true - card_recent_post: true - card_categories: true - card_tags: true - card_archives: true + card_author: + enable: true + description: + card_announcement: + enable: true + content: This is my Blog + card_recent_post: + enable: true + limit: 5 # if set 0 will show all + card_categories: + enable: true + limit: 8 # if set 0 will show all + card_tags: + enable: true + limit: 40 # if set 0 will show all + color: false + card_archives: + enable: true + type: monthly # yearly or monthly + format: MMMM YYYY # eg: YYYY年MM月 + order: -1 # Sort of order. 1, asc for ascending; -1, desc for descending + limit: 8 # if set 0 will show all card_webinfo: true -# Website Announcement -announcement: - content: Thank you for visiting this site, please bookmark ^_^

4. Changed CDN_USE to inject, can insert code into head or bottom

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28

   -# CDN -# Required for the website -# Add js/css as needed -CDN_USE: - css: - - /css/index.css - js: - - https://cdn.jsdelivr.net/npm/jquery@latest/dist/jquery.min.js #/js/third-party/jquery.min.js - - /js/utils.js - - /js/main.js +# inject +# Insert code before </head> and before </body> +inject: + head: + # - <link rel="stylesheet" href="xxxxx"> + bottom: + # - <script src="xxxx"></script> # CDN # Do not modify if not necessary CDN: + # main + main_css: /css/index.css + jquery: https://cdn.jsdelivr.net/npm/jquery@latest/dist/jquery.min.js + main: /js/main.js + utils: /js/utils.js

5. Adapted to valine version 1.4.5 and above

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18

   valine: enable: false # if you want use valine,please set this value is true appId: # leancloud application app id appKey: # leancloud application app key notify: false # valine mail notify (true/false) Deprecated in v1.4.0+ verify: false # valine verify code (true/false) Deprecated in v1.4.0+ pageSize: 10 # comment list page size avatar: monsterid # gravatar style https://valine.js.org/#/avatar lang: en # i18n: zh-CN/zh-TW/en/ja placeholder: Please leave your footprints # valine comment input placeholder(like: Please leave your footprints ) guest_info: nick,mail,link #valine comment header info recordIP: false # Record reviewer IP serverURLs: # This configuration is suitable for domestic custom domain name users, overseas version will be automatically detected (no need to manually fill in) + emojiCDN: # emoji CDN + enableQQ: false # enable the Nickname box to automatically get QQ Nickname and QQ Avatar + requiredFields: nick,mail # required fields nick/mail/link bg: /img/comment_bg.png # valine background count: false # dispaly comment count in top_img

6. Removed support for hiding articles.