diff --git a/docs/content/themes/after-dark/index.md b/docs/content/themes/after-dark/index.md index 016b68adc5..fe3c25800d 100644 --- a/docs/content/themes/after-dark/index.md +++ b/docs/content/themes/after-dark/index.md @@ -3,17 +3,17 @@ title = "after-dark" description = "A robust, elegant dark theme" template = "theme.html" -date = 2024-11-06T07:53:33-06:00 +date = 2024-12-23T03:38:12-08:00 [taxonomies] theme-tags = [] [extra] -created = 2024-11-06T07:53:33-06:00 -updated = 2024-11-06T07:53:33-06:00 +created = 2024-12-23T03:38:12-08:00 +updated = 2024-12-23T03:38:12-08:00 repository = "https://github.com/getzola/after-dark.git" homepage = "https://github.com/getzola/after-dark" -minimum_version = "0.17.0" +minimum_version = "0.19.1" license = "MIT" demo = "https://getzola.github.io/after-dark/" diff --git a/docs/content/themes/apollo/index.md b/docs/content/themes/apollo/index.md index be01c822b1..e9a866c395 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 = 2024-12-18T14:51:26+01:00 +date = 2024-12-29T21:39:11+01:00 [taxonomies] theme-tags = [] [extra] -created = 2024-12-18T14:51:26+01:00 -updated = 2024-12-18T14:51:26+01:00 +created = 2024-12-29T21:39:11+01:00 +updated = 2024-12-29T21:39:11+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/duckquill/index.md b/docs/content/themes/duckquill/index.md index 71b969a3fd..583d33f3d6 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-10T00:18:25Z +date = 2024-12-23T23:19:37+03:00 [taxonomies] theme-tags = [] [extra] -created = 2024-12-10T00:18:25Z -updated = 2024-12-10T00:18:25Z +created = 2024-12-23T23:19:37+03:00 +updated = 2024-12-23T23:19:37+03:00 repository = "https://codeberg.org/daudix/duckquill.git" homepage = "https://codeberg.org/daudix/duckquill" minimum_version = "0.19.0" diff --git a/docs/content/themes/homepage-creators/index.md b/docs/content/themes/homepage-creators/index.md index a56a9039b0..cf15d50166 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 = 2024-12-22T22:21:57+08:00 +date = 2024-12-25T17:08:52+08:00 [taxonomies] theme-tags = [] [extra] -created = 2024-12-22T22:21:57+08:00 -updated = 2024-12-22T22:21:57+08:00 +created = 2024-12-25T17:08:52+08:00 +updated = 2024-12-25T17:08:52+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/linkita/index.md b/docs/content/themes/linkita/index.md index 7a11d7b35c..e8609e874e 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-16T13:54:28+02:00 +date = 2024-12-29T21:26:44+02:00 [taxonomies] theme-tags = ['Blog', 'Multilingual', 'Responsive', 'SEO', 'Search'] [extra] -created = 2024-12-16T13:54:28+02:00 -updated = 2024-12-16T13:54:28+02:00 +created = 2024-12-29T21:26:44+02:00 +updated = 2024-12-29T21:26:44+02:00 repository = "https://codeberg.org/salif/linkita.git" homepage = "https://codeberg.org/salif/linkita" minimum_version = "0.19.0" @@ -53,10 +53,11 @@ A clean and elegant blog theme for [Zola](https://www.getzola.org/). Linkita is ### Linkita features -- i18n -- Improved SEO +- Multilingual support +- Improved search engine optimization +- Search support (elasticlunr_javascript) +- More configurability - Author profiles -- Search (elasticlunr_javascript) - Keyboard shortcuts ## Installing @@ -75,7 +76,7 @@ Alternatively, clone the repository: `git clone https://codeberg.org/salif/linki theme = "linkita" ``` -3. Optionally, you can switch from the `linkita` branch to the latest release: +3. Optionally, you can switch from the `linkita` branch to the latest stable version: ```sh cd themes/linkita @@ -85,9 +86,9 @@ npm run switch-to-latest ## Updating ```sh -git submodule update --merge --remote themes/linkita -# cd themes/linkita -# npm run switch-to-latest +git submodule update --remote themes/linkita +# Optionally, you can switch to the latest stable version: +# cd themes/linkita && npm run switch-to-latest ``` ## Usage @@ -155,8 +156,6 @@ content_tier = "" locations = [] # A high-level section name. e.g. `Technology` section = "" -# Tag words associated with this article -tags = [""] # Indicates whether the article is an opinion piece or not. e.g. `true` or `false` opinion = # The URL for the audio @@ -650,7 +649,7 @@ copyright = "© $YEAR Your Name | [CC BY-SA 4.0]($LICENSE_URL)" # search_page_url = "$BASE_URL/search/" ``` -### Locale and Date format +### Language specific options | key | type | default value | | ----------------------------------------- | ------ | ------------- | @@ -660,6 +659,8 @@ copyright = "© $YEAR Your Name | [CC BY-SA 4.0]($LICENSE_URL)" | extra.languages[lang].header_menu_name | string | | | extra.languages[lang].header_buttons | array of strings | | | extra.languages[lang].art_x_lang | string | | +| extra.languages[lang].taxonomy_list_description | string | | +| extra.languages[lang].taxonomy_single_description | string | | For date format, see [chrono docs](https://docs.rs/chrono/0.4/chrono/format/strftime/index.html). @@ -675,21 +676,57 @@ date_format = "%x" date_format_archive = "%m-%d" ``` +#### Taxonomy/term description + +Taxonomy pages do not have a description by default. +Optionally you can set a generic description. +`$NAME` will be automatically replaced. + +```toml +[extra.languages.en] +taxonomy_list_description = "A map of all $NAME on this site. Start exploring!" +taxonomy_single_description = "Browse articles related to $NAME. Start exploring!" +``` + ### Web analytics -| key | type | -| -------------------------- | ------ | -| extra.goatcounter.endpoint | string | -| extra.goatcounter.src | string | +#### GoatCounter + +| key | type | +| --------------------------------- | ------ | +| extra.goatcounter.endpoint | string | +| extra.goatcounter.src | string | +| extra.goatcounter.noscript_prefix | string | Set only if you use [GoatCounter](https://www.goatcounter.com/). +To enable [pixel](https://www.goatcounter.com/help/pixel), set `noscript_prefix` to an empty string. +If your `base_url` includes a subpath, set `noscript_prefix` to the subpath without a trailing slash. + ```toml [extra.goatcounter] endpoint = "https://MYCODE.goatcounter.com/count" src = "//gc.zgo.at/count.js" ``` +#### Vercel Analytics + +| key | type | +| -------------------------- | ------ | +| extra.vercel_analytics.src | string | + +Set only if you use [Vercel Web Analytics](https://vercel.com/docs/analytics). + +```toml +[extra.vercel_analytics] +src = "/_vercel/insights/script.js" +``` + +#### Prevent tracking own pageviews + +Open a page of your site, adding `#disable-analytics` to the page address. Do this once for each browser and device. +For example, open . + ### Comments | key | type | default value | @@ -735,14 +772,11 @@ See the [MIT License](https://codeberg.org/salif/linkita/src/branch/linkita/LICE Pull requests are welcome on [Codeberg](https://codeberg.org/salif/linkita) and [Github](https://github.com/salif/linkita). Open bug reports and feature requests on [Codeberg](https://codeberg.org/salif/linkita/issues). -## Blogs using this theme +## Sites using Linkita - [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. -See also [Google results](https://www.google.com/search?q=%22Powered+by+Zola+and+Linkita%22+-site%3Ahttps%3A%2F%2Fsalif.github.io%2Flinkita%2F) -and [Bing results](https://www.bing.com/search?q=%22Powered+by+Zola+and+Linkita%22+-site%3Ahttps%3A%2F%2Fsalif.github.io%2Flinkita%2F). - \ No newline at end of file diff --git a/docs/content/themes/re137/index.md b/docs/content/themes/re137/index.md index 9470d0bffe..497b29ebbd 100644 --- a/docs/content/themes/re137/index.md +++ b/docs/content/themes/re137/index.md @@ -3,14 +3,14 @@ title = "re137" description = "A Chinese friendly zola theme. Inspired by lightspeed." template = "theme.html" -date = 2024-11-11T18:40:55+09:00 +date = 2024-12-26T20:59:14+09:00 [taxonomies] theme-tags = [] [extra] -created = 2024-11-11T18:40:55+09:00 -updated = 2024-11-11T18:40:55+09:00 +created = 2024-12-26T20:59:14+09:00 +updated = 2024-12-26T20:59:14+09:00 repository = "https://github.com/tinikov/re137.git" homepage = "https://github.com/tinikov/re137" minimum_version = "0.4.0" diff --git a/docs/content/themes/re137/screenshot.png b/docs/content/themes/re137/screenshot.png index 76483399d8..e0cd5834cc 100644 Binary files a/docs/content/themes/re137/screenshot.png and b/docs/content/themes/re137/screenshot.png differ diff --git a/docs/content/themes/serene/index.md b/docs/content/themes/serene/index.md index 72bbba79f6..5d63efc76c 100644 --- a/docs/content/themes/serene/index.md +++ b/docs/content/themes/serene/index.md @@ -3,14 +3,14 @@ title = "serene" description = "A spiffy blog theme for zola" template = "theme.html" -date = 2024-11-03T22:43:56+08:00 +date = 2024-12-23T23:11:47+07:00 [taxonomies] theme-tags = [] [extra] -created = 2024-11-03T22:43:56+08:00 -updated = 2024-11-03T22:43:56+08:00 +created = 2024-12-23T23:11:47+07:00 +updated = 2024-12-23T23:11:47+07:00 repository = "https://github.com/isunjn/serene.git" homepage = "https://github.com/isunjn/serene" minimum_version = "0.19.0" diff --git a/docs/content/themes/tabi/index.md b/docs/content/themes/tabi/index.md index 247ad2bd29..bd7e243e12 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-20T19:06:52+08:00 +date = 2024-12-28T17:42:58+01:00 [taxonomies] theme-tags = [] [extra] -created = 2024-12-20T19:06:52+08:00 -updated = 2024-12-20T19:06:52+08:00 +created = 2024-12-28T17:42:58+01:00 +updated = 2024-12-28T17:42:58+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/zluinav/index.md b/docs/content/themes/zluinav/index.md index 4002aba12e..517e306bd3 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-21T20:14:47+06:30 +date = 2024-12-26T14:28:41+06:30 [taxonomies] theme-tags = ['blind', 'multilingual', 'accessible', 'responsive'] [extra] -created = 2024-12-21T20:14:47+06:30 -updated = 2024-12-21T20:14:47+06:30 +created = 2024-12-26T14:28:41+06:30 +updated = 2024-12-26T14:28:41+06:30 repository = "https://github.com/harrymkt/zluinav" homepage = "https://github.com/harrymkt/zluinav" minimum_version = "0.19.2" @@ -27,7 +27,7 @@ UI Navigation, or known as zluinav, is a Zola theme designed for accessibility r This theme is also available for Hugo at [Hguinav](https://github.com/harrymkt/hguinav). -Zola is a fast site generator written in Rust powered by tera as its templating engine and has a powerful theme creation feature. +[Zola](https://www.getzola.org/) is a fast site generator written in Rust powered by tera as its templating engine and has a powerful theme creation feature. [Theme demo](https://harrymkt.github.io/zluinav) @@ -59,7 +59,7 @@ git clone https://github.com/harrymkt/zluinav.git ``` Or [download manually](https://github.com/harrymkt/zluinav/archive/refs/heads/main.zip) and paste in the themes directory. -Or, add to the Git submodule +Or, add to the Git submodule (recommended): ```bash git submodule add --name zluinav https://github.com/harrymkt/zluinav.git themes/zluinav git submodule update --remote @@ -78,6 +78,9 @@ Contributions to this theme are welcome, provided that the following requirement - Use 2 level space indentation for HTML. Use 1 tab level indentation for CSS and JavaScript. If Markdown files need indentation, use 1 tab. - Be the templates accessible for visually impaired and/or blind and prefer readability. Don't worry, I will process in case accessibility issues before pull requests are merged. - Photos are not required in this theme. You may design with CSS for visual if you so wish. +- When creating a pull request it is advised that you: + - Use different branch other than main; this avoids issues with updating in case your pull request gets rejected. + - Add label if possible. Thank you! \ No newline at end of file diff --git a/docs/content/themes/zola-folio/index.md b/docs/content/themes/zola-folio/index.md new file mode 100644 index 0000000000..7cd4bcfae8 --- /dev/null +++ b/docs/content/themes/zola-folio/index.md @@ -0,0 +1,148 @@ + ++++ +title = "zola-folio" +description = "A fork of the Jekyll *folio theme to zola" +template = "theme.html" +date = 2024-12-31T14:02:39-06:00 + +[taxonomies] +theme-tags = [] + +[extra] +created = 2024-12-31T14:02:39-06:00 +updated = 2024-12-31T14:02:39-06:00 +repository = "https://github.com/evjrob/zola-folio" +homepage = "https://github.com/evjrob/zola-folio" +minimum_version = "0.19.2" +license = "MIT" +demo = "https://zola-folio.pages.dev/" + +[extra.author] +name = "Everett Robinson" +homepage = "http://everettsprojects.com" ++++ + +# *folio + +[![zola-folio](static/img/zola-folio.png)](https://zola-folio.pages.dev/) + +*folio is a [Zola](https://www.getzola.org) theme forked from the [original Jekyll theme by Lia Boegev](https://github.com/bogoli/-folio/tree/master). + +**[Live Demo](https://zola-folio.pages.dev/)** + +## Features + +- [x] Menu bar +- [x] Social links +- [x] Tags +- [x] MathJax +- [x] Search +- [x] Customizable color +- [x] SEO tags +- [ ] Multi-language support + +## Installation + +In the git repo of your zola site: + +### Add the theme as a git submodule: + +```bash +git submodule add https://github.com/evjrob/zola-folio themes/zola-folio +git submodule update --init --recursive +git submodule update --remote --merge +``` + +### Or clone the theme directly into your themes directory: + +```bash +git clone https://github.com/evjrob/zola-folio themes/zola-folio +``` + +Then set `theme = "zola-folio"` in your config.toml file. You can now test the theme locally by running `zola serve` in the terminal and navigating to the localhost URL displayed by the command. + +## Configuration + +### Menu Bar + +Items in the top menu bar can be controlled with the `extra.menu_items` setting in config.toml: + +```toml +menu_items = [ + {name = "about", url = "/pages/about"}, + {name = "projects", url = "/pages/projects"}, + {name = "photography", url = "/pages/photography"}, +] +``` + +### About Page Social Contacts + +If you have an about page, you can add social contact links using the `extra.socials` setting in the frontmatter of the page: + +```toml ++++ +title = "about" +template = "about.html" +[extra] +socials = [ + {name = "email", uri = "mailto:you@example.com"}, + {name = "github", uri = "https://github.com"}, + {name = "instagram", uri = "https://www.instagram.com/"}, + {name = "bluesky", uri = "https://bsky.app/"} +] ++++ +``` + +### MathJax + +MathJax can be enabled by setting `extra.math` in config.toml: + +```toml +[extra] +math = true +``` +[Example](https://zola-folio.pages.dev/math/). + +### Search + +Search using elasticlunr.js: + +```toml +default_language = "en" +build_search_index = true + +[search] +include_title = true +include_description = true +include_path = true +include_content = true +index_format = "elasticlunr_json" +``` + +### Customizable Colors + +Simply set the `extra.theme_color` in the config.toml: + +```toml +[extra] +theme_color = "red"|"blue"|"green"|"purple" +``` +If the existing colors are not to your liking, then you can create your own by adding a **sass/color/custom.scss** file with the following: + +```scss +:root { + --theme-color: #ffffff; + --theme-color-light: #ffffff; +} +``` +Then set `theme_color = "custom"`. + +### SEO Tags + +The typical `` tags including Open Graph and Twitter are automatically set for posts using the information in the frontmatter of each post. To ensure an image is set for Open Graph and Twitter cards, please ensure the frontmatter contains the `extra.feature_image` value: + +```toml +[extra] +feature_image = "my_image.ext" +``` + \ No newline at end of file diff --git a/docs/content/themes/zola-folio/screenshot.png b/docs/content/themes/zola-folio/screenshot.png new file mode 100644 index 0000000000..fcd8b62f64 Binary files /dev/null and b/docs/content/themes/zola-folio/screenshot.png differ diff --git a/docs/content/themes/zola-pickles/index.md b/docs/content/themes/zola-pickles/index.md index dd3038617b..d06612ae2c 100644 --- a/docs/content/themes/zola-pickles/index.md +++ b/docs/content/themes/zola-pickles/index.md @@ -3,14 +3,14 @@ title = "pickles" description = "A modern, simple, clean blog theme for Zola." template = "theme.html" -date = 2024-10-17T09:39:18-06:00 +date = 2024-12-29T19:02:45-07:00 [taxonomies] theme-tags = [] [extra] -created = 2024-10-17T09:39:18-06:00 -updated = 2024-10-17T09:39:18-06:00 +created = 2024-12-29T19:02:45-07:00 +updated = 2024-12-29T19:02:45-07:00 repository = "https://github.com/lukehsiao/zola-pickles.git" homepage = "https://github.com/lukehsiao/zola-pickles" minimum_version = "0.19.0" diff --git a/docs/content/themes/zola-theme-jiaxiang.wang/index.md b/docs/content/themes/zola-theme-jiaxiang.wang/index.md index 5402117306..87f59835d3 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 = 2024-12-23T00:33:31+08:00 +date = 2024-12-29T19:57:25+08:00 [taxonomies] theme-tags = [] [extra] -created = 2024-12-23T00:33:31+08:00 -updated = 2024-12-23T00:33:31+08:00 +created = 2024-12-29T19:57:25+08:00 +updated = 2024-12-29T19:57:25+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"