A minimal, responsive, and feature-rich Jekyll theme for technical writing.
- Dark Theme
- Localized UI language
- Pinned Posts on Home Page
- Hierarchical Categories
- Trending Tags
- Table of Contents
- Last Modified Date
- Syntax Highlighting
- Mathematical Expressions
- Mermaid Diagrams & Flowcharts
- Dark Mode Images
- Embed Media
- Comment Systems
- Built-in Search
- Atom Feeds
- PWA
- Web Analytics
- SEO & Performance Optimization
To learn how to use, develop, and upgrade the project, please refer to the Wiki.
Contributions (pull requests, issues, and discussions) are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated. For details, see the "Contributing Guidelines".
Thanks to all the contributors involved in the development of the project!
— Made with contrib.rocks
This project is built on the Jekyll ecosystem and some great libraries, and is developed using VS Code as well as tools provided by JetBrains under a non-commercial open-source software license.
The avatar and favicon for the project's website are from ClipartMAX.
This project is published under MIT License.
<<<<<<< HEAD
Add the following fields to the post's YAML front matter:
light_image:
path: /path/to/light-image.webp
lqip: data:image/webp;base64,...
alt: Alt text for light mode image
dark_image:
path: /path/to/dark-image.webp
lqip: data:image/webp;base64,...
alt: Alt text for dark mode image
Inside the _layouts
, within the {% if post.image %}
block, insert the following code after {% assign card_body_col = '7' %}
and before {% endif %}
.
{% elsif post.light_image and post.dark_image %}
<div class="col-md-5">
<img
src="{{ post.light_image.path }}"
alt="{{ post.light_image.alt}}"
{{ post.light_image.lqip }}
class="popup img-link light shimmer"
style="height: 100%; border-top-right-radius: 8px; border-bottom-right-radius: 8px;"
>
<img
src="{{ post.dark_image.path }}"
alt="{{ post.dark_image.alt}}"
{{ post.dark_image.lqip }}
class="popup img-link dark"
style="height: 100%;border-top-right-radius: 8px; border-bottom-right-radius: 8px;"
>
</div>
{% assign card_body_col = '7' %}
When installing the Chirpy theme through RubyGems.org, Jekyll can only read files in the folders
_data
, _layouts
, _includes
, _sass
and assets
, as well as a small part of options of the _config.yml
file
from the theme's gem. If you have ever installed this theme gem, you can use the command
bundle info --path jekyll-theme-chirpy
to locate these files.
The Jekyll team claims that this is to leave the ball in the user’s court, but this also results in users not being able to enjoy the out-of-the-box experience when using feature-rich themes.
To fully use all the features of Chirpy, you need to copy the other critical files from the theme's gem to your Jekyll site. The following is a list of targets:
.
├── _config.yml
├── _plugins
├── _tabs
└── index.html
To save you time, and also in case you lose some files while copying, we extract those files/configurations of the latest version of the Chirpy theme and the CD workflow to here, so that you can start writing in minutes.
Check out the theme's docs.
This repository is automatically updated with new releases from the theme repository. If you encounter any issues or want to contribute to its improvement, please visit the theme repository to provide feedback.
This work is published under MIT License.
v7.2.4
- make post on add ficher img dark lith mode
- make post on mormate
- make the abute lode bater
- and more