Compare commits

..

4 commits

Author SHA1 Message Date
Emelie Graven f9d6b40fd2
fixup! Disable drone autotag
Some checks failed
continuous-integration/drone/push Build is failing
2021-11-16 16:32:52 +01:00
Emelie Graven 3938c58b60
Disable drone autotag
All checks were successful
continuous-integration/drone/push Build is passing
2021-11-16 16:12:54 +01:00
Emelie Graven 76919e67f3
update drone trigger
All checks were successful
continuous-integration/drone/push Build is passing
2021-11-16 16:08:40 +01:00
Emelie Graven 5a95ec4586
Update docker image, add drone pipeline
All checks were successful
continuous-integration/drone/push Build is passing
2021-11-16 16:03:41 +01:00
51 changed files with 229 additions and 647 deletions

18
.drone.yml Normal file
View file

@ -0,0 +1,18 @@
kind: pipeline
name: default
steps:
- name: docker
image: plugins/docker
settings:
repo: egraven/zola
username: egraven
password:
from_secret: DOCKER_TOKEN
tags:
- latest
- "${DRONE_SEMVER}"
trigger:
branch:
- release

View file

@ -1,21 +1,28 @@
FROM rust:slim AS builder FROM lukemathwalker/cargo-chef:latest-rust-slim AS chef
WORKDIR zola
RUN apt-get update -y && \ FROM chef AS deps
apt-get install -y python-pip make g++ python-setuptools libssl-dev pkg-config rsync && \ #RUN rustup target add x86_64-unknown-linux-musl
pip install dockerize && \ RUN apt-get update && apt-get install -y make g++ pkg-config libssl-dev # musl-tools
rustup target add x86_64-unknown-linux-gnu
WORKDIR /app FROM deps AS recipe
COPY . . COPY . .
RUN cargo chef prepare --recipe-path recipe.json
RUN cargo build --release --target x86_64-unknown-linux-gnu FROM deps AS build
COPY --from=recipe /zola/recipe.json recipe.json
#RUN cargo chef cook --release --target x86_64-unknown-linux-musl --recipe-path recipe.json
RUN cargo chef cook --release --recipe-path recipe.json
RUN mv target/x86_64-unknown-linux-gnu/release/zola /usr/bin COPY . .
RUN mkdir -p /workdir #RUN cargo build --release --target x86_64-unknown-linux-musl --bin zola
WORKDIR /workdir RUN cargo build --release --bin zola
RUN dockerize -n -o /workdir /usr/bin/zola
FROM debian:bullseye-slim AS runtime
WORKDIR zola
#COPY --from=build zola/target/x86_64-unknown-linux-musl/release/zola /usr/local/bin/
COPY --from=build zola/target/release/zola /usr/local/bin/
ENTRYPOINT ["/usr/local/bin/zola"]
LABEL org.opencontainers.image.authors="Emelie Graven <emelie@graven.dev>"
FROM scratch
COPY --from=builder /workdir .
ENTRYPOINT [ "/usr/bin/zola" ]

View file

@ -37,5 +37,3 @@
| [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://github.com/uggla/blog | | [uggla.fr](https://uggla.fr) | https://github.com/uggla/blog |
| [NorthCon e.V.](https://verein.northcon.de/) | | | [NorthCon e.V.](https://verein.northcon.de/) | |
| [OrgaTalk wiki](https://wiki.orgatalk.de/) | https://github.com/orgatalk/wiki |
| [Der Corona-Effekt](https://corona-effekt.orgatalk.de/) | https://github.com/orgatalk/corona-effekt |

View file

@ -121,7 +121,7 @@ The source for all examples is this 300 pixel × 380 pixel image:
## Using `resize_image` in markdown via shortcodes ## Using `resize_image` in markdown via shortcodes
`resize_image` is a Zola built-in Tera function (see the [templates](@/documentation/templates/_index.md) chapter), `resize_image` is a built-in Tera global function (see the [templates](@/documentation/templates/_index.md) chapter),
but it can be used in Markdown using [shortcodes](@/documentation/content/shortcodes.md). but it can be used in Markdown using [shortcodes](@/documentation/content/shortcodes.md).
The examples above were generated using a shortcode file named `resize_image.html` with this content: The examples above were generated using a shortcode file named `resize_image.html` with this content:

View file

@ -10,25 +10,16 @@ To get started, you will need to add the languages you want to support
to your `config.toml`. For example: to your `config.toml`. For example:
```toml ```toml
[languages.fr] languages = [
generate_feed = true # there will be a feed for French content {code = "fr", feed = true}, # there will be a feed for French content
build_search_index = true {code = "fr", search = true}, # there will be a Search Index for French content
taxonomies = [ {code = "it"}, # there won't be a feed for Italian content
{name = "auteurs"},
{name = "tags"},
] ]
[languages.fr.translations]
summary = "Mon blog"
[languages.it]
# Italian language doesn't have any taxonomies/feed/search index
[languages.it.translations]
summary = "Mio blog"
``` ```
If you want to use per-language taxonomies, ensure you set the `lang` field in their
configuration.
Note: By default, Chinese and Japanese search indexing is not included. You can include Note: By default, Chinese and Japanese search indexing is not included. You can include
the support by building `zola` using `cargo build --features search/indexing-ja --features search/indexing-zh`. the support by building `zola` using `cargo build --features search/indexing-ja --features search/indexing-zh`.
Please also note that, enabling Chinese indexing will increase the binary size by approximately Please also note that, enabling Chinese indexing will increase the binary size by approximately

View file

@ -269,7 +269,7 @@ highlight(code);
```` ````
- `hl_lines` to highlight lines. You must specify a list of inclusive ranges of lines to highlight, - `hl_lines` to highlight lines. You must specify a list of inclusive ranges of lines to highlight,
separated by ` ` (whitespace). Ranges are 1-indexed and `linenostart` doesn't influence the values, it always refers to the codeblock line number. separated by whitespaces. Ranges are 1-indexed and `linenostart` doesn't influence the values, it always refers to the codeblock line number.
```` ````
```rust,hl_lines=1 3-5 9 ```rust,hl_lines=1 3-5 9
@ -280,7 +280,7 @@ highlight(code);
```` ````
- `hide_lines` to hide lines. You must specify a list of inclusive ranges of lines to hide, - `hide_lines` to hide lines. You must specify a list of inclusive ranges of lines to hide,
separated by ` ` (whitespace). Ranges are 1-indexed. separated by ` `. Ranges are 1-indexed.
```` ````
```rust,hide_lines=1-2 ```rust,hide_lines=1-2

View file

@ -16,12 +16,12 @@ Here is an example of using that field to render a two-level table of contents:
<ul> <ul>
{% for h1 in page.toc %} {% for h1 in page.toc %}
<li> <li>
<a href="{{ h1.permalink | safe }}">{{ h1.title }}</a> <a href="{{h1.permalink | safe}}">{{ h1.title }}</a>
{% if h1.children %} {% if h1.children %}
<ul> <ul>
{% for h2 in h1.children %} {% for h2 in h1.children %}
<li> <li>
<a href="{{ h2.permalink | safe }}">{{ h2.title }}</a> <a href="{{h2.permalink | safe}}">{{ h2.title }}</a>
</li> </li>
{% endfor %} {% endfor %}
</ul> </ul>

View file

@ -131,7 +131,7 @@ In a similar manner to how section and pages calculate their output path:
The taxonomy pages are then available at the following paths: The taxonomy pages are then available at the following paths:
```txt ```
$BASE_URL/$NAME/ (taxonomy) $BASE_URL/$NAME/ (taxonomy)
$BASE_URL/$NAME/$SLUG (taxonomy entry) $BASE_URL/$NAME/$SLUG (taxonomy entry)
``` ```

View file

@ -18,7 +18,7 @@ We can use any continuous integration (CI) server to build and deploy our site.
In either case, it seems to work best if you use `git submodule` to include your theme, e.g.: In either case, it seems to work best if you use `git submodule` to include your theme, e.g.:
```sh ```shell
git submodule add https://github.com/getzola/after-dark.git themes/after-dark git submodule add https://github.com/getzola/after-dark.git themes/after-dark
``` ```
@ -47,7 +47,7 @@ jobs:
- name: checkout - name: checkout
uses: actions/checkout@v2 uses: actions/checkout@v2
- name: build_and_deploy - name: build_and_deploy
uses: shalzz/zola-deploy-action@v0.14.1 uses: shalzz/zola-deploy-action@v0.13.0
env: env:
# Target branch # Target branch
PAGES_BRANCH: gh-pages PAGES_BRANCH: gh-pages
@ -110,7 +110,7 @@ Depending on how you added your theme, Travis may not know how to access
it. The best way to ensure that it will have full access to the theme is to use git it. The best way to ensure that it will have full access to the theme is to use git
submodules. When doing this, ensure that you are using the `https` version of the URL. submodules. When doing this, ensure that you are using the `https` version of the URL.
```sh ```shell
$ git submodule add {THEME_URL} themes/{THEME_NAME} $ git submodule add {THEME_URL} themes/{THEME_NAME}
``` ```

View file

@ -21,13 +21,12 @@ This guide assumes that your Zola project is located in the root of your reposit
Depending on how you added your theme, your repository may not contain it. The best way to ensure that the theme will Depending on how you added your theme, your repository may not contain it. The best way to ensure that the theme will
be added is to use submodules. When doing this, ensure that you are using the `https` version of the URL. be added is to use submodules. When doing this, ensure that you are using the `https` version of the URL.
```sh ```shell
$ git submodule add {THEME_URL} themes/{THEME_NAME} $ git submodule add {THEME_URL} themes/{THEME_NAME}
``` ```
For example, this could look like: For example, this could look like:
```shell
```sh
$ git submodule add https://github.com/getzola/hyde.git themes/hyde $ git submodule add https://github.com/getzola/hyde.git themes/hyde
``` ```

View file

@ -84,6 +84,9 @@ hard_link_static = false
# #
taxonomies = [] taxonomies = []
# A list of directories used to search for additional `.sublime-syntax` files.
extra_syntaxes = []
# When set to "true", a search index is built from the pages and section # When set to "true", a search index is built from the pages and section
# content for `default_language`. # content for `default_language`.
build_search_index = false build_search_index = false
@ -93,9 +96,6 @@ build_search_index = false
# When set to "true", all code blocks are highlighted. # When set to "true", all code blocks are highlighted.
highlight_code = false highlight_code = false
# A list of directories used to search for additional `.sublime-syntax` files.
extra_syntaxes = []
# The theme to use for code highlighting. # The theme to use for code highlighting.
# See below for list of allowed values. # See below for list of allowed values.
highlight_theme = "base16-ocean-dark" highlight_theme = "base16-ocean-dark"
@ -196,7 +196,7 @@ Zola currently has the following highlight themes available:
- [ayu-dark](https://github.com/dempfi/ayu) - [ayu-dark](https://github.com/dempfi/ayu)
- [ayu-light](https://github.com/dempfi/ayu) - [ayu-light](https://github.com/dempfi/ayu)
- [ayu-mirage](https://github.com/dempfi/ayu) - [ayu-mirage](https://github.com/dempfi/ayu)
- [base16-atelierdune-light](https://atelierbram.github.io/syntax-highlighting/atelier-schemes/dune/) - [base16-aterlierdune-light](https://atelierbram.github.io/syntax-highlighting/atelier-schemes/dune/)
- [base16-ocean-dark](https://tmtheme-editor.herokuapp.com/#!/editor/theme/Base16%20Ocean%20Dark) - [base16-ocean-dark](https://tmtheme-editor.herokuapp.com/#!/editor/theme/Base16%20Ocean%20Dark)
- [base16-ocean-light](https://tmtheme-editor.herokuapp.com/#!/editor/theme/Base16%20Ocean%20Light) - [base16-ocean-light](https://tmtheme-editor.herokuapp.com/#!/editor/theme/Base16%20Ocean%20Light)
- [bbedit](https://tmtheme-editor.herokuapp.com/#!/editor/theme/BBEdit) - [bbedit](https://tmtheme-editor.herokuapp.com/#!/editor/theme/BBEdit)

View file

@ -19,6 +19,7 @@ content: String;
title: String?; title: String?;
description: String?; description: String?;
date: String?; date: String?;
// `updated` will be the same as `date` if `date` is specified but `updated` is not in front-matter
updated: String?; updated: String?;
slug: String; slug: String;
path: String; path: String;

View file

@ -35,7 +35,7 @@ in the configuration file is `simple-blog`. Also make sure to place the variable
Any file from the theme can be overridden by creating a file with the same path and name in your `templates` or `static` Any file from the theme can be overridden by creating a file with the same path and name in your `templates` or `static`
directory. Here are a few examples of that, assuming that the theme name is `simple-blog`: directory. Here are a few examples of that, assuming that the theme name is `simple-blog`:
```txt ```plain
templates/pages/post.html -> replace themes/simple-blog/templates/pages/post.html templates/pages/post.html -> replace themes/simple-blog/templates/pages/post.html
templates/macros.html -> replace themes/simple-blog/templates/macros.html templates/macros.html -> replace themes/simple-blog/templates/macros.html
static/js/site.js -> replace themes/simple-blog/static/js/site.js static/js/site.js -> replace themes/simple-blog/static/js/site.js

View file

@ -3,11 +3,11 @@
title = "DeepThought" title = "DeepThought"
description = "A simple blog theme focused on writing powered by Bulma and Zola." description = "A simple blog theme focused on writing powered by Bulma and Zola."
template = "theme.html" template = "theme.html"
date = 2021-09-07T11:12:53+03:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-09-07T11:12:53+03:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-09-07T11:12:53+03:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/RatanShreshtha/DeepThought.git" repository = "https://github.com/RatanShreshtha/DeepThought.git"
homepage = "https://github.com/RatanShreshtha/DeepThought" homepage = "https://github.com/RatanShreshtha/DeepThought"
minimum_version = "0.9.0" minimum_version = "0.9.0"
@ -19,121 +19,38 @@ name = "Ratan Kulshreshtha"
homepage = "https://ratanshreshtha.dev" homepage = "https://ratanshreshtha.dev"
+++ +++
<p align="center"> # DeepThought
<a href="https://github.com/RatanShreshtha/DeepThought"> A simple blog theme focused on writing powered by Bulma and Zola.
<img src="static/images/avatar.png" alt="Logo" width="80" height="80">
</a>
<h3 align="center">DeepThought</h3> ![DeepThought](./screenshot.png)
<p align="center"> ## Live Demo
A simple blog theme focused on writing powered by Bulma and Zola. Live version of the website is available at [here](https://deepthought-theme.netlify.app/)
<br />
<a href="https://deepthought-theme.netlify.app/docs/"><strong>Explore the docs »</strong></a>
<br />
<br />
<a href="https://github.com/RatanShreshtha/DeepThought">Code Repository</a>
·
<a href="https://github.com/RatanShreshtha/DeepThought/issues">Report Bug</a>
·
<a href="https://github.com/RatanShreshtha/DeepThought/issues">Request Feature</a>
</p>
</p>
<details open="open"> ## Installation
<summary><h2 style="display: inline-block">Table of Contents</h2></summary> Get [Zola](https://www.getzola.org/) and follow their guide on [installing a theme](https://www.getzola.org/documentation/themes/installing-and-using-themes/).
<ol>
<li>
<a href="#about-the-project">About The Project</a>
<ul>
<li><a href="#built-with">Built With</a></li>
</ul>
</li>
<li>
<a href="#getting-started">Getting Started</a>
<ul>
<li><a href="#prerequisites">Prerequisites</a></li>
<li><a href="#installation">Installation</a></li>
</ul>
</li>
<li><a href="#usage">Usage</a></li>
<li><a href="#roadmap">Roadmap</a></li>
<li><a href="#contributing">Contributing</a></li>
<li><a href="#license">License</a></li>
<li><a href="#contact">Contact</a></li>
<li><a href="#acknowledgements">Acknowledgements</a></li>
</ol>
</details>
## About The Project
[![DeepThought](./screenshot.png)](https://deepthought-theme.netlify.app/)
> A simple blog theme focused on writing powered by Bulma and Zola.
### Features
- [x] Dark Mode
- [x] Pagination
- [x] Search
- [x] Charts
- [x] Maps
- [x] Diagrams
- [x] Galleria
- [x] Analytics
- [x] Comments
- [x] Categories
- [x] Social Links
- [x] Multilingual Navbar
- [x] Katex
### Built With
* [Zola](https://www.getzola.org/)
* [Bulma](https://bulma.io/)
## Getting Started
To get a local copy up and running follow these simple steps.
### Prerequisites
You need static site generator (SSG) [Zola](https://www.getzola.org/documentation/getting-started/installation/) installed in your machine to use this theme follow their guide on [getting started](https://www.getzola.org/documentation/getting-started/overview/).
### Installation
Follow zola's guide on [installing a theme](https://www.getzola.org/documentation/themes/installing-and-using-themes/).
Make sure to add `theme = "DeepThought"` to your `config.toml` Make sure to add `theme = "DeepThought"` to your `config.toml`
**Check zola version (only 0.9.0+)** **Check zola version (only 0.9.0+)**
Just to double-check to make sure you have the right version. It is not supported to use this theme with a version under 0.9.0. Just to double-check to make sure you have the right version. It is not supported to use this theme with a version under 0.9.0.
## How to serve?
Go into your sites directory, and type `zola serve`. You should see your new site at `localhost:1111`.
## Usage
### How to serve?
Go into your sites directory and type `zola serve`. You should see your new site at `localhost:1111`.
**NOTE**: you must provide the theme options variables in `config.toml` to serve a functioning site **NOTE**: you must provide the theme options variables in `config.toml` to serve a functioning site
### Deployment ## Deployment
[Zola](https://www.getzola.org) already has great documentation for deploying to [Netlify](https://www.getzola.org/documentation/deployment/netlify/) or [Github Pages](https://www.getzola.org/documentation/deployment/github-pages/). I won't bore you with a regurgitated explanation. [Zola](https://www.getzola.org) already has great documentation for deploying to [Netlify](https://www.getzola.org/documentation/deployment/netlify/) or [Github Pages](https://www.getzola.org/documentation/deployment/github-pages/). I won't bore you with a regurgitated explanation.
### Theme Options ## Theme Options
```toml ```toml
navbar_items = [ navbar_items = [
{ code = "en", nav_items = [
{ url = "$BASE_URL/", name = "Home" }, { url = "$BASE_URL/", name = "Home" },
{ url = "$BASE_URL/posts", name = "Posts" }, { url = "$BASE_URL/posts", name = "Posts" },
{ url = "$BASE_URL/docs", name = "Docs" }, { url = "$BASE_URL/docs", name = "Docs" },
{ url = "$BASE_URL/tags", name = "Tags" }, { url = "$BASE_URL/tags", name = "Tags" },
{ url = "$BASE_URL/categories", name = "Categories" }, { url = "$BASE_URL/categories", name = "Categories" },
]},
] ]
# Add links to favicon, you can use https://realfavicongenerator.net/ to generate favicon for your site # Add links to favicon, you can use https://realfavicongenerator.net/ to generate favicon for your site
@ -159,138 +76,32 @@ keybase = "<keybase_username>"
linkedin = "<linkedin_username>" linkedin = "<linkedin_username>"
stackoverflow = "<stackoverflow_userid>" stackoverflow = "<stackoverflow_userid>"
twitter = "<twitter_username>" twitter = "<twitter_username>"
instagram = "<instagram_usernaem>"
behance = "<behance_username>"
# To add google analytics # To add google analytics
[extra.analytics] [extra.analytics]
google = "<your_gtag>" google = "<your_gtag>"
# To add disqus comments # To add hyvor comments
[extra.commenting] [extra.commenting]
disqus = "<your_disqus_shortname>" hyvor = "<your_hyvor_website_id>"
# To enable mapbox maps # To enable mapbox maps
[extra.mapbox] [extra.mapbox]
access_token = "<your_access_token>" access_token = "<your_access_token>"
``` ```
#### Multilingual Navbar ## Features
- [x] Dark Mode
If you want to have a multilingual navbar on your blog, you must add your new code language in the [languages](https://www.getzola.org/documentation/content/multilingual/#configuration) array in the `config.toml` file. - [x] Pagination
- [x] Search
**NOTE**: Don't add you default language to this array - [x] Charts
- [x] Maps
```toml - [x] Diagrams
languages = [ - [x] Galleria
{code = "fr"}, - [x] Analytics
{code = "es"}, - [x] Comments
] - [x] Categories
``` - [x] Social Links
- [x] Post Sharing
And then create and array of nav item for each language:
**NOTE**: Include your default language in this array
```toml
navbar_items = [
{ code = "en", nav_items = [
{ url = "$BASE_URL/", name = "Home" },
{ url = "$BASE_URL/posts", name = "Posts" },
{ url = "$BASE_URL/docs", name = "Docs" },
{ url = "$BASE_URL/tags", name = "Tags" },
{ url = "$BASE_URL/categories", name = "Categories" },
]},
{ code = "fr", nav_items = [
{ url = "$BASE_URL/", name = "Connexion" },
]},
{ code = "es", nav_items = [
{ url = "$BASE_URL/", name = "Publicationes" },
{ url = "$BASE_URL/", name = "Registrar" },
]}
]
```
en:
![DeepThought](./screenshot_navbar_en.png)
fr:
![DeepThought](./screenshot_navbar_fr.png)
es:
![DeepThought](./screenshot_navbar_es.png)
### KaTeX math formula support
This theme contains math formula support using [KaTeX](https://katex.org/),
which can be enabled by setting `katex.enabled = true` in the `extra` section
+of `config.toml`:
```toml
[extra]
katex.enabled = true
katex.auto_render = true
```
After enabling this extension, the `katex` short code can be used in documents:
* `{{/* katex(body="\KaTeX") */}}` to typeset a math formula inlined into a text,
similar to `$...$` in LaTeX
* `{%/* katex(block=true) */%}\KaTeX{%/* end */%}` to typeset a block of math formulas,
similar to `$$...$$` in LaTeX
#### Automatic rendering without short codes
Optionally, `\\( \KaTeX \\)` / `$ \KaTeX $` inline and `\\[ \KaTeX \\]` / `$$ \KaTeX $$`
block-style automatic rendering is also supported, if enabled in the config:
```toml
[extra]
katex.enabled = true
katex.auto_render = true
```
## Roadmap
See the [open issues](https://github.com/RatanShreshtha/DeepThought/issues) for a list of proposed features (and known issues).
## Contributing
Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are **greatly appreciated**.
1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
## License
Distributed under the MIT License. See `LICENSE` for more information.
## Contact
Ratan Kulshreshtha - [@RatanShreshtha](https://twitter.com/RatanShreshtha)>
Project Link: [https://github.com/RatanShreshtha/DeepThought](https://github.com/RatanShreshtha/DeepThought)
## Acknowledgements
* [GitHub Emoji Cheat Sheet](https://www.webpagefx.com/tools/emoji-cheat-sheet)
* [Choose an Open Source License](https://choosealicense.com)
* [Slick Carousel](https://kenwheeler.github.io/slick)
* [Font Awesome](https://fontawesome.com)
* [Unsplash](https://unsplash.com/)

View file

@ -3,11 +3,11 @@
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 = 2021-09-07T11:12:53+03:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-09-07T11:12:53+03:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-09-07T11:12:53+03:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/InsidiousMind/Ergo.git" repository = "https://github.com/InsidiousMind/Ergo.git"
homepage = "https://github.com/insipx/Ergo" homepage = "https://github.com/insipx/Ergo"
minimum_version = "0.4.1" minimum_version = "0.4.1"

View file

@ -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 = 2021-09-07T11:12:53+03:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-09-07T11:12:53+03:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-09-07T11:12:53+03:00 updated = 2021-08-18T01:00:57-07: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"

View file

@ -3,11 +3,11 @@
title = "adidoks" title = "adidoks"
description = "AdiDoks is a Zola theme helping you build modern documentation." description = "AdiDoks is a Zola theme helping you build modern documentation."
template = "theme.html" template = "theme.html"
date = 2021-09-07T11:12:53+03:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-09-07T11:12:53+03:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-09-07T11:12:53+03:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/aaranxu/adidoks.git" repository = "https://github.com/aaranxu/adidoks.git"
homepage = "https://github.com/aaranxu/adidoks" homepage = "https://github.com/aaranxu/adidoks"
minimum_version = "0.13.0" minimum_version = "0.13.0"
@ -35,10 +35,10 @@ Before using the theme, you need to install the [Zola](https://www.getzola.org/d
## Quick Start ## Quick Start
```bash ```bash
git clone https://github.com/aaranxu/adidoks.git git clone git@github.com:aaranxu/adidoks.git
cd adidoks cd adidoks
zola serve zola serve
# open http://127.0.0.1:1111/ in the browser # open http://127.0.0.1:1111/
``` ```
Read more from [the document of the AdiDoks](https://adidoks.org/docs/getting-started/introduction/). Read more from [the document of the AdiDoks](https://adidoks.org/docs/getting-started/introduction/).
@ -60,7 +60,7 @@ Download this theme to your themes directory:
```bash ```bash
cd mysite/themes cd mysite/themes
git clone https://github.com/aaranxu/adidoks.git git clone git@github.com:aaranxu/adidoks.git
``` ```
Or install as a submodule: Or install as a submodule:
@ -68,7 +68,7 @@ Or install as a submodule:
```bash ```bash
cd mysite cd mysite
git init # if your project is a git repository already, ignore this command git init # if your project is a git repository already, ignore this command
git submodule add https://github.com/aaranxu/adidoks.git themes/adidoks git submodule add git@github.com:aaranxu/adidoks.git themes/adidoks
``` ```
### Step 3: Configuration ### Step 3: Configuration
@ -110,9 +110,7 @@ AdiDoks will start the Zola development web server accessible by default at
## Customisation ## Customisation
You can customize your configurations, templates and content for yourself. Look You can customize your configurations, templates and content for yourself. Look at the `config.toml`, `theme.toml`, `content` files and templates files in this repo for an idea.
at the `config.toml`, `theme.toml`, `content` files and templates files in this
repo for an idea.
### Global Configuration ### Global Configuration
@ -138,7 +136,7 @@ build_search_index = true
The following options should be under the `[extra]` in `config.toml` The following options should be under the `[extra]` in `config.toml`
- `language_code` - set HTML file language (default to `en-US`) - `alanguage_code` - set HTML file language (default to `en-US`)
- `theme_color` - your site's HTML color (default to `#fff`) - `theme_color` - your site's HTML color (default to `#fff`)
- `title_separator` - the separator to your site title, like `|` and `-` (defaults to `|`) - `title_separator` - the separator to your site title, like `|` and `-` (defaults to `|`)
- `title_addition` - the additon content for the title of the homepage - `title_addition` - the additon content for the title of the homepage
@ -152,28 +150,27 @@ The following options should be under the `[extra]` in `config.toml`
- `[[extra.menu.social]]` - the social links on the header of the page - `[[extra.menu.social]]` - the social links on the header of the page
- `[extra.footer]` - the footer content on the left - `[extra.footer]` - the footer content on the left
- `[[extra.footer.nav]]` - the footer navigations on the right - `[[extra.footer.nav]]` - the footer navigations on the right
- `[extra.home]` - the main content of the homepage
- `[[extra.home.list]]` - the lists' content of the homepage
### Templates ### Templates
All pages are extend to the `base.html`, and you can customize them as need. All pages are extend to the `base.html`, and you can customize for as need.
### Content ### Content
#### Homepage #### Homepage
Go to the *content/_index.md* file to add your own homepage content. Go to the `config.toml` to set your own homepage content.
- `[extra]` - the main content of the homepage
- `[[extra.ist]]` - the lists' content of the homepage
#### Sections #### Sections
Each section includes a `_index.md`, and you can customize it or add your new Each section includes a `_index.md`, and you can customize it.
section under the `content` folder.
#### Pages #### Pages
There are mainly three types of pages in the site. There are three types of pages in the site.
- `blog` - blog article - `blog` - blog article
- `docs` - documentation article - `docs` - documentation article

View file

@ -3,11 +3,11 @@
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 = 2021-09-07T11:12:53+03:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-09-07T11:12:53+03:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-09-07T11:12:53+03:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/getzola/after-dark.git" 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.11.0" minimum_version = "0.11.0"

View file

@ -3,16 +3,16 @@
title = "anatole-zola" title = "anatole-zola"
description = "A port of farbox-theme-Anatole for zola" description = "A port of farbox-theme-Anatole for zola"
template = "theme.html" template = "theme.html"
date = 2021-09-07T11:12:53+03:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-09-07T11:12:53+03:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-09-07T11:12:53+03:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/longfangsong/anatole-zola.git" repository = "https://github.com/longfangsong/anatole-zola.git"
homepage = "https://github.com/longfangsong/anatole-zola" homepage = "https://github.com/longfangsong/anatole-zola"
minimum_version = "0.4.0" minimum_version = "0.4.0"
license = "MIT" license = "MIT"
demo = "https://longfangsong.github.io" demo = "https://longfangsong.github.io/blog-next"
[extra.author] [extra.author]
name = "longfangsong" name = "longfangsong"
@ -114,13 +114,6 @@ Tags and links sections are optional.
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 edit its content.
- If you want to add the author's name on each page, add:
```toml
[extra]
author = "John Doe"
```
### Sidebar menu ### Sidebar menu
We support a bunch of social links, they are: We support a bunch of social links, they are:
@ -133,8 +126,6 @@ facebook = ""
instagram = "" instagram = ""
dribbble = "" dribbble = ""
weibo = "" weibo = ""
linkedin = ""
flickr = ""
``` ```
Fill in your username if you want! And the logo won't appear if you leave it empty. Fill in your username if you want! And the logo won't appear if you leave it empty.
@ -155,23 +146,13 @@ avatar = "mm" # avatar style https://github.com/xCss/Valine/wiki/avatar-setting-
placeholder = "Say something here" placeholder = "Say something here"
``` ```
[disqus](https://disqus.com/admin/create/), note disqus does not work in Mainland China: And [disqus](https://disqus.com/admin/create/), note disqus does not work in Mainland China:
```toml ```toml
[extra.comment.disqus] [extra.comment.disqus]
name = "longfangsong" name = "longfangsong"
``` ```
And [utterances](https://utteranc.es/):
```toml
[extra.comment.utterances]
repo = "Your repo for comments"
issue_term = "pathname"
theme = "github-light"
```
## Customize ## Customize
There are several points I left in the origin templates for you to customize your site. There are several points I left in the origin templates for you to customize your site.
@ -200,4 +181,3 @@ You can add more social links by adding a `templates.html` with some content add
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 awsome logos, [font awsome icons](https://fontawesome.com/icons?d=gallery) are already available.

View file

@ -3,11 +3,11 @@
title = "Anpu" title = "Anpu"
description = "A port of the Hugo Anubis theme" description = "A port of the Hugo Anubis theme"
template = "theme.html" template = "theme.html"
date = 2021-09-07T11:12:53+03:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-09-07T11:12:53+03:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-09-07T11:12:53+03:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/zbrox/anpu-zola-theme.git" repository = "https://github.com/zbrox/anpu-zola-theme.git"
homepage = "https://github.com/zbrox/anpu-zola-theme" homepage = "https://github.com/zbrox/anpu-zola-theme"
minimum_version = "0.11.0" minimum_version = "0.11.0"

View file

@ -3,11 +3,11 @@
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 = 2021-09-07T11:12:53+03:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-09-07T11:12:53+03:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-09-07T11:12:53+03:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/getzola/book.git" 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"

View file

@ -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 = 2021-09-07T11:12:53+03:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-09-07T11:12:53+03:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-09-07T11:12:53+03:00 updated = 2021-08-18T01:00:57-07: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"

View file

@ -3,11 +3,11 @@
title = "codinfox-zola" title = "codinfox-zola"
description = "Codinfox theme for Zola" description = "Codinfox theme for Zola"
template = "theme.html" template = "theme.html"
date = 2021-09-07T11:12:53+03:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-09-07T11:12:53+03:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-09-07T11:12:53+03:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/svavs/codinfox-zola" repository = "https://github.com/svavs/codinfox-zola"
homepage = "https://github.com/svavs/codinfox-zola" homepage = "https://github.com/svavs/codinfox-zola"
minimum_version = "0.11.0" minimum_version = "0.11.0"
@ -37,8 +37,7 @@ This theme supports:
2. Changable sidebar locations (reverse it by changing the boolean value 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 3. Integration of FontAwesome, MathJax, Disqus and Google Analytics
4. Support for multilingual sites 4. Support for multilingual sites
5. Support for Gravatar 4. and numerous improvements over original Lanyon and Codinfox-Lanyon
6. and numerous improvements over original Lanyon and Codinfox-Lanyon
All the configuration variables and their meaning are inside: All the configuration variables and their meaning are inside:
@ -53,20 +52,6 @@ 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). 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).
### Before you start
[Get a gravatar account](https://gravatar.com) and set this up with a profile image.
#### Add gravatar profile image to codinfox-zola theme
1. login to gravatar.com
2. click My Profile
3. click **view profile** in RH sidebar beneath profile name
4. click JSON
5. copy the `hash` value on line 4
6. paste the `hash` value to `author.toml` line 10
### Install and use ### Install and use
To use this theme you can follow the instruction required by any Zola theme. To use this theme you can follow the instruction required by any Zola theme.
@ -81,8 +66,6 @@ Now is possible to create the content inside the `content` folder as usual for Z
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/). 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 ## License
Open sourced under the [MIT license](LICENSE.md). Open sourced under the [MIT license](LICENSE.md).

View file

@ -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 = 2021-09-07T11:12:53+03:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-09-07T11:12:53+03:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-09-07T11:12:53+03:00 updated = 2021-08-18T01:00:57-07: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"

View file

@ -3,11 +3,11 @@
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 = 2021-09-07T11:12:53+03:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-09-07T11:12:53+03:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-09-07T11:12:53+03:00 updated = 2021-08-18T01:00:57-07: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"

View file

@ -3,11 +3,11 @@
title = "dose" title = "dose"
description = "a small blog theme" description = "a small blog theme"
template = "theme.html" template = "theme.html"
date = 2021-09-07T11:12:53+03:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-09-07T11:12:53+03:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-09-07T11:12:53+03:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/oltd/dose.git" repository = "https://github.com/oltd/dose.git"
homepage = "https://github.com/oltd/dose" homepage = "https://github.com/oltd/dose"
minimum_version = "0.13.0" minimum_version = "0.13.0"

View file

@ -3,11 +3,11 @@
title = "even" title = "even"
description = "A robust, elegant dark theme" description = "A robust, elegant dark theme"
template = "theme.html" template = "theme.html"
date = 2021-09-07T11:12:53+03:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-09-07T11:12:53+03:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-09-07T11:12:53+03:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/getzola/even.git" repository = "https://github.com/getzola/even.git"
homepage = "https://github.com/getzola/even" homepage = "https://github.com/getzola/even"
minimum_version = "0.11.0" minimum_version = "0.11.0"

View file

@ -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 = 2021-09-07T11:12:53+03:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-09-07T11:12:53+03:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-09-07T11:12:53+03:00 updated = 2021-08-18T01:00:57-07: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"

View file

@ -3,11 +3,11 @@
title = "Float" title = "Float"
description = "An elegant blog theme" description = "An elegant blog theme"
template = "theme.html" template = "theme.html"
date = 2021-09-07T11:12:53+03:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-09-07T11:12:53+03:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-09-07T11:12:53+03:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://gitlab.com/float-theme/float.git" repository = "https://gitlab.com/float-theme/float.git"
homepage = "https://float-theme.netlify.app/" homepage = "https://float-theme.netlify.app/"
minimum_version = "0.11.0" minimum_version = "0.11.0"

View file

@ -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 = 2021-09-07T11:12:53+03:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-09-07T11:12:53+03:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-09-07T11:12:53+03:00 updated = 2021-08-18T01:00:57-07: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"

View file

@ -3,11 +3,11 @@
title = "hyde" title = "hyde"
description = "A classic blog theme" description = "A classic blog theme"
template = "theme.html" template = "theme.html"
date = 2021-09-07T11:12:53+03:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-09-07T11:12:53+03:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-09-07T11:12:53+03:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/getzola/hyde.git" repository = "https://github.com/getzola/hyde.git"
homepage = "https://github.com/getzola/hyde" homepage = "https://github.com/getzola/hyde"
minimum_version = "0.11.0" minimum_version = "0.11.0"

View file

@ -3,11 +3,11 @@
title = "juice" title = "juice"
description = "An intuitive, elegant, and lightweight Zola theme for product sites." description = "An intuitive, elegant, and lightweight Zola theme for product sites."
template = "theme.html" template = "theme.html"
date = 2021-09-07T11:12:53+03:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-09-07T11:12:53+03:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-09-07T11:12:53+03:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/huhu/juice" repository = "https://github.com/huhu/juice"
homepage = "https://github.com/huhu/juice" homepage = "https://github.com/huhu/juice"
minimum_version = "0.11.0" minimum_version = "0.11.0"

View file

@ -1,190 +0,0 @@
+++
title = "karzok"
description = "A theme for your documentation. Fast and secure"
template = "theme.html"
date = 2021-09-07T11:12:53+03:00
[extra]
created = 2021-09-07T11:12:53+03:00
updated = 2021-09-07T11:12:53+03:00
repository = "https://github.com/kogeletey/karzok"
homepage = "https://fmatch.org/karzok"
minimum_version = "0.0.14"
license = "Apache-2.0"
demo = "https://fmatch.org/karzok"
[extra.author]
name = "Konrad Geletey"
homepage = ""
+++
[![builds.sr.ht status](https://builds.sr.ht/~kogeletey/karzok.svg)](https://builds.sr.ht/~kogeletey/karzok?)
# Karzok
A theme for your documentation. Fast and secure
![screenshot](./screenshot.png)
## Demo
[Fmatch Karzok](https://fmatch.org/karzok)
## Requirements
Karzok uses npm,zola to dependency managment,rendering, scripts and plugins.
### Install
1. [Zola](https://www.getzola.org/documentation/getting-started/installation/)
2. [Node.js](https://nodejs.org/)
for your platform.
### Optional
1. [yj](https://github.com/sclevine/yj)
> for transfer toml file in yaml
2. [docker](https://docs.docker.com/engine/install/)
> for packaging container
3. [rsync](https://rsync.samba.org/)
> A better copy and move
## Get Started
### 1. Create a new zola site
```zsh
zola init zola_site
```
### 2. Download this theme to you themes directory:
```zsh
git clone https://git.sr.ht/~kogeletey/karzok zola_site/themes
```
or install as submodule:
```zsh
cd zola_site
git init # if your project is a git repository already, ignore this command
git submodule add https://git.sr.ht/~kogeletey/karzok zola_site/themes
```
### 3. Configuration. Open in favorite editor `config.toml`
```toml
base_url = "https://karzok.example.net" # set-up for production
theme = "karzok"
```
See more in [Karzok Configuration](#configuration)
### 4. Added new content
```zsh
cp ./themes/content/_index.md content/_index.md
cp ./thems/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
```zsh
npm run gen # don't use npm install before that
```
2. Just run `zola serve` in the root path of the project
```zsh
zola serve
```
Open in favorite browser [http://127.0.0.1:1111](http://127.0.0.1:1111). Saved
changes live reolad.
ii. production enviroment
- with docker
1. Build docker image
```zsh
docker build .
```
or if installed docker-compose
```zsh
docker-compose build
```
2. Run containers
```zsh
docker start -d -p 80:80 container_id
```
or if installed docker-compose
```zsh
docker-compose up -d
```
Open in favorite browser [https://localhost](http://localhost)
## Configuration
## options under the `[extra]`
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
4. `cdnurl` - you can customize your url to store assets,default use [jsdelivr](https://www.jsdelivr.com)
5. `[[extra.menu]]` - the main navigation on the site
6. `[[extra.header]]` - the header navigantion for the site
### Templates
All pages are extend to the base.html, and you can customize them as need.
## License
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)
## 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:
- [ ] readme contrubutions
- [x] configure loading from cdn
- [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

Binary file not shown.

Before

Width:  |  Height:  |  Size: 75 KiB

View file

@ -3,11 +3,11 @@
title = "lightspeed" title = "lightspeed"
description = "Zola theme with a perfect Lighthouse score" description = "Zola theme with a perfect Lighthouse score"
template = "theme.html" template = "theme.html"
date = 2021-09-07T11:12:53+03:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-09-07T11:12:53+03:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-09-07T11:12:53+03:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/carpetscheme/lightspeed" repository = "https://github.com/carpetscheme/lightspeed"
homepage = "https://github.com/carpetscheme/lightspeed" homepage = "https://github.com/carpetscheme/lightspeed"
minimum_version = "0.10.0" minimum_version = "0.10.0"

View file

@ -3,11 +3,11 @@
title = "ntun-zola-theme" title = "ntun-zola-theme"
description = "A classic resume theme" description = "A classic resume theme"
template = "theme.html" template = "theme.html"
date = 2021-09-07T11:12:53+03:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-09-07T11:12:53+03:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-09-07T11:12:53+03:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/Netoun/ntun" repository = "https://github.com/Netoun/ntun"
homepage = "https://github.com/netoun/ntun" homepage = "https://github.com/netoun/ntun"
minimum_version = "0.1.0" minimum_version = "0.1.0"
@ -64,7 +64,7 @@ links = [
{ url = "", title="", icon = "fab fa-github"}, { url = "", title="", icon = "fab fa-github"},
{ url = "", title="", icon = "fab fa-twitter"}, { url = "", title="", icon = "fab fa-twitter"},
{ url = "", title="", icon = "fab fa-linkedin"}, { url = "", title="", icon = "fab fa-linkedin"},
{ url = "mailto:", title="", icon = "fas fa-envelope"} { url = "mailto:"title="", icon = "fas fa-envelope"}
] ]
# if you add languages, put your emoji flag on array # if you add languages, put your emoji flag on array
@ -76,4 +76,3 @@ languages_flags = [
If you put `$BASE_URL` in a url, it will automatically be replaced by the actual If you put `$BASE_URL` in a url, it will automatically be replaced by the actual
site URL. site URL.

View file

@ -3,11 +3,11 @@
title = "Oceanic Zen" title = "Oceanic Zen"
description = "Minimalistic blog theme" description = "Minimalistic blog theme"
template = "theme.html" template = "theme.html"
date = 2021-09-07T11:12:53+03:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-09-07T11:12:53+03:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-09-07T11:12:53+03:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/barlog-m/oceanic-zen.git" repository = "https://github.com/barlog-m/oceanic-zen.git"
homepage = "https://github.com/barlog-m/oceanic-zen" homepage = "https://github.com/barlog-m/oceanic-zen"
minimum_version = "0.12.0" minimum_version = "0.12.0"

View file

@ -1,18 +1,18 @@
+++ +++
title = "Papaya" title = "Papaya"
description = "A clean Zola theme for blogging and projects" description = "A clean blogging theme with projects"
template = "theme.html" template = "theme.html"
date = 2021-09-07T11:12:53+03:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-09-07T11:12:53+03:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-09-07T11:12:53+03:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/justint/papaya.git" repository = "https://github.com/justint/papaya.git"
homepage = "https://github.com/justint/papaya" homepage = "https://github.com/justint/papaya"
minimum_version = "0.14.0" minimum_version = "0.14.0"
license = "MIT" license = "MIT"
demo = "https://justintennant.me/papaya" demo = ""
[extra.author] [extra.author]
name = "Justin Tennant" name = "Justin Tennant"
@ -23,7 +23,7 @@ homepage = "https://justintennant.me"
A clean [Zola](https://getzola.org) theme for blogging and projects, forked from [Anpu](https://github.com/zbrox/anpu-zola-theme). A clean [Zola](https://getzola.org) theme for blogging and projects, forked from [Anpu](https://github.com/zbrox/anpu-zola-theme).
**Demo site**: [https://justintennant.me/papaya/](https://justintennant.me/papaya/) **Demo site**: https://justintennant.me/papaya/
![index](pics/index.png) ![index](pics/index.png)

View file

@ -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 = 2021-09-07T11:12:53+03:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-09-07T11:12:53+03:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-09-07T11:12:53+03:00 updated = 2021-08-18T01:00:57-07: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"

View file

@ -3,11 +3,11 @@
title = "simple-dev-blog" title = "simple-dev-blog"
description = "A simple dev blog theme with no javascript, prerendered linked pages and SEO tags." description = "A simple dev blog theme with no javascript, prerendered linked pages and SEO tags."
template = "theme.html" template = "theme.html"
date = 2021-09-07T11:12:53+03:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-09-07T11:12:53+03:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-09-07T11:12:53+03:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/bennetthardwick/simple-dev-blog-zola-starter" repository = "https://github.com/bennetthardwick/simple-dev-blog-zola-starter"
homepage = "https://github.com/bennetthardwick/simple-dev-blog-zola-starter" homepage = "https://github.com/bennetthardwick/simple-dev-blog-zola-starter"
minimum_version = "0.4.0" minimum_version = "0.4.0"

View file

@ -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 = 2021-09-07T11:12:53+03:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-09-07T11:12:53+03:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-09-07T11:12:53+03:00 updated = 2021-08-18T01:00:57-07: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"

View file

@ -3,11 +3,11 @@
title = "solar-theme-zola" title = "solar-theme-zola"
description = "A port of solar-theme-hugo for zola" description = "A port of solar-theme-hugo for zola"
template = "theme.html" template = "theme.html"
date = 2021-09-07T11:12:53+03:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-09-07T11:12:53+03:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-09-07T11:12:53+03:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/hulufei/solar-theme-zola.git" repository = "https://github.com/hulufei/solar-theme-zola.git"
homepage = "https://github.com/hulufei/solar-theme-zola" homepage = "https://github.com/hulufei/solar-theme-zola"
minimum_version = "0.4.0" minimum_version = "0.4.0"
@ -62,7 +62,7 @@ Set a field in `extra` with a key of `site_menus`:
```toml ```toml
site_menus = [ site_menus = [
{ url = "https://github.com/hulufei/solar-theme-zola", name = "Repository" }, { url = "https://github/hulufei.com/solar-theme-zola", name = "Repository" },
{ url = "rss.xml", name = "RSS" }, { url = "rss.xml", name = "RSS" },
] ]
``` ```

View file

@ -3,11 +3,11 @@
title = "tale-zola" title = "tale-zola"
description = "Tala-Zola is a minimal Zola theme helping you to build a nice and seo-ready blog." description = "Tala-Zola is a minimal Zola theme helping you to build a nice and seo-ready blog."
template = "theme.html" template = "theme.html"
date = 2021-09-07T11:12:53+03:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-09-07T11:12:53+03:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-09-07T11:12:53+03:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/aaranxu/tale-zola.git" repository = "https://github.com/aaranxu/tale-zola.git"
homepage = "https://github.com/aaranxu/tale-zola" homepage = "https://github.com/aaranxu/tale-zola"
minimum_version = "0.13.0" minimum_version = "0.13.0"
@ -198,15 +198,6 @@ Use Google Analytics. Add your own Google Analytics ID.
google_analytics = "UA—XXXXXXXX-X" google_analytics = "UA—XXXXXXXX-X"
``` ```
Whether to use Disqus globally and set to your disqus id name.
And you can enable the disqus on per post page with `extra.disqus` option
```toml
[extra]
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 hightlighting](https://www.getzola.org/documentation/getting-started/configuration/#syntax-highlighting).
```toml ```toml
@ -261,9 +252,6 @@ on = "on" # Like: on May 3, 2021
top = "Top" # Go to the top of the page in the post top = "Top" # Go to the top of the page in the post
tags = "Tags" # In the page of Tags tags = "Tags" # In the page of Tags
# disqus comments block
disqus_discussion = "Discussion and feedback"
# The contents of the 404 page # The contents of the 404 page
p404 = "404: Page not found" p404 = "404: Page not found"
p404_info = "Oops! We can't seem to find the page you are looking for." p404_info = "Oops! We can't seem to find the page you are looking for."

View file

@ -3,11 +3,11 @@
title = "Toucan" title = "Toucan"
description = "Inspired from Pelican default theme" description = "Inspired from Pelican default theme"
template = "theme.html" template = "theme.html"
date = 2021-09-07T11:12:53+03:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-09-07T11:12:53+03:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-09-07T11:12:53+03:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://git.42l.fr/HugoTrentesaux/toucan.git" repository = "https://git.42l.fr/HugoTrentesaux/toucan.git"
homepage = "https://git.42l.fr/HugoTrentesaux/toucan" homepage = "https://git.42l.fr/HugoTrentesaux/toucan"
minimum_version = "0.8.0" minimum_version = "0.8.0"

View file

@ -3,11 +3,11 @@
title = "zerm" title = "zerm"
description = "A minimalistic and dark theme based on Radek Kozieł's theme for Hugo" description = "A minimalistic and dark theme based on Radek Kozieł's theme for Hugo"
template = "theme.html" template = "theme.html"
date = 2021-09-07T11:12:53+03:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-09-07T11:12:53+03:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-09-07T11:12:53+03:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/ejmg/zerm.git" repository = "https://github.com/ejmg/zerm.git"
homepage = "https://github.com/ejmg/zerm" homepage = "https://github.com/ejmg/zerm"
minimum_version = "0.8.0" minimum_version = "0.8.0"

View file

@ -3,11 +3,11 @@
title = "henry" title = "henry"
description = "A timeless blog theme" description = "A timeless blog theme"
template = "theme.html" template = "theme.html"
date = 2021-09-07T11:12:53+03:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-09-07T11:12:53+03:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-09-07T11:12:53+03:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/sirodoht/zola-henry" repository = "https://github.com/sirodoht/zola-henry"
homepage = "https://github.com/sirodoht/zola-henry" homepage = "https://github.com/sirodoht/zola-henry"
minimum_version = "0.4.0" minimum_version = "0.4.0"

View file

@ -3,11 +3,11 @@
title = "zola-paper" title = "zola-paper"
description = "A clean theme inspired from hugo-paper." description = "A clean theme inspired from hugo-paper."
template = "theme.html" template = "theme.html"
date = 2021-09-07T11:12:53+03:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-09-07T11:12:53+03:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-09-07T11:12:53+03:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/schoenenberg/zola-paper.git" repository = "https://github.com/schoenenberg/zola-paper.git"
homepage = "https://github.com/schoenenberg/zola-paper" homepage = "https://github.com/schoenenberg/zola-paper"
minimum_version = "0.11.0" minimum_version = "0.11.0"

View file

@ -3,11 +3,11 @@
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 = 2021-09-07T11:12:53+03:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-09-07T11:12:53+03:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-09-07T11:12:53+03:00 updated = 2021-08-18T01:00:57-07: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.13.0" minimum_version = "0.13.0"
@ -20,7 +20,7 @@ homepage = "https://luke.hsiao.dev"
+++ +++
# Pickles # Pickles
Pickles is a clean, responsive blog theme for [Zola](https://www.getzola.org/) based on the Hugo theme with the same name featuring pagination. Pickles is a clean, responsive blog theme based on the Hugo theme with the same name featuring pagination.
![pickles screenshot](https://github.com/lukehsiao/zola-pickles/blob/master/screenshot.png?raw=true) ![pickles screenshot](https://github.com/lukehsiao/zola-pickles/blob/master/screenshot.png?raw=true)

View file

@ -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 = 2021-09-07T11:12:53+03:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-09-07T11:12:53+03:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-09-07T11:12:53+03:00 updated = 2021-08-18T01:00:57-07: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"

View file

@ -3,11 +3,11 @@
title = "zola.386" title = "zola.386"
description = "Zola port of the BOOTSTRA.386 theme." description = "Zola port of the BOOTSTRA.386 theme."
template = "theme.html" template = "theme.html"
date = 2021-09-07T11:12:53+03:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-09-07T11:12:53+03:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-09-07T11:12:53+03:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/lopes/zola.386" repository = "https://github.com/lopes/zola.386"
homepage = "https://github.com/lopes/zola.386" homepage = "https://github.com/lopes/zola.386"
minimum_version = "0.10.1" minimum_version = "0.10.1"

View file

@ -3,11 +3,11 @@
title = "EasyDocs" title = "EasyDocs"
description = "An easy way to create docs for your project" description = "An easy way to create docs for your project"
template = "theme.html" template = "theme.html"
date = 2021-09-07T11:12:53+03:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-09-07T11:12:53+03:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-09-07T11:12:53+03:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/codeandmedia/zola_easydocs_theme.git" repository = "https://github.com/codeandmedia/zola_easydocs_theme.git"
homepage = "https://github.com/codeandmedia/zola_easydocs_theme" homepage = "https://github.com/codeandmedia/zola_easydocs_theme"
minimum_version = "0.13.0" minimum_version = "0.13.0"