diff --git a/docs/content/themes/academic-workshop/index.md b/docs/content/themes/academic-workshop/index.md index ec092426e..22fd509ca 100644 --- a/docs/content/themes/academic-workshop/index.md +++ b/docs/content/themes/academic-workshop/index.md @@ -3,14 +3,14 @@ title = "Academic Workshop" description = "A Zola theme for a website to list the schedule of your scientific workshop or seminar series" template = "theme.html" -date = 2024-12-03T16:12:31-05:00 +date = 2024-12-14T09:37:00-08:00 [taxonomies] theme-tags = [] [extra] -created = 2024-12-03T16:12:31-05:00 -updated = 2024-12-03T16:12:31-05:00 +created = 2024-12-14T09:37:00-08:00 +updated = 2024-12-14T09:37:00-08:00 repository = "https://github.com/aterenin/academic-workshop.git" homepage = "https://github.com/aterenin/academic-workshop" minimum_version = "0.18.0" diff --git a/docs/content/themes/duckquill/index.md b/docs/content/themes/duckquill/index.md index e673a2d4d..71b969a3f 100644 --- a/docs/content/themes/duckquill/index.md +++ b/docs/content/themes/duckquill/index.md @@ -3,14 +3,14 @@ title = "Duckquill" description = "Modern, pretty, and clean theme" template = "theme.html" -date = 2024-12-04T03:05:06+03:00 +date = 2024-12-10T00:18:25Z [taxonomies] theme-tags = [] [extra] -created = 2024-12-04T03:05:06+03:00 -updated = 2024-12-04T03:05:06+03:00 +created = 2024-12-10T00:18:25Z +updated = 2024-12-10T00:18:25Z repository = "https://codeberg.org/daudix/duckquill.git" homepage = "https://codeberg.org/daudix/duckquill" minimum_version = "0.19.0" diff --git a/docs/content/themes/linkita/index.md b/docs/content/themes/linkita/index.md index 9680ff683..d660a39be 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 = 2024-12-07T01:27:32+02:00 +date = 2024-12-11T14:35:25+02:00 [taxonomies] -theme-tags = ['Blog', 'SEO-friendly', 'Multilingual', 'Responsive'] +theme-tags = ['Blog', 'Multilingual', 'Responsive', 'SEO', 'Search'] [extra] -created = 2024-12-07T01:27:32+02:00 -updated = 2024-12-07T01:27:32+02:00 +created = 2024-12-11T14:35:25+02:00 +updated = 2024-12-11T14:35:25+02:00 repository = "https://codeberg.org/salif/linkita.git" homepage = "https://codeberg.org/salif/linkita" minimum_version = "0.19.0" @@ -26,7 +26,10 @@ homepage = "https://salif.eu" A clean and elegant blog theme for [Zola](https://www.getzola.org/). Linkita is based on [Kita](https://github.com/st1020/kita) and [Hugo-Paper](https://github.com/nanxiaobei/hugo-paper) and is multilingual and SEO friendly. -The source code is available on [Codeberg](https://codeberg.org/salif/linkita) and mirrored on [GitHub](https://github.com/salif/linkita). A live preview can be viewed in [English](https://salif.github.io/linkita/en/), [Bulgarian](https://salif.github.io/linkita/), and [Esperanto](https://salif.github.io/linkita/eo/). Screenshots are provided for both [Light mode](https://codeberg.org/salif/linkita/src/branch/linkita/screenshot.png) and [Dark mode](https://codeberg.org/salif/linkita/src/branch/linkita/screenshot.dark.png). For discussion, you can join the [Matrix chat room](https://matrix.to/#/#linkita:mozilla.org). +- The source code is available on [Codeberg](https://codeberg.org/salif/linkita) and mirrored on [GitHub](https://github.com/salif/linkita). +- Live preview in [English](https://salif.github.io/linkita/en/), [Bulgarian](https://salif.github.io/linkita/), [Esperanto](https://salif.github.io/linkita/eo/). See [demo source code](https://codeberg.org/salif/linkita-demo). +- Screenshots for [light mode](https://codeberg.org/salif/linkita/src/branch/linkita/screenshot.png), [dark mode](https://codeberg.org/salif/linkita/src/branch/linkita/screenshot.dark.png). +- For discussion, join the [Matrix chat room](https://matrix.to/#/#linkita:mozilla.org). ## Features @@ -597,7 +600,7 @@ gender = "female" # or "male" # Your Fediverse account URL # url = "" -# [extra.profiles.your_username.open_graph.languages.fr.image_alt] +# [extra.profiles.your_username.open_graph.languages.fr] # A description in French of what is in the social image # image_alt = "" ``` @@ -734,8 +737,8 @@ Open bug reports and feature requests on [Codeberg](https://codeberg.org/salif/l ## Blogs using this theme -- [salif.eu](https://salif.eu): Personal website - [Zola Themes Collection](https://salif.github.io/zola-themes-collection/) +- [salif.eu](https://salif.eu): Personal website If you use Linkita, feel free to create a pull request to add your site to this list. diff --git a/docs/content/themes/project-portfolio/index.md b/docs/content/themes/project-portfolio/index.md index 6f694bfd0..5a4d71588 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 = 2024-12-04T13:08:57+01:00 +date = 2024-12-09T20:02:25+01:00 [taxonomies] theme-tags = [] [extra] -created = 2024-12-04T13:08:57+01:00 -updated = 2024-12-04T13:08:57+01:00 +created = 2024-12-09T20:02:25+01:00 +updated = 2024-12-09T20:02:25+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 new file mode 100644 index 000000000..ce9a5a7fa --- /dev/null +++ b/docs/content/themes/radion/index.md @@ -0,0 +1,247 @@ + ++++ +title = "radion" +description = "A sleek, modern blog theme." +template = "theme.html" +date = 2024-12-17T17:19:14-08:00 + +[taxonomies] +theme-tags = [] + +[extra] +created = 2024-12-17T17:19:14-08:00 +updated = 2024-12-17T17:19:14-08:00 +repository = "https://github.com/micahkepe/radion.git" +homepage = "https://github.com/micahkepe/radion" +minimum_version = "0.19.2" +license = "MIT" +demo = "https://micahkepe.com/radion/" + +[extra.author] +name = "Micah Kepe" +homepage = "https://micahkepe.com" ++++ + +# radion + +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 +> + +
+Dark theme + +![radion dark theme screenshot](screenshot.png) +
+ +
+Light theme + +![radion light theme screenshot](screenshot-light.png) +
+ +## Features + +- [x] Code Snippet Clipboards + - [x] Line(s)-specific highlighting +- [x] Latex Support +- [x] Light/Dark mode support +- [x] Search functionality +- [x] Table of Contents option + +## Contents and Configuration Guide + +- Installation +- Options + - Top menu + - Title + - Author + - GitHub + - Code Snippets + - LaTex Support + - Searchbar + - Light and Dark Modes + - Table of Contents +- Acknowledgements + +## Installation + +First download this theme to your `themes` directory: + +```bash +cd themes +git clone https://github.com/micahkepe/radion +``` + +and then enable it in your `config.toml`: + +```toml +theme = "radion" +``` + +This theme requires your index section (`content/_index.md`) to be paginated to work: + +```toml +paginate_by = 5 +``` + +The posts should therefore be in directly under the `content` folder. + +The theme requires tags and categories taxonomies to be enabled in your +`config.toml`: + +```toml +taxonomies = [ + # You can enable/disable RSS + {name = "categories", feed = true}, + {name = "tags", feed = true}, +] +``` + +If you want to paginate taxonomies pages, you will need to overwrite the +templates as it only works for non-paginated taxonomies by default. + +## Options + +### Top-menu + +Set a field in `extra` with a key of `radion_menu`: + +```toml +radion_menu = [ + {url = "$BASE_URL", name = "Home"}, + {url = "$BASE_URL/categories", name = "Categories"}, + {url = "$BASE_URL/tags", name = "Tags"}, + {url = "https://google.com", name = "Google"}, +] +``` + +If you put `$BASE_URL` in a url, it will automatically be replaced by the actual +site URL. + +### Title + +The site title is shown on the homepage. As it might be different from the +`` element that the `title` field in the config represents, you can set +the `radion_title` instead. + +### Author + +You can set this on a per page basis or in the config file. + +`config.toml`: + +```toml +[extra] +author = "John Smith" +``` + +In a page (wrap this in +++): + +```toml +title = "..." +date = 1970-01-01 + +[extra] +author = "John Smith" +``` + +### GitHub + +To enable a GitHub reference link in the header, set the following in your +`config.toml`: + +```toml +[extra] +github = "https://github.com/your-github-link" +``` + +### Code Snippets + +Syntax Highlighting: + +```toml +[markdown] +# Whether to do syntax highlighting +# Theme can be customized by setting the `highlight_theme` variable to a theme supported by Zola +highlight_code = true + +highlight_theme = "one-dark" +``` + +Enhanced Codeblocks (Clipboard Support and Language Tags) + +```toml +[extra] +codeblock = true +``` + +### LaTex Support + +To enable LaTeX support with MathJax, set the following in your `config.toml`: + +```toml +[extra] +latex = true +``` + +### Searchbar + +To enable a searchbar at the top of the page navigation, set the following in +your `config.toml`: + +```toml +build_search_index = true + +[search] +index_format = "elasticlunr_json" + +[extra] +enable_search = true +``` + +### Light and Dark Modes + +To set the color theme of the site, set the following in your `config.toml`: + +```toml +[extra] +theme = "toggle" # options: {light, dark, auto, toggle} +``` + +There are four options for the `theme` field: + +- `light`: Always light mode +- `dark`: Always dark mode +- `auto`: Automatically switch between light and dark mode based on the user's + system preferences +- `toggle`: Allow the user to toggle between light and dark mode + +### Table of Contents + +To enable a table of contents on a page, add the following to the front matter +of the page: + +```toml +[extra] +toc = true +``` + +## Acknowledgements + +Lots of inspiration and code snippets taken from these awesome Zola themes: + +- [`after-dark`](https://github.com/getzola/after-dark) by + [Vincent Prouillet](https://www.vincentprouillet.com/) + +- [`apollo`](https://github.com/not-matthias/apollo/tree/main) by + [not-matthias](https://github.com/not-matthias) + +- [`redux`](https://github.com/SeniorMars/redux) by + [SeniorMars](https://github.com/SeniorMars). + + \ No newline at end of file diff --git a/docs/content/themes/radion/screenshot.png b/docs/content/themes/radion/screenshot.png new file mode 100644 index 000000000..585843518 Binary files /dev/null and b/docs/content/themes/radion/screenshot.png differ diff --git a/docs/content/themes/tabi/index.md b/docs/content/themes/tabi/index.md index 98de5522a..fa727414b 100644 --- a/docs/content/themes/tabi/index.md +++ b/docs/content/themes/tabi/index.md @@ -3,14 +3,14 @@ title = "tabi" description = "tabi is an accessible Zola theme with search, multi-language support, optional JavaScript, a perfect Lighthouse score, and comprehensive documentation. Crafted for personal websites and blogs." template = "theme.html" -date = 2024-12-04T22:56:53+01:00 +date = 2024-12-15T13:47:54+01:00 [taxonomies] theme-tags = [] [extra] -created = 2024-12-04T22:56:53+01:00 -updated = 2024-12-04T22:56:53+01:00 +created = 2024-12-15T13:47:54+01:00 +updated = 2024-12-15T13:47:54+01:00 repository = "https://github.com/welpo/tabi.git" homepage = "https://github.com/welpo/tabi" minimum_version = "0.17.0" diff --git a/docs/content/themes/zallery/index.md b/docs/content/themes/zallery/index.md index fdcc2875f..9fb8a2634 100644 --- a/docs/content/themes/zallery/index.md +++ b/docs/content/themes/zallery/index.md @@ -3,14 +3,14 @@ title = "zallery" description = "Gallery theme for zola" template = "theme.html" -date = 2024-09-25T18:41:17-05:00 +date = 2024-12-13T19:35:13-06:00 [taxonomies] theme-tags = [] [extra] -created = 2024-09-25T18:41:17-05:00 -updated = 2024-09-25T18:41:17-05:00 +created = 2024-12-13T19:35:13-06:00 +updated = 2024-12-13T19:35:13-06:00 repository = "https://github.com/gamingrobot/zallery.git" homepage = "https://github.com/gamingrobot/zallery" minimum_version = "0.19.0" diff --git a/docs/content/themes/zluinav/index.md b/docs/content/themes/zluinav/index.md index 7cf668c56..c489f0f36 100644 --- a/docs/content/themes/zluinav/index.md +++ b/docs/content/themes/zluinav/index.md @@ -3,14 +3,14 @@ title = "UI Navigation" description = "A multilingual theme designed for accessibility rather than visual." template = "theme.html" -date = 2024-12-08T22:04:39+06:30 +date = 2024-12-15T16:46:17+06:30 [taxonomies] theme-tags = ['blind', 'multilingual', 'accessible', 'responsive'] [extra] -created = 2024-12-08T22:04:39+06:30 -updated = 2024-12-08T22:04:39+06:30 +created = 2024-12-15T16:46:17+06:30 +updated = 2024-12-15T16:46:17+06:30 repository = "https://github.com/harrymkt/zluinav" homepage = "https://github.com/harrymkt/zluinav" minimum_version = "0.19.2" @@ -35,20 +35,22 @@ Zola is a fast site generator written in Rust powered by tera as its templating This theme is distributed under the terms of the [MIT License](https://github.com/harrymkt/zluinav/blob/main/LICENSE.md). ## Features of zluinav theme -- Blog with pagination enabled; multiple blogs can be created by copying the blog directory in the content folder to the new directory for a new blog. This means that you can have multiple blogs in one site. In fact, Zola doesn't have its build-in posts, but it is possible using sections. +- Accessibility; Zluinav is designed to be accessible as possible, especially for blind and visually impaired. This is done by using accessibility tags, such as ARIA, and other possible accessibility features. +- Blog with pagination enabled; multiple blogs can be created by copying the blog directory in the content folder to the new directory for a new blog. This means that you can have multiple blogs in one site. In fact, Zola doesn't have its build-in posts, but it is possible using sections. Please note that directory other than blog will require you to manually set the `template` to `blogpage.html` and `page_template` to `section_paginated.html` in its `_index.md` file. - Documentation site; build accessible documentation sites by using built-in 1subsection templates specifically designed for documentation. - Multilingual; build your site in multiple languages. -- Custom navigation; can be set via `config.extra.nav`. +- Custom Menus; can be set via `config.extra.menus.menu_name`. +- Built-in search, with a variety of search formats to choose. - Customizable extrahead, header, navigation, and footer by base templates and blocks. - Fast; Zola generates within a few milliseconds. Zluinav is built with HTML using aria whenever possible for accessibility with assistive screen reader as well as using JavaScript. You can rebase the templates, should you wish to add your own content. - Copy code blocks; add code blocks which can then be copied using buttons and display the code language if available, helped by JavaScript. - Variables; add variables to your page content to be replaced during the site generate. - Local date display; display dates in user's local timezone, no madder what timezone the date is set. -- Use macros and shortcodes to make your content length shorten. +- Use extensive macros and shortcodes to make your content length shorten. - Comprehensive documentation; Zluinav provides a full Comprehensive documentation including possible templates, shortcodes, blocks, configurable parameters, and more, everything as it updates. ## Installation -Using git: +Using git clone: ```bash cd themes git clone https://github.com/harrymkt/zluinav.git diff --git a/docs/content/themes/zola-theme-jiaxiang.wang/index.md b/docs/content/themes/zola-theme-jiaxiang.wang/index.md new file mode 100644 index 000000000..81f2537cf --- /dev/null +++ b/docs/content/themes/zola-theme-jiaxiang.wang/index.md @@ -0,0 +1,134 @@ + ++++ +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 = 2024-12-17T19:13:55+08:00 + +[taxonomies] +theme-tags = [] + +[extra] +created = 2024-12-17T19:13:55+08:00 +updated = 2024-12-17T19:13:55+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" +license = "AGPL" +demo = "https://theme.jiaxiang.wang/" + +[extra.author] +name = "Jiaxiang Wang" +homepage = "https://blog.jiaxiang.wang" ++++ + +<div align="center"> + +<h1>Zola Theme for jiaxiang.wang [WIP]</h1> + +<h4>为创造者而生的开源 Zola 主题</h4> + +<p align="center"> + +主题预览](#-预览) | [快速上手](#-快速上手) | [加入讨论 + +[中文](./README.md) | [English](./README.en.md) + +</p> +</div> + +[![preview](<./content/articles/docs/01 Read Me/preview.webp>)](https://blog.jiaxiang.wang) + +## ℹ️ 简介 + +[zola-theme-jiaxiang.wang](https://github.com/iWangJiaxiang/zola-theme-jiaxiang.wang) 是一款适用于 [Zola](https://github.com/getzola/zola) 的博客主题。 + +> 本主题由 [王嘉祥](https://blog.jiaxiang.wang) 移植自 [Halo](https://github.com/halo-dev/halo) 主题 [Halo-Theme-Hao](https://github.com/chengzhongxue/halo-theme-hao)，[Halo-Theme-Hao](https://github.com/chengzhongxue/halo-theme-hao) 主题移植自 [Hexo](https://hexo.io/zh-cn/index.html) 社区中 [张洪 Heo](https://blog.zhheo.com/) 对 [Hexo-Theme-Butterfly](https://github.com/chengzhongxue/halo-theme-hao) 主题的魔改与重设计版本。 + +## 🔥 预览 + +> 如果你的站点也使用了本主题，欢迎通过 PR 的形式在 readme.md 和 /static/data/friends.json 中添加站点信息 + +| 站点名称 | 站点地址 | +|:------:|:-----------------------| +| 王嘉祥 | https://blog.jiaxiang.wang | + +### 🔌 功能 + +> 由于精力有限。目前只移植了主要功能，更多功能持续更新。 + +- [x] 基本功能 + - [x] 评论 + - [x] Twikoo + - [ ] Artalk + - [ ] Waline + - [x] 搜索（Algolia） + - [x] Markdown + - [x] Katex + - [x] Prism 代码高亮 + - [x] 随机访问文章 + - [x] 右键菜单 + - [x] Pjax + - [ ] i18n国际化 + - [ ] Post GPT +- [ ] 特殊页面 + - [x] 个人装备 + - [x] 友链 + - [ ] 赞赏 + - [ ] 爱发电 + - [x] 订阅 + - [x] 关于我 + - [x] 音乐 + - [ ] 留言板 +- [x] 日常运营 + - [x] 每日推荐 + - [x] 文章推荐 +- [x] 文章 + - [x] 图片压缩 + - [x] 公众号链接 + - [x] 动态目录 + - [x] 分类/标签 + - [x] 访问热度（基于Twikoo） + - [x] 相关文章 +- [x] 合规 + - [x] ICP备案 + - [x] 公安备案 + +## 📝 快速上手 + +1. 参考[官方说明](https://www.getzola.org/documentation/getting-started/installation/)安装 Zola 命令行工具 +1. 将本仓库克隆到本地 + + ```bash + git clone --depth=1 https://github.com/iWangJiaxiang/zola-theme-jiaxiang.wang.git + ``` + +1. 进入本地仓库 + + ```bash + cd zola-theme-jiaxiang.wang + ``` + +1. 运行预览命令，然后在浏览器打开提示的预览地址 + + ```bash + zola serve + ``` + + 此时您应该成功访问到博客网站啦 + +1. 参考官方资料进一步探索并定制您的博客 + - [zola 命令说明](https://www.getzola.org/documentation/getting-started/cli-usage/) + - [理解项目结构](https://www.getzola.org/documentation/getting-started/directory-structure/) + - [自定义](https://www.getzola.org/documentation/getting-started/configuration/) + +## 💬 讨论 + +如果你对主题有什么建议或者意见，欢迎提 PR & Issue。 + +## 🔐 许可 + +[Zola-Theme-Jiaxiang](https://github.com/iWangJiaxiang/zola-theme-jiaxiang.wang) 使用 [AGPL](./LICENSE) 协议开源，请遵守开源协议。 + + + \ No newline at end of file diff --git a/docs/content/themes/zola-theme-jiaxiang.wang/screenshot.png b/docs/content/themes/zola-theme-jiaxiang.wang/screenshot.png new file mode 100644 index 000000000..c50a3f206 Binary files /dev/null and b/docs/content/themes/zola-theme-jiaxiang.wang/screenshot.png differ diff --git a/docs/content/themes/zolarwind/index.md b/docs/content/themes/zolarwind/index.md index 5cd14accd..94685e6d5 100644 --- a/docs/content/themes/zolarwind/index.md +++ b/docs/content/themes/zolarwind/index.md @@ -3,14 +3,14 @@ title = "Zolarwind" description = "A localizable blog theme using Tailwind CSS for styling and KaTex for math" template = "theme.html" -date = 2024-12-06T19:05:42+01:00 +date = 2024-12-09T16:12:52+01:00 [taxonomies] theme-tags = [] [extra] -created = 2024-12-06T19:05:42+01:00 -updated = 2024-12-06T19:05:42+01:00 +created = 2024-12-09T16:12:52+01:00 +updated = 2024-12-09T16:12:52+01:00 repository = "https://github.com/thomasweitzel/zolarwind.git" homepage = "https://github.com/thomasweitzel/zolarwind" minimum_version = "0.19.1"