Happy New Year 2024 to all! (v0.3.0)

Note

There's a patch release out already, see https://github.com/hugo-fixit/FixIt/releases/tag/v0.3.1

---

Snapshot: https://fixit-b232h90uu-cell-x.vercel.app

Upgrade guide

The FixIt theme is still under active development in the 0.x stage, so some configuration changes will inevitably occur during the upgrade process. Nothing could ever be ready, just go ahead and fix it! Thank you all for your love and understanding.

1. Migrate author configuration to params.author, e.g. hugo-fixit/docs@81b1fc9

2. Update taxonomies configuration and add Colloections configuration, see #359 (comment). e.g. hugo-fixit/docs@717bbc4

3. The type: friends in front matter is deprecated. use layout: friends instead.

4. The type: offline page is deprecated, migrate to build-in page.

   1. add outputFormats.offline as below:

      [outputFormats]
        # ...
        # FixIt 0.3.0 | NEW Options to make output /offline/index.html file
        [offline]
          path = "offline"
          baseName = "index"
          mediaType = "text/html"
          isPlainText = false
          isHTML = true
          permalinkable = true

   2. add "offline" in outputs.home as below:

      [outputs]
        home = ["HTML", "RSS", "JSON", "BaiduUrls", "offline"]
        # ...

   3. remove offline page in your content directory.

5. If you are using lunr search engine, please choose another one!

6. Update the outputs configuration to avoid the "taxonomyterm" warning in versions above Hugo 0.112.0, see #354 (comment).

7. Remove params.gitRepo and params.page.edit, then add params.gitInfo, e.g. 9f7bce8

There are also new features, which will not affect your use if you don’t upgrade, but We strongly recommend you upgrade. 😊

Changelog

• 🎉 Feat: add related content support (#390 resolved #227)
• 🎉 Feat: add taxonomy collections (#387 resolved #359)
• ♻️ Refactor: process theme.js with ESBuild and remove babel and core-js
• ♻️ Refactor: migrate params.gitRepo and params.page.edit to params.gitInfo
• ♻️ Refactor: use Hugo render hooks for heading link rendering
• ♻️ Refactor: refactor site footer and params.footer.powered config
• 🚚 Feat: the type: friends in front matter is deprecated. use layout: friends instead
• 🚚 Feat: migrate offline page to build-in page
• 🚨 Fix: the author key in site configuration is deprecated. use params.author instead
• 🔥 Feat: remove lunr search engine
• ✨ Feat: add archives page template (#397)
• ✨ Feat: add code block attributes support (#330)
• ✨ Feat: add options to cache remote image locally (#362 fixes #348)
• ✨ Feat: add hiddenFromRss and hiddenFromRelated in page param and front matter
• ✨ Feat: add more options support for bilibili shortcode, e.g. autoplay, muted etc. (#375)
• ✨ Feat: add serial number to the table of contents of the article
• ✨ Feat: add params.navigationReverse to reverse the order of the navigation menu
• ✨ Feat: add pin icon in home post list and add repost icon in section .etc.
• ✨ Feat: add params.withSiteTitle and params.titleDelimiter to resolve #395
• ✨ Feat: add param params.indexWithSubtitle
• ✨ Feat: add options to make output readme.md and change options for baidu_urls.txt
• ⚡ Perf: optimize lightgallery images rendering
• ⚡ Perf: preload some stylesheet
• ⚡ Perf: use .LinkTitle instead of .Title
• 🔍 Feat: enhance search engine accessibility
• 🐛 Fix: use dateFormat function to render localized dates (@stefanoginobili #355)
• 🐛 Fix: total word count error in section
• 🐛 Fix: fix path errors in image src and 1.5x srcset (#346)
• 🐛 Fix: fix toc active error when breadcrumb is enabled and set sticky to true (#368)
• 🐛 Fix: add a option "Responsive" for plugin image fixed #369
• 🐛 Fix: fix featured image path error and show img tags in rss (#373)
• 🐛 Fix: disable encrypted articles from rendering to rss (#374)
• 🐛 Style: fix the emoji style of valine comment (#376)
• 🐛 Fix: active index of toc may result in error (#305)
• 💄 Style: update define list style
• 💄 Style: update footnote and footnote-ref style
• 💄 Style: optimize menu icon style
• 📝 Docs: update the outputs configuration to avoid the "taxonomyterm" warning in versions above Hugo 0.112.0 (resolve #354)
• 🔧 Chore: update default config in hugo.toml
• 🔧 Chore: update FixIt embedded archetypes
• 🔧 Chore: change the theme minimum supported Hugo versions above 0.112.0
• ⬆️ Chore(libs):
  • Update algoliasearch from 4.14.2 to 4.20.0
  • Update Artalk from 2.5.2 to 2.6.4
  • Update fontawesome-free from 6.2.0 to 6.4.2
  • Update instant.page from 5.1.1 to 5.2.0
  • Update katex from 0.16.2 to 0.16.9
  • Update lightgallery from 2.6.1 to 2.7.2
  • Removed Renren, Digg and StumbleUpon in sharer.js 0.5.0
  • Update Twikoo from 1.6.8 to 1.6.22
  • Update vConsole from 3.14.6 to 3.15.1
  • Update eruda from 2.5.0 to 3.0.1
  • Update Waline from 2.14.7 to 2.15.8
  • Update simple-icons from 7.12.0 to 9.19.0
• Full Changelog: @Lruihao v0.2.18...v0.3.0