Today we are going to learn the basics of publishing and maintaining a blog to host your technical writing. You will create a static blog and learn how to host it for free on Github Pages. You can expect to walk away being confident modifying and customizing your blog to better fit your needs.
You’ll find this post in your
_posts directory. Go ahead and edit it and re-build the site to see your changes. You can rebuild the site in many different ways, but the most common way is to run
By default dactl has a couple of special classes which will turn a paragraph into a notice block when added to it. Read on for information on how to use it.
How to create a notice block
Creating notices from your paragraphs works the same way as creating leading post paragraphs.
You need to add a correct class after the paragraph:
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.
In order to use dactl’s post images with overlays you’ll need to learn how to set them. You do that in post’s YAML frontmatter and I’ll show you how.
YAML Front matter
Each Jekyll post starts with YAML Front 1. For example, this is how this post would look like if I wanted to use all of the options:
Everything in between those two