panthera-jekyll
panthera-jekyll is a Jekyll theme for GitHub Pages and Jekyll sites. You can preview the theme to see what it looks like, or even use it today.
Installation
Building a Jekyll Site
Add this line to your Jekyll site's Gemfile:
gem "panthera-jekyll"And add this line to your Jekyll site's _config.yml:
theme: panthera-jekyllAnd then execute:
$ bundle
Or install it yourself as:
$ gem install panthera-jekyll
Building a Github Page
Add this line to your Github Page's _config.yml:
remote_theme: christianezeani/panthera-jekyllCustomizing
Configuration variables
panthera-jekyll will respect the following variables, if set in your site's _config.yml:
title: [The title of your site or Profile Name]
subtitle: [A brief subtitle or job title]
description: [A short description of your site's purpose]To configure the left side set the following variables as shown below:
left_side:
background_image: [Absolute or relative image url]
background_color: [CSS background color, e.g. "#F00". We strongly recommend quoting this value. Don't worry about the transparency of the background, we've taken care of that.]
close_button_color: [CSS background color, e.g. "#F00". We strongly recommend quoting this value.]
text_color: [CSS background color, e.g. "#F00". We strongly recommend quoting this value.]Example
left_side:
background_image: "./assets/images/left-background.jpg"
background_color: "#F00"
close_button_color: "#F00"
text_color: "#F00"To configure side menu, set the following variables:
menu:
- text: [Menu text]
link: [Relative page link with the '/' prefix]
icon: [Menu Icon]Example
menu:
- text: Portfolio
link: /
icon: ""
- text: Skills & Offers
link: /skills-and-offers
icon: ""To configure social links, set the following variables:
social_icons:
- name: [Socialmedia title]
link: [Social link]
icon: [Icon class]Example
social_icons:
- name: linkedin
link: https://www.linkedin.com/christianezeani
icon: fab fa-linkedin
- name: github
link: https://github.com/christianezeani
icon: fab fa-github-squareTo configure footer, set the following variables:
footer:
copyright_text: [The copyright text. Value should be quoted]Example
footer:
copyright_text: "© Christian Ezeani"panthera-jekyll currently supports the following icons:
- FontAwesome (version 5.9.0)
Stylesheet
If you'd like to add your own custom styles:
-
Create a file called
/assets/css/style.scssin your site -
Add the following content to the top of the file, exactly as shown:
--- --- @import "panthera-jekyll";
-
Add any custom CSS (or Sass, including imports) you'd like immediately after the
@importline
Note: If you'd like to change the theme's Sass variables, you must set new values before the @import line in your stylesheet.
Blog Posts
Creating Posts
To create a post, add a file to your _posts directory with the following format:
YEAR-MONTH-DAY-title.MARKUP
Where YEAR is a four-digit number, MONTH and DAY are both two-digit numbers, and MARKUP is the file extension representing the format used in the file. For example, the following are examples of valid post filenames:
2020-07-10-new-years-eve-is-awesome.md
---
layout: post
title: First Demo Post
date: 2020-07-10 13:32:20 +0300
description: Post description (optional)
image: /image.jpg (optional)
tags: [Holidays, Hawaii]
---
Post content hereDisplaying an index of posts
- Create a page, e.g.
posts.md, with the following content:
---
layout: post
---
# PAGE TITLE HERE
{% include posts/index.html %}- Add a link to the left pane in your
_config.yml
menu:
...
- text: Blog Posts
link: /posts
icon: ""...and you're good
More post features are coming soon. To get updates on new features, hit the Watch button at the top of this page to get notifications.
If you love this project, kindly hit the Star button at the top of this page.
Follow me on Github to see more of my projects.
Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/chrisitanezeani/panthera-jekyll. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.
License
The theme is available as open source under the terms of the MIT License.
