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                      : [email protected] # 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
this should contain a proper description written by Srinivasa Kumar