web/README.md

85 lines
3.5 KiB
Markdown
Raw Permalink Normal View History

<!-- markdownlint-disable-next-line -->
2021-07-19 17:24:04 +03:00
<div align="center">
<!-- markdownlint-disable-next-line -->
2021-09-29 15:44:17 +03:00
# Chirpy Jekyll Theme
2023-10-23 00:38:07 +03:00
A minimal, responsive, and feature-rich Jekyll theme for technical writing.
2021-11-26 18:29:51 +03:00
2024-06-04 14:28:02 +03:00
[![CI](https://img.shields.io/github/actions/workflow/status/cotes2020/jekyll-theme-chirpy/ci.yml?logo=github)][ci]&nbsp;
[![Codacy Badge](https://img.shields.io/codacy/grade/4e556876a3c54d5e8f2d2857c4f43894?logo=codacy)][codacy]&nbsp;
[![GitHub license](https://img.shields.io/github/license/cotes2020/jekyll-theme-chirpy?color=goldenrod)][license]&nbsp;
[![Gem Version](https://img.shields.io/gem/v/jekyll-theme-chirpy?&logo=RubyGems&logoColor=ghostwhite&label=gem&color=orange)][gem]&nbsp;
[![Open in Dev Containers](https://img.shields.io/badge/Dev_Containers-Open-deepskyblue?logo=linuxcontainers)][open-container]
2021-07-19 17:24:04 +03:00
[**Live Demo** →][demo]
2021-09-29 15:44:17 +03:00
[![Devices Mockup](https://chirpy-img.netlify.app/commons/devices-mockup.png)][demo]
2021-09-29 15:44:17 +03:00
</div>
2020-04-12 19:38:56 +03:00
## Features
2019-09-30 15:37:14 +03:00
2024-04-17 14:25:28 +03:00
- Dark Theme
2023-09-27 14:21:57 +03:00
- 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
2024-04-17 14:25:28 +03:00
- Dark Mode Images
- Embed Media
- Comment Systems
2023-09-27 14:21:57 +03:00
- Built-in Search
- Atom Feeds
- PWA
- Web Analytics
2023-09-27 14:21:57 +03:00
- SEO & Performance Optimization
2021-01-25 15:19:50 +03:00
## Documentation
2023-10-01 01:00:36 +03:00
To learn how to use, develop, and upgrade the project, please refer to the [Wiki][wiki].
## Contributing
2023-10-05 01:04:14 +03:00
Contributions (_pull requests_, _issues_, and _discussions_) are what make the open-source community such an amazing place
2023-09-27 14:21:57 +03:00
to learn, inspire, and create. Any contributions you make are greatly appreciated.
For details, see the "[Contributing Guidelines][contribute-guide]".
## Credits
2019-09-30 15:37:14 +03:00
### Contributors
2019-11-05 17:14:02 +03:00
Thanks to [all the contributors][contributors] involved in the development of the project!
2020-01-04 12:05:41 +03:00
[![all-contributors](https://contrib.rocks/image?repo=cotes2020/jekyll-theme-chirpy&columns=16)][contributors]
2024-04-17 14:25:28 +03:00
<sub> — Made with [contrib.rocks](https://contrib.rocks)</sub>
2021-01-25 15:19:50 +03:00
### Third-Party Assets
This project is built on the [Jekyll][jekyllrb] ecosystem and some [great libraries][lib], and is developed using [VS Code][vscode] as well as tools provided by [JetBrains][jetbrains] under a non-commercial open-source software license.
2020-01-04 12:05:41 +03:00
The avatar and favicon for the project's website are from [ClipartMAX][clipartmax].
2019-09-30 15:37:14 +03:00
## License
2023-10-01 01:00:36 +03:00
This project is published under [MIT License][license].
[gem]: https://rubygems.org/gems/jekyll-theme-chirpy
[ci]: https://github.com/cotes2020/jekyll-theme-chirpy/actions/workflows/ci.yml?query=event%3Apush+branch%3Amaster
[codacy]: https://app.codacy.com/gh/cotes2020/jekyll-theme-chirpy/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade
[license]: https://github.com/cotes2020/jekyll-theme-chirpy/blob/master/LICENSE
[open-container]: https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/cotes2020/jekyll-theme-chirpy
[jekyllrb]: https://jekyllrb.com/
[clipartmax]: https://www.clipartmax.com/middle/m2i8b1m2K9Z5m2K9_ant-clipart-childrens-ant-cute/
[demo]: https://cotes2020.github.io/chirpy-demo/
[wiki]: https://github.com/cotes2020/jekyll-theme-chirpy/wiki
[contribute-guide]: https://github.com/cotes2020/jekyll-theme-chirpy/blob/master/docs/CONTRIBUTING.md
[contributors]: https://github.com/cotes2020/jekyll-theme-chirpy/graphs/contributors
[lib]: https://github.com/cotes2020/chirpy-static-assets
[vscode]: https://code.visualstudio.com/
[jetbrains]: https://www.jetbrains.com/?from=jekyll-theme-chirpy