Chirpy Survive Guide

Disclaimer

This post don’t replace the official documentation, It’s only a summary about what I think’s more important.

Change avatar picture

Create img/avatar inside assets folder

Paste the picture that you want to be your avatar picture inside assets/img/avatar/

Go to _config.yml line 86, fill it with the image path like i did:

Change favicon

Create favicon inside assets/img folder

Go to Real Favicon Generator, upload your image and config it, click on Generate your Favicons and HTML code

Download the generated package, unzip and delete the following two from the extracted files:

• browserconfig.xml
• site.webmanifest

And then copy the remaining image files to the directory assets/img/favicons/

Run locally

First clone your repository:

git clone reponame.github.io

Follow Jekyll documentation to install ruby and complements

Go to the project folder, open terminal inside it and do this command:

bundle

The commands above is only for the first time you’re running the project locally

Now to run a local server:

bundle exec jekyll s

After a while, the local service will be published at http://127.0.0.1:4000.

New post structure

Folder: _posts

File name: YYYY-MM-DD-TITLE.md

Header:

---
author:
  name: name
title: title
date: YYYY-MM-DD HH:MM:SS TTTT
categories: [cat1, cat2]        # 1 or 2
tags: [tag]                     # Always in lowercase
---

Tip: Brazillian TTTT is UTC-3.

Tip2: Create posts inside assets/img folder

Official documentation

Getting Started

Customize the Favicon

Writing a New Post