Skip to content

ellekasai/shiori

gh-pages
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Unfortunately, this project is no longer maintained.

I now have other priorities in my life and no longer have time to update this library. Email me at elle.kasai@gmail.com if you'd like to reach me.

πŸŽ€ Hi! I'm Shiori, a Bootstrap-based Jekyll Theme. πŸŽ€

πŸŽ€ Live Demo πŸŽ€

You can view the live demo of myself here.

πŸŽ€ Screenshots πŸŽ€

Desktop/Tablet

πŸŽ€ Color Schemes πŸŽ€

I wear different colors (based on Flat UI Colors).

  • Dark
  • Turquoise
  • Green
  • Blue
  • Purple
  • Orange
  • Red

πŸŽ€ Usage πŸŽ€

Note: If you're not familiar with Jekyll, please read up on Jekyll's documentation first.

Fork this repo, clone it, and then run:

bundle install

...which installs github-pages gem. After that, run the server:

jekyll serve --watch

⚠️ Warning ⚠️

Once the server is started, you must go to http://localhost:4000/shiori/, since baseurl is set as "/shiori" initially.

To use http://localhost:4000/, change baseurl in _config.yml to "" .

Keeping Shiori Up to Date

To keep Shiori up to date, follow these steps:

  1. Configure a remote for a fork
  2. Sync a fork (Note: Use gh-pages instead of master.)

πŸŽ€ Customization πŸŽ€

Required

You should change these files before deploying:

  • _config.yml: You must change baseurl, url, and title. Others are optional.
    • Make sure to restart the server after you update _config.yml.
  • CNAME: Change this to host Shiori on a custom domain.
  • README.md: Write your own README!
  • _includes/nav.html: Modify or remove navigation links.
  • _includes/nav-right.html: Modify or remove navigation links.
  • _includes/sidebar.html: Customize the side bar.
  • _includes/post-header.html: Customize the post header.
  • _includes/post-footer.html: Customize the post footer.
  • _includes/footer.html: Add copyright info, etc.

Optional

You may customize these files - they're optional:

  • favicon.ico: Favicon.
  • about.html: About page. Currently not linked from anywhere.
  • _includes/head.html: Extra stuff in the <head> tag.
  • _includes/scripts.html: Extra stuff before the </body> tag.
  • _includes/post-header-home.html: Customize the post header on the home page.

Customize the Theme

To change my color theme, edit _data/theme.yml.

Add Your Own CSS

You can customize CSS by editing these files:

  • _sass/custom-bootstrap-variables.scss: Change Bootstrap variables (documentation).
  • _sass/custom-scss.scss: Add your own custom CSS.

Category Pages

If you want to make category pages, you must manually push the generated _site directory to GitHub. If you're still okay with that, @alextsui05 made an excellent demo and tutorial for category pages. You can see his code on this pull request.

πŸŽ€ Author πŸŽ€

Elle Kasai

Special Thanks

License

MIT License

About

[Unmaintained] A Bootstrap-based Jekyll Theme.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published