Layout settings and more in _config.yml
All of the dactl’s configurations has to be set in _config.yml file. Read on for explanation of all of the features that you can toggle, including configuring the layout.
I’ve split dactl’s _config.yml into two parts. First part should be configured by you, second contains important Jekyll & build settings and you should leave it alone, unless you know what you are doing.
Let’s go through each line in the first, configurable part:
class="highlight">
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
# Base blog settings
blog:
title : dactl
description : >
this should contain a proper description
# Layout configuration
logo_path : "assets/img/dactl.svg" # path to logo file
search_path : # "yourgitusername.github.io"
# needed for searchbox in archive page
hero_layout : true # turn on hero layout for blog and posts
hero_placeholder : "assets/img/generic_hero.jpg" # placeholder for hero
excerpts : true # show excerpts instead of full post content on blog page
inline_footnotes : true # enable/disable barefoot inline footnotes
titles_only : false # titles only on main blog page
# Fonts
font : '"Rubik", -apple-system, BlinkMacSystemFont, "Helvetica Neue", sans-serif'
load_google_fonts : 'Rubik:400,400italic,700,700italic'
# Author info
author:
fullname : Your Name
rss : true # generate RSS feed and show it's icon in header
mail : your@email.com # change to your e-mail address
twitter : twitter-user-name
github : github-user-name
youtube : youtube-user-name
stackoverflow : stackoverflow-user-name
disqus : dactl # your disqus site name
google_analytics : # 'UA-XXXXXXXX-X'
photo : "uploads/me2.png"
photo2x : "uploads/me.png"
baseurl : "/dactl/" # the subpath of your site, e.g. /blog/, set to '' in case of hosting on GitHub pages
# i.e. `http://<username>.github.io`
url : "" # the base hostname & protocol for your site
Base blog settings
title - title of your blog, both in <title> tag and in the header.
description - descriptionof your blog, shown in the footer
Layout settings
logo_path - Path to an .svg image used as logo
search_path - Path to your blog, needed for the DuckDuckGo’s searchbar found in Archive page.
hero_layout - true / false - Turn the hero image layout on or off. When turned off you don’t need to supply images and overlays in post’s YAML front matter and the layout gets slightly adjusted.
hero_placeholder - Path to an image which will be used as a placeholder when there is no hero set for post, optional.
excerpts - true or false - Turn post excerpts on or off. When set to false you will see full text content for each post on blog page.
inline_footnotes - true or false - When set to false you will turn off Barefoot.js inline footnotes.
titles_only - true or false - When set to true Jekyll will generate blog layout with post titles only. hero_layout and excerpts are overidden by titles_only when it’s set to true.
Fonts
font - Name of the font family used for theme’s typography.
load_google_fonts - Choose what font family should be loaded, served by google fonts.
In order to change the font you need to supply it’s name and variants - font weight of 400 and 700 are required.
Author info
fullname - Your name and surname or nick, used throughout the blog.
rss - true or false - Turn the RSS feeds on or off.
mail - Your e-mail address.
twitter - Your twitter username
github - Your Github username
youtube - Your YouTube username
stackoverflow - Your Stackoverflow username
disqus - Your Disqus site name.
photo - Avatar or photo of you, used on About page.
photo2x - Same as above but in higher resolution.
Google Analytics
google_analytics - Supply your Google Analytics ID here, if you want to use it.
baseurl - Subpath of your blog, e.g. /blog, leave it empty in case of hosting on Github pages - yourusername.github.io