Cards Jekyll Template
This is a simple and minimalist template for Jekyll designed for developers that want to write blog posts but don’t want to care about frontend stuff.
The Theme features:
- Gulp
- Stylus (Jeet, Rupture, Kouto Swiss)
- Live Search
- Offcanvas Menu
- SVG icons
- Very very small and fast!
- Shell Script to create posts
- Tags page
- Series page
- About Me page
- Feed RSS
- Sitemap.xml
- Color Customization
- Info Customization
If you want to see this template in real action, take a look at my original site.
Basic Setup
- Install Jekyll (use the command
sudo gem install jekyll
) - Fork the Cards Jekyll Template
- Clone the repo you just forked.
- Edit
_config.yml
to personalize your site. - Check out the sample posts in
_posts
to see examples for assigning categories and tags, and other YAML data. - Read the documentation below for further customization pointers and documentation.
- Remember to compile your assets files with Gulp.
Site and User Settings
You have to fill some informations on _config.yml
to customize your site.
# Site settings
title: Willian Justen - Desenvolvedor Front End
description: A blog about lorem ipsum dolor sit amet
baseurl: "" # the subpath of your site, e.g. /blog/ or empty.
url: "http://localhost:3000" # the base hostname & protocol for your site
# User settings
username: Lorem Ipsum
user_description: Anon Developer at Lorem Ipsum Dolor
email: [email protected]
twitter_username: lorem_ipsum
github_username: lorem_ipsum
gplus_username: lorem_ipsum
disqus_username: lorem_ipsum
Header Name
To use the power of CSS Content and media query, the header name is defined on src/styl/_header.styl. Change to your prefered name.
Color customization
All color variables are in src/styl/_variables.styl. To change the main color, just set the new value at main
assignment. Another colors are for texts and the code background color.
Theme Colors
Every post has a main color that is defined on src/styl/_theme-colors.styl. Just create a new color with the prefix post-
and define your main-class: ‘css’ and color: ‘#2DA0C3’ on every post you create.
Creating posts
You can use the initpost.sh
to create your new posts. Just follow the command:
./initpost.sh -c Post Title
The new file will be created at _posts
with this format date-title.md
.
Front-matter
When you create a new post, you need to fill the post information in the front-matter, follow this example:
---
layout: post
title: "Falando sobre RSCSS"
date: 2016-02-07 18:48:16
image: '/assets/img/rscss/rscss.png'
description: 'Escrevendo CSS sem perder a sanidade. Aprenda uma metodologia que pode salvar muitas dores de cabeça.'
main-class: 'css'
color: '#2DA0C3'
tags:
- css
- metodologia
- frontend
categories:
twitter_text: 'Escrevendo CSS sem perder a sanidade.'
introduction: 'Escrevendo CSS sem perder a sanidade. Com essa introdução, Rico St. Cruz o criador chama a atenção de todos sobre uma metodologia melhor para se escrever CSS.'
---
Running the blog in local
In order to compile the assets and run Jekyll on local you need to follow those steps:
- Install NodeJS (remember to use the latest version)
- Run
npm install
- Run
npm install -g gulp gulp-cli
- Run
gulp
Looking for Support or Custom Solutions?
We specialize in creating stunning, fully-customized Jekyll websites tailored to your needs.
If you need assistance with setup, customization, or support, don't hesitate to contact us.
CONTACT US