Introduction
_config.yml stores configuration data. Many of these options can be specified from the command line executable but it’s easier to specify them here so you don’t have to remember them.
Please stop and re-run jekyll serve command after you change configuration file! Master configuration file contains global configurations and variable definitions that are read once at execution time. Changes made to config.yml during automatic regeneration are not loaded until the next execution.
Relative URLs
If you’re deploying to server where your site is not going to be in root directory, you should setup baseurl variable.
For example, if your site is going to be stored on URL that looks like this http://example.com/project, you’ll have to update your baseurl variable and it should look like this:
doks:
baseurl: /project
Build site with environment variable! When you run jekyll serve, your baseurl variable shouldn’t render at all in any pages.
We’ll set Jekyll to only render baseurl variable when its environment is set to production.
So then, how do you get the baseurl variable to only show up on a production environment? When building your Jekyll project with jekyll build, you’ll want to prefix it with JEKYLL_ENV=production so the complete command looks like this one: JEKYLL_ENV=production jekyll build
Color themes
Doks supports few color themes:
- blue (default)
- green
- purple
- red
- yellow
You can update your color_theme variable in _config.yml to see changes.
doks:
color_theme: green
Header
Logo with text
If you need logo as text, update text variable and leave image empty.
doks:
header:
logo:
text: Project name
image:
Logo with image
If you need logo as image, update image variable and set it to true and leave text empty.
To set your custom logo image just upload it in place of logo.png here
/doks-theme/assets/images/layout/logo.png.
doks:
header:
logo:
text:
image: true
Recommended logo image size. Recommended logo image size is 400px x 178px. With this size you are sure you'll have retina ready logo image.
Navigation
To add new items in main navigation you have to setup nav variable in _config.yml. Add as many items as you need.
doks:
header:
nav:
- item_name: Item 1
item_url: /example-url-1
- item_name: Item 2
item_url: /example-url-2
Footer
Logo with text
If you need logo as text, update text variable and leave image empty.
doks:
footer:
content:
logo:
text: Project name
image:
Logo with image
If you need logo as image, update image variable and set it to true and leave text empty.
To set your custom logo image just upload it in place of logo-footer.png here /doks-theme/assets/images/layout/logo-footer.png.
doks:
footer:
content:
logo:
text:
image: true
Recommended logo image size. Recommended logo image size is 400px x 178px. With this size you are sure you'll have retina ready logo image.
Copyright
If you need to setup new footer copyright text, update copyright variable in your _config.yml file.
doks:
footer:
content:
copyright: Copyright © 2017. - Project name <br>All rights reserved.
Social list
To properly setup social list update social_list variable in _config.yml. Add as many items as you need.
At the bottom of the “Getting Started” section you can find list of icons you can use in this list. Update network_name variable to add proper icon.
doks:
footer:
social_list:
- network_name: facebook
profile_url: http://example.com
- network_name: twitter
profile_url: http://example.com
- network_name: instagram
profile_url: http://example.com
- network_name: youtube
profile_url: http://example.com
Google Analytics
To activate Google Analytics you have to update _config.yml with GA tracking code. You can do that with tracking_code variable.
doks:
google_analytics:
tracking_code: UA-XXXXXX-X
Build site with environment variable! When you run jekyll serve, your Google Analytics tracking code shouldn’t render at all in any pages.
The reason for this is if you visit your Google Analytics account, you’ll see a bunch of visits from localhost:4000 or 127.0.0.1:4000 depending on the type of operating system you’re developing your Jekyll project.
This can potentially muddy up your analytics, so to mitigate this problem, we’ll set Jekyll to only render Google Analytics when its environment is set to production.
So then, how do you get the analytics to only show up on a production environment? When building your Jekyll project with jekyll build, you’ll want to prefix it with JEKYLL_ENV=production so the complete command looks like this one: JEKYLL_ENV=production jekyll build
Disqus comments
To activate Disqus commenting system you have to update _config.yml with Disqus forum shortname. You can do that with disqus_forum_shortname variable.
Comments are available only on default page layout and you have to enable them on new pages with comments: true variable.
doks:
comments:
disqus_forum_shortname:
Build site with environment variable! When you run jekyll serve, your Disqus commenting system shouldn’t render at all in any pages.
We’ll set Jekyll to only render Disqus commenting system when its environment is set to production.
So then, how do you get the Disqus commenting system to only show up on a production environment? When building your Jekyll project with jekyll build, you’ll want to prefix it with JEKYLL_ENV=production so the complete command looks like this one: JEKYLL_ENV=production jekyll build
Favicon
To change favicon just replace /favicon.ico with your new icon. Make sure it is in .ico format. Dimensions should be 16px x 16px.
Favicon .psd file included! We've included .psd file with pre-made favicon in /designs folder of your theme.