A minimal, responsive, and powerful Jekyll theme for presenting professional writing.
- Dark/Light Theme Mode
- Localized UI language
- Pinned Posts
- Hierarchical Categories
- Trending Tags
- Table of Contents
- Last Modified Date of Posts
- Syntax Highlighting
- Mathematical Expressions
- Mermaid Diagram & Flowchart
- Dark/Light Mode Images
- Embed Videos
- Disqus/Utterances/Giscus Comments
- Search
- Atom Feeds
- Google Analytics
- Page Views Reporting
- SEO & Performance Optimization
Follow the instructions in the Jekyll Docs to complete the installation of the basic environment. Git also needs to be installed.
Sign in to GitHub and browse to Chirpy Starter, click the button Use this template > Create a new repository, and name the new repository USERNAME.github.io, where USERNAME represents your GitHub username.
Clone it to your local machine, go to its root directory, and run the following command to install the dependencies.
$ bundleRun the following command in the root directory of your site:
$ bundle exec jekyll sOr run with Docker:
$ docker run -it --rm \
--volume="$PWD:/srv/jekyll" \
-p 4000:4000 jekyll/jekyll \
jekyll serveAfter a few seconds, the local service will be published at http://127.0.0.1:4000.
For more details on usage, please refer to the tutorial on the demo website or wiki. Note that the tutorial is based on the latest release, 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, see contributing guidelines.
This theme is mainly built with Jekyll 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 from Clipart Max.
🎉 Thanks to all the volunteers who contributed to this project, their GitHub IDs are on this 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, thank JetBrains for providing the OSS development license.
If you like it, please consider sponsoring me. It will help me to maintain this project better and I would be very grateful!
This work is published under MIT License.