jekyll-theme-panda

Theme Showcase : RiinoSite - Jeklyy-Theme-Panda

DEMO 1: RiinoSite Blog

DEMO 2: low illuminance

! Notes: Currently the mathjax.js might be unavailable in your blog, please use it locally or change CDN url in your own projects. We will fix this in next version.

[TOC]

Installation

Choice 1 : Set up via jekyll-remote-theme

Step 1 Install jekyll-remote-theme

Step 2 Fork this jekyll-theme-panda

Step 3 Set remote_theme : <your-github-username>/jekyll-theme-panda

Choice 2 : Set up via bundler (Not available in GithubPage)

Add this line to your Jekyll site's Gemfile:

gem "jekyll-theme-panda"

And add this line to your Jekyll site's _config.yml:

theme: jekyll-theme-panda

And then execute:

$ bundle install

Or install it yourself as:

$ gem install jekyll-theme-panda

Choice 3 : Directly use this repo

Clone this repo or download this repo in your computer, then edit files in _post and edit _config.yml.

Tips: Please keep using one level permalink:

permalink: /:year-:month-:day-:title:output_ext

Since navigation header uses relative path in default situation

YAML front matter example

post

---
layout: post
title:  "Theme Showcase"
subtitle: "Features and yaml configuration demo" #optional 
author: "RiinoSite"    #optional
date:   2020-03-01 17:08:09 +0800
tags:           #optional
- jekyll 
- doc
status: doc     #optional,if status is 'WIP', will display a WIP banner
last-modify: 2020-07-10 10:30:00 +0000 #optional
toc: true       #default: true
sticky : true   #default: false
hide: false     #default: false (hide from Home page only)
mathjax: true   #default: true
mermaid: true   #default: true
banner-title: THEME DOC #optional
banner-subtitle: Readme.md #optional, must be with banner-title
# toc options: inline, true, false
---

album

---
layout: album
title: Postcard Series 2019
hidden: true #must be true
description: ['text1','text2']
cover_number: 2 #determine which image will be the cover
photos:
 - url: /img/albums/postcard/poster-1.jpg
   description: photo description
 - url: /img/albums/postcard/poster-11.jpg
   description: photo description
---

preset

---
layout: preset
title: Shilin Filter
cover_before: /img/presets/shilin/shilin_before.jpg
cover_after: /img/presets/shilin/shilin_after.jpg
hidden: true #must be true
description: ['text']
download_url: google.com
derivation: ['text']
derivation_img : ./img/presets/shilin/shilin_after_1.jpg
samples:
 - title: 'Atmosphere adjustment'
   subtitle: '冷たい雰囲気を与える'
   img_url: '/img/presets/shilin/shilin_1.jpg'
   img_text: '@ Twatutia, Taipei, 2019'
---

Toolkits

Available layouts:

| name | description | filename | | ———- | ——————————————————– | ———————— | | default | default layout with contents in a home-message section | layoutsdefault.html | | home | index page layout | layoutshome.html | | forarchive | archive page layout | layoutsforarchive.html | | post | post page layout | layoutspost.html | | blank | default layout without home-message section | layoutsblank.html | | preset | preset introduction page layout | layoutspreset.html | | presetlist | presets page layout | layoutspresetlist.html | | album | album page layout | layoutsalbum.html | | albumlist | albums page layout | _layoutsalbumlist.html |

Available includes(html):

| name | description | filename | | —— | ——————————————— | ——————— | | footer | footer component, can be edited in config | includesfooter.html | | head | head tag | includeshome.html | | header | navigator component, can be edited in config | includesheader.html | | search | search bar plug-in | includessearch.html |

Available includes(md):

| name | description | path | | ————— | ————————————- | ———————- | | profile content | markdown content in Profile in header | includesabouten.md | | policy content | markdown content in Policy in footer | includespolicyen.md |

Syntax colors:

Check _sass\syntax.scss

Contributing

Bug reports and pull requests are welcome on GitHub at github.com/sorphwer/jekyll-theme-panda. 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.

Development

We suggest fork this repo and set it as your own remote_theme to modify this theme.

About Search Tool

jekyll-theme-panda is currently use jekyll-search-bar hosted in riino.site in default mode. To modify this search tool, please check the corresponding github page.

Notice: Search tool can only be used within post type posts. To disable search tool, create a blank search.json in your root.

License

The theme is available as open source under the terms of the MIT License.