diff --git a/docs/content/themes/clean-blog/index.md b/docs/content/themes/clean-blog/index.md new file mode 100644 index 00000000..773a9b37 --- /dev/null +++ b/docs/content/themes/clean-blog/index.md @@ -0,0 +1,78 @@ + ++++ +title = "Clean Blog" +description = "A port of Start Bootstrap Clean Blog for Zola" +template = "theme.html" +date = 2020-01-01T23:06:35+00:00 + +[extra] +created = 2020-01-01T23:06:35+00:00 +updated = 2020-01-01T23:06:35+00:00 +repository = "https://github.com/dave-tucker/zola-clean-blog" +homepage = "https://github.com/dave-tucker/zola-clean-blog" +minimum_version = "0.4.0" +license = "MIT" +demo = "https://zola-clean-blog.netlify.com/" + +[extra.author] +name = "Dave Tucker" +homepage = "https://dtucker.co.uk" ++++ + +zola-clean-blog +=============== + +![screenshot](screenshot.png) + +A port of the StartBootstrap Clean Blog theme, for Zola. + +## Demo + +[Live Demo](https://zola-clean-blog.netlify.com) + +## Usage + +To use the theme, clone this repository to your `themes` directory. +It requires that you use the categories and tags taxonomies. +This can be done with the following additions to `config.toml`: +```toml +theme = "zola-clean-blog" + +taxonomies = [ + {name = "categories", rss = true, paginate_by=5}, + {name = "tags", rss = true, paginate_by=5}, +] +``` + +## Features + +- Paginated Home/Categories/Tag Pages +- Customizable Menu +- Customizable Social Links + +## How To Customize + +- To replace header images, add a new image to `static/img/$page-bg.jpg` where `$page` is one of `about`, `home`, `post` or `contact`. + +- To replace the copyright field, create your own `templates/index.html` to extend the template and add a `copyright` block: +``` +{%/* extends "themes/zola-clean-blog/templates/index.html" */%} +{%/* block copyright */%} +Copyright %copy; Example, Inc. 2016-2019 +{%/* endblock copyright */%} +``` + +- To add a new menu item, override `clean_blog_menu` in your `config.toml`. You can use `$BASE_URL` to reference your own site. + +- To add a new social link, override `clean_blog_social` in your `config.toml`. You can use `$BASE_URL` to reference your own site. + +- To add Google Analytics, you may add your script to the `extrascripts` block using your own `index.html` +``` +{%/* extends "themes/zola-clean-blog/templates/index.html" */%} +{%/* block analytics */%} + +{%/* endblock analytics */%} +``` + \ No newline at end of file diff --git a/docs/content/themes/clean-blog/screenshot.png b/docs/content/themes/clean-blog/screenshot.png new file mode 100644 index 00000000..394d23ea Binary files /dev/null and b/docs/content/themes/clean-blog/screenshot.png differ diff --git a/docs/content/themes/docsascode-theme/index.md b/docs/content/themes/docsascode-theme/index.md new file mode 100644 index 00000000..98e1ad2e --- /dev/null +++ b/docs/content/themes/docsascode-theme/index.md @@ -0,0 +1,122 @@ + ++++ +title = "Docsascode_theme" +description = "A modern simple Zola's theme related to docs as code methodology" +template = "theme.html" +date = 2020-03-05T23:16:20+03:00 + +[extra] +created = 2020-03-05T23:16:20+03:00 +updated = 2020-03-05T23:16:20+03:00 +repository = "https://github.com/codeandmedia/zola_docsascode_theme.git" +homepage = "https://github.com/codeandmedia/zola_docsascode_theme" +minimum_version = "0.10.0" +license = "MIT" +demo = "docsascode.codeandmedia.com" + +[extra.author] +name = "Roman Soldatenkov" +homepage = "https://codeandmedia.com" ++++ + +**Demo: [docsascode.codeandmedia.com](http://docsascode.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. + +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) + +``` +codeandmedia/zola_docsascode_theme:latest +``` + +## Perks + +* light / dark switcher +* tags and authors taxonomies by default +* search +* useful UI both on mobiles and desktops + +## 6 steps build your knowledge base/docs repo + +1. Fork the repo +2. delete demo content and add your own (I explain how to structure it below) +3. change website name and domain in config.toml, also, change the title in _index.md in a root +4. connect your repo to dockerhub +5. build your docker image or setup [autobuilds](https://docs.docker.com/docker-hub/builds/) +6. host a builded docker image on your own way + +But, zola is amazing static site generator, so you feel free to + +1. download all repo files +2. again delete demo content and add your own +3. change name and domain in config.toml/index.md +4. setup zola (win, linux, mac) +5. execute zola build +6. host builded html-output anywhere you want + +Zola supports Netlify and other similar services, or you can decide to create your own CI/CD process. + +## How to structure your content + +All your articles should be inside _content_ folder. Any images, videos, other static files should be inside _static._ + +### Folders + +Every folder should contains _index.md like + +```toml ++++ +title = "Docsascode title" +description = "Description is optional" +sort_by = "date" # sort by weight or date +insert_anchor_links = "right" # if you want ยง next to headers ++++ +``` +Each folder is the section of the website, it means if you create folder foo it will be seen as _yoursitedomain.com/foo_ + +The theme supports folders in folders and articles + folders in one folder (see an example inside _content_). So you can store inside folder another folders and describe in index some specific details. + +### Pages + +A page should be started by + +```toml ++++ +title = "File and folders in folder" +date = 2020-01-18 # or weight +description = "Description" +insert_anchor_links = "right" + +[taxonomies] #all taxonomies is optional +tags = ["newtag"] +authors = ["John Doe"] ++++ +``` + +Zola allows to create drafts: + +```toml +draft = true +``` + +Also, by default you have two taxonomies: _tags_ and _authors_. It's optional, not necessary to use it on all pages. And you can add your own taxonomy: + +1. Copy tags or authors folder and rename it to your taxonomy +2. Add your taxonomy to config.toml +3. Add to page.html template code like + +```rust + {%/* if page.taxonomies.yourtaxonomynameplural */%} +