Merge branch 'master' into next
|
@ -35,7 +35,7 @@ binary size
|
||||||
|
|
||||||
- The feed template variable `last_build_date` is renamed to `last_updated` to more accurately reflect its semantics
|
- The feed template variable `last_build_date` is renamed to `last_updated` to more accurately reflect its semantics
|
||||||
- The sitemap template’s `SitemapEntry` type’s `date` field has been renamed to `updated` to reflect that it will use the `updated` front-matter field if available, rather than `date`
|
- The sitemap template’s `SitemapEntry` type’s `date` field has been renamed to `updated` to reflect that it will use the `updated` front-matter field if available, rather than `date`
|
||||||
- Code is now wrapped in `<pre><code>` instead of just `<pre>
|
- Code blocks are now wrapped in `<pre><code>` instead of just `<pre>`
|
||||||
|
|
||||||
### Other
|
### Other
|
||||||
- Add `updated` front-matter field for pages, which sitemap templates will use for the `SitemapEntry.date` field instead of the `date` front-matter field, and which the default Atom feed template will use
|
- Add `updated` front-matter field for pages, which sitemap templates will use for the `SitemapEntry.date` field instead of the `date` front-matter field, and which the default Atom feed template will use
|
||||||
|
|
|
@ -34,3 +34,4 @@
|
||||||
| [peterlyons.com](https://peterlyons.com) | https://github.com/focusaurus/peterlyons.com-zola |
|
| [peterlyons.com](https://peterlyons.com) | https://github.com/focusaurus/peterlyons.com-zola |
|
||||||
| [blog.turbo.fish](https://blog.turbo.fish) | https://git.sr.ht/~jplatte/blog.turbo.fish |
|
| [blog.turbo.fish](https://blog.turbo.fish) | https://git.sr.ht/~jplatte/blog.turbo.fish |
|
||||||
| [guerinpe.com](https://guerinpe.com) | https://github.com/Grelot/blog |
|
| [guerinpe.com](https://guerinpe.com) | https://github.com/Grelot/blog |
|
||||||
|
| [uggla.fr](https://uggla.fr) | https://uggla.fr |
|
||||||
|
|
|
@ -32,7 +32,7 @@ in the `docs/content` folder of the repository and the community can use [its fo
|
||||||
| Data files | ![yes] | ![yes] | ![yes] | ![no] |
|
| Data files | ![yes] | ![yes] | ![yes] | ![no] |
|
||||||
| LiveReload | ![yes] | ![no] | ![yes] | ![yes] |
|
| LiveReload | ![yes] | ![no] | ![yes] | ![yes] |
|
||||||
| Netlify support | ![yes] | ![no] | ![yes] | ![no] |
|
| Netlify support | ![yes] | ![no] | ![yes] | ![no] |
|
||||||
| ZEIT Now support | ![yes] | ![no] | ![yes] | ![yes] |
|
| Vercel support | ![yes] | ![no] | ![yes] | ![yes] |
|
||||||
| Breadcrumbs | ![yes] | ![no] | ![no] | ![yes] |
|
| Breadcrumbs | ![yes] | ![no] | ![no] | ![yes] |
|
||||||
| Custom output formats | ![no] | ![no] | ![yes] | ![no] |
|
| Custom output formats | ![no] | ![no] | ![yes] | ![no] |
|
||||||
|
|
||||||
|
|
|
@ -16,6 +16,10 @@ For example the default would be page/1.
|
||||||
- `feed`: if set to `true`, a feed (atom by default) will be generated for each term.
|
- `feed`: if set to `true`, a feed (atom by default) will be generated for each term.
|
||||||
- `lang`: only set this if you are making a multilingual site and want to indicate which language this taxonomy is for
|
- `lang`: only set this if you are making a multilingual site and want to indicate which language this taxonomy is for
|
||||||
|
|
||||||
|
Insert into the configuration file (config.toml):
|
||||||
|
|
||||||
|
⚠️ Place the taxonomies key in the main section and not in the `[extra]` section
|
||||||
|
|
||||||
**Example 1:** (one language)
|
**Example 1:** (one language)
|
||||||
|
|
||||||
```toml
|
```toml
|
||||||
|
|
|
@ -1,6 +1,6 @@
|
||||||
+++
|
+++
|
||||||
title = "GitLab Pages"
|
title = "GitLab Pages"
|
||||||
weight = 30
|
weight = 40
|
||||||
+++
|
+++
|
||||||
|
|
||||||
We are going to use the GitLab CI runner to automatically publish the site (this CI runner is already included in your repository if you use GitLab.com).
|
We are going to use the GitLab CI runner to automatically publish the site (this CI runner is already included in your repository if you use GitLab.com).
|
||||||
|
|
36
docs/content/documentation/deployment/vercel.md
Normal file
|
@ -0,0 +1,36 @@
|
||||||
|
+++
|
||||||
|
title = "Vercel"
|
||||||
|
weight = 50
|
||||||
|
+++
|
||||||
|
|
||||||
|
Vercel (previously zeit) is similar to Netlify, making deployment of sites easy.
|
||||||
|
The sites are hosted by Vercel and automatically deployed whenever we push a
|
||||||
|
commit to our selected production branch (e.g, master).
|
||||||
|
|
||||||
|
If you don't have an account with Vercel, you can sign up [here](https://vercel.com/signup).
|
||||||
|
|
||||||
|
## Automatic deploys
|
||||||
|
|
||||||
|
Once you sign up you can import your site from a Git provider (Github, GitLab or Bitbucket).
|
||||||
|
After the import, you can set the settings for your project.
|
||||||
|
|
||||||
|
- Choose Framework Preset as **Other**
|
||||||
|
- Build command as `zola build` and make sure toggle on Override switch.
|
||||||
|
- By default Vercel chooses output directory as `public`, if you use a different directory then specify output directory.
|
||||||
|
- To add your own domain, go to domain setting in left and add it there.
|
||||||
|
|
||||||
|
|
||||||
|
All we have to is include a `vercel.json` in our project's root directory by
|
||||||
|
specifying the `ZOLA_VERSION` we want to use to deploy the site.
|
||||||
|
|
||||||
|
```
|
||||||
|
{
|
||||||
|
"build": {
|
||||||
|
"env": {
|
||||||
|
"ZOLA_VERSION": "0.11.0"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
And your site should now be up and running.
|
|
@ -105,7 +105,7 @@ $ zola --config config.staging.toml serve
|
||||||
|
|
||||||
By default, drafts are not loaded. If you wish to include them, pass the `--drafts` flag.
|
By default, drafts are not loaded. If you wish to include them, pass the `--drafts` flag.
|
||||||
|
|
||||||
### check
|
## check
|
||||||
|
|
||||||
The check subcommand will try to build all pages just like the build command would, but without writing any of the
|
The check subcommand will try to build all pages just like the build command would, but without writing any of the
|
||||||
results to disk. Additionally, it will also check all external links in Markdown files by trying to fetch
|
results to disk. Additionally, it will also check all external links in Markdown files by trying to fetch
|
||||||
|
|
|
@ -4,14 +4,23 @@ weight = 40
|
||||||
+++
|
+++
|
||||||
|
|
||||||
The default configuration is sufficient to get Zola running locally but not more than that.
|
The default configuration is sufficient to get Zola running locally but not more than that.
|
||||||
It follows the philosophy of paying for only what you need; almost everything is turned off by default.
|
It follows the philosophy of paying for only what you need, almost everything is turned off by default.
|
||||||
|
|
||||||
To change the configuration, edit the `config.toml` file.
|
To change the configuration, edit the `config.toml` file.
|
||||||
If you are not familiar with TOML, have a look at [the TOML spec](https://github.com/toml-lang/toml).
|
If you are not familiar with TOML, have a look at [the TOML spec](https://github.com/toml-lang/toml).
|
||||||
|
|
||||||
Only the `base_url` variable is mandatory; everything else is optional. All configuration variables
|
⚠️ If you add keys to your `config.toml`, you must pay attention to which toml section it belongs to.
|
||||||
used by Zola as well as their default values are listed below:
|
|
||||||
|
|
||||||
|
Here are the current `config.toml` sections:
|
||||||
|
1. main (unnamed)
|
||||||
|
2. link_checker
|
||||||
|
3. slugify
|
||||||
|
4. search
|
||||||
|
5. translations
|
||||||
|
6. extra
|
||||||
|
|
||||||
|
**Only the `base_url` variable is mandatory**. Everything else is optional. All configuration variables
|
||||||
|
used by Zola as well as their default values are listed below:
|
||||||
|
|
||||||
```toml
|
```toml
|
||||||
# The base URL of the site; the only required configuration variable.
|
# The base URL of the site; the only required configuration variable.
|
||||||
|
@ -86,18 +95,6 @@ ignored_content = []
|
||||||
# A list of directories used to search for additional `.sublime-syntax` files.
|
# A list of directories used to search for additional `.sublime-syntax` files.
|
||||||
extra_syntaxes = []
|
extra_syntaxes = []
|
||||||
|
|
||||||
# Optional translation object. The key if present should be a language code.
|
|
||||||
# Example:
|
|
||||||
# default_language = "fr"
|
|
||||||
#
|
|
||||||
# [translations]
|
|
||||||
# [translations.fr]
|
|
||||||
# title = "Un titre"
|
|
||||||
#
|
|
||||||
# [translations.en]
|
|
||||||
# title = "A title"
|
|
||||||
|
|
||||||
|
|
||||||
# Configuration of the link checker.
|
# Configuration of the link checker.
|
||||||
[link_checker]
|
[link_checker]
|
||||||
# Skip link checking for external URLs that start with these prefixes
|
# Skip link checking for external URLs that start with these prefixes
|
||||||
|
@ -134,10 +131,27 @@ include_content = true
|
||||||
|
|
||||||
|
|
||||||
# Optional translation object. Keys should be language codes.
|
# Optional translation object. Keys should be language codes.
|
||||||
|
# Optional translation object. The key if present should be a language code.
|
||||||
|
# Example:
|
||||||
|
# default_language = "fr"
|
||||||
|
#
|
||||||
|
# [translations]
|
||||||
|
# [translations.fr]
|
||||||
|
# title = "Un titre"
|
||||||
|
#
|
||||||
|
# [translations.en]
|
||||||
|
# title = "A title"
|
||||||
|
#
|
||||||
[translations]
|
[translations]
|
||||||
|
|
||||||
# You can put any kind of data here. The data
|
# You can put any kind of data here. The data
|
||||||
# will be accessible in all templates.
|
# will be accessible in all templates
|
||||||
|
# Example:
|
||||||
|
# [extra]
|
||||||
|
# author = "Famous author"
|
||||||
|
#
|
||||||
|
# author value will be available using {{ config.extra.author }} in templates
|
||||||
|
#
|
||||||
[extra]
|
[extra]
|
||||||
```
|
```
|
||||||
|
|
||||||
|
@ -170,7 +184,7 @@ Zola currently has the following highlight themes available:
|
||||||
- [ir-white](https://tmtheme-editor.herokuapp.com/#!/editor/theme/IR_White)
|
- [ir-white](https://tmtheme-editor.herokuapp.com/#!/editor/theme/IR_White)
|
||||||
- [kronuz](https://tmtheme-editor.herokuapp.com/#!/editor/theme/Kronuz)
|
- [kronuz](https://tmtheme-editor.herokuapp.com/#!/editor/theme/Kronuz)
|
||||||
- [material-dark](https://tmtheme-editor.herokuapp.com/#!/editor/theme/Material%20Dark)
|
- [material-dark](https://tmtheme-editor.herokuapp.com/#!/editor/theme/Material%20Dark)
|
||||||
- [material-light](https://github.com/morhetz/gruvbox)
|
- [material-light](https://tmtheme-editor.herokuapp.com/#!/editor/theme/Material%20Light)
|
||||||
- [monokai](https://tmtheme-editor.herokuapp.com/#!/editor/theme/Monokai)
|
- [monokai](https://tmtheme-editor.herokuapp.com/#!/editor/theme/Monokai)
|
||||||
- [nord](https://github.com/crabique/Nord-plist/tree/0d655b23d6b300e691676d9b90a68d92b267f7ec)
|
- [nord](https://github.com/crabique/Nord-plist/tree/0d655b23d6b300e691676d9b90a68d92b267f7ec)
|
||||||
- [nyx-bold](https://github.com/GalAster/vscode-theme-nyx)
|
- [nyx-bold](https://github.com/GalAster/vscode-theme-nyx)
|
||||||
|
|
|
@ -16,10 +16,10 @@ $ brew install zola
|
||||||
|
|
||||||
### Arch Linux
|
### Arch Linux
|
||||||
|
|
||||||
Use your favourite AUR helper to install the `zola-bin` package.
|
Zola is available in the official Arch Linux repositories.
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
$ yay -S zola-bin
|
$ pacman -S zola
|
||||||
```
|
```
|
||||||
|
|
||||||
### Fedora
|
### Fedora
|
||||||
|
@ -38,6 +38,13 @@ Zola is available in the official package repository.
|
||||||
$ pkg install zola
|
$ pkg install zola
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### OpenBSD
|
||||||
|
Zola is available in the official package repository.
|
||||||
|
|
||||||
|
```sh
|
||||||
|
$ doas pkg_add zola
|
||||||
|
```
|
||||||
|
|
||||||
### Snapcraft
|
### Snapcraft
|
||||||
|
|
||||||
Zola is available on snapcraft:
|
Zola is available on snapcraft:
|
||||||
|
|
|
@ -32,3 +32,27 @@ Feeds for taxonomy terms get two more variables, using types from the
|
||||||
|
|
||||||
- `taxonomy`: of type `TaxonomyConfig`
|
- `taxonomy`: of type `TaxonomyConfig`
|
||||||
- `term`: of type `TaxonomyTerm`, but without `term.pages` (use `pages` instead)
|
- `term`: of type `TaxonomyTerm`, but without `term.pages` (use `pages` instead)
|
||||||
|
|
||||||
|
Enable feed autodiscovery allows feed readers and browsers to notify user about a RSS or Atom feed available on your web site. So it is easier for user to subscribe.
|
||||||
|
As an example this is how it looks like using [Firefox](https://en.wikipedia.org/wiki/Mozilla_Firefox) [Livemarks](https://addons.mozilla.org/en-US/firefox/addon/livemarks/?src=search) addon.
|
||||||
|
|
||||||
|
![RSS feed autodiscovery example.](rss_feed.png)
|
||||||
|
|
||||||
|
You can enable posts autodiscovery modifying your blog `base.html` template adding the following code in between the `<head>` tags.
|
||||||
|
```html
|
||||||
|
{% block rss %}
|
||||||
|
<link rel="alternate" type="application/rss+xml" title="RSS" href="{{ get_url(path="rss.xml", trailing_slash=false) }}">
|
||||||
|
{% endblock %}
|
||||||
|
```
|
||||||
|
You can as well use an Atom feed using `type="application/atom+xml"` and `path="atom.xml"`.
|
||||||
|
|
||||||
|
All pages on your site will refer to your post feed.
|
||||||
|
|
||||||
|
In order to enable the tag feeds as well, you can overload the `block rss` using the following code in your `tags/single.html` template.
|
||||||
|
```html
|
||||||
|
{% block rss %}
|
||||||
|
{% set rss_path = "tags/" ~ term.name ~ "/rss.xml" %}
|
||||||
|
<link rel="alternate" type="application/rss+xml" title="RSS" href="{{ get_url(path=rss_path, trailing_slash=false) }}">
|
||||||
|
{% endblock rss %}
|
||||||
|
```
|
||||||
|
Each tag page will refer to it's dedicated feed.
|
BIN
docs/content/documentation/templates/feeds/rss_feed.png
Normal file
After Width: | Height: | Size: 13 KiB |
|
@ -37,7 +37,7 @@ The page and section variables are described in more detail in the next section.
|
||||||
|
|
||||||
## Built-in templates
|
## Built-in templates
|
||||||
Zola comes with four built-in templates: `atom.xml` and `rss.xml` (described in
|
Zola comes with four built-in templates: `atom.xml` and `rss.xml` (described in
|
||||||
[Feeds](@/documentation/templates/feeds.md)), `sitemap.xml` (described in [Sitemap](@/documentation/templates/sitemap.md)),
|
[Feeds](@/documentation/templates/feeds/index.md)), `sitemap.xml` (described in [Sitemap](@/documentation/templates/sitemap.md)),
|
||||||
and `robots.txt` (described in [Robots.txt](@/documentation/templates/robots.md)).
|
and `robots.txt` (described in [Robots.txt](@/documentation/templates/robots.md)).
|
||||||
Additionally, themes can add their own templates, which will be applied if not
|
Additionally, themes can add their own templates, which will be applied if not
|
||||||
overridden. You can override built-in or theme templates by creating a template with
|
overridden. You can override built-in or theme templates by creating a template with
|
||||||
|
|
|
@ -17,7 +17,7 @@ following fields:
|
||||||
name = "my theme name"
|
name = "my theme name"
|
||||||
description = "A classic blog theme"
|
description = "A classic blog theme"
|
||||||
license = "MIT"
|
license = "MIT"
|
||||||
homepage = "https://github.com/Keats/zola-hyde"
|
homepage = "https://github.com/getzola/hyde"
|
||||||
# The minimum version of Zola required
|
# The minimum version of Zola required
|
||||||
min_version = "0.4.0"
|
min_version = "0.4.0"
|
||||||
# An optional live demo URL
|
# An optional live demo URL
|
||||||
|
|
|
@ -3,23 +3,25 @@
|
||||||
title = "Ergo"
|
title = "Ergo"
|
||||||
description = "A simple blog Theme focused on writing, inspired by svbtle"
|
description = "A simple blog Theme focused on writing, inspired by svbtle"
|
||||||
template = "theme.html"
|
template = "theme.html"
|
||||||
date = 2018-09-03T02:13:01-04:00
|
date = 2020-08-10T11:31:05+02:00
|
||||||
|
|
||||||
[extra]
|
[extra]
|
||||||
created = 2019-07-12T23:49:55+02:00
|
created = 2020-08-10T11:31:05+02:00
|
||||||
updated = 2018-09-03T02:13:01-04:00
|
updated = 2020-08-10T11:31:05+02:00
|
||||||
repository = "https://github.com/InsidiousMind/Ergo"
|
repository = "https://github.com/InsidiousMind/Ergo.git"
|
||||||
homepage = "https://github.com/InsidiousMind/Ergo"
|
homepage = "https://github.com/insipx/Ergo"
|
||||||
minimum_version = "0.4.1"
|
minimum_version = "0.4.1"
|
||||||
license = "MIT"
|
license = "MIT"
|
||||||
demo = "https://ergo.liquidthink.net"
|
demo = "https://ergo.liquidthink.net"
|
||||||
|
|
||||||
[extra.author]
|
[extra.author]
|
||||||
name = "Andrew Plaza"
|
name = "Andrew Plaza"
|
||||||
homepage = "https://code.liquidthink.net"
|
homepage = "https://liquidthink.net"
|
||||||
+++
|
+++
|
||||||
|
|
||||||
[ergo](http://ergo.liquidthink.net)
|
[ergo LIVE DEMO](http://ergo.liquidthink.net)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
![Ergo Screenshot](https://i.imgur.com/l182IYg.jpg)
|
![Ergo Screenshot](https://i.imgur.com/l182IYg.jpg)
|
||||||
|
|
||||||
|
@ -59,6 +61,9 @@ Change them however you like! Feel free to go into theme and edit the colors. Ho
|
||||||
# and update your config.toml accordingly
|
# and update your config.toml accordingly
|
||||||
profile = 'profile.svg'
|
profile = 'profile.svg'
|
||||||
|
|
||||||
|
# Description. This is needed for SEO/site metadata purposes
|
||||||
|
description = "Simple blog theme focused on writing, inspired by svbtle"
|
||||||
|
|
||||||
# website, should not be preceded with `http://`
|
# website, should not be preceded with `http://`
|
||||||
website = "code.liquidthink.net"
|
website = "code.liquidthink.net"
|
||||||
|
|
||||||
|
@ -70,6 +75,12 @@ twitter = "liquid_think"
|
||||||
email = "${MY_EMAIL}@cool_domain.com"
|
email = "${MY_EMAIL}@cool_domain.com"
|
||||||
# instagram
|
# instagram
|
||||||
instagram = "${your_insta}"
|
instagram = "${your_insta}"
|
||||||
|
# keybase
|
||||||
|
keybase = "${your_keybase}"
|
||||||
|
# linkedin
|
||||||
|
linkedin = "${your_linkedin}"
|
||||||
|
# reddit
|
||||||
|
reddit = "${your_reddit}"
|
||||||
# youtube
|
# youtube
|
||||||
youtube = "${your_youtube_channel_id}"
|
youtube = "${your_youtube_channel_id}"
|
||||||
# if any social networks are missing from this list that you want added, open an issue. I will add it for you ASAP
|
# if any social networks are missing from this list that you want added, open an issue. I will add it for you ASAP
|
||||||
|
|
|
@ -3,11 +3,11 @@
|
||||||
title = "Zulma"
|
title = "Zulma"
|
||||||
description = "A zola theme based off bulma.css"
|
description = "A zola theme based off bulma.css"
|
||||||
template = "theme.html"
|
template = "theme.html"
|
||||||
date = 2019-05-12T22:44:07+01:00
|
date = 2020-08-10T11:31:05+02:00
|
||||||
|
|
||||||
[extra]
|
[extra]
|
||||||
created = 2019-07-12T23:55:11+02:00
|
created = 2020-08-10T11:31:05+02:00
|
||||||
updated = 2019-05-12T22:44:07+01:00
|
updated = 2020-08-10T11:31:05+02:00
|
||||||
repository = "https://github.com/Worble/Zulma"
|
repository = "https://github.com/Worble/Zulma"
|
||||||
homepage = "https://github.com/Worble/Zulma"
|
homepage = "https://github.com/Worble/Zulma"
|
||||||
minimum_version = "0.6.0"
|
minimum_version = "0.6.0"
|
||||||
|
@ -56,7 +56,7 @@ git clone https://github.com/Worble/Zulma
|
||||||
and then enable it in your `config.toml`:
|
and then enable it in your `config.toml`:
|
||||||
|
|
||||||
```toml
|
```toml
|
||||||
theme = "zulma"
|
theme = "Zulma"
|
||||||
```
|
```
|
||||||
|
|
||||||
That's it! No more configuration should be required, however it might look a little basic. Head to the [Options](#options) section to see what you can set for more customizability.
|
That's it! No more configuration should be required, however it might look a little basic. Head to the [Options](#options) section to see what you can set for more customizability.
|
||||||
|
@ -73,7 +73,7 @@ All the source javascript files live in `javascript/src`. Following is a list of
|
||||||
|
|
||||||
### Building
|
### Building
|
||||||
|
|
||||||
The javascript files are transpiled by babel, minified by webpack, sourcemaps are generated and then everything placed in `static/js`. The repo already contains the transpiled and minified files along with their corrosponding sourcemaps so you don't need to do anything to use these. If you would prefer to build it yourself, feel free to inspect the js files and then run the build process yourself (please ensure that you have [node, npm](https://nodejs.org/en/) and optionally [yarn](https://yarnpkg.com/lang/en/) installed):
|
The JavaScript files are transpiled by babel, minified by webpack, sourcemaps are generated and then everything placed in `static/js`. The repo already contains the transpiled and minified files along with their corrosponding sourcemaps so you don't need to do anything to use these. If you would prefer to build it yourself, feel free to inspect the js files and then run the build process (please ensure that you have [node, npm](https://nodejs.org/en/) and optionally [yarn](https://yarnpkg.com/lang/en/) installed):
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
cd javascript
|
cd javascript
|
||||||
|
@ -81,6 +81,10 @@ yarn
|
||||||
yarn webpack
|
yarn webpack
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### Github warnings
|
||||||
|
|
||||||
|
You may get warnings about vulnerabilities from the JavaScript dependencies. These shouldn't be an issue since we only have dev-dependencies and none of the them reach the end-user, but if you don't want to run the buld process yourself, and to stop Github pestering you about security warnings, feel free to delete the top level `javascript` folder when committing.
|
||||||
|
|
||||||
## Options
|
## Options
|
||||||
|
|
||||||
### Pagination
|
### Pagination
|
||||||
|
@ -100,8 +104,8 @@ Zulma has 3 taxonomies already set internally: `tags`, `cateogories` and `author
|
||||||
```toml
|
```toml
|
||||||
taxonomies = [
|
taxonomies = [
|
||||||
{name = "categories"},
|
{name = "categories"},
|
||||||
{name = "tags", paginate_by = 5, feed = true},
|
{name = "tags", paginate_by = 5, rss = true},
|
||||||
{name = "authors", feed = true},
|
{name = "authors", rss = true},
|
||||||
]
|
]
|
||||||
```
|
```
|
||||||
|
|
||||||
|
@ -231,7 +235,7 @@ zulma_allow_theme_selection = true
|
||||||
|
|
||||||
## Original
|
## Original
|
||||||
|
|
||||||
This template is based on the [blog template](https://dansup.github.io/bulma-templates/templates/blog.html) over at [Free Bulma Templates](https://dansup.github.io/bulma-templates/). All themes were taken from [Bulmaswatch](https://jenil.github.io/bulmaswatch/). The code behind from originally adapted from the [after-dark](https://github.com/getzola/after-dark/blob/master/README.md) zola template.
|
This template is based on the [blog template](https://bulmatemplates.github.io/bulma-templates/templates/blog.html) over at [Free Bulma Templates](https://bulmatemplates.github.io/bulma-templates/). All themes were taken from [Bulmaswatch](https://jenil.github.io/bulmaswatch/). The code behind from originally adapted from the [after-dark](https://github.com/getzola/after-dark/blob/master/README.md) zola template.
|
||||||
|
|
||||||
## Known Bugs
|
## Known Bugs
|
||||||
|
|
||||||
|
|
|
@ -3,14 +3,14 @@
|
||||||
title = "after-dark"
|
title = "after-dark"
|
||||||
description = "A robust, elegant dark theme"
|
description = "A robust, elegant dark theme"
|
||||||
template = "theme.html"
|
template = "theme.html"
|
||||||
date = 2017-11-07T17:39:37+01:00
|
date = 2020-08-10T11:31:05+02:00
|
||||||
|
|
||||||
[extra]
|
[extra]
|
||||||
created = 2019-04-06T11:27:43+02:00
|
created = 2020-08-10T11:31:05+02:00
|
||||||
updated = 2017-11-07T17:39:37+01:00
|
updated = 2020-08-10T11:31:05+02:00
|
||||||
repository = "https://github.com/getzola/after-dark"
|
repository = "https://github.com/getzola/after-dark.git"
|
||||||
homepage = "https://github.com/getzola/after-dark"
|
homepage = "https://github.com/getzola/after-dark"
|
||||||
minimum_version = "0.5.0"
|
minimum_version = "0.11.0"
|
||||||
license = "MIT"
|
license = "MIT"
|
||||||
demo = "https://zola-after-dark.netlify.com"
|
demo = "https://zola-after-dark.netlify.com"
|
||||||
|
|
||||||
|
@ -55,9 +55,9 @@ The theme requires tags and categories taxonomies to be enabled in your `config.
|
||||||
|
|
||||||
```toml
|
```toml
|
||||||
taxonomies = [
|
taxonomies = [
|
||||||
# You can enable/disable feeds
|
# You can enable/disable RSS
|
||||||
{name = "categories", feed = true},
|
{name = "categories", rss = true},
|
||||||
{name = "tags", feed = true},
|
{name = "tags", rss = true},
|
||||||
]
|
]
|
||||||
```
|
```
|
||||||
If you want to paginate taxonomies pages, you will need to overwrite the templates
|
If you want to paginate taxonomies pages, you will need to overwrite the templates
|
||||||
|
|
79
docs/content/themes/anpu/index.md
Normal file
|
@ -0,0 +1,79 @@
|
||||||
|
|
||||||
|
+++
|
||||||
|
title = "Anpu"
|
||||||
|
description = "A port of the Hugo Anubis theme"
|
||||||
|
template = "theme.html"
|
||||||
|
date = 2020-08-10T11:31:05+02:00
|
||||||
|
|
||||||
|
[extra]
|
||||||
|
created = 2020-08-10T11:31:05+02:00
|
||||||
|
updated = 2020-08-10T11:31:05+02:00
|
||||||
|
repository = "https://github.com/zbrox/anpu-zola-theme.git"
|
||||||
|
homepage = "https://github.com/zbrox/anpu-zola-theme"
|
||||||
|
minimum_version = "0.11.0"
|
||||||
|
license = "MIT"
|
||||||
|
demo = "https://anpu-zola-theme.netlify.app"
|
||||||
|
|
||||||
|
[extra.author]
|
||||||
|
name = "Rostislav Raykov"
|
||||||
|
homepage = "https://zbrox.com"
|
||||||
|
+++
|
||||||
|
|
||||||
|
# Anpu theme for Zola
|
||||||
|
|
||||||
|
This is a port of the Hugo theme [Anubis](https://github.com/Mitrichius/hugo-theme-anubis/tree/master/layouts) for [Zola](https://getzola.com).
|
||||||
|
|
||||||
|
![screenshot](screenshot.png)
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
In order to use the theme you need to clone this repository in your `themes` folder and set your theme setting in `config.toml` to `anpu`. Like this
|
||||||
|
|
||||||
|
```toml
|
||||||
|
theme = "anpu"
|
||||||
|
```
|
||||||
|
|
||||||
|
This theme requires both the `tags` and `categories` taxonomies.
|
||||||
|
|
||||||
|
```toml
|
||||||
|
taxonomies = [
|
||||||
|
{ name = "categories" },
|
||||||
|
{ name = "tags" },
|
||||||
|
]
|
||||||
|
```
|
||||||
|
|
||||||
|
## How To Customize
|
||||||
|
|
||||||
|
There are two things you can customize:
|
||||||
|
|
||||||
|
- The links to be included in the menu
|
||||||
|
- The date format of the posts
|
||||||
|
|
||||||
|
### Menu links
|
||||||
|
|
||||||
|
In your `config.toml` under the `[extra]` section you need to set the `anpu_menu_links` list.
|
||||||
|
|
||||||
|
Example:
|
||||||
|
|
||||||
|
```toml
|
||||||
|
[extra]
|
||||||
|
anpu_menu_links = [
|
||||||
|
{ url = "$BASE_URL/about/", name = "About" },
|
||||||
|
]
|
||||||
|
```
|
||||||
|
|
||||||
|
If you include `$BASE_URL` in the url of a link it will be replaced to the base url of your site.
|
||||||
|
|
||||||
|
### Date format
|
||||||
|
|
||||||
|
In your `config.toml` under the `[extra]` section you need to set the `anpu_date_format` value.
|
||||||
|
|
||||||
|
Example:
|
||||||
|
|
||||||
|
```toml
|
||||||
|
[extra]
|
||||||
|
anpu_date_format = "%e %B %Y"
|
||||||
|
```
|
||||||
|
|
||||||
|
The formatting uses the standart `date` filter in Tera. The date format options you can use are listed in the [chrono crate documentation](https://tera.netlify.app/docs/#date).
|
||||||
|
|
BIN
docs/content/themes/anpu/screenshot.png
Normal file
After Width: | Height: | Size: 261 KiB |
|
@ -3,12 +3,12 @@
|
||||||
title = "book"
|
title = "book"
|
||||||
description = "A book theme inspired from GitBook/mdBook"
|
description = "A book theme inspired from GitBook/mdBook"
|
||||||
template = "theme.html"
|
template = "theme.html"
|
||||||
date = 2018-01-28T10:53:19+01:00
|
date = 2020-08-10T11:31:05+02:00
|
||||||
|
|
||||||
[extra]
|
[extra]
|
||||||
created = 2018-11-17T18:27:11+01:00
|
created = 2020-08-10T11:31:05+02:00
|
||||||
updated = 2018-01-28T10:53:19+01:00
|
updated = 2020-08-10T11:31:05+02:00
|
||||||
repository = "https://github.com/getzola/book"
|
repository = "https://github.com/getzola/book.git"
|
||||||
homepage = "https://github.com/getzola/book"
|
homepage = "https://github.com/getzola/book"
|
||||||
minimum_version = "0.5.0"
|
minimum_version = "0.5.0"
|
||||||
license = "MIT"
|
license = "MIT"
|
||||||
|
|
|
@ -3,11 +3,11 @@
|
||||||
title = "Clean Blog"
|
title = "Clean Blog"
|
||||||
description = "A port of Start Bootstrap Clean Blog for Zola"
|
description = "A port of Start Bootstrap Clean Blog for Zola"
|
||||||
template = "theme.html"
|
template = "theme.html"
|
||||||
date = 2020-01-01T23:06:35+00:00
|
date = 2020-08-10T11:31:05+02:00
|
||||||
|
|
||||||
[extra]
|
[extra]
|
||||||
created = 2020-01-01T23:06:35+00:00
|
created = 2020-08-10T11:31:05+02:00
|
||||||
updated = 2020-01-01T23:06:35+00:00
|
updated = 2020-08-10T11:31:05+02:00
|
||||||
repository = "https://github.com/dave-tucker/zola-clean-blog"
|
repository = "https://github.com/dave-tucker/zola-clean-blog"
|
||||||
homepage = "https://github.com/dave-tucker/zola-clean-blog"
|
homepage = "https://github.com/dave-tucker/zola-clean-blog"
|
||||||
minimum_version = "0.4.0"
|
minimum_version = "0.4.0"
|
||||||
|
|
76
docs/content/themes/codinfox-zola/index.md
Normal file
|
@ -0,0 +1,76 @@
|
||||||
|
|
||||||
|
+++
|
||||||
|
title = "codinfox-zola"
|
||||||
|
description = "Codinfox theme for Zola"
|
||||||
|
template = "theme.html"
|
||||||
|
date = 2020-08-10T11:31:05+02:00
|
||||||
|
|
||||||
|
[extra]
|
||||||
|
created = 2020-08-10T11:31:05+02:00
|
||||||
|
updated = 2020-08-10T11:31:05+02:00
|
||||||
|
repository = "https://github.com/svavs/codinfox-zola"
|
||||||
|
homepage = "https://github.com/svavs/codinfox-zola"
|
||||||
|
minimum_version = "0.11.0"
|
||||||
|
license = "MIT"
|
||||||
|
demo = "https://svavs.github.io/"
|
||||||
|
|
||||||
|
[extra.author]
|
||||||
|
name = "Silvano Sallese"
|
||||||
|
homepage = "https://svavs.github.io/"
|
||||||
|
+++
|
||||||
|
|
||||||
|
# Codinfox-Zola
|
||||||
|
|
||||||
|
This is a [Zola](https://www.getzola.com) theme inspired to [Codinfox-Lanyon](https://codinfox.github.com/), a Lanyon based theme for [Jekyll](http://jekyllrb.com). See a live demo [here](https://codinfox-zola.vercel.app/).
|
||||||
|
|
||||||
|
This theme places content first by tucking away navigation in a hidden drawer.
|
||||||
|
|
||||||
|
* Built for [Zola](https://www.getzola.com)
|
||||||
|
* Developed on GitHub and hosted for free on [GitHub Pages](https://pages.github.com)
|
||||||
|
* Coded with [Spacemacs](https://www.spacemacs.org)
|
||||||
|
|
||||||
|
This theme supports:
|
||||||
|
|
||||||
|
1. Theme colors: you can choose your favorite theme color (changing in `_config.scss`)
|
||||||
|
2. Changable sidebar locations (reverse it by changing the boolean value in `_config.scss`)
|
||||||
|
3. Integration of FontAwesome, MathJax, Disqus and Google Analytics
|
||||||
|
4. Support for multilingual sites
|
||||||
|
4. and numerous improvements over original Lanyon and Codinfox-Lanyon
|
||||||
|
|
||||||
|
All the configuration variables and their meaning are inside:
|
||||||
|
|
||||||
|
- `config.toml` (for the zola config variables and some extra variables required by this theme),
|
||||||
|
- `author.toml` (for the personal informations to be displayed about the author of the site),
|
||||||
|
- `nav.toml` (for the navigation menu structure available in the site's sidebar)
|
||||||
|
- `_config.scss` (for the definition of some css customizations)
|
||||||
|
|
||||||
|
The options are fairly straightforward and described in comments.
|
||||||
|
|
||||||
|
Learn more and contribute on [GitHub](https://github.com/svavs/codinfox-zola).
|
||||||
|
|
||||||
|
Have questions or suggestions? Feel free to [open an issue on GitHub](https://github.com/svavs/codinfox-zola/issues/new) or [ask me on Twitter](https://twitter.com/svavs).
|
||||||
|
|
||||||
|
### Install and use
|
||||||
|
|
||||||
|
To use this theme you can follow the instruction required by any Zola theme.
|
||||||
|
|
||||||
|
Simply clone this repository under the `themes` folder of your site's main folder.
|
||||||
|
|
||||||
|
Then, define the required extra variables in the config.toml (take it from the config.toml file of the theme), create and define the author.toml and nav.toml configuration files in the main folder of your site (the same level of the config.toml), and that's it!
|
||||||
|
|
||||||
|
To define your own home picture, put an image file in the `static/img/` folder and set the path in the config.extra.image variable.
|
||||||
|
|
||||||
|
Now is possible to create the content inside the `content` folder as usual for Zola sites.
|
||||||
|
|
||||||
|
If you want to have a Blog with this theme, then create a folder inside the `content` folder containing all the blog posts in Markdown format. Zola automatically generate a section that you can manage as a blog. See an example in the [live demo](https://codinfox-zola.vercel.app/blog/).
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
Open sourced under the [MIT license](LICENSE.md).
|
||||||
|
|
||||||
|
|
||||||
|
## TODO
|
||||||
|
- recaptcha for hiding email address link (https://developers.google.com/recaptcha/intro)
|
||||||
|
- hidden multilingual links in topbar for main index section pages
|
||||||
|
|
||||||
|
|
BIN
docs/content/themes/codinfox-zola/screenshot.png
Normal file
After Width: | Height: | Size: 244 KiB |
|
@ -3,11 +3,11 @@
|
||||||
title = "dinkleberg"
|
title = "dinkleberg"
|
||||||
description = "The Rust BR theme for Gutenberg"
|
description = "The Rust BR theme for Gutenberg"
|
||||||
template = "theme.html"
|
template = "theme.html"
|
||||||
date = 2018-05-31T23:02:50-03:00
|
date = 2020-08-10T11:31:05+02:00
|
||||||
|
|
||||||
[extra]
|
[extra]
|
||||||
created = 2019-04-06T11:27:43+02:00
|
created = 2020-08-10T11:31:05+02:00
|
||||||
updated = 2018-05-31T23:02:50-03:00
|
updated = 2020-08-10T11:31:05+02:00
|
||||||
repository = "https://github.com/rust-br/dinkleberg.git"
|
repository = "https://github.com/rust-br/dinkleberg.git"
|
||||||
homepage = "https://github.com/rust-br/dinkleberg"
|
homepage = "https://github.com/rust-br/dinkleberg"
|
||||||
minimum_version = "0.4.0"
|
minimum_version = "0.4.0"
|
||||||
|
@ -46,6 +46,7 @@ label_next = "Próxima"
|
||||||
label_previous = "Anterior"
|
label_previous = "Anterior"
|
||||||
label_page = "Página"
|
label_page = "Página"
|
||||||
label_of = "de"
|
label_of = "de"
|
||||||
|
label_minutes = "minutos"
|
||||||
|
|
||||||
og_image="" # Image that will appear on social media
|
og_image="" # Image that will appear on social media
|
||||||
og_alt_image="" # Alt for og_image
|
og_alt_image="" # Alt for og_image
|
||||||
|
|
|
@ -3,16 +3,16 @@
|
||||||
title = "Docsascode_theme"
|
title = "Docsascode_theme"
|
||||||
description = "A modern simple Zola's theme related to docs as code methodology"
|
description = "A modern simple Zola's theme related to docs as code methodology"
|
||||||
template = "theme.html"
|
template = "theme.html"
|
||||||
date = 2020-03-05T23:16:20+03:00
|
date = 2020-08-10T11:31:05+02:00
|
||||||
|
|
||||||
[extra]
|
[extra]
|
||||||
created = 2020-03-05T23:16:20+03:00
|
created = 2020-08-10T11:31:05+02:00
|
||||||
updated = 2020-03-05T23:16:20+03:00
|
updated = 2020-08-10T11:31:05+02:00
|
||||||
repository = "https://github.com/codeandmedia/zola_docsascode_theme.git"
|
repository = "https://github.com/codeandmedia/zola_docsascode_theme.git"
|
||||||
homepage = "https://github.com/codeandmedia/zola_docsascode_theme"
|
homepage = "https://github.com/codeandmedia/zola_docsascode_theme"
|
||||||
minimum_version = "0.10.0"
|
minimum_version = "0.10.0"
|
||||||
license = "MIT"
|
license = "MIT"
|
||||||
demo = "docsascode.codeandmedia.com"
|
demo = "https://docsascode.codeandmedia.com"
|
||||||
|
|
||||||
[extra.author]
|
[extra.author]
|
||||||
name = "Roman Soldatenkov"
|
name = "Roman Soldatenkov"
|
||||||
|
@ -23,10 +23,10 @@ homepage = "https://codeandmedia.com"
|
||||||
|
|
||||||
I was inspired by [Linode's approach](https://www.linode.com/2020/01/17/docs-as-code-at-linode/) to creating and managing docs. They call it _docs as code methodology._ Thereby my aim was making simple and productive way to work with any sort of documents and articles through Markdown, Git and Docker/k8s optionally.
|
I was inspired by [Linode's approach](https://www.linode.com/2020/01/17/docs-as-code-at-linode/) to creating and managing docs. They call it _docs as code methodology._ Thereby my aim was making simple and productive way to work with any sort of documents and articles through Markdown, Git and Docker/k8s optionally.
|
||||||
|
|
||||||
The repo contains a theme for [Zola](https://www.getzola.org/) (the best static site generator I've ever seen) and dockerfile for building Docker images with Nginx-alpine. You can push to your Docker an [image with demo-content](https://hub.docker.com/r/codeandmedia/zola_docsascode_theme)
|
The repo contains a theme for [Zola](https://www.getzola.org/) (the best static site generator I've ever seen) and dockerfile for building Docker images with Nginx-alpine. You can pull to your Docker an [image with demo-content](https://hub.docker.com/r/codeandmedia/docsascode-theme)
|
||||||
|
|
||||||
```
|
```
|
||||||
codeandmedia/zola_docsascode_theme:latest
|
codeandmedia/docsascode-theme:latest
|
||||||
```
|
```
|
||||||
|
|
||||||
## Perks
|
## Perks
|
||||||
|
|
|
@ -3,14 +3,14 @@
|
||||||
title = "even"
|
title = "even"
|
||||||
description = "A robust, elegant dark theme"
|
description = "A robust, elegant dark theme"
|
||||||
template = "theme.html"
|
template = "theme.html"
|
||||||
date = 2018-01-25T18:44:44+01:00
|
date = 2020-08-10T11:31:05+02:00
|
||||||
|
|
||||||
[extra]
|
[extra]
|
||||||
created = 2019-07-12T23:49:55+02:00
|
created = 2020-08-10T11:31:05+02:00
|
||||||
updated = 2018-01-25T18:44:44+01:00
|
updated = 2020-08-10T11:31:05+02:00
|
||||||
repository = "https://github.com/getzola/even"
|
repository = "https://github.com/getzola/even.git"
|
||||||
homepage = "https://github.com/getzola/even"
|
homepage = "https://github.com/getzola/even"
|
||||||
minimum_version = "0.6.0"
|
minimum_version = "0.11.0"
|
||||||
license = "MIT"
|
license = "MIT"
|
||||||
demo = "https://zola-even.netlify.com"
|
demo = "https://zola-even.netlify.com"
|
||||||
|
|
||||||
|
@ -48,9 +48,9 @@ The theme requires tags and categories taxonomies to be enabled in your `config.
|
||||||
|
|
||||||
```toml
|
```toml
|
||||||
taxonomies = [
|
taxonomies = [
|
||||||
# You can enable/disable feeds
|
# You can enable/disable RSS
|
||||||
{name = "categories", feed = true},
|
{name = "categories", rss = true},
|
||||||
{name = "tags", feed = true},
|
{name = "tags", rss = true},
|
||||||
]
|
]
|
||||||
```
|
```
|
||||||
If you want to paginate taxonomies pages, you will need to overwrite the templates
|
If you want to paginate taxonomies pages, you will need to overwrite the templates
|
||||||
|
|
|
@ -3,11 +3,11 @@
|
||||||
title = "feather"
|
title = "feather"
|
||||||
description = "A modern blog theme"
|
description = "A modern blog theme"
|
||||||
template = "theme.html"
|
template = "theme.html"
|
||||||
date = 2018-01-21T04:35:36-05:00
|
date = 2020-08-10T11:31:05+02:00
|
||||||
|
|
||||||
[extra]
|
[extra]
|
||||||
created = 2019-07-12T23:49:55+02:00
|
created = 2020-08-10T11:31:05+02:00
|
||||||
updated = 2018-01-21T04:35:36-05:00
|
updated = 2020-08-10T11:31:05+02:00
|
||||||
repository = "https://github.com/piedoom/feather"
|
repository = "https://github.com/piedoom/feather"
|
||||||
homepage = "https://github.com/piedoom/feather"
|
homepage = "https://github.com/piedoom/feather"
|
||||||
minimum_version = "0.5.1"
|
minimum_version = "0.5.1"
|
||||||
|
|
145
docs/content/themes/float/index.md
Normal file
|
@ -0,0 +1,145 @@
|
||||||
|
|
||||||
|
+++
|
||||||
|
title = "Float"
|
||||||
|
description = "An elegant blog theme"
|
||||||
|
template = "theme.html"
|
||||||
|
date = 2020-08-10T11:31:05+02:00
|
||||||
|
|
||||||
|
[extra]
|
||||||
|
created = 2020-08-10T11:31:05+02:00
|
||||||
|
updated = 2020-08-10T11:31:05+02:00
|
||||||
|
repository = "https://gitlab.com/float-theme/float.git"
|
||||||
|
homepage = "https://float-theme.netlify.app/"
|
||||||
|
minimum_version = "0.11.0"
|
||||||
|
license = "MIT"
|
||||||
|
demo = ""
|
||||||
|
|
||||||
|
[extra.author]
|
||||||
|
name = "Leon"
|
||||||
|
homepage = "https://exp2.uniuni.space/"
|
||||||
|
+++
|
||||||
|
|
||||||
|
![Float](content/blog/2020-06-14-Float theme for Zola/Float.png)
|
||||||
|
|
||||||
|
**[English](README.en.md)**
|
||||||
|
|
||||||
|
Float 是一款為 [Zola](https://www.getzola.org/) 設計的佈景主題。
|
||||||
|
|
||||||
|
[[_TOC_]]
|
||||||
|
|
||||||
|
## 特色
|
||||||
|
|
||||||
|
- 依據不同的螢幕尺寸提供最佳化版面,從小尺寸到大尺寸都可獲得優秀的閱讀體驗。
|
||||||
|
- 文章卡片提供兩種卡片尺寸,重點文章可採用更醒目的寬版卡片。
|
||||||
|
- 文章卡片配圖可自行指定,未指定者使用 [Unsplash Source](https://source.unsplash.com/) 的隨機圖片。
|
||||||
|
- 使用 Zola 的 `resize_image()` 自動產生適用於 DPR 1.0 ~ 3.0 的圖片,卡片配圖會由瀏覽器依據設備之 DPR 自動選用最佳尺寸的圖片。
|
||||||
|
- 圖片啟用延遲載入,縮短頁面載入時間。
|
||||||
|
- 預設埋入 HTML SEO 標籤、[Open Graph](https://ogp.me/) 與 [Twitter Cards](https://developer.twitter.com/en/docs/tweets/optimize-with-cards/overview/abouts-cards) 標籤。
|
||||||
|
- 整合 [Google Analytics](https://analytics.google.com/)。
|
||||||
|
- 整合 [Google AdSense](https://adsense.google.com/)。
|
||||||
|
- 版面為 [AdSense 自動廣告](https://support.google.com/adsense/answer/9261306)最佳化,不會因自動廣告的寬度不一而破版。
|
||||||
|
- 整合 [LikeCoin](https://like.co/)。
|
||||||
|
- 整合 [utterances](https://utteranc.es/),利用 [GitHub](https://github.com/) issue 作為留言系統。
|
||||||
|
|
||||||
|
## 安裝與啟用
|
||||||
|
|
||||||
|
在您的 Zola 專案資料夾內:
|
||||||
|
|
||||||
|
```shell
|
||||||
|
cd themes
|
||||||
|
git clone git@gitlab.com:float-theme/float.git
|
||||||
|
```
|
||||||
|
|
||||||
|
編輯您的 config.toml,指定 Float 作為佈景主題:
|
||||||
|
|
||||||
|
```TOML
|
||||||
|
theme = "float"
|
||||||
|
```
|
||||||
|
|
||||||
|
編輯您的 config.toml,加入 tags 作為分類系統:
|
||||||
|
|
||||||
|
```TOML
|
||||||
|
taxonomies = [
|
||||||
|
{name = "tags", paginate_by = 10},
|
||||||
|
]
|
||||||
|
```
|
||||||
|
|
||||||
|
複製 float/static/ 的所有子資料夾與檔案到您的 static/:
|
||||||
|
|
||||||
|
```shell
|
||||||
|
cp -r themes/float/static/* static/
|
||||||
|
```
|
||||||
|
|
||||||
|
複製 float/content/ 的所有子資料夾與檔案到您的 content/:
|
||||||
|
|
||||||
|
```shell
|
||||||
|
cp -r themes/float/content/* content/
|
||||||
|
```
|
||||||
|
|
||||||
|
## 使用 Float
|
||||||
|
|
||||||
|
### 文章與配圖
|
||||||
|
|
||||||
|
文章皆以資料夾的方式存在,如下例:
|
||||||
|
|
||||||
|
```
|
||||||
|
content/
|
||||||
|
└── blog/
|
||||||
|
└── 2020-06-21-Float theme for Zola/
|
||||||
|
├── index.md
|
||||||
|
├── pic1.png
|
||||||
|
├── pic2.png
|
||||||
|
└── qa_report.pdf
|
||||||
|
```
|
||||||
|
|
||||||
|
文章為 index.md,文內的配圖或其它檔案也是放在文章資料夾內。
|
||||||
|
|
||||||
|
### Front-matter
|
||||||
|
|
||||||
|
Front-matter 請參照下列註解說明:
|
||||||
|
|
||||||
|
```TOML
|
||||||
|
title = "Float theme for Zola"
|
||||||
|
description = "Float features and usage guide"
|
||||||
|
draft = false
|
||||||
|
[taxonomies]
|
||||||
|
tags = ["Float", "Zola"]
|
||||||
|
[extra]
|
||||||
|
feature_image = "pic1.png" # 卡片圖片。
|
||||||
|
feature = true # 是否為重點文章,重點文章會以寬版卡片顯示。
|
||||||
|
```
|
||||||
|
|
||||||
|
## 客製化
|
||||||
|
|
||||||
|
可客製化設定大多可以在 config.toml 的 `[extra]` 區段做設定:
|
||||||
|
|
||||||
|
```TOML
|
||||||
|
[extra]
|
||||||
|
copyright = ""
|
||||||
|
|
||||||
|
web_fonts = "<link rel='stylesheet' href='https://fonts.googleapis.com/css2?family=Noto+Serif+TC:wght@500;700&display=swap'>"
|
||||||
|
|
||||||
|
google_analytics = false
|
||||||
|
# google_analytics_id = "UA-XXXXXX-X"
|
||||||
|
|
||||||
|
google_adsense = false
|
||||||
|
# google_adsense_id = "ca-pub-XXXXXXXXXXXXXXXX"
|
||||||
|
|
||||||
|
twitter_account = "@xxx"
|
||||||
|
|
||||||
|
likecoin = false
|
||||||
|
# likecoin_name = "xxx"
|
||||||
|
|
||||||
|
utterances = false
|
||||||
|
# utterances_repo = "xxx/xxx"
|
||||||
|
```
|
||||||
|
|
||||||
|
### 字體
|
||||||
|
|
||||||
|
字體的 CSS 位於 float/sass/font.scss,欲更換字體,把 float/sass/font.scss 複製到自己的 sass/font.scss,並修改之。
|
||||||
|
|
||||||
|
## 已知問題
|
||||||
|
|
||||||
|
- 分頁設定皆須設為 10 篇分頁。因為 Zola 的 `get_section()` 無法取得該 section 的分頁設定。
|
||||||
|
|
||||||
|
|
BIN
docs/content/themes/float/screenshot.png
Normal file
After Width: | Height: | Size: 720 KiB |
|
@ -3,11 +3,11 @@
|
||||||
title = "hallo"
|
title = "hallo"
|
||||||
description = "A single-page theme to introduce yourself."
|
description = "A single-page theme to introduce yourself."
|
||||||
template = "theme.html"
|
template = "theme.html"
|
||||||
date = 2019-06-05T15:08:48+02:00
|
date = 2020-08-10T11:31:05+02:00
|
||||||
|
|
||||||
[extra]
|
[extra]
|
||||||
created = 2019-07-12T23:55:11+02:00
|
created = 2020-08-10T11:31:05+02:00
|
||||||
updated = 2019-06-05T15:08:48+02:00
|
updated = 2020-08-10T11:31:05+02:00
|
||||||
repository = "https://github.com/flyingP0tat0/zola-hallo.git"
|
repository = "https://github.com/flyingP0tat0/zola-hallo.git"
|
||||||
homepage = "https://github.com/janbaudisch/zola-hallo"
|
homepage = "https://github.com/janbaudisch/zola-hallo"
|
||||||
minimum_version = "0.4.0"
|
minimum_version = "0.4.0"
|
||||||
|
|
|
@ -3,14 +3,14 @@
|
||||||
title = "hyde"
|
title = "hyde"
|
||||||
description = "A classic blog theme"
|
description = "A classic blog theme"
|
||||||
template = "theme.html"
|
template = "theme.html"
|
||||||
date = 2017-10-24T15:01:52+02:00
|
date = 2020-08-10T11:31:05+02:00
|
||||||
|
|
||||||
[extra]
|
[extra]
|
||||||
created = 2019-04-06T11:27:43+02:00
|
created = 2020-08-10T11:31:05+02:00
|
||||||
updated = 2017-10-24T15:01:52+02:00
|
updated = 2020-08-10T11:31:05+02:00
|
||||||
repository = "https://github.com/getzola/hyde"
|
repository = "https://github.com/getzola/hyde.git"
|
||||||
homepage = "https://github.com/getzola/hyde"
|
homepage = "https://github.com/getzola/hyde"
|
||||||
minimum_version = "0.5.0"
|
minimum_version = "0.11.0"
|
||||||
license = "MIT"
|
license = "MIT"
|
||||||
demo = "https://zola-hyde.netlify.com"
|
demo = "https://zola-hyde.netlify.com"
|
||||||
|
|
||||||
|
|
129
docs/content/themes/juice/index.md
Normal file
|
@ -0,0 +1,129 @@
|
||||||
|
|
||||||
|
+++
|
||||||
|
title = "juice"
|
||||||
|
description = "An intuitive, elegant, and lightweight Zola™ theme for product sites."
|
||||||
|
template = "theme.html"
|
||||||
|
date = 2020-08-10T11:31:05+02:00
|
||||||
|
|
||||||
|
[extra]
|
||||||
|
created = 2020-08-10T11:31:05+02:00
|
||||||
|
updated = 2020-08-10T11:31:05+02:00
|
||||||
|
repository = "https://github.com/huhu/juice"
|
||||||
|
homepage = "https://github.com/huhu/juice"
|
||||||
|
minimum_version = "0.11.0"
|
||||||
|
license = "MIT"
|
||||||
|
demo = "https://juice.huhu.io"
|
||||||
|
|
||||||
|
[extra.author]
|
||||||
|
name = "Huhu teams"
|
||||||
|
homepage = "https://huhu.io"
|
||||||
|
+++
|
||||||
|
|
||||||
|
# Juice
|
||||||
|
|
||||||
|
<img align="right" width="150" height="150" src="/static/juice.svg">
|
||||||
|
|
||||||
|
**Juice** is an intuitive, elegant, and responsive Zola™ theme for product sites.
|
||||||
|
|
||||||
|
- Build for product sites
|
||||||
|
- Simple and intuitive structure
|
||||||
|
- Clean and elegant design
|
||||||
|
- Responsive and mobile device compatible
|
||||||
|
- Customize and extend friendly
|
||||||
|
|
||||||
|
https://juice.huhu.io
|
||||||
|
|
||||||
|
# Installation
|
||||||
|
|
||||||
|
First download this theme to your `themes` directory:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ cd themes
|
||||||
|
$ git clone https://github.com/huhu/juice.git
|
||||||
|
```
|
||||||
|
|
||||||
|
or add as a submodule
|
||||||
|
```bash
|
||||||
|
$ git submodule add https://github.com/huhu/juice themes/juice
|
||||||
|
```
|
||||||
|
|
||||||
|
and then enable it in your `config.toml`:
|
||||||
|
|
||||||
|
```toml
|
||||||
|
theme = "juice"
|
||||||
|
```
|
||||||
|
|
||||||
|
# Structure
|
||||||
|
|
||||||
|
### Hero
|
||||||
|
|
||||||
|
**Juice** is designed for product websites, hence we let **hero** part fills whole of screen.
|
||||||
|
You can customize your **hero** by using `hero` block in the `index.html`.
|
||||||
|
|
||||||
|
```html
|
||||||
|
{%/* block hero */%}
|
||||||
|
<div>
|
||||||
|
Your cool hero html...
|
||||||
|
</div>
|
||||||
|
{%/* endblock hero */%}
|
||||||
|
```
|
||||||
|
|
||||||
|
### Page
|
||||||
|
|
||||||
|
Every markdown file located in `content` directory will become a **Page**. There also will display as
|
||||||
|
a navigate link on the top-right corner.
|
||||||
|
You can change the frontmatter's `weight` value to sort the order (ascending order).
|
||||||
|
|
||||||
|
```
|
||||||
|
+++
|
||||||
|
title = "Changelog"
|
||||||
|
description = "Changelog"
|
||||||
|
weight = 3
|
||||||
|
+++
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
### CSS variables
|
||||||
|
|
||||||
|
You can override theme variable by creating a file named `_variables.html` in your `templates` directory.
|
||||||
|
|
||||||
|
```html
|
||||||
|
<style>
|
||||||
|
:root {
|
||||||
|
/* Primary theme color */
|
||||||
|
--primary-color: #FED43F;
|
||||||
|
/* Primary theme text color */
|
||||||
|
--primary-text-color: #543631;
|
||||||
|
/* Primary theme link color */
|
||||||
|
--primary-link-color: #F9BB2D;
|
||||||
|
/* Secondary color: the background body color */
|
||||||
|
--secondary-color: #fcfaf6;
|
||||||
|
--secondary-text-color: #303030;
|
||||||
|
/* Highlight text color of table of content */
|
||||||
|
--toc-highlight-text-color: #d46e13;
|
||||||
|
}
|
||||||
|
</style>
|
||||||
|
```
|
||||||
|
|
||||||
|
# Configuration
|
||||||
|
|
||||||
|
You can customize some builtin property in `config.toml` file:
|
||||||
|
|
||||||
|
```toml
|
||||||
|
[extra]
|
||||||
|
juice_logo_name = "Juice"
|
||||||
|
juice_logo_path = "juice.svg"
|
||||||
|
juice_extra_menu = [
|
||||||
|
{ title = "Github", link = "https://github.com/huhu/juice"}
|
||||||
|
]
|
||||||
|
```
|
||||||
|
|
||||||
|
# Contributing
|
||||||
|
|
||||||
|
Thank you very much for considering contributing to this project!
|
||||||
|
|
||||||
|
We appreciate any form of contribution:
|
||||||
|
|
||||||
|
- New issues (feature requests, bug reports, questions, ideas, ...)
|
||||||
|
- Pull requests (documentation improvements, code improvements, new features, ...)
|
||||||
|
|
BIN
docs/content/themes/juice/screenshot.png
Normal file
After Width: | Height: | Size: 150 KiB |
148
docs/content/themes/lightspeed/index.md
Normal file
|
@ -0,0 +1,148 @@
|
||||||
|
|
||||||
|
+++
|
||||||
|
title = "lightspeed"
|
||||||
|
description = "Zola theme with a perfect Lighthouse score"
|
||||||
|
template = "theme.html"
|
||||||
|
date = 2020-08-10T11:31:05+02:00
|
||||||
|
|
||||||
|
[extra]
|
||||||
|
created = 2020-08-10T11:31:05+02:00
|
||||||
|
updated = 2020-08-10T11:31:05+02:00
|
||||||
|
repository = "https://github.com/carpetscheme/lightspeed"
|
||||||
|
homepage = "https://github.com/carpetscheme/lightspeed"
|
||||||
|
minimum_version = "0.10.0"
|
||||||
|
license = "MIT"
|
||||||
|
demo = "https://quirky-perlman-34d0da.netlify.com/"
|
||||||
|
|
||||||
|
[extra.author]
|
||||||
|
name = "El Carpet"
|
||||||
|
homepage = "https://github.com/carpetscheme"
|
||||||
|
+++
|
||||||
|
|
||||||
|
# Light Speed
|
||||||
|
|
||||||
|
An insanely fast and performance-based Zola theme, ported from [Light Speed Jekyll](https://github.com/bradleytaunt/lightspeed).
|
||||||
|
|
||||||
|
Some fun facts about the theme:
|
||||||
|
|
||||||
|
* Perfect score on Google's Lighthouse audit
|
||||||
|
* Only ~600 bytes of CSS
|
||||||
|
* No JavaScript
|
||||||
|
|
||||||
|
Demo: [quirky-perlman-34d0da.netlify.com](https://quirky-perlman-34d0da.netlify.com)
|
||||||
|
|
||||||
|
-----
|
||||||
|
|
||||||
|
## Contents
|
||||||
|
|
||||||
|
- [Installation](#installation)
|
||||||
|
- [Options](#options)
|
||||||
|
- [Title](#title)
|
||||||
|
- [Sass](#Sass)
|
||||||
|
- [Footer menu](#footer-menu)
|
||||||
|
- [Author](#author)
|
||||||
|
- [Netlify](#netlify)
|
||||||
|
- [Original](#original)
|
||||||
|
- [License](#license)
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
First download this theme to your `themes` directory:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ cd themes
|
||||||
|
$ git clone https://github.com/carpetscheme/lightspeed.git
|
||||||
|
```
|
||||||
|
and then enable it in your `config.toml`:
|
||||||
|
|
||||||
|
```toml
|
||||||
|
theme = "lightspeed"
|
||||||
|
```
|
||||||
|
|
||||||
|
Posts should be placed directly in the `content` folder.
|
||||||
|
|
||||||
|
To sort the post index by date, enable sort in your index section `content/_index.md`:
|
||||||
|
|
||||||
|
```toml
|
||||||
|
sort_by = "date"
|
||||||
|
```
|
||||||
|
|
||||||
|
## Options
|
||||||
|
|
||||||
|
### Title
|
||||||
|
Set a title and description in the config to appear in the site header:
|
||||||
|
|
||||||
|
```toml
|
||||||
|
title = "Different strokes"
|
||||||
|
description = "for different folks"
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
### Sass
|
||||||
|
|
||||||
|
Styles are compiled from sass and imported inline to the header :zap:
|
||||||
|
|
||||||
|
You can overide the styles by enabling sass compilation in the config:
|
||||||
|
|
||||||
|
```toml
|
||||||
|
compile_sass = true
|
||||||
|
```
|
||||||
|
|
||||||
|
...and placing a replacement `style.scss` file in your sass folder.
|
||||||
|
|
||||||
|
### Footer-menu
|
||||||
|
Set a field in `extra` with a key of `footer_links`:
|
||||||
|
|
||||||
|
```toml
|
||||||
|
[extra]
|
||||||
|
|
||||||
|
footer_links = [
|
||||||
|
{url = "$BASE_URL/about", name = "About"},
|
||||||
|
{url = "$BASE_URL/rss.xml", name = "RSS"},
|
||||||
|
{url = "https://google.com", name = "Google"},
|
||||||
|
]
|
||||||
|
```
|
||||||
|
|
||||||
|
If you put `$BASE_URL` in a url, it will automatically be replaced by the actual
|
||||||
|
site URL.
|
||||||
|
|
||||||
|
Create pages such as `$BASE_URL/about` by placing them in a subfolder of the content directory, and specifying the path in the frontmatter:
|
||||||
|
|
||||||
|
```toml
|
||||||
|
path = "about"
|
||||||
|
```
|
||||||
|
|
||||||
|
### Author
|
||||||
|
|
||||||
|
To add author name to the head meta-data, set an `author` field in `extra`:
|
||||||
|
|
||||||
|
```toml
|
||||||
|
[extra]
|
||||||
|
|
||||||
|
author = "Grant Green"
|
||||||
|
```
|
||||||
|
|
||||||
|
### Netlify
|
||||||
|
|
||||||
|
Deployed on netlify? Add a link in the footer by setting `netlify` in `extra` as `true`.
|
||||||
|
|
||||||
|
```toml
|
||||||
|
[extra]
|
||||||
|
|
||||||
|
netlify = true
|
||||||
|
```
|
||||||
|
|
||||||
|
## Original
|
||||||
|
This template is based on the Jekyll template [Light Speed Jekyll](https://github.com/bradleytaunt/lightspeed) by **Bradley Taunt**:
|
||||||
|
|
||||||
|
- <https://github.com/bradleytaunt>
|
||||||
|
- <https://twitter.com/bradtaunt>
|
||||||
|
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
Open sourced under the [MIT license](LICENSE.md).
|
||||||
|
|
||||||
|
This project is open source except for example articles found in `content`.
|
||||||
|
|
||||||
|
|
||||||
|
|
BIN
docs/content/themes/lightspeed/screenshot.png
Normal file
After Width: | Height: | Size: 36 KiB |
|
@ -3,11 +3,11 @@
|
||||||
title = "sam"
|
title = "sam"
|
||||||
description = "A Simple and Minimalist theme with a focus on typography and content."
|
description = "A Simple and Minimalist theme with a focus on typography and content."
|
||||||
template = "theme.html"
|
template = "theme.html"
|
||||||
date = 2019-07-02T17:55:24+02:00
|
date = 2020-08-10T11:31:05+02:00
|
||||||
|
|
||||||
[extra]
|
[extra]
|
||||||
created = 2019-07-02T17:55:24+02:00
|
created = 2020-08-10T11:31:05+02:00
|
||||||
updated = 2019-07-02T17:55:24+02:00
|
updated = 2020-08-10T11:31:05+02:00
|
||||||
repository = "https://github.com/janbaudisch/zola-sam.git"
|
repository = "https://github.com/janbaudisch/zola-sam.git"
|
||||||
homepage = "https://github.com/janbaudisch/zola-sam"
|
homepage = "https://github.com/janbaudisch/zola-sam"
|
||||||
minimum_version = "0.4.0"
|
minimum_version = "0.4.0"
|
||||||
|
|
62
docs/content/themes/simple-dev-blog/index.md
Normal file
|
@ -0,0 +1,62 @@
|
||||||
|
|
||||||
|
+++
|
||||||
|
title = "simple-dev-blog"
|
||||||
|
description = "A simple dev blog theme with no javascript, prerendered linked pages and SEO tags."
|
||||||
|
template = "theme.html"
|
||||||
|
date = 2020-08-10T11:31:05+02:00
|
||||||
|
|
||||||
|
[extra]
|
||||||
|
created = 2020-08-10T11:31:05+02:00
|
||||||
|
updated = 2020-08-10T11:31:05+02: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"
|
||||||
|
license = "MIT"
|
||||||
|
demo = "https://simple-dev-blog-zola-starter.netlify.app/"
|
||||||
|
|
||||||
|
[extra.author]
|
||||||
|
name = "Bennett Hardwick"
|
||||||
|
homepage = "https://bennetthardwick.com/"
|
||||||
|
+++
|
||||||
|
|
||||||
|
|
||||||
|
![preview image](https://i.imgur.com/IWoJtkF.png)
|
||||||
|
|
||||||
|
# simple-dev-blog-zola-starter
|
||||||
|
|
||||||
|
A simple dev-blog theme for Zola. It uses no JavaScript, prerenders links between navigation, blog posts and tags and adds common tags for SEO.
|
||||||
|
|
||||||
|
You can view it live [here](https://simple-dev-blog-zola-starter.netlify.app/).
|
||||||
|
|
||||||
|
### How to get started
|
||||||
|
|
||||||
|
To create a new Zola site, first download the CLI and install it on your system.
|
||||||
|
You can find installation instructions [on the Zola website](https://www.getzola.org/documentation/getting-started/installation/).
|
||||||
|
|
||||||
|
1. After you've installed the Zola CLI, run the following command to create a new site:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
zola init my_amazing_site
|
||||||
|
cd my_amazing_site
|
||||||
|
```
|
||||||
|
|
||||||
|
2. After you've created the site, install the "Simple Dev Blog" theme like so:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
git clone --depth=1 \
|
||||||
|
https://github.com/bennetthardwick/simple-dev-blog-zola-starter \
|
||||||
|
themes/simple-dev-blog
|
||||||
|
```
|
||||||
|
|
||||||
|
3. Now in your `config.toml` file, choose the theme by setting `theme = "simple-dev-blog"`.
|
||||||
|
|
||||||
|
4. That's it! Now build your site by running the following command, and navigate to `127.0.0.1:111`:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
zola serve
|
||||||
|
```
|
||||||
|
|
||||||
|
You should now have a speedy simple dev blog up and running, have fun!
|
||||||
|
|
||||||
|
|
||||||
|
|
BIN
docs/content/themes/simple-dev-blog/screenshot.png
Normal file
After Width: | Height: | Size: 136 KiB |
|
@ -3,11 +3,11 @@
|
||||||
title = "Slim"
|
title = "Slim"
|
||||||
description = "Slim is a minimal, clean and beautiful theme for Zola."
|
description = "Slim is a minimal, clean and beautiful theme for Zola."
|
||||||
template = "theme.html"
|
template = "theme.html"
|
||||||
date = 2019-10-01T01:16:57+01:00
|
date = 2020-08-10T11:31:05+02:00
|
||||||
|
|
||||||
[extra]
|
[extra]
|
||||||
created = 2019-10-01T01:16:57+01:00
|
created = 2020-08-10T11:31:05+02:00
|
||||||
updated = 2019-10-01T01:16:57+01:00
|
updated = 2020-08-10T11:31:05+02:00
|
||||||
repository = "https://github.com/jameshclrk/zola-slim"
|
repository = "https://github.com/jameshclrk/zola-slim"
|
||||||
homepage = "https://github.com/jameshclrk/zola-slim"
|
homepage = "https://github.com/jameshclrk/zola-slim"
|
||||||
minimum_version = "0.8.0"
|
minimum_version = "0.8.0"
|
||||||
|
|
71
docs/content/themes/solar-theme-zola/index.md
Normal file
|
@ -0,0 +1,71 @@
|
||||||
|
|
||||||
|
+++
|
||||||
|
title = "solar-theme-zola"
|
||||||
|
description = "A port of solar-theme-hugo for zola"
|
||||||
|
template = "theme.html"
|
||||||
|
date = 2020-08-10T11:31:05+02:00
|
||||||
|
|
||||||
|
[extra]
|
||||||
|
created = 2020-08-10T11:31:05+02:00
|
||||||
|
updated = 2020-08-10T11:31:05+02:00
|
||||||
|
repository = "https://github.com/hulufei/solar-theme-zola.git"
|
||||||
|
homepage = "https://github.com/hulufei/solar-theme-zola"
|
||||||
|
minimum_version = "0.4.0"
|
||||||
|
license = "MIT"
|
||||||
|
demo = ""
|
||||||
|
|
||||||
|
[extra.author]
|
||||||
|
name = "hulufei"
|
||||||
|
homepage = "https://github/hulufei"
|
||||||
|
+++
|
||||||
|
|
||||||
|
# Solar Theme for Zola
|
||||||
|
|
||||||
|
Port of [Solar theme for Hugo](https://github.com/bake/solar-theme-hugo) to Zola.
|
||||||
|
|
||||||
|
![screenshot](./screenshot.png)
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
|
||||||
|
First download this theme to your `themes` directory:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ cd themes
|
||||||
|
$ git clone https://github.com/hulufei/solar-theme-zola.git
|
||||||
|
```
|
||||||
|
and then enable it in your `config.toml`:
|
||||||
|
|
||||||
|
```toml
|
||||||
|
theme = "solar-theme-zola"
|
||||||
|
```
|
||||||
|
|
||||||
|
Add `title` and `description`:
|
||||||
|
|
||||||
|
```toml
|
||||||
|
title = "Your Blog Title"
|
||||||
|
description = "Your blog description"
|
||||||
|
```
|
||||||
|
|
||||||
|
## Options
|
||||||
|
|
||||||
|
### Color schemes
|
||||||
|
|
||||||
|
Set color scheme to (Solarized) `dark` or (Solarized) `light` with `highlight_theme` option:
|
||||||
|
|
||||||
|
```toml
|
||||||
|
highlight_theme = "solarized-dark"
|
||||||
|
```
|
||||||
|
|
||||||
|
### Sidebar menu
|
||||||
|
|
||||||
|
Set a field in `extra` with a key of `site_menus`:
|
||||||
|
|
||||||
|
```toml
|
||||||
|
site_menus = [
|
||||||
|
{ url = "https://github/hulufei/solar-theme-zola", name = "Repository" },
|
||||||
|
{ url = "rss.xml", name = "RSS" },
|
||||||
|
]
|
||||||
|
```
|
||||||
|
Each link needs to have a `url` and a `name`.
|
||||||
|
|
||||||
|
|
BIN
docs/content/themes/solar-theme-zola/screenshot.png
Normal file
After Width: | Height: | Size: 76 KiB |
63
docs/content/themes/toucan/index.md
Normal file
|
@ -0,0 +1,63 @@
|
||||||
|
|
||||||
|
+++
|
||||||
|
title = "Toucan"
|
||||||
|
description = "Inspired from Pelican default theme"
|
||||||
|
template = "theme.html"
|
||||||
|
date = 2020-08-10T11:31:05+02:00
|
||||||
|
|
||||||
|
[extra]
|
||||||
|
created = 2020-08-10T11:31:05+02:00
|
||||||
|
updated = 2020-08-10T11:31:05+02:00
|
||||||
|
repository = "https://git.42l.fr/HugoTrentesaux/toucan.git"
|
||||||
|
homepage = "https://git.42l.fr/HugoTrentesaux/toucan"
|
||||||
|
minimum_version = "0.8.0"
|
||||||
|
license = "AGPL"
|
||||||
|
demo = "http://blog.coinduf.eu/"
|
||||||
|
|
||||||
|
[extra.author]
|
||||||
|
name = "Hugo Trentesaux"
|
||||||
|
homepage = "https://trentesaux.fr/"
|
||||||
|
+++
|
||||||
|
|
||||||
|
# Toucan
|
||||||
|
|
||||||
|
A light theme for Zola adapted from Pelican.
|
||||||
|
|
||||||
|
![screenshot](./screenshot.png)
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
|
||||||
|
You can add the theme as a submodule :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git submodule add --name toucan https://git.42l.fr/HugoTrentesaux/toucan.git themes/toucan
|
||||||
|
```
|
||||||
|
|
||||||
|
and enable the theme in your `config.toml`
|
||||||
|
|
||||||
|
```toml
|
||||||
|
theme = "toucan"
|
||||||
|
```
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
Categories will be added to the menu, and all articles from categories with
|
||||||
|
|
||||||
|
```toml
|
||||||
|
transparent = true
|
||||||
|
```
|
||||||
|
|
||||||
|
will be listed in the home page.
|
||||||
|
|
||||||
|
You can personalize the following options :
|
||||||
|
|
||||||
|
```toml
|
||||||
|
[extra]
|
||||||
|
title = "Toucan theme"
|
||||||
|
title_pic = "/favicon.ico"
|
||||||
|
description = "Theme for Zola inspired from Pelican website theme"
|
||||||
|
license = """Content under <a href="https://creativecommons.org/licenses/by-sa/4.0/">CC BY-SA</a> Licence"""
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
|
BIN
docs/content/themes/toucan/screenshot.png
Normal file
After Width: | Height: | Size: 442 KiB |
63
docs/content/themes/zerm/index.md
Normal file
|
@ -0,0 +1,63 @@
|
||||||
|
|
||||||
|
+++
|
||||||
|
title = "zerm"
|
||||||
|
description = "A minimalistic and dark theme based on Radek Kozieł's theme for Hugo"
|
||||||
|
template = "theme.html"
|
||||||
|
date = 2020-08-10T11:31:05+02:00
|
||||||
|
|
||||||
|
[extra]
|
||||||
|
created = 2020-08-10T11:31:05+02:00
|
||||||
|
updated = 2020-08-10T11:31:05+02:00
|
||||||
|
repository = "https://github.com/ejmg/zerm.git"
|
||||||
|
homepage = "https://github.com/ejmg/zerm"
|
||||||
|
minimum_version = "0.8.0"
|
||||||
|
license = "MIT"
|
||||||
|
demo = "https://zerm.ejmg.now.sh/"
|
||||||
|
|
||||||
|
[extra.author]
|
||||||
|
name = "elias julian marko garcia"
|
||||||
|
homepage = "https://github.com/ejmg"
|
||||||
|
+++
|
||||||
|
|
||||||
|
# zerm
|
||||||
|
|
||||||
|
a minimalist and dark theme for [Zola](https://getzola.org).
|
||||||
|
|
||||||
|
![Screenshot](../master/zerm-preview.png?raw=true)
|
||||||
|
|
||||||
|
[**Live Preview!**](https://zerm.ejmg.now.sh/)
|
||||||
|
|
||||||
|
Largely a port of Radek Kozieł's [Terminal
|
||||||
|
Theme](https://github.com/panr/hugo-theme-terminal) for Hugo. 4/5ths of my way
|
||||||
|
through porting this theme, I discovered Paweł Romanowski own independent fork
|
||||||
|
for Zola, [Terminimal](https://github.com/pawroman/zola-theme-terminimal),
|
||||||
|
which helped me get the PostCSS to Sass styling conversion done more
|
||||||
|
quickly. My sincerest thanks to both of you!
|
||||||
|
|
||||||
|
## differences
|
||||||
|
|
||||||
|
This theme is largely true to the original by Radek, but there are some mild
|
||||||
|
differences. They are almost all stylistic in nature and are intended to
|
||||||
|
emphasize minimalism even more. Some of them are as follows:
|
||||||
|
- tags are now included in a post's meta data.
|
||||||
|
- no post image previews.
|
||||||
|
- categories are included in the taxonomy.
|
||||||
|
- bullet points have slightly more margin and different symbols for nesting.
|
||||||
|
- no social media or comment support.
|
||||||
|
|
||||||
|
Some of these might be added later and [PR's are always
|
||||||
|
welcomed](https://github.com/ejmg/zerm/pulls).
|
||||||
|
|
||||||
|
## configuration
|
||||||
|
|
||||||
|
Please follow the Zola documentation for [how to use a
|
||||||
|
theme](https://www.getzola.org/documentation/themes/installing-and-using-themes/#installing-a-theme).
|
||||||
|
|
||||||
|
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)!
|
||||||
|
|
||||||
|
## license
|
||||||
|
|
||||||
|
MIT. See `LICENSE.md` for more details.
|
||||||
|
|
||||||
|
|
BIN
docs/content/themes/zerm/screenshot.png
Normal file
After Width: | Height: | Size: 58 KiB |
72
docs/content/themes/zola-henry/index.md
Normal file
|
@ -0,0 +1,72 @@
|
||||||
|
|
||||||
|
+++
|
||||||
|
title = "henry"
|
||||||
|
description = "A timeless blog theme"
|
||||||
|
template = "theme.html"
|
||||||
|
date = 2020-08-10T11:31:05+02:00
|
||||||
|
|
||||||
|
[extra]
|
||||||
|
created = 2020-08-10T11:31:05+02:00
|
||||||
|
updated = 2020-08-10T11:31:05+02:00
|
||||||
|
repository = "https://github.com/sirodoht/zola-henry"
|
||||||
|
homepage = "https://github.com/sirodoht/zola-henry"
|
||||||
|
minimum_version = "0.4.0"
|
||||||
|
license = "MIT"
|
||||||
|
demo = ""
|
||||||
|
|
||||||
|
[extra.author]
|
||||||
|
name = "sirodoht"
|
||||||
|
homepage = ""
|
||||||
|
+++
|
||||||
|
|
||||||
|
# henry
|
||||||
|
|
||||||
|
Henry is a single-column [Zola](https://github.com/getzola/zola) theme based on the original Jekyll styles.
|
||||||
|
|
||||||
|
![Henry screenshot](screenshot.png)
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
|
||||||
|
First download this theme to your `themes` directory:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
$ cd themes
|
||||||
|
$ git clone https://github.com/sirodoht/zola-henry.git henry
|
||||||
|
```
|
||||||
|
|
||||||
|
and then enable it in your `config.toml`:
|
||||||
|
|
||||||
|
```toml
|
||||||
|
theme = "henry"
|
||||||
|
```
|
||||||
|
|
||||||
|
## Options
|
||||||
|
|
||||||
|
### Nav links
|
||||||
|
|
||||||
|
Set a field in `extra` with a key of `henry_links`:
|
||||||
|
|
||||||
|
```toml
|
||||||
|
[extra]
|
||||||
|
henry_links = [
|
||||||
|
{url = "/about", name = "About"},
|
||||||
|
{url = "https://github.com/patrick", name = "Projects"},
|
||||||
|
]
|
||||||
|
```
|
||||||
|
|
||||||
|
Each link needs to have a `url` and a `name`.
|
||||||
|
|
||||||
|
### Footer GitHub icon link
|
||||||
|
|
||||||
|
By default Henry ships with GitHub icon link in the right side of the footer. You can change its link href in your `config.toml`.
|
||||||
|
|
||||||
|
```toml
|
||||||
|
[extra]
|
||||||
|
henry_github = "https://github.com/sirodoht/zola-henry"
|
||||||
|
```
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
MIT
|
||||||
|
|
||||||
|
|
BIN
docs/content/themes/zola-henry/screenshot.png
Normal file
After Width: | Height: | Size: 58 KiB |
51
docs/content/themes/zola-paper/index.md
Normal file
|
@ -0,0 +1,51 @@
|
||||||
|
|
||||||
|
+++
|
||||||
|
title = "zola-paper"
|
||||||
|
description = "A clean theme inspired from hugo-paper."
|
||||||
|
template = "theme.html"
|
||||||
|
date = 2020-08-10T11:31:05+02:00
|
||||||
|
|
||||||
|
[extra]
|
||||||
|
created = 2020-08-10T11:31:05+02:00
|
||||||
|
updated = 2020-08-10T11:31:05+02:00
|
||||||
|
repository = "https://github.com/schoenenberg/zola-paper.git"
|
||||||
|
homepage = "https://github.com/schoenenberg/zola-paper"
|
||||||
|
minimum_version = "0.11.0"
|
||||||
|
license = "MIT"
|
||||||
|
demo = "https://schoenenberg.github.io/zola-paper"
|
||||||
|
|
||||||
|
[extra.author]
|
||||||
|
name = "Maximilian Schoenenberg"
|
||||||
|
homepage = "https://www.schoenenberg.dev"
|
||||||
|
+++
|
||||||
|
|
||||||
|
# Zola-Paper
|
||||||
|
A clean theme inspired from hugo-paper.
|
||||||
|
|
||||||
|
[Zola](https://getzola.org) port of [Hugo-Paper](https://github.com/nanxiaobei/hugo-paper/) (with a few tweaks).
|
||||||
|
|
||||||
|
**Demo:** [https://schoenenberg.github.com/zola-paper](https://schoenenberg.github.com/zola-paper)
|
||||||
|
|
||||||
|
![Screenshot](screenshot.png)
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
|
||||||
|
The easiest way to install this theme is to either clone it ...
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git clone https://github.com/schoenenberg/zola-paper.git themes/zola-paper
|
||||||
|
```
|
||||||
|
|
||||||
|
... or to use it as a submodule.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git submodule add https://github.com/schoenenberg/zola-paper.git themes/zola-paper
|
||||||
|
```
|
||||||
|
|
||||||
|
Either way, you will have to enable the theme in your `config.toml`.
|
||||||
|
|
||||||
|
```toml
|
||||||
|
theme = "zola-paper"
|
||||||
|
```
|
||||||
|
|
||||||
|
|
BIN
docs/content/themes/zola-paper/screenshot.png
Normal file
After Width: | Height: | Size: 76 KiB |
|
@ -3,14 +3,14 @@
|
||||||
title = "pickles"
|
title = "pickles"
|
||||||
description = "A modern, simple, clean blog theme for Zola."
|
description = "A modern, simple, clean blog theme for Zola."
|
||||||
template = "theme.html"
|
template = "theme.html"
|
||||||
date = 2020-02-06T18:26:26-08:00
|
date = 2020-08-10T11:31:05+02:00
|
||||||
|
|
||||||
[extra]
|
[extra]
|
||||||
created = 2020-02-06T18:26:26-08:00
|
created = 2020-08-10T11:31:05+02:00
|
||||||
updated = 2020-02-06T18:26:26-08:00
|
updated = 2020-08-10T11:31:05+02:00
|
||||||
repository = "https://github.com/lukehsiao/zola-pickles.git"
|
repository = "https://github.com/lukehsiao/zola-pickles.git"
|
||||||
homepage = "https://github.com/lukehsiao/zola-pickles"
|
homepage = "https://github.com/lukehsiao/zola-pickles"
|
||||||
minimum_version = "0.4.0"
|
minimum_version = "0.11.0"
|
||||||
license = "MIT OR Apache-2.0"
|
license = "MIT OR Apache-2.0"
|
||||||
demo = ""
|
demo = ""
|
||||||
|
|
||||||
|
@ -48,7 +48,9 @@ insert_anchor_links = "right"
|
||||||
+++
|
+++
|
||||||
```
|
```
|
||||||
|
|
||||||
## Options
|
## Reference guides
|
||||||
|
|
||||||
|
## Configuration Options
|
||||||
|
|
||||||
```toml
|
```toml
|
||||||
[extra]
|
[extra]
|
||||||
|
@ -63,8 +65,16 @@ analytics = ""
|
||||||
|
|
||||||
# See below
|
# See below
|
||||||
katex_enable = false
|
katex_enable = false
|
||||||
|
|
||||||
|
# See below
|
||||||
|
instantpage_enable = false
|
||||||
```
|
```
|
||||||
|
|
||||||
|
A full example configuration is included in config.toml.
|
||||||
|
|
||||||
|
Note how pickles also expects `title` and `description` to also be set in the
|
||||||
|
Zola configuration.
|
||||||
|
|
||||||
### KaTeX math formula support
|
### KaTeX math formula support
|
||||||
|
|
||||||
This theme contains math formula support using [KaTeX](https://katex.org/),
|
This theme contains math formula support using [KaTeX](https://katex.org/),
|
||||||
|
@ -83,11 +93,23 @@ This them also includes a figure shortcode for convenience in captioning figures
|
||||||
{%/* figure(link="https://www.example.com/", src="https://www.example.com/img.jpeg", alt="sample alt text") */%}
|
{%/* figure(link="https://www.example.com/", src="https://www.example.com/img.jpeg", alt="sample alt text") */%}
|
||||||
Your caption here.
|
Your caption here.
|
||||||
{%/* end */%}
|
{%/* end */%}
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
### Fontawesome
|
### Fontawesome
|
||||||
|
|
||||||
This theme includes fontawesome, so that fontawesome icons can be directly used.
|
This theme includes fontawesome, so that fontawesome icons can be directly used.
|
||||||
|
|
||||||
|
### Instant.page
|
||||||
|
|
||||||
|
The theme contains instant.page prefetching. This can be enabled by setting
|
||||||
|
`instantpage_enable = true` in the `extra` section of `config.toml`.
|
||||||
|
|
||||||
|
## Showing article summaries
|
||||||
|
|
||||||
|
By default, the theme will use the first 280 characters of your post as a
|
||||||
|
summary, if a proper [page
|
||||||
|
summary](https://www.getzola.org/documentation/content/page/#summary) using
|
||||||
|
`<!-- more -->` is not provided. For more sensible summaries, we recommend using
|
||||||
|
the manual more indicator.
|
||||||
|
|
||||||
|
|
|
@ -3,11 +3,11 @@
|
||||||
title = "Hikari"
|
title = "Hikari"
|
||||||
description = "Fluid, responsive blog theme for Zola"
|
description = "Fluid, responsive blog theme for Zola"
|
||||||
template = "theme.html"
|
template = "theme.html"
|
||||||
date = 2019-01-27T19:57:59+01:00
|
date = 2020-08-10T11:31:05+02:00
|
||||||
|
|
||||||
[extra]
|
[extra]
|
||||||
created = 2019-07-12T23:49:55+02:00
|
created = 2020-08-10T11:31:05+02:00
|
||||||
updated = 2019-01-27T19:57:59+01:00
|
updated = 2020-08-10T11:31:05+02:00
|
||||||
repository = "https://github.com/waynee95/zola-theme-hikari"
|
repository = "https://github.com/waynee95/zola-theme-hikari"
|
||||||
homepage = "https://github.com/waynee95/zola-theme-hikari"
|
homepage = "https://github.com/waynee95/zola-theme-hikari"
|
||||||
minimum_version = "0.5.1"
|
minimum_version = "0.5.1"
|
||||||
|
@ -59,6 +59,6 @@ enable_mathjax = false
|
||||||
|
|
||||||
[MIT](LICENSE)
|
[MIT](LICENSE)
|
||||||
|
|
||||||
Thanks to [Mathieu Mayer-Mazzoli](//github.com/mx3m) for creating this awesome theme!
|
Thanks to [Mathieu Mayer-Mazzoli](https://github.com/mx3m) for creating this awesome theme!
|
||||||
|
|
||||||
|
|
107
docs/content/themes/zola.386/index.md
Normal file
|
@ -0,0 +1,107 @@
|
||||||
|
|
||||||
|
+++
|
||||||
|
title = "zola.386"
|
||||||
|
description = "Zola port of the BOOTSTRA.386 theme."
|
||||||
|
template = "theme.html"
|
||||||
|
date = 2020-08-10T11:31:05+02:00
|
||||||
|
|
||||||
|
[extra]
|
||||||
|
created = 2020-08-10T11:31:05+02:00
|
||||||
|
updated = 2020-08-10T11:31:05+02:00
|
||||||
|
repository = "https://github.com/lopes/zola.386"
|
||||||
|
homepage = "https://github.com/lopes/zola.386"
|
||||||
|
minimum_version = "0.1.3"
|
||||||
|
license = "MIT"
|
||||||
|
demo = "https://zola-386.netlify.com"
|
||||||
|
|
||||||
|
[extra.author]
|
||||||
|
name = "José Lopes"
|
||||||
|
homepage = "https://github.com/lopes"
|
||||||
|
+++
|
||||||
|
|
||||||
|
# ZOLA.386
|
||||||
|
|
||||||
|
![ZOLA.386 screenshot](https://github.com/lopes/zola.386/blob/master/screenshot.png?raw=true)
|
||||||
|
|
||||||
|
## [Live demo](https://zola386.netlify.app/)
|
||||||
|
|
||||||
|
ZOLA.386 is a port of the BOOTSTRA.386 theme and was based on:
|
||||||
|
|
||||||
|
- [BOOTSTRA.386](https://kristopolous.github.io/BOOTSTRA.386/): main idea, design.
|
||||||
|
- [HUGO.386](https://themes.gohugo.io/hugo.386/): item placement.
|
||||||
|
- [Dinkleberg](https://github.com/rust-br/dinkleberg): internal structure and SEO.
|
||||||
|
- [after-dark](https://github.com/getzola/after-dark): navbar and minor components.
|
||||||
|
|
||||||
|
ZOLA.386 is a theme that refers to the 90s, but with cutting edge features to be fast and responsive.
|
||||||
|
|
||||||
|
|
||||||
|
## Instalation
|
||||||
|
The easiest way to install ZOLA.386 is to clone this repository and build your site upon it:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ git clone https://github.com/lopes/zola.386
|
||||||
|
```
|
||||||
|
|
||||||
|
Of course you can install it just as another theme for your site, but ZOLA.386 must be added as a module:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ cd themes
|
||||||
|
$ git clone https://github.com/lopes/zola.386.git
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
## Configuration
|
||||||
|
Configuration is mainly done in `config.toml` and here I'll describe the main topics.
|
||||||
|
|
||||||
|
### Global
|
||||||
|
`config.toml` starts with the global variables. All of these items are important, but it is fundamental to create two taxonomies at least:
|
||||||
|
|
||||||
|
```toml
|
||||||
|
taxonomies = [
|
||||||
|
{name="categories", rss=true},
|
||||||
|
{name="tags", rss=true},
|
||||||
|
]
|
||||||
|
```
|
||||||
|
|
||||||
|
Remember that all descriptions (`config.description` and `page.description`) are shown on the index page, one at the header and the others through the body.
|
||||||
|
|
||||||
|
### Extras
|
||||||
|
ZOLA.386 comes with a lot of extra variables which eases the creation and maintenance of the site, so it's important to review all of them after installing the theme.
|
||||||
|
|
||||||
|
The `zola386_menu` composes the navbar and is created by setting up a `path`, which will be appended to the `base_url` and the `name` will appear on the navbar.
|
||||||
|
|
||||||
|
```toml
|
||||||
|
zola386_menu = [
|
||||||
|
{path="/", name="Home"},
|
||||||
|
{path="categories", name="Categories"},
|
||||||
|
{path="tags", name="Tags"},
|
||||||
|
{path="about", name="About"},
|
||||||
|
]
|
||||||
|
```
|
||||||
|
|
||||||
|
### Social
|
||||||
|
ZOLA.386 is also prepared to deal with Google Analytics, Disqus, and Twitter --[Open Graph Protocol](https://ogp.me/) is welcome. This theme is prepared to use the output of [Favicon Generator](https://www.favicon-generator.org/), to do so, you'll just need to download the output of that site and extract in `static/images`.
|
||||||
|
|
||||||
|
As said, Disqus is supportted, but besides setting the username in `config.toml`, you also must to put a `disqus = true` extra option on the pages where Disqus will be enable --this gives you the freedom to enable or disable comments on certain posts. You can use the extra option `image` on each page, to represent that post.
|
||||||
|
|
||||||
|
### Animations
|
||||||
|
All JavaScript animations can be set at `static/js/zola386.js`. Basically you can disable all animations, use one or two scans, and change the scan speed. Personally, I prefer only one scan with a speed factor of 5.
|
||||||
|
|
||||||
|
|
||||||
|
### Language
|
||||||
|
|
||||||
|
Under the `label_` variables, you can set names to better localize your site. Note that you can change the language of a single page, by using `page.extra.lang`, which causes `<html lang="">` to change only on that page. A theme to provide information for its owner and SEO-friendly.
|
||||||
|
|
||||||
|
### Other files
|
||||||
|
The `content\_index.md` file must be properly configured to provide better experience. Check out this file for more information.
|
||||||
|
|
||||||
|
The 404 page is almost hardcoded, so you must edit it directly.
|
||||||
|
|
||||||
|
|
||||||
|
## License
|
||||||
|
This theme is released under the MIT license. For more information read the [License](https://github.com/lopes/zola.386/blob/master/LICENSE).
|
||||||
|
|
||||||
|
|
||||||
|
[![Netlify Status](https://api.netlify.com/api/v1/badges/5d6f1986-7bf3-40d3-b298-3339288585d4/deploy-status)](https://app.netlify.com/sites/zola386/deploys)
|
||||||
|
|
||||||
|
|
BIN
docs/content/themes/zola.386/screenshot.png
Normal file
After Width: | Height: | Size: 96 KiB |