Repository files navigation

• Localized Layout
• Dark/Light Theme Mode
• Pinned Posts
• Hierarchical Categories
• Last Modified Date for Posts
• Table of Contents
• Auto-generated Related Posts
• Syntax Highlighting
• Mathematical Expressions
• Mermaid Diagram & Flowchart
• Disqus/Utterances/Giscus Comments
• Search
• Atom Feeds
• Google Analytics
• GA Pageviews Reporting
• SEO & Performance Optimization

Before starting, please follow the instructions in theJekyll Docs to complete the installation ofRuby,RubyGems,Jekyll, andBundler. In addition,Git is also required to be installed.

Create a new repository from theChirpy Starter and name it<GH_USERNAME>.github.io, whereGH_USERNAME represents your GitHub username.

Before running for the first time, go to the root directory of your site, and install dependencies as follows:

$bundle

Run the following command in the root directory of the site:

$bundleexec jekyll s

Or run with Docker:

$docker run -it --rm \    --volume="$PWD:/srv/jekyll" \    -p 4000:4000 jekyll/jekyll \    jekyll serve

After a while, navigate to the site athttp://localhost:4000.

For more details on usage, please refer to the tutorial on thedemo website /wiki. Note that the tutorial is based on thelatest tag, and the features of the default branch are usually ahead of the documentation.

Welcome to report bugs, improve code quality or submit a new feature. For more information, seecontributing guidelines.

This theme is mainly built withJekyll ecosystem,Bootstrap,Font Awesome and some other wonderful tools (their copyright information can be found in the relevant files). The avatar and favicon design come fromClipart Max.

🎉 Thanks to all the volunteers who contributed to this project, their GitHub IDs are onthis list. Also, I won't forget those guys who submitted the issues or unmerged PR because they reported bugs, shared ideas, or inspired me to write more readable documentation.

Last but not least, thankJetBrains for providing the OSS development license.

If you like this theme or find it helpful, please consider sponsoring me, because it will encourage and help me better maintain the project, I will be very grateful!

This work is published underMIT License.