Base
Knowledge base template for Jekyll. Browse through a live demo.
Base was made by CloudCannon, the Cloud CMS for Jekyll.
Find more templates, themes and step-by-step Jekyll tutorials at CloudCannon Academy.
Features
- Tutorials organised by category
- Two types of tutorials - text and video
- Ability to have a "tutorial series"
- FAQ section
- Disqus comments
- Sticky sidebar for main headings in tutorials
- Optimised for editing in CloudCannon
- RSS/Atom feed
- SEO tags
- Google Analytics
Setup
- Add your site and author details in
_config.yml. - Add your Google Analytics, Disqus and MailChimp keys to
_config.yml. - Get a workflow going to see your site's output (with CloudCannon or Jekyll locally).
Develop
Base was built with Jekyll version 3.4.3, but should support newer versions as well.
Install the dependencies with Bundler:
$ bundle install
Run jekyll commands through Bundler to ensure you're using the right versions:
$ bundle exec jekyll serve
Editing
Base is already optimised for adding, updating and removing tutorials, navigation, footer and FAQ information in CloudCannon.
The sticky sidebar in tutorials in populated by pulling out <h2> elements from the content.
Posts
- Add, update or remove a post in the Posts collection.
- The tutorials page is organised by categories.
- Change the defaults when new posts are created in
_posts/_defaults.md.
Post Series
To create a new series:
- Add a new document to the
setscollection. - Set the
titleanddescription.
To add a tutorial/post to a series:
- Add a
setfield to the tutorial front matter which points to the file name of the desired set without the.mdextention. e.g. If I have a set at_sets/getting-started.mdI would use this in my tutorial front matter:set: getting-started. - Add a
order_numberfield to the tutorial front matter and specify a number. This is the tutorials order in the set.
Navigation
- Exposed as a data file to give clients better access.
- Set in the Data / Navigation section.
Footer
- Exposed as a data file to give clients better access.
- Set in the Data / Footer section.
-
一般编写都是采用utf-8的吧，但是在windows下安装的jekyll，默认是以GBK编码的方式去读取咱们编写的文件，如此便乱码了。 要解决此问题，总不至于要写GBK编码的文件吧，毕竟这个编码不怎么通用，所以需要修改jekyll中的代码，让其以utf-8编码来读取我们的文件，已有网友找到解决方法！需要修改jekyll中读取的代码，指定为utf-8编码即可。具体如下： 错误信息: Genera
-
序：上篇文章虽然在本地搭建好了jekyll环境，但是却存在一些问题，如通过jekyll new创建的站点无法正常跑起来、中文编码有问题。这说明之前搭建的环境有不周之处。 PS：因之前自己搭建环境时并未做过多记录，现在写起文章来需要在模拟几次安装，所以本文写的有点慢，毕竟不像当初只是为了安装，现在是为了弄清楚安装。立足点不同，需要做的事情也不同，这次需要做许多确认工作。 一、语法高亮插件问题 通
-
Aperture Aperture template for Jekyll. Browse through a live demo. Aperture was made by CloudCannon, the Cloud CMS for Jekyll.Find more templates and themes at CloudCannon Academy. Learn Jekyll with s
-
jekyll-vue-template A Jekyll project template that uses Vue.js single file components complete with webpack bundling and optimizations. Overview jekyll-vue-template is an opinionated, but minimal boil
-
Leia em Português Typing Introduction Typing, is a template for Jekyll created especially for those who want to have a blog and pages quickly and lightly. Keep things simple, my friend! Its interface
-
Fur E-commerce template for Jekyll. Browse through a live demo. Fur was made by CloudCannon, the Cloud CMS for Jekyll. Find more templates, themes and Jekyll tutorials at CloudCannon Academy. Features
-
Treat Food/baking blog template for Jekyll. Browse through a live demo. Treat was made by CloudCannon, the Cloud CMS for Jekyll. Find more templates, themes and step-by-step Jekyll tutorials at CloudC
-
Cause Not for profit themed template for Jekyll. Browse through a live demo.Increase the web presence of a not for profit or cause website with this configurable theme. CloudCannon was made by CloudCa