Update themes gallery (#1742)

Co-authored-by: GitHub Action <action@github.com>

docs/content/themes/DeepThought/index.md

@@ -3,11 +3,11 @@
 title = "DeepThought"
 description = "A simple blog theme focused on writing powered by Bulma and Zola."
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://github.com/RatanShreshtha/DeepThought.git"
 homepage = "https://github.com/RatanShreshtha/DeepThought"
 minimum_version = "0.9.0"

docs/content/themes/Ergo/index.md

@@ -3,11 +3,11 @@
 title = "Ergo"
 description = "A simple blog Theme focused on writing, inspired by svbtle"
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://github.com/InsidiousMind/Ergo.git"
 homepage = "https://github.com/insipx/Ergo"
 minimum_version = "0.4.1"

docs/content/themes/Zulma/index.md

@@ -3,11 +3,11 @@
 title = "Zulma"
 description = "A zola theme based off bulma.css"
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://github.com/Worble/Zulma"
 homepage = "https://github.com/Worble/Zulma"
 minimum_version = "0.6.0"

docs/content/themes/adidoks/index.md

@@ -3,11 +3,11 @@
 title = "adidoks"
 description = "AdiDoks is a Zola theme helping you build modern documentation."
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://github.com/aaranxu/adidoks.git"
 homepage = "https://github.com/aaranxu/adidoks"
 minimum_version = "0.13.0"
@@ -21,7 +21,7 @@ homepage = "https://github.com/aaranxu"
 
 # Zola Theme AdiDoks
 
-AdiDoks is a mordern documentation theme, which is a port of the Hugo
+AdiDoks is a modern documentation theme, which is a port of the Hugo
 theme [Doks](https://github.com/h-enk/doks) for Zola.
 
 ## Demo
@@ -73,7 +73,7 @@ git submodule add https://github.com/aaranxu/adidoks.git themes/adidoks
 
 ### Step 3: Configuration
 
-Enable the theme in your `config.toml` in the site derectory:
+Enable the theme in your `config.toml` in the site directory:
 
 ```toml
 theme = "adidoks"

docs/content/themes/after-dark/index.md

@@ -3,11 +3,11 @@
 title = "after-dark"
 description = "A robust, elegant dark theme"
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://github.com/getzola/after-dark.git"
 homepage = "https://github.com/getzola/after-dark"
 minimum_version = "0.11.0"
@@ -29,6 +29,7 @@ homepage = "https://www.vincentprouillet.com"
 - [Options](#options)
   - [Top menu](#top-menu)
   - [Title](#title)
+  - [Author](#author)
 
 ## Installation
 First download this theme to your `themes` directory:
@@ -86,6 +87,23 @@ The site title is shown on the homepage. As it might be different from the `<tit
 element that the `title` field in the config represents, you can set the `after_dark_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"
+```
+
 ## Original
 This template is based on the Hugo template https://git.habd.as/comfusion/after-dark
 

docs/content/themes/anatole-zola/index.md

@@ -3,11 +3,11 @@
 title = "anatole-zola"
 description = "A port of farbox-theme-Anatole for zola"
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://github.com/longfangsong/anatole-zola.git"
 homepage = "https://github.com/longfangsong/anatole-zola"
 minimum_version = "0.4.0"
@@ -21,14 +21,14 @@ homepage = "https://github.com/longfangsong"
 
 # Anatole Theme for Zola
 
-Port [Anatole theme for farbox](https://github.com/hi-caicai/farbox-theme-Anatole) to Zola.
+*[Anatole theme for Farbox](https://github.com/hi-caicai/farbox-theme-Anatole) ported to Zola*
-
+___
+[Zola Homepage](https://www.getzola.org/themes/anatole-zola/) | [Demo with customizations](https://longfangsong.github.io/)
+___
 ![screenshot](./screenshot.png)
 
 ![screenshot-mobile](./screenshot-mobile.png)
 
-You can view my blog for an example configuation, with customizations.
-
 ## Installation
 
 First download this theme to your `themes` directory:
@@ -59,17 +59,17 @@ base_url = "https://example.com"
 
 ### Language
 
-Currently, we have English and Chinese translation, set the `default_language` if necessary:
+Currently, we have English, Chinese and German translations, set the `default_language` if necessary:
 
 ```toml
 # 如果你想要中文
 default_language = "zh"
 ```
 
-It's sad that transations in themes are not working, you can copy these to your `config.toml`:
+If there are complications, you can copy this snippet to your `config.toml`:
 
 ```toml
-[translations.en]
+[languages.en.translations]
 about = "About"
 home = "Home"
 tags = "Tags"
@@ -78,7 +78,7 @@ links = "Links"
 next_page = "Next Page"
 last_page = "Last Page"
 
-[translations.zh]
+[languages.zh.translations]
 home = "首页"
 about = "关于"
 tags = "标签"
@@ -86,9 +86,19 @@ archive = "归档"
 links = "友链"
 next_page = "下一页"
 last_page = "上一页"
+
+[languages.de.translations]
+about = "Info"
+home = "Home"
+tags = "Kategorien"
+archive = "Archiv"
+links = "Links"
+date_format = "%d-%m-%Y"
+next_page = "Nächste Seite"
+last_page = "Vorherige Seite"
 ```
 
-Feel free to create a pull request if you want to translate the promotes into other languages!
+Feel free to create a pull request if you want to translate the theme into other languages!
 
 ### Sections
 
@@ -112,7 +122,7 @@ Tags and links sections are optional.
   links = true
   ```
 
-  and copy `content/links` to your own `content` library. And edit the `_index.md` in it to edit its content.
+  and copy `content/links` to your own `content` library. And edit the `_index.md` in it to modify its content.
 
 - If you want to add the author's name on each page, add:
 
@@ -123,11 +133,12 @@ Tags and links sections are optional.
 
 ### Sidebar menu
 
-We support a bunch of social links, they are:
+We support a bunch of social links:
 
 ```toml
 [extra.social]
 github = ""
+stackoverflow = "" # use user_id
 twitter = ""
 facebook = ""
 instagram = ""
@@ -143,7 +154,9 @@ Fill in your username if you want! And the logo won't appear if you leave it emp
 
 ### Comment system
 
-We currently support [valine](https://valine.js.org/quickstart.html):
+We currently support... 
+
+- [Valine](https://valine.js.org/quickstart.html):
 
 ```toml
 [extra.comment.valine]
@@ -155,14 +168,14 @@ avatar = "mm" # avatar style https://github.com/xCss/Valine/wiki/avatar-setting-
 placeholder = "Say something here"
 ```
 
-[disqus](https://disqus.com/admin/create/), note disqus does not work in Mainland China:
+- [Disqus](https://disqus.com/admin/create/), note that Disqus does not work in Mainland China:
 
 ```toml
 [extra.comment.disqus]
 name = "longfangsong"
 ```
 
-And [utterances](https://utteranc.es/):
+- [Utterances](https://utteranc.es/):
 
 ```toml
 [extra.comment.utterances]
@@ -174,7 +187,7 @@ theme = "github-light"
 
 ## Customize
 
-There are several points I left in the origin templates for you to customize your site.
+There are several options I left in the origin templates for you to customize your site.
 
 ### More style
 
@@ -198,6 +211,6 @@ You can add more social links by adding a `templates.html` with some content add
 {%/* endblock */%}
 ```
 
-If you want to use some awsome logos, [font awsome icons](https://fontawesome.com/icons?d=gallery) are already available.
+If you want to use some awesome logos, [FontAwesome icons](https://fontawesome.com/icons?d=gallery) are already available.
 
         

docs/content/themes/anpu/index.md

@@ -3,11 +3,11 @@
 title = "Anpu"
 description = "A port of the Hugo Anubis theme"
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://github.com/zbrox/anpu-zola-theme.git"
 homepage = "https://github.com/zbrox/anpu-zola-theme"
 minimum_version = "0.11.0"

docs/content/themes/blow/index.md

@@ -0,0 +1,155 @@
+
++++
+title = "Blow"
+description = "A Zola theme made with Tailwindcss"
+template = "theme.html"
+date = 2022-01-23T23:20:14+01:00
+
+[extra]
+created = 2022-01-23T23:20:14+01:00
+updated = 2022-01-23T23:20:14+01:00
+repository = "https://github.com/tchartron/blow.git"
+homepage = "https://github.com/tchartron/blow"
+minimum_version = "0.9.0"
+license = "MIT"
+demo = "https://tchartron.com"
+
+[extra.author]
+name = "Thomas Chartron"
+homepage = "https://tchartron.com"
++++        
+
+# Blow
+A [Zola](https://www.getzola.org/) theme built with [tailwindcss](https://tailwindcss.com/)  
+
+(WIP) Example : [Here](https://tchartron.com)  
+
+## Preview
+![preview](screenshot.png)
+
+## Usage
+You should follow the [official documentation](https://www.getzola.org/documentation/themes/installing-and-using-themes/) about installing a Zola theme.  
+
+I recommend adding the theme as a git submodule :  
+```bash
+cd my-zola-website
+git submodule add -b main git@github.com:tchartron/blow.git themes/blow
+```
+
+Edit the theme used in your `config.toml` file
+```toml
+# The site theme to use.
+theme = "blow"
+```
+
+Then edit your `config.toml` file to override values from the theme :
+```toml
+[extra]
+enable_search = true
+enable_sidebar = true
+enable_adsense = true
+enable_multilingue = true
+adsense_link = "https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=myclientid"
+
+[extra.lang]
+items = [
+    { lang = "en", links = [
+        { base_url = "/", name = "English" },
+        { base_url = "/fr", name = "French" },
+    ] },
+    { lang = "fr", links = [
+        { base_url = "/", name = "Anglais" },
+        { base_url = "/fr", name = "Français" },
+    ] },
+]
+
+[extra.navbar]
+items = [
+    { lang = "en", links = [
+        { url = "/", name = "Home" },
+        { url = "/categories", name = "Categories" },
+        { url = "/tags", name = "Tags" },
+    ] },
+    { lang = "fr", links = [
+        { url = "/fr", name = "Accueil" },
+        { url = "/fr/categories", name = "Categories" },
+        { url = "/fr/tags", name = "Tags" },
+    ] },
+]
+title = "title"
+
+[extra.sidebar]
+items = [
+    { lang = "en", links = [
+        { url = "/markdown", name = "Markdown" },
+        { url = "/blog", name = "Blog" },
+    ] },
+    { lang = "fr", links = [
+        { url = "/fr/markdown", name = "Markdown" },
+        { url = "/fr/blog", name = "Blog" },
+    ] },
+]
+
+# Index page
+[extra.index]
+title = "Main title"
+image = "https://via.placeholder.com/200"
+
+[extra.default_author]
+name = "John Doe"
+avatar = "https://via.placeholder.com/200"
+
+[extra.social]
+github = "https://github.com/johndoe"
+gitlab = "https://gitlab.com/johndoe"
+twitter = "https://twitter.com/johndoe"
+linkedin = "https://www.linkedin.com/in/john-doe-b1234567/"
+email = "john.doe@gmail.com"
+
+[extra.favicon]
+favicon = "/icons/favicon.ico"
+favicon_16x16 = "/icons/favicon-16x16.png"
+favicon_32x32 = "/icons/favicon-32x32.png"
+apple_touch_icon = "/icons/apple-touch-icon.png"
+android_chrome_512 = "/icons/android-chrome-512x512.png"
+android_chrome_192 = "/icons/android-chrome-192x192.png"
+manifest = "/icons/site.webmanifest"
+```
+
+You can now run `zola serve` and visit : `http://127.0.0.1:1111/` to see your site
+
+## Syntax Highlighting
+Blow makes use of Zola code highlighting feature.  
+It supports setting a different color scheme depending on the user selected theme (Dark / Light)  
+In order to use it you should select the color scheme you want to use for light and dark themes in the list provided [here](https://www.getzola.org/documentation/getting-started/configuration/#syntax-highlighting) and edit your `config.toml` file like this example :  
+```toml
+highlight_theme = "css"
+
+highlight_themes_css = [
+  { theme = "ayu-dark", filename = "syntax-dark.css" },
+  { theme = "ayu-light", filename = "syntax-light.css" },
+]
+```
+
+## Features
+- [X] Dark/Light modes (with syntax highlighting depending on selected theme)
+- [X] Customizable navbar links
+- [X] Tags and Categories taxonomies
+- [X] Search functionality supporting Command + K shortcut
+- [X] Social links (github, gitlab, twitter, linkedin, email) 
+- [X] Postcss build process with cssnano (and tailwindcss tree shaking to reduce final bundle size)
+- [X] Uglifyjs build process with minification
+- [X] Example script to deploy to Github Pages
+- [X] Pagination
+- [X] Sidemenu menu with sections links
+- [X] Table of content (2 levels and currently viewed part highlighted)
+- [X] Multilingue
+- [X] 404
+- [X] Mobile responsive
+- [X] Favicon
+- [ ] Adsense
+
+## Deployment
+There is a section about deployment in Zola [documentation](https://www.getzola.org/documentation/deployment/overview/) but you'll find an [example](https://github.com/tchartron/blow/blob/main/deploy-github.sh) to deploy your site to github pages
+
+        

docs/content/themes/book/index.md

@@ -3,11 +3,11 @@
 title = "book"
 description = "A book theme inspired from GitBook/mdBook"
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://github.com/getzola/book.git"
 homepage = "https://github.com/getzola/book"
 minimum_version = "0.5.0"

docs/content/themes/clean-blog/index.md

@@ -3,11 +3,11 @@
 title = "Clean Blog"
 description = "A port of Start Bootstrap Clean Blog for Zola"
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://github.com/dave-tucker/zola-clean-blog"
 homepage = "https://github.com/dave-tucker/zola-clean-blog"
 minimum_version = "0.4.0"
@@ -56,7 +56,7 @@ taxonomies = [
 
 - To replace the copyright field, create your own `templates/index.html` to extend the template and add a `copyright` block:
 ```
-{%/* extends "themes/zola-clean-blog/templates/index.html" */%}
+{%/* extends "zola-clean-blog/templates/index.html" */%}
 {%/* block copyright */%}
 Copyright %copy; Example, Inc. 2016-2019
 {%/* endblock copyright */%}
@@ -68,7 +68,7 @@ Copyright %copy; Example, Inc. 2016-2019
 
 - To add Google Analytics, you may add your script to the `extrascripts` block using your own `index.html`
 ```
-{%/* extends "themes/zola-clean-blog/templates/index.html" */%}
+{%/* extends "zola-clean-blog/templates/index.html" */%}
 {%/* block analytics */%}
 <script>
 ...
@@ -76,3 +76,4 @@ Copyright %copy; Example, Inc. 2016-2019
 {%/* endblock analytics */%}
 ```
 
+        

docs/content/themes/codinfox-zola/index.md

@@ -3,11 +3,11 @@
 title = "codinfox-zola"
 description = "Codinfox theme for Zola"
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://github.com/svavs/codinfox-zola"
 homepage = "https://github.com/svavs/codinfox-zola"
 minimum_version = "0.11.0"

docs/content/themes/dinkleberg/index.md

@@ -3,11 +3,11 @@
 title = "dinkleberg"
 description = "The Rust BR theme for Gutenberg"
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://github.com/rust-br/dinkleberg.git"
 homepage = "https://github.com/rust-br/dinkleberg"
 minimum_version = "0.4.0"

docs/content/themes/docsascode-theme/index.md

@@ -3,11 +3,11 @@
 title = "Docsascode_theme"
 description = "A modern simple Zola's theme related to docs as code methodology"
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://github.com/codeandmedia/zola_docsascode_theme.git"
 homepage = "https://github.com/codeandmedia/zola_docsascode_theme"
 minimum_version = "0.10.0"

docs/content/themes/dose/index.md

@@ -3,20 +3,20 @@
 title = "dose"
 description = "a small blog theme"
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://github.com/oltdaniel/dose.git"
-homepage = "https://github.com/oltd/dose"
+homepage = "https://github.com/oltdaniel/dose"
-minimum_version = "0.13.0"
+minimum_version = "0.14.0"
 license = "MIT"
-demo = "https://oltd.github.io/dose"
+demo = "https://oltdaniel.github.io/dose"
 
 [extra.author]
-name = "oltd"
+name = "oltdaniel"
-homepage = "https://oltd.dev"
+homepage = "https://oltdaniel.eu"
 +++        
 
 # dose
@@ -29,7 +29,7 @@ First download this theme to your `themes` directory:
 
 ```bash
 cd themes
-git clone https://github.com/oltd/dose.git
+git clone https://github.com/oltdaniel/dose.git
 ```
 
 and then enable it in your `config.toml`:
@@ -51,8 +51,8 @@ And the theme uses the following extras:
 ```toml
 [extra]
 social_media = [
-    {name = "GitHub", url = "https://github.com/oltd"},
+    {name = "GitHub", url = "https://github.com/oltdaniel"},
-    {name = "Twitter", url = "https://twitter.com/@oltd_maker"},
+    {name = "Twitter", url = "https://twitter.com/@twitter"},
 ]
 ```
 
@@ -90,19 +90,38 @@ This theme supports dark and light mode. Currently this will be only switched ba
 
 #### Size
 
-We need about `2kB` extra stuff aside from images and raw html. This is divided up to `1.7kB CSS` and `~300B JS`.
+We need about `~2.3KiB` extra stuff aside from images and raw html. This is divided up to `~2.1KiB CSS` and `212B JS`.
+
+Test yourself with `zola build 1>/dev/null; echo "scale=2; $(cat public/**/*.{js,css} | wc -c)/1024" | bc -l`.
 
 #### Syntax Highlighting
 
 As I didn't want to invest any time in creating an own syntax color schema for this theme, I suggest to use `visual-studio-dark`, which is the same one used in the demo page.
 
+#### Customization
+
+You can create your own version of this theme, by simply changing the sass variables in `sass/style.scss` to match your taste.
+
+```scss
+/**
+ * Variables
+ */
+$base-background: white;
+$text-color: black;
+$article-tag: green;
+$lang-tag: red;
+$link-color: blue;
+$target-color: yellow;
+$separator-decoration: "//////";
+```
+
 ### TODO
 
-- [ ] introduce sass variables for colors
+- [x] introduce sass variables for colors
-- [ ] dark/light switch with javascript and store in browser session
+- [x] dark/light switch with javascript and store in browser local storage
 
 ## License
 
-![GitHub](https://img.shields.io/github/license/oltd/dose)
+![GitHub](https://img.shields.io/github/license/oltdaniel/dose)
 
         

docs/content/themes/even/index.md

@@ -3,11 +3,11 @@
 title = "even"
 description = "A robust, elegant dark theme"
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://github.com/getzola/even.git"
 homepage = "https://github.com/getzola/even"
 minimum_version = "0.11.0"

docs/content/themes/feather/index.md

@@ -3,11 +3,11 @@
 title = "feather"
 description = "A modern blog theme"
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://github.com/piedoom/feather"
 homepage = "https://github.com/piedoom/feather"
 minimum_version = "0.5.1"

docs/content/themes/float/index.md

@@ -3,11 +3,11 @@
 title = "Float"
 description = "An elegant blog theme"
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://gitlab.com/float-theme/float.git"
 homepage = "https://float-theme.netlify.app/"
 minimum_version = "0.11.0"
@@ -47,7 +47,7 @@ Float 是一款為 [Zola](https://www.getzola.org/) 設計的佈景主題。
 
 把 Float 以 Git 子模組的方式加入專案內：
 ```shell
-git submodule add https://gitlab.com/float-theme/float.git theme/float
+git submodule add https://gitlab.com/float-theme/float.git themes/float
 ```
 
 編輯您的 config.toml，指定 Float 作為佈景主題：

docs/content/themes/hallo/index.md

@@ -3,11 +3,11 @@
 title = "hallo"
 description = "A single-page theme to introduce yourself."
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://github.com/flyingP0tat0/zola-hallo.git"
 homepage = "https://github.com/janbaudisch/zola-hallo"
 minimum_version = "0.4.0"
@@ -56,10 +56,7 @@ theme = "hallo"
 
 ### Introduction
 
-The introduction text is included from `templates/partials/introduction.html`.
+The introduction text is made in `content/_index.md`.
-
-You will need to create this file and fill it with content.
-
 
 ## Options
 

docs/content/themes/hook/index.md

@@ -3,11 +3,11 @@
 title = "Hook"
 description = "Clean and simple personal site/blog theme"
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://github.com/InputUsername/zola-hook.git"
 homepage = "https://github.com/InputUsername/zola-hook"
 minimum_version = "0.15.2"

docs/content/themes/hyde/index.md

@@ -3,11 +3,11 @@
 title = "hyde"
 description = "A classic blog theme"
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://github.com/getzola/hyde.git"
 homepage = "https://github.com/getzola/hyde"
 minimum_version = "0.11.0"

docs/content/themes/juice/index.md

@@ -3,11 +3,11 @@
 title = "juice"
 description = "An intuitive, elegant, and lightweight Zola theme for product sites."
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://github.com/huhu/juice"
 homepage = "https://github.com/huhu/juice"
 minimum_version = "0.11.0"
@@ -106,6 +106,15 @@ You can override theme variable by creating a file named `_variables.html` in yo
 </style>
 ```
 
+### Favicon
+
+```html
+{%/* extends "juice/templates/index.html" */%}
+{%/* block favicon */%}
+    <link rel="icon" type="image/png" href="/favicon.ico">
+{%/* endblock favicon */%}
+```
+
 # Configuration
 
 You can customize some builtin property in `config.toml` file:

docs/content/themes/karzok/index.md

@@ -3,13 +3,13 @@
 title = "karzok"
 description = "A theme for your documentation. Fast and secure"
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://github.com/kogeletey/karzok"
-homepage = "https://fmatch.org/karzok"
+homepage = "https://github.com/kogeletey/karzok"
 minimum_version = "0.0.14"
 license = "Apache-2.0"
 demo = "https://fmatch.org/karzok"
@@ -19,12 +19,19 @@ name = "Konrad Geletey"
 homepage = ""
 +++        
 
-[![builds.sr.ht status](https://builds.sr.ht/~kogeletey/karzok.svg)](https://builds.sr.ht/~kogeletey/karzok?)
+<p align="center">
+  <a href="https://builds.sr.ht/~kogeletey/karzok"><img src="https://builds.sr.ht/~kogeletey/karzok.svg"  alt="builds.sr.ht status" /></a>
+  <a href="https://design.penpot.app/#/view/b4a9c170-5cb6-11ec-826f-e949c75b760d?page-id=ef8611e1-7c24-11eb-89c7-03f8ac143bbf&index=0&share-id=d81024f0-5cb7-11ec-826f-e949c75b760d"><img alt="designed with penpot" src="https://badgen.net/badge/designed%20with/penpot/31EFB8" /></a>
+</p>
+
 # Karzok
+
 A theme for your documentation. Fast and secure
 
 ![screenshot](./screenshot.png)
+
 ## Demo
+
 [Fmatch Karzok](https://fmatch.org/karzok)
 
 ## Requirements
@@ -41,11 +48,11 @@ for your platform.
 ### Optional
 
 1. [yj](https://github.com/sclevine/yj)
-    > for transfer toml file in yaml
+   > for transfer toml file in yaml
 2. [docker](https://docs.docker.com/engine/install/)
-    > for packaging container
+   > for packaging container
 3. [rsync](https://rsync.samba.org/)
-    > A better copy and move
+   > A better copy and move
 
 ## Get Started
 
@@ -82,21 +89,14 @@ See more in [Karzok Configuration](#configuration)
 
 ```zsh
     cp ./themes/content/_index.md content/_index.md
-    cp ./thems/content/tmpl.md content/filename.md
+    # a template will appear with which you can quickly start writing
+    # cp ./themes/content/tmpl.md content/filename.md
 ```
 
 how you can give freedom to your creativity
 
 ### 5. Run the project
 
-#### With [docker-compose](https://docs.docker.com/compose) and [cargo make](https://sagiegurari.github.io/cargo-make/)
-
-```zsh
-cargo make --makefile make.toml dockerup
-```
-
-#### Without
-
 i. development enviroment
 
 1. Install node dependencies needed to work
@@ -116,7 +116,7 @@ changes live reolad.
 
 ii. production enviroment
 
--   with docker
+- with docker
 
 1. Build docker image
 
@@ -150,10 +150,15 @@ Open in favorite browser [https://localhost](http://localhost)
 
 1. `math` - rendering math formulas throught [katex](https://katex.org)
 2. `favicon` - set path to favicon icon import(default `favicon`)
-3. `localcdn`- if you want to store all assets on your domain, then enable this setting
+3. `localcdn`- if you want to store all assets on your domain, then enable this
-4. `cdnurl` - you can customize your url to store assets,default use [jsdelivr](https://www.jsdelivr.com)
+   setting
-5. `[[extra.menu]]` - the main navigation on the site
+4. `cdnurl` - you can customize your url to store assets,default use
-6. `[[extra.header]]` - the header navigantion for the site
+   [jsdelivr](https://www.jsdelivr.com)
+5. `show_word_count` - allowing you to show number of words
+6. `show_reading_time`- allowing you to show reading time
+7. `children`- for header nesting to work
+8. `[[extra.menu]]` - the main navigation on the site
+9. `[[extra.header]]` - the header navigantion for the site
 
 ### Templates
 
@@ -164,26 +169,21 @@ All pages are extend to the base.html, and you can customize them as need.
 This program is Free Software: You can use, study share and improve it at your
 will. Specifically you can redistribute and/or modify it under the terms of the
 [Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0)
+
 # Contribute
+
 Make sure to read the [Code of Conduct](/meta/code-of-conduct)
 
 ## Find bugs and come up with features
-On the [todo.sr.ht](https://todo.sr.ht/~kogeletey/karzok) or [github issues](https://github.com/kogeletey/karzok/issues)
+
+On the [todo.sr.ht](https://todo.sr.ht/~kogeletey/karzok) or
+[github issues](https://github.com/kogeletey/karzok/issues)
 
 ## Improve Code
-The Karzok is stored in the repository at [sr.ht](https://sr.ht/~kogeletey/karzok) and mirror [github](https://github.com/kogeletey/karzok)
+
-### TODOs:
+The Karzok is stored in the repository at
--   [ ] readme contrubutions
+[sr.ht](https://sr.ht/~kogeletey/karzok) and mirror
--   [x] configure loading from cdn
+[github](https://github.com/kogeletey/karzok)
--   [x] choose code_of_conduct
--   [x] proceed subpages
--   [ ] create mobile version
--   [x] choose license
--   [ ] adding full path article in the page
--   [ ] make dark theme
--   [ ] continue author rendering
--   [ ] adding word count
--   [x] refactor home.scss
 
 > Thank you so much for any help
 

docs/content/themes/lightspeed/index.md

@@ -3,11 +3,11 @@
 title = "lightspeed"
 description = "Zola theme with a perfect Lighthouse score"
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://github.com/carpetscheme/lightspeed"
 homepage = "https://github.com/carpetscheme/lightspeed"
 minimum_version = "0.10.0"
@@ -42,7 +42,7 @@ Demo: [quirky-perlman-34d0da.netlify.com](https://quirky-perlman-34d0da.netlify.
   - [Footer menu](#footer-menu)
   - [SEO](#seo)
   - [Footer text](#footer-text)
-  - [Sass](#Sass)
+  - [Sass](#sass)
 - [Original](#original)
 - [License](#license)
 

docs/content/themes/ntun/index.md

@@ -3,11 +3,11 @@
 title = "ntun-zola-theme"
 description = "A classic resume theme"
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://github.com/Netoun/ntun"
 homepage = "https://github.com/netoun/ntun"
 minimum_version = "0.1.0"

docs/content/themes/oceanic-zen/index.md

@@ -3,11 +3,11 @@
 title = "Oceanic Zen"
 description = "Minimalistic blog theme"
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://github.com/barlog-m/oceanic-zen.git"
 homepage = "https://github.com/barlog-m/oceanic-zen"
 minimum_version = "0.12.0"

docs/content/themes/papaya/index.md

@@ -3,11 +3,11 @@
 title = "Papaya"
 description = "A clean Zola theme for blogging and projects"
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://github.com/justint/papaya.git"
 homepage = "https://github.com/justint/papaya"
 minimum_version = "0.14.0"
@@ -36,6 +36,8 @@ A clean [Zola](https://getzola.org) theme for blogging and projects, forked from
 - Blog posts
 - Project pages
 - Categories and tags
+- Multilingual support
+- Customizable sections and navigation menu links
 - Featured images for posts/pages
 - Smart image embedding shortcode (`{{/* img() */}}`)
 - GitHub repository star/fork counts
@@ -65,6 +67,7 @@ A clean [Zola](https://getzola.org) theme for blogging and projects, forked from
         { name = "tags" },
     ]
     ```
+
 4. In your `content` directory, add new `blog` and `projects` directories. Copy the `_index.md` file from Papaya's `content/blog` into your `content/blog`, and the `_index.md` and `categories.json` files from Papaya's `content/projects` into your `content/projects`.
  
    Your `content` directory structure should look like this:
@@ -93,64 +96,13 @@ A clean [Zola](https://getzola.org) theme for blogging and projects, forked from
 
 Here are the customizable features of Papaya: 
 
-- Navigation menu links
+- [Project categories](#project-categories)
-- Post/project date formats
+- [Multilingual support](#multilingual-support)
-- Post/project featured images
+- [Custom sections and navigation menu links](#custom-sections-and-navigation-menu-links)
-- Project categories
+- [Post/project date formats](#postproject-date-formats)
-- Open Graph Protocol locale/profile information
+- [Post/project featured images](#postproject-featured-images)
-- Social/contact links
+- [Open Graph Protocol locale/profile information](#open-graph-protocol-localeprofile-information)
-
+- [Social/contact links](#socialcontact-links)
-### Navigation menu links
-
-In your `config.toml` under the `[extra]` section you need to set the `papaya_menu_links` list.
-
-Example:
-
-```toml
-[extra]
-papaya_menu_links = [
-    { url = "$BASE_URL/about/", name = "About" },
-]
-```
-
-If you include `$BASE_URL` in the URL of a link it will be replaced with the base URL of your site.
-
-### Post/project date formats
-
-In your `config.toml` under the `[extra]` section you need to set the `papaya_date_format` value.
-
-Example:
-
-```toml
-[extra]
-papaya_date_format = "%e %B %Y"
-```
-
-The formatting uses the standard `date` filter in Tera. The date format options you can use are listed in the [chrono crate documentation](https://tera.netlify.app/docs/#date).
-
-### Post/project featured images
-
-Posts and projects can have featured images which display at the top of their page before the page contents.
-
-```toml
-[extra]
-featured_image = "image.jpg"
-featured_image_alt = "A lodge overlooks a forested mountain range."
-```
-
-![Featured image](pics/featured_image.png)
-
-Featured images can also be extended to the full width of the viewport:
-
-```toml
-[extra]
-featured_image = "image.jpg"
-featured_image_alt = "A lodge overlooks a forested mountain range."
-featured_image_extended = true
-```
-
-![Featured image, extended](pics/featured_image_extended.png)
-
 
 ### Project categories
 
@@ -179,6 +131,7 @@ Example `categories.json`:
 ```
 
 Example project page front matter:
+
 ```toml
 title = "Example software project"
 date = 2021-08-11
@@ -189,6 +142,264 @@ categories = ["software"]
 
 The example project page above would be grouped into & displayed within the "Software" category of your projects page.
 
+### Multilingual support
+
+Currently Zola has a basic internationalization (i18n) support, you can see this at [zola doc](https://www.getzola.org/documentation/content/multilingual/).
+
+To write a multilingual site, follow the steps below (English and Chinese in this example):
+
+1. Add a `default_language` configuration and `[languages.zh]` and `[languages.en]` sections to your `config.toml`:
+
+    ```toml
+    default_language = "en"
+
+    [languages]
+
+    [languages.en]
+
+    [languages.zh]
+    title = "中文标题"
+    description = "中文描述"
+    ```
+
+    Under the `[languages.zh]` section you can override default configurations like `title`, `description`, etc.
+
+2. Add translations of all keywords in `[languages.zh.translations]` and `languages.en.translations]` sections (see Papaya's [`config.toml`](config.toml) for a listing of all keywords):
+
+    ```toml
+    [languages]
+
+    [languages.en]
+
+    [languages.en.translations]
+    projects = "Projects"
+    blog = "Blog"
+    about = "About"
+    recent_projects = "Recent Projects"
+    more_projects = "More Projects"
+    recent_blog_posts = "Recent Blog Posts"
+    more_blog_posts = "More blog posts"
+    ...
+
+    [languages.zh]
+
+    [languages.zh.translations]
+    projects = "项目"
+    blog = "博文"
+    about = "关于"
+    recent_projects = "近期项目"
+    more_projects = "更多项目"
+    recent_blog_posts = "近期博文"
+    more_blog_posts = "更多博文"
+    ...
+    ```
+
+3. Add a `_index.zh.md` file into every section. 
+
+   For example: add `content/blog/_index.zh.md` and `content/projects/_index.zh.md`. 
+
+4. Provide a `{page-name}.zh.md` (or `index.zh.md` into the page's directory, if it has one) for every page you'd like to translate.
+
+   For example: add `content/blog/what-is-zola.zh.md` and `content/blog/blog-with-image/index.zh.md`.
+
+6. Add a `content/categories.zh.json` file. For example:
+
+    ```json
+    {
+        "软件": "software",
+        "电影": "film"
+    }
+    ```
+
+Now you will have a website that supports both English and Chinese! Since `default_language` in `config.toml` is set to "en", by visiting `{base_url}` you will see the English version of this blog. You can visit the Chinese version by visiting `{base_url}/zh`.
+
+A page (post or project) can be available in both languages or only in one language, and it's not necessary that a page is available in the default language.
+
+### Custom sections and navigation menu links
+
+The navigation menu is constructed from a list of `menu_items` in your `config.toml`. For example:
+```toml
+[extra]
+
+menu_items = [
+   { name = "projects", url = "$LANG_BASE_URL/projects", show_recent = true, recent_items = 3, recent_trans_key = "recent_projects", more_trans_key = "more_projects" },
+   { name = "blog", url = "$LANG_BASE_URL/blog", show_recent = true, recent_items = 3, recent_trans_key = "recent_blog_posts", more_trans_key = "more_blog_posts" },
+   { name = "tags", url = "$LANG_BASE_URL/tags" },
+   { name = "about", url = "$LANG_BASE_URL/about" },
+]
+```
+
+A `menu_item` can be one of two things:
+
+- **a link to a section.** Section links can be optionally configured to display its most recently authored items on your index page. See [Configuring section menu items](#configuring-section-menu-items).
+
+- **a link to a URL.** See [Configuring URL menu items](#configuring-url-menu-items)
+
+#### Configuring section menu items
+
+A section is created whenever a directory (or subdirectory) in the content section contains an `_index.md` file; see the [Zola docs on sections](https://www.getzola.org/documentation/content/section/). 
+
+Papaya has two sections by default: `projects` and `blog`. You can add additional sections or change section names.  For example, you can add a section called _Diary_. In order to add this section, you need to:
+
+1. Create a directory called `diary` in `content/`.
+
+2. Create an `_index.md` inside `content/diary/`, for example:
+
+    ```toml
+    +++
+    title = "Diary"
+    render = true
+    # diary will use blog.html for its template
+    template = "blog.html"
+    +++
+    ```
+
+Sections can be added to the navigation menu, and optionally configured to display its most recently authored items on your index page. To add your section to the navigation menu:
+
+1. In your `config.toml` under the `[extra]` section, add your section to the `menu_items`:
+
+    ```toml
+    [extra]
+    menu_items = [
+        ...
+        { name = "diary", url = "$LANG_BASE_URL/diary" }
+    ]
+    ```
+   
+2. In your `config.toml` under the `[languages.<code>.translations]` section, add your section name translation keys:
+
+   ```toml
+   [languages]
+   
+   [languages.en]
+   
+   [languages.en.translations]
+   diary = "Diary"
+   
+   [languages.zh]
+
+   [languages.zh.translations]
+   diary = "日记"
+   ```
+
+   This will add a simple hyperlink to your new _Diary_ section in the navigation menu.
+
+To also display recently authored items from your _Diary_ section on your index page:
+
+1. Add the following attributes to your menu item:
+
+   - `show_recent`: Adds the section's recent items listing to your index page.
+   - `recent_items`: Number of recent items to display.
+   - `recent_trans_key`: Translation key for the recent items listing title text.
+   - `more_trans_key`: Translation key for the hyperlink text to the section.
+
+   For example:
+
+   ```toml
+   [extra]
+   menu_items = [
+       ...
+       { name = "diary", url = "$LANG_BASE_URL/diary", show_recent = true, recent_items = 3, recent_trans_key = "recent_diary", more_trans_key = "more_diary" }
+   ]
+   ```
+
+2. In your `config.toml` under the `[languages.<code>.translations]` section, add your section name, `recent_trans_key`, and `more_trans_key` translation keys:
+
+    ```toml
+    [languages]
+
+    [languages.en]
+
+    [languages.en.translations]
+    diary = "Diary"
+    recent_diary = "Recent Diaries"
+    more_diary = "More Diaries"
+
+    [languages.zh]
+
+    [languages.zh.translations]
+    diary = "日记"
+    recent_diary = "近期日记"
+    more_diary = "更多日记"
+    ```
+   
+   This will add both a hyperlink to your new _Diary_ section in the navigation menu, and a listing of the three most recent items from your _Diary_ section on your index page.
+
+#### Configuring URL menu items
+
+If you want to add a simple link to the navigation menu, add an item with a `name` and `url`. For example:
+
+```toml
+[extra]
+sections = [
+    ...
+    { name = "tag", url = "$LANG_BASE_URL/tags" }
+]
+```
+
+A translation key for your link's `name` must be added into your `config.toml`:
+
+```toml
+[languages]
+
+[languages.en]
+
+[languages.en.translations]
+tag = "Tag"
+
+[languages.zh]
+
+[langauges.zh.translations]
+tag = "标签"
+```
+
+If you include `$BASE_URL` in the URL of a link it will be replaced with the base URL of your site, and `$LANG_BASE_URL` will be replaced with the language-specific base URL of your site.
+
+### Post/project date formats
+
+You can have different date formats in different languages. You need to set the `date_format` value in every langauge's translation section.
+
+Example:
+
+```toml
+[languages]
+
+[languages.en]
+
+[languages.en.translations]
+date_format = "%e %B %Y"
+
+[languages.zh]
+
+[languages.zh.translations]
+date_format = "%Y 年 %m 月 %d 日"
+```
+
+The formatting uses the standard `date` filter in Tera. The date format options you can use are listed in the [chrono crate documentation](https://tera.netlify.app/docs/#date).
+
+### Post/project featured images
+
+Posts and projects can have featured images which display at the top of their page before the page contents.
+
+```toml
+[extra]
+featured_image = "image.jpg"
+featured_image_alt = "A lodge overlooks a forested mountain range."
+```
+
+![Featured image](pics/featured_image.png)
+
+Featured images can also be extended to the full width of the viewport:
+
+```toml
+[extra]
+featured_image = "image.jpg"
+featured_image_alt = "A lodge overlooks a forested mountain range."
+featured_image_extended = true
+```
+
+![Featured image, extended](pics/featured_image_extended.png)
+
 ### Open Graph Protocol locale/profile information
 
 In your `config.toml` you can add a `[extra.ogp]` section to specify your Open Graph Protocol locale and profile information.
@@ -219,6 +430,27 @@ Example:
 email = "papaya@tiliqua.sp"
 github = "papaya"
 linkedin = "papayatiliqua"
+twitter = "papayathehisser"
+```
+
+If you want to include other custom social websites, you can add them to `other`:
+
+Example:
+
+```toml
+[extra.social]
+other = [
+    { name = "BTC", font_awesome = "fa-brands fa-btc", url = "https://www.bitcoin.com/" }
+]
+```
+
+The `font_awesome` attribute specifies the Font Awesome classes; you can find them in [Font Awesome](https://fontawesome.com/). Be aware that different versions of Font Awesome may include different sets of icons; you can change your version of Font Awesome by updating the CDN path in the `[extra.cdn]` section:
+
+```toml
+[extra]
+
+[extra.cdn]
+font_awesome = "https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0-beta2/css/all.min.css"
 ```
 
 ## Image embedding shortcode
@@ -226,15 +458,21 @@ linkedin = "papayatiliqua"
 Included with Papaya is a shortcode for embedding images into your posts:
 
 ```
-img(path, alt, caption, class, extended_width_pct)
+img(path, alt, caption, class, extended_width_pct, quality)
 ```
 
+You can use `./<image-path>` to specify the relative path of image which is relative to current markdown file.
+
 ### Arguments
 
-- `path`: The path to the image relative to the `content` directory in the [directory structure](https://www.getzola.org/documentation/getting-started/directory-structure/).
+- `path`: The path to the image. It can be either:
+  - a full path (eg: `https://somesite.com/my-image.jpg`), 
+  - relative to the `content` directory in the [directory structure](https://www.getzola.org/documentation/getting-started/directory-structure/) (eg: `@/projects/project-1/my-image.jpg`), or
+  - relative to the current markdown file (eg: `./my-image.jpg`).
 - `alt`: _(optional)_ The alternate text for the image.
 - `caption`: _(optional)_ A caption for the image. Text/HTML/Tera templates supported.
 - `class`: _(optional)_ Any CSS classes to assign to the image. Multiple classes should be separated with a space (`" "`).
+- `quality`: _(optional)_ JPEG or WebP quality of the image, in percent.  Only used when encoding JPEGs or WebPs; default value is `90`.
 - `extended_width_pct`: _(optional)_ The percentage by which the image's width should be expanded past it's default figure width, up to maximum configured pixel width. 
 
    Range is `0.0-1.0`, or `-1` for document width. 
@@ -265,7 +503,7 @@ By default, images embedded with the `img` shortcode will be inserted as a `figu
 
 ![Default sized image](pics/img_default.png)
 
-With the `extended_width_pct` argument, we can specify a percentage of how much the image should expand outside its default figure width, up to your maximum configured image width (`config.extras.images.max_width`, 2500px default).
+With the `extended_width_pct` argument, we can specify a percentage of how much the image should expand outside its default figure width, up to your maximum configured image width (`config.extra.images.max_width`, 2500px default).
 
 Here's an example with `extended_width_pct=0.1`:
 

docs/content/themes/resume/index.md

@@ -0,0 +1,166 @@
+
++++
+title = "resume"
+description = "A resume theme"
+template = "theme.html"
+date = 2022-01-23T23:20:14+01:00
+
+[extra]
+created = 2022-01-23T23:20:14+01:00
+updated = 2022-01-23T23:20:14+01:00
+repository = "https://github.com/AlongWY/zola-resume.git"
+homepage = "https://github.com/alongwy/zola-resume"
+minimum_version = "0.11.0"
+license = "MIT"
+demo = "https://resume.alongwy.top"
+
+[extra.author]
+name = "Feng Yunlong"
+homepage = "https://www.alongwy.top"
++++        
+
+# Zola Resume
+
+[Chinese Version](README.CN.md)
+
+Redesigned form [hugo resume](https://github.com/eddiewebb/hugo-resume).
+
+## Features
++ This is basically a single-page website with auto-scrolling based on left-hand nav.
++ Dedicated project/publications pages allow more detail.
++ Includes a client-side search at '/search'. 
++ Includes an `/admin` endpoint that can allow authorized users to use a WYSIWYG editor and commit files back to markdown, but with a Wordpress/CMS like experience.
+
+## Quick Start
+
+```bash
+git clone git@github.com:alongwy/zola-resume.git
+cd zola-resume
+zola serve
+# open http://127.0.0.1:1111/
+```
+
+## Installation
+Just earlier we showed you how to run the theme directly. Now we start to install the theme in an existing site step by step.
+
+### Step 1: Create a new zola site
+
+```bash
+zola init mysite
+```
+
+### Step 2: Install zola-resume
+Download this theme to your themes directory:
+
+```bash
+cd mysite/themes
+git clone git@github.com:alongwy/zola-resume.git
+```
+
+Or install as a submodule:
+
+```bash
+cd mysite
+git init  # if your project is a git repository already, ignore this command
+git submodule add git@github.com:alongwy/zola-resume.git themes/zola-resume
+```
+
+### Step 3: Configuration
+Enable the theme in your config.toml in the site derectory:
+
+```toml
+theme = "zola-resume"
+```
+
+Or copy the config.toml.example from the theme directory to your project's root directory:
+
+```bash
+cp themes/zola-resume/config.toml.example config.toml
+```
+
+#### For CMS
+
+```bash
+cp themes/zola-resume/static/admin/config.yml static/admin/config.yml
+```
+
+and change those
+
+```yaml
+# static/admin/config.yml
+
+backend:
+  name: github
+  repo: USERNAME/REPO
+  branch: BRANCH
+  cms_label_prefix: netlify-cms/
+  site_domain: DOMAIN.netlify.com
+```
+
+### Step 4: Add new content
+You can copy the content from the theme directory to your project:
+
+```
+cp -r themes/zola-resume/data .
+cp -r themes/zola-resume/content .
+```
+
+You can modify or add new posts in the content/blog, content/projects or other content directories as needed.
+
+### Step 5: Run the project
+Just run zola serve in the root path of the project:
+
+```
+zola serve
+```
+
+This will start the Zola development web server accessible by default at http://127.0.0.1:1111. Saved changes will live reload in the browser.
+
+## Examples
+
+![screenshot](https://raw.githubusercontent.com/alongwy/zola-resume/master/screenshot.png)
+
+See [along's site](https://resume.alongwy.top) for a live example.
+
+## Setup & Use
+
+This theme uses a combination of custom sections and some data files to drive content.
+
+### Summary
+Edit the main `contents/_index.md with a brief bio/summary`
+
+### Data files
+Data files are used for simple content presented on the homepage.
+
+- [data/certifications.json](https://github.com/AlongWY/zola-resume/blob/main/data/certifications.json)
+- [data/social.json](https://github.com/AlongWY/zola-resume/blob/main/data/social.json)
+- [data/skills.json](https://github.com/AlongWY/zola-resume/blob/main/data/skills.json)
+- [data/experience.json](https://github.com/AlongWY/zola-resume/blob/main/data/experience.json)
+- [data/education.json](https://github.com/AlongWY/zola-resume/blob/main/data/education.json)
+
+### Projects/Opensource
+
+The difference indicates your role as originator or colaborator.
+
+### Publications
+Similar to projects, create them under `publications`. Include any papers, speaking engagements, articles, etc.
+
+### Blog / Posts
+Similar to posts, create them under `blog`. Include any thoughts, musiings, etc.
+**This template does not support a `posts` folder**
+
+### Template params
+
+Almost All personal information outside the above details is captured by extra in [`config.toml`](https://github.com/AlongWY/zola-resume/blob/main/config.toml), or can be edited in the "Settings" collection if using CMS.
+
+## CMS Editor with Netlify CMS
+**Does not require deployment to Netlify!**
+
+[Netlify CMS](https://www.netlifycms.org/) is an open source project that enables CMS like experience for static site generation tools like Hugo. This theme includes a fully working integration and guide in [static/admin](https://github.com/AlongWY/zola-resume/tree/main/static/admin)
+
+## Credits
+
+This project ports the Hugo Resume theme by Feng Yunlong to support zola.
+
+
+        

docs/content/themes/sam/index.md

@@ -3,11 +3,11 @@
 title = "sam"
 description = "A Simple and Minimalist theme with a focus on typography and content."
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://github.com/janbaudisch/zola-sam.git"
 homepage = "https://github.com/janbaudisch/zola-sam"
 minimum_version = "0.4.0"

docs/content/themes/serene/index.md

@@ -3,11 +3,11 @@
 title = "serene"
 description = "A blog theme for zola, simple and clean."
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://github.com/isunjn/serene.git"
 homepage = "https://github.com/isunjn/serene"
 minimum_version = "0.9.0"
@@ -19,7 +19,7 @@ name = "isunjn"
 homepage = "https://github.com/isunjn"
 +++        
 
-English | [简体中文](README-cn.md)
+English | [简体中文](https://github.com/isunjn/serene/blob/main/README-cn.md)
 
 # Serene - A blog theme for zola
 
@@ -32,13 +32,13 @@ Serene is a simple and clean blog theme for Static-Site-Generator [Zola](https:/
 <details>
   <summary>Click to see screenshots</summary>
   
-  ![](screenshots/1.png)
+  ![](https://github.com/isunjn/serene/blob/main/screenshots/1.png?raw=true)
-  ![](screenshots/2.png)
+  ![](https://github.com/isunjn/serene/blob/main/screenshots/2.png?raw=true)
-  ![](screenshots/3.png)
+  ![](https://github.com/isunjn/serene/blob/main/screenshots/3.png?raw=true)
-  ![](screenshots/4.png)
+  ![](https://github.com/isunjn/serene/blob/main/screenshots/4.png?raw=true)
-  ![](screenshots/5.png)
+  ![](https://github.com/isunjn/serene/blob/main/screenshots/5.png?raw=true)
-  ![](screenshots/6.png)
+  ![](https://github.com/isunjn/serene/blob/main/screenshots/6.png?raw=true)
-  ![](screenshots/7.png)
+  ![](https://github.com/isunjn/serene/blob/main/screenshots/7.png?raw=true)
 </details>
 
 ## Features
@@ -80,6 +80,6 @@ Be noticed that to keep serene simple, some needs may not be considered. You can
 
 ## License
 
-[MIT](LICENSE)
+[MIT](https://github.com/isunjn/serene/blob/main/LICENSE)
 
         

docs/content/themes/simple-dev-blog/index.md

@@ -3,11 +3,11 @@
 title = "simple-dev-blog"
 description = "A simple dev blog theme with no javascript, prerendered linked pages and SEO tags."
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://github.com/bennetthardwick/simple-dev-blog-zola-starter"
 homepage = "https://github.com/bennetthardwick/simple-dev-blog-zola-starter"
 minimum_version = "0.4.0"

docs/content/themes/slim/index.md

@@ -3,11 +3,11 @@
 title = "Slim"
 description = "Slim is a minimal, clean and beautiful theme for Zola."
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://github.com/jameshclrk/zola-slim"
 homepage = "https://github.com/jameshclrk/zola-slim"
 minimum_version = "0.8.0"

docs/content/themes/solar-theme-zola/index.md

@@ -3,11 +3,11 @@
 title = "solar-theme-zola"
 description = "A port of solar-theme-hugo for zola"
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://github.com/hulufei/solar-theme-zola.git"
 homepage = "https://github.com/hulufei/solar-theme-zola"
 minimum_version = "0.4.0"

docs/content/themes/tale-zola/index.md

@@ -3,11 +3,11 @@
 title = "tale-zola"
 description = "Tala-Zola is a minimal Zola theme helping you to build a nice and seo-ready blog."
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://github.com/aaranxu/tale-zola.git"
 homepage = "https://github.com/aaranxu/tale-zola"
 minimum_version = "0.13.0"
@@ -207,7 +207,7 @@ disqus = false
 disqus_id = ""
 ```
 
-Code syntax highlighting. See also [syntax hightlighting](https://www.getzola.org/documentation/getting-started/configuration/#syntax-highlighting).
+Code syntax highlighting. See also [syntax highlighting](https://www.getzola.org/documentation/getting-started/configuration/#syntax-highlighting).
 
 ```toml
 [markdown]

docs/content/themes/toucan/index.md

@@ -3,11 +3,11 @@
 title = "Toucan"
 description = "Inspired from Pelican default theme"
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://git.42l.fr/HugoTrentesaux/toucan.git"
 homepage = "https://git.42l.fr/HugoTrentesaux/toucan"
 minimum_version = "0.8.0"

docs/content/themes/zerm/index.md

@@ -3,11 +3,11 @@
 title = "zerm"
 description = "A minimalistic and dark theme based on Radek Kozieł's theme for Hugo"
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://github.com/ejmg/zerm.git"
 homepage = "https://github.com/ejmg/zerm"
 minimum_version = "0.8.0"
@@ -56,6 +56,27 @@ theme](https://www.getzola.org/documentation/themes/installing-and-using-themes/
 In `config.toml`, you will find all values for customization that are supported
 thus far have documentation explaining how they are used. If there is any confusion or something is not working as intended, [please open an issue](https://github.com/ejmg/zerm/issues)!
 
+## math
+You can use KaTeX for mathematical typesetting.
+Assets are only available if you opt-in on a per-page level through
+a single line (`math=true`) on the extra section of the page frontmatter.
+
+``` md
+# index.md
++++
+title="this page title"
+...
+
+[extra]
+math=true
++++
+
+Content
+```
+
+Pages wich doesn't opt-in are not affected in any way, so you doesn't have
+to worry about any performance hit.
+
 ## license
 
 MIT. See `LICENSE.md` for more details.

docs/content/themes/zola-henry/index.md

@@ -3,11 +3,11 @@
 title = "henry"
 description = "A timeless blog theme"
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://github.com/sirodoht/zola-henry"
 homepage = "https://github.com/sirodoht/zola-henry"
 minimum_version = "0.4.0"

docs/content/themes/zola-paper/index.md

@@ -3,11 +3,11 @@
 title = "zola-paper"
 description = "A clean theme inspired from hugo-paper."
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://github.com/schoenenberg/zola-paper.git"
 homepage = "https://github.com/schoenenberg/zola-paper"
 minimum_version = "0.11.0"

docs/content/themes/zola-pickles/index.md

@@ -3,11 +3,11 @@
 title = "pickles"
 description = "A modern, simple, clean blog theme for Zola."
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://github.com/lukehsiao/zola-pickles.git"
 homepage = "https://github.com/lukehsiao/zola-pickles"
 minimum_version = "0.13.0"

docs/content/themes/zola-theme-hikari/index.md

@@ -3,11 +3,11 @@
 title = "Hikari"
 description = "Fluid, responsive blog theme for Zola"
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://github.com/waynee95/zola-theme-hikari"
 homepage = "https://github.com/waynee95/zola-theme-hikari"
 minimum_version = "0.5.1"

docs/content/themes/zola.386/index.md

@@ -3,11 +3,11 @@
 title = "zola.386"
 description = "Zola port of the BOOTSTRA.386 theme."
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://github.com/lopes/zola.386"
 homepage = "https://github.com/lopes/zola.386"
 minimum_version = "0.10.1"

docs/content/themes/zola_easydocs_theme/index.md

@@ -3,11 +3,11 @@
 title = "EasyDocs"
 description = "An easy way to create docs for your project"
 template = "theme.html"
-date = 2022-01-17T03:13:30+08:00
+date = 2022-01-23T23:20:14+01:00
 
 [extra]
-created = 2022-01-17T03:13:30+08:00
+created = 2022-01-23T23:20:14+01:00
-updated = 2022-01-17T03:13:30+08:00
+updated = 2022-01-23T23:20:14+01:00
 repository = "https://github.com/codeandmedia/zola_easydocs_theme.git"
 homepage = "https://github.com/codeandmedia/zola_easydocs_theme"
 minimum_version = "0.13.0"