_config.yml file is the most important one. It contains the basic setup of your project.
Some parts are preconfigured and shouldn’t be touched as the comments state.
Of course if you are familiar with Jekyll you can change whatever you want.
Note: You do not have to change anything. Chalk works out of the box. I do recommend changing the
_config.yml to suit your needs.
name: Used as the page title and throughout your project as the default name.
paginate: Define how much posts should be shown on the homepage for each page.
url: Your production url (https://example.com).
blog_theme: 2 options here,
dark. Choose which design you prefer.
about_enabled: If you wish to put the about page link in the top navigation in between the social icons set to true.
discus_identifier: If you like to use Disqus for comments on each blog post, you can add the Disqus identifier here and it will popup automatically.
ga_analytics: Add Google Analytics Tracking ID here.
local_fonts: By default Chalk uses Google Fonts but if you wish to use local fonts this is the fallback.
rss_enabled: When set to
true, the rss icon in the top navigation will show up and people will be able to subscribe to your rss feed.
scrollappear_enabled: If set to
true, some elements appear with fade-in effect when visible for the first time, i.e., when scrolling down.
social: Add you social links in here. When filled in they will show up in the navigation.
Other than the
_config.yml you can change a lot more in the project.
To add tags you must add a file with the tag name in
In the file you add 2 variables:
slug used to reference the tag and
name which is displayed in the article header.
You can change colors, fonts, sizes in the
For each specific theme (light or dark) you can change the variables in
Chalk uses Google Fonts by default. You can change the font in
_includes/webfonts.html and in
Don’t forget that Chalk also supports local fonts if enabled in
Changing the text in the footer is easy. It can be found in
If you have any questions about using or configuring Chalk please create an issue here!