How to configure the site of our blog. From WordPress to Jekyll 6

How to set up the site

Continuing with this series of articles on how I went from WordPress to Jekyll, The time has come to leave theory behind and move on to practice.

I am describing the configuration steps in the sense that I did them. The first file to edit is config.yml. In this we find the default configuration of the site. Each particular post or page can be assigned a different configuration. But, in case we don't, the one established in this file will be assigned.

Remember that in the previous article we had downloaded a theme and we are basing ourselves on it for the creation of our site.
The .yml extension indicates that the document is written using YAML. This language allows hierarchies between data to be established in a way that is understandable to both computers and humans. Jekyll uses it to give consistency to the various components of a project.

How to configure the site using YAML

A basic Jekyll project features a config.yml file that allows us to define some parameters.

These parameters are represented in the format

Category: ”content” It is worth mentioning that it is preceded by the sign # it is ignored, so if we want Jekyll to use that parameter we must remove it.

In our config.yml file we will see something like this:

title: The site title

email: The site email

description: A description of the site object for search engines to display

baseurl: If the blog is part of another site and a specific folder is assigned to it, it is indicated here

url: The primary domain of the site.

There are also two other categories.



These two parameters show links to Twitter and Github user accounts.

Below you will tell Jekyll which theme to use and which add-ons.

Config.yml in Minimal mistakes

Nwe are going to use a theme with many more options and, therefore, requires a more complete config.yml. The most practical is to copy the file from the theme project and paste it into ours instead of its content. Once this is done we edit the following parameters

Remember that our example project was a gardening blog.

The first thing we have to do is establish the theme. In this line

# theme : "minimal-mistakes-jekyll»We delete the symbol of the numeral" # "

This theme offers several variations. I like the call Aqua.
We comment on "default" by putting the #d symbol in front of the name and uncomment "aqua

Locale indicates the language of the website in the format language_VARIANT. For example, since I am in Argentina it is

locale : "es-AR»

You can find the list of languages ​​in this page

We indicate the title of the site

title : "Blog de jardinería"

We choose a separator between the title of the site and that of the post so that it is displayed correctly in search engines.

title_separator : "-"

We can add a subtitle

subtitle: “Llevamos la naturaleza a tu computadora”

We indicate the name of the person in charge of the site

name : "Rosendo Margarito Flores"

We complete the site description
to display in search engines and on the home page

description : "Un blog para difundir el auto cultivo de vegetales y flores entre aquellos que no tienen la menor idea de cómo se hace."

The next two parameters are two old acquaintances, but in reverse order.

EIn the first case we indicate the domain of the site

url: "https: //desdeeljardin.flor"

Suppose our blog was part of a seed store. We may want to assign it its own standard address from the garden flower / blog.

Then we do
baseurl : "/blog"

For some reason, posts with images have more visits than those without. In case you have not assigned one to them, you can make it show one by default by activating this parameter.

teaser : "/assets/images/500x300.png"

To avoid confusion, I am going to keep the original file structure of the theme. Therefore, in our project folder we must create a folder called assets, inside it a called images, and inside it a 500 × 300 pixel called 500 × 300.png

We can also choose the site logo. We repeat the procedure to create it and save it in the same folders and complete the parameter:

logo : "/assets/images/88x88.png"

We can choose a different title than the site to be displayed at the top browser

masthead_title: “¡Feliz primavera!”
In the next article we will continue reviewing the configuration options. But, I take the opportunity to clarify that I have no idea about gardening. Therefore I am not responsible for what the example blog says.

The content of the article adheres to our principles of editorial ethics. To report an error click here!.

Be the first to comment

Leave a Comment

Your email address will not be published.



  1. Responsible for the data: AB Internet Networks 2008 SL
  2. Purpose of the data: Control SPAM, comment management.
  3. Legitimation: Your consent
  4. Communication of the data: The data will not be communicated to third parties except by legal obligation.
  5. Data storage: Database hosted by Occentus Networks (EU)
  6. Rights: At any time you can limit, recover and delete your information.

bool (true)