diff --git a/docs/content/themes/anatole-zola/index.md b/docs/content/themes/anatole-zola/index.md index 2f3e8c9831..132f93d60f 100644 --- a/docs/content/themes/anatole-zola/index.md +++ b/docs/content/themes/anatole-zola/index.md @@ -3,14 +3,14 @@ title = "anatole-zola" description = "A port of farbox-theme-Anatole for zola" template = "theme.html" -date = 2024-10-27T15:53:15+01:00 +date = 2025-02-21T01:54:46+01:00 [taxonomies] theme-tags = [] [extra] -created = 2024-10-27T15:53:15+01:00 -updated = 2024-10-27T15:53:15+01:00 +created = 2025-02-21T01:54:46+01:00 +updated = 2025-02-21T01:54:46+01:00 repository = "https://github.com/longfangsong/anatole-zola.git" homepage = "https://github.com/longfangsong/anatole-zola" minimum_version = "0.4.0" diff --git a/docs/content/themes/apollo/index.md b/docs/content/themes/apollo/index.md index 77dd3b3a5e..9e7633bfa7 100644 --- a/docs/content/themes/apollo/index.md +++ b/docs/content/themes/apollo/index.md @@ -3,14 +3,14 @@ title = "apollo" description = "Modern and minimalistic blog theme" template = "theme.html" -date = 2025-02-15T16:02:55+01:00 +date = 2025-02-18T18:52:04+01:00 [taxonomies] theme-tags = [] [extra] -created = 2025-02-15T16:02:55+01:00 -updated = 2025-02-15T16:02:55+01:00 +created = 2025-02-18T18:52:04+01:00 +updated = 2025-02-18T18:52:04+01:00 repository = "https://github.com/not-matthias/apollo.git" homepage = "https://github.com/not-matthias/apollo" minimum_version = "0.14.0" diff --git a/docs/content/themes/homepage-creators/index.md b/docs/content/themes/homepage-creators/index.md index 4928d8caac..6baaf56838 100644 --- a/docs/content/themes/homepage-creators/index.md +++ b/docs/content/themes/homepage-creators/index.md @@ -3,14 +3,14 @@ title = "homepage-creators" description = "A fast and beautiful personal homepage for creators, used by https://jiaxiang.wang, a port of HeoWeb." template = "theme.html" -date = 2025-02-05T09:21:16+08:00 +date = 2025-02-28T17:31:40+08:00 [taxonomies] theme-tags = [] [extra] -created = 2025-02-05T09:21:16+08:00 -updated = 2025-02-05T09:21:16+08:00 +created = 2025-02-28T17:31:40+08:00 +updated = 2025-02-28T17:31:40+08:00 repository = "https://github.com/iWangJiaxiang/Homepage-Creators.git" homepage = "https://github.com/iWangJiaxiang/homepage-for-creators" minimum_version = "0.19.2" diff --git a/docs/content/themes/hook/index.md b/docs/content/themes/hook/index.md index e5eeff3f2a..fbe34f9173 100644 --- a/docs/content/themes/hook/index.md +++ b/docs/content/themes/hook/index.md @@ -3,17 +3,17 @@ title = "Hook" description = "Clean and simple personal site/blog theme" template = "theme.html" -date = 2025-01-27T01:10:42+01:00 +date = 2025-02-17T14:22:24+01:00 [taxonomies] theme-tags = [] [extra] -created = 2025-01-27T01:10:42+01:00 -updated = 2025-01-27T01:10:42+01:00 +created = 2025-02-17T14:22:24+01:00 +updated = 2025-02-17T14:22:24+01:00 repository = "https://github.com/InputUsername/zola-hook.git" homepage = "https://github.com/InputUsername/zola-hook" -minimum_version = "0.15.2" +minimum_version = "0.19.0" license = "MIT" demo = "https://inputusername.github.io/zola-hook/" diff --git a/docs/content/themes/kita/index.md b/docs/content/themes/kita/index.md index 4fce473035..ef09cbc643 100644 --- a/docs/content/themes/kita/index.md +++ b/docs/content/themes/kita/index.md @@ -3,19 +3,19 @@ title = "Kita" description = "Kita is a clean, elegant and simple blog theme for Zola." template = "theme.html" -date = 2025-01-19T09:47:39+08:00 +date = 2025-02-19T22:07:30+08:00 [taxonomies] theme-tags = [] [extra] -created = 2025-01-19T09:47:39+08:00 -updated = 2025-01-19T09:47:39+08:00 +created = 2025-02-19T22:07:30+08:00 +updated = 2025-02-19T22:07:30+08:00 repository = "https://github.com/st1020/kita.git" homepage = "https://github.com/st1020/kita" minimum_version = "0.17.0" license = "MIT" -demo = "https://st1020.github.io/kita/" +demo = "https://kita-zola.pages.dev" [extra.author] name = "st1020" @@ -28,7 +28,7 @@ Kita is a clean, elegant and simple blog theme for Zola. This theme is based on Hugo theme [hugo-paper](https://github.com/nanxiaobei/hugo-paper) with some features added. -[Demo](https://st1020.github.io/kita/) +[Demo](https://kita-zola.pages.dev)  diff --git a/docs/content/themes/linkita/index.md b/docs/content/themes/linkita/index.md index d9f2ee5839..d77d47c659 100644 --- a/docs/content/themes/linkita/index.md +++ b/docs/content/themes/linkita/index.md @@ -3,14 +3,14 @@ title = "Linkita" description = "A clean and elegant blog theme for Zola. Linkita is based on Kita and Hugo-Paper and is multilingual and SEO friendly." template = "theme.html" -date = 2025-02-16T19:22:57+02:00 +date = 2025-02-17T21:35:09+02:00 [taxonomies] theme-tags = ['Blog', 'Multilingual', 'Responsive', 'SEO', 'Search'] [extra] -created = 2025-02-16T19:22:57+02:00 -updated = 2025-02-16T19:22:57+02:00 +created = 2025-02-17T21:35:09+02:00 +updated = 2025-02-17T21:35:09+02:00 repository = "https://codeberg.org/salif/linkita.git" homepage = "https://codeberg.org/salif/linkita" minimum_version = "0.19.0" diff --git a/docs/content/themes/project-portfolio/index.md b/docs/content/themes/project-portfolio/index.md index ffc8a86895..d7ad697d87 100644 --- a/docs/content/themes/project-portfolio/index.md +++ b/docs/content/themes/project-portfolio/index.md @@ -3,14 +3,14 @@ title = "Project Portfolio" description = "Theme for a project portfolio (based on Tailwind CSS)." template = "theme.html" -date = 2025-02-05T12:32:43+01:00 +date = 2025-02-28T20:53:32+01:00 [taxonomies] theme-tags = [] [extra] -created = 2025-02-05T12:32:43+01:00 -updated = 2025-02-05T12:32:43+01:00 +created = 2025-02-28T20:53:32+01:00 +updated = 2025-02-28T20:53:32+01:00 repository = "https://github.com/awinterstein/zola-theme-project-portfolio.git" homepage = "https://github.com/awinterstein/zola-theme-project-portfolio" minimum_version = "0.9.0" diff --git a/docs/content/themes/radion/index.md b/docs/content/themes/radion/index.md index 2d0ac98972..71783d9fa6 100644 --- a/docs/content/themes/radion/index.md +++ b/docs/content/themes/radion/index.md @@ -3,14 +3,14 @@ title = "radion" description = "A sleek, modern blog theme." template = "theme.html" -date = 2025-02-14T12:54:34-06:00 +date = 2025-03-02T14:11:58-06:00 [taxonomies] -theme-tags = [] +theme-tags = ['SEO', 'search', 'accessible'] [extra] -created = 2025-02-14T12:54:34-06:00 -updated = 2025-02-14T12:54:34-06:00 +created = 2025-03-02T14:11:58-06:00 +updated = 2025-03-02T14:11:58-06:00 repository = "https://github.com/micahkepe/radion.git" homepage = "https://github.com/micahkepe/radion" minimum_version = "0.19.2" @@ -24,24 +24,26 @@ homepage = "https://micahkepe.com" # radion -A sleek, modern blog theme for [Zola](https://www.getzola.org/). See the live +A sleek, modern blog theme for [Zola](https://www.getzola.org/). See the live site demo [here](https://micahkepe.com/radion/). -> **radion** -> noun -> 1. (*physics*) A scalar field in higher-dimensional spacetimes +> **radion** +> noun > +> 1. (_physics_) A scalar field in higher-dimensional spacetimes <details open> <summary>Dark theme</summary>  + </details> <details> <summary>Light theme</summary>  + </details> ## Features @@ -52,6 +54,8 @@ site demo [here](https://micahkepe.com/radion/). - [x] Light/Dark mode support - [x] Search functionality - [x] Table of Contents option +- [x] Footnote support +- [x] Built-in comments option (Giscus) ## Contents and Configuration Guide @@ -60,12 +64,14 @@ site demo [here](https://micahkepe.com/radion/). - Top menu - Title - Author + - Favicon - GitHub - Code Snippets - LaTex Support - Searchbar - Light and Dark Modes - Table of Contents + - Comments - Acknowledgements ## Installation @@ -150,6 +156,22 @@ date = 1970-01-01 author = "John Smith" ``` +### Favicon + +To change the default favicon, create your own favicon folder with the following +site: [RealFaviconGenerator](https://realfavicongenerator.net/), setting the +'Favicon path' option to `/icons/favicon/`. Unzip the created folder, then +create a `static/icons/` directory if it does not already exist, and then place +the unzipped `favicon/` directory in `static/icons/`. + +By default, favicons are enabled, however, if for some reason you would like to +disable favicons, set the following in your `config.toml`: + +```toml +[extra] +favicon = false +``` + ### GitHub To enable a GitHub reference link in the header, set the following in your @@ -231,6 +253,39 @@ of the page: toc = true ``` +### Comments + +> [!NOTE] +> Giscus comments assumes that you are hosting the blog site via GitHub Pages +> and thus have access to GitHub Discussions. + +First, follow the instructions at [giscus.app](https://giscus.app/). +This includes installing the Giscus app and enabling discussions on the +GitHup repository that you host the website code. Additionally, fill in the +repository path in the prompt. Then, from the generated script, fill in the +corresponding values in the `config.toml`: + +```toml +[extra] +comments = true # {true, false}; sets global enabling of comments by default +giscus_repo = "FILL ME IN" +giscus_repo_id = "FILL ME IN" +giscus_data_category_id = "FILL ME IN" +``` + +Comments can be enabled or disabled on a per page basis by editing the page's +front matter. For example, to disable comments on a specific post: + +```toml +[extra] +comments = false +``` + +The `config.toml` value for `comments` takes precedence and priority. For +example, if you globally disable comments in your `config.toml` by setting +`comments = false`, then trying to enabling comments through a page's front +matter will have no effect. + ## Acknowledgements Lots of inspiration and code snippets taken from these awesome Zola themes: diff --git a/docs/content/themes/tranquil/index.md b/docs/content/themes/tranquil/index.md index 44b1a1c9e6..aace1f7c2f 100644 --- a/docs/content/themes/tranquil/index.md +++ b/docs/content/themes/tranquil/index.md @@ -3,14 +3,14 @@ title = "tranquil" description = "A blog theme for zola, simple and clean" template = "theme.html" -date = 2025-01-25T22:42:42+01:00 +date = 2025-03-01T17:19:35+01:00 [taxonomies] theme-tags = [] [extra] -created = 2025-01-25T22:42:42+01:00 -updated = 2025-01-25T22:42:42+01:00 +created = 2025-03-01T17:19:35+01:00 +updated = 2025-03-01T17:19:35+01:00 repository = "https://github.com/TeaDrinkingProgrammer/tranquil.git" homepage = "https://github.com/TeaDrinkingProgrammer/tranquil" minimum_version = "0.9.0" diff --git a/docs/content/themes/zola-theme-jiaxiang.wang/index.md b/docs/content/themes/zola-theme-jiaxiang.wang/index.md index 93b944c272..6b8ec1b671 100644 --- a/docs/content/themes/zola-theme-jiaxiang.wang/index.md +++ b/docs/content/themes/zola-theme-jiaxiang.wang/index.md @@ -3,14 +3,14 @@ title = "jiaxiang.wang" description = "A fast and beautiful theme for creators, used by https://blog.jiaxiang.wang, porting from Halo-theme-hao." template = "theme.html" -date = 2025-02-05T11:11:12+08:00 +date = 2025-02-27T22:27:38+08:00 [taxonomies] theme-tags = [] [extra] -created = 2025-02-05T11:11:12+08:00 -updated = 2025-02-05T11:11:12+08:00 +created = 2025-02-27T22:27:38+08:00 +updated = 2025-02-27T22:27:38+08:00 repository = "https://github.com/iWangJiaxiang/zola-theme-jiaxiang.wang" homepage = "https://github.com/iWangJiaxiang/zola-theme-jiaxiang.wang" minimum_version = "0.19.2" @@ -72,6 +72,7 @@ homepage = "https://blog.jiaxiang.wang" - [x] 右键菜单 - [x] Pjax - [ ] i18n 国际化 + - [x] AVIF 图片格式支持 - [ ] 文章摘要 - [x] 抽取本地文章描述 - [ ] 基于 Post GPT by Tianli