Repository - Chapter 1

Cheap and Simple Site


markdown-github-screenshot



Templates

In this page you can get the list of available themes and their repositories.

If you want to customize you will need to look the repository to overwrite them.


Structure

To use other layout or make changes to the existent one, make a copy from the original repository and do the proper changes.

The following example repository structure is part of this page.

.
└── yoursite.github.io/
    β”œβ”€β”€ _layouts/
    β”‚   β”œβ”€β”€ custom.html
    β”‚   └── default.html
    β”œβ”€β”€ assets/
    β”‚   └── css/
    β”‚       └── style.scss
    β”œβ”€β”€ images/
    β”œβ”€β”€ pages/
    β”‚   β”œβ”€β”€ a.md
    β”‚   β”œβ”€β”€ b.md
    β”‚   └── c.md
    β”œβ”€β”€ _config.yml
    β”œβ”€β”€ favicon.ico
    └── index.md


Layout

Continuing the Leap Day example you can get the file from the _layouts folder.

Sometimes it’s easier to look what you will get by going directly to that repo and see what you need to update.

This logic to overwrite values applies for other settings.


Layout Overwrite

There are a lot of values that you can change directly in each page, this is how you do it:


---
layout: custom
title: Markdown
description: 
---

There a lot of parameters that you can update, but that’s for another time!


---
layout: custom
title: Markdown Guide
description: Learn how to use Markdown effectively in Jekyll.
permalink: /guides/markdown/
categories: [guides, markdown]
tags: [markdown, jekyll, tutorials]
date: 2024-12-10
author: Luciano Adonis
header_image: /assets/images/markdown-banner.jpg
sidebar: true
toc: true
lang: en
keywords: [markdown, jekyll, guide]
custom_css: /assets/css/markdown.css
custom_js: /assets/js/markdown.js
show_comments: true
featured: true
---


This paraters are the ones that you would see in the _config.yml.