From 2ad0ea7faab2bba8a16bc653eef5359504c94afd Mon Sep 17 00:00:00 2001 From: Jen-Chieh Shen Date: Sat, 7 Dec 2024 16:32:18 +0800 Subject: [PATCH] docs: README --- README.md | 87 ++++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 86 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 2514ce2..35e4659 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,87 @@ +[![License: GPL v3](https://img.shields.io/badge/License-GPL%20v3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0) +[![JCS-ELPA](https://raw.githubusercontent.com/jcs-emacs/badges/master/elpa/v/sideline-eros.svg)](https://jcs-emacs.github.io/jcs-elpa/#/sideline-eros) + # sideline-eros -Show EROS result in sideline +> Show EROS result in sideline + +[![CI](https://github.com/emacs-sideline/sideline-eros/actions/workflows/test.yml/badge.svg)](https://github.com/emacs-sideline/sideline-eros/actions/workflows/test.yml) + +## 🔨 Quickstart + +```elisp +(use-package sideline-eros + :hook (sideline-mode . sideline-eros-setup) + :init + (setq sideline-backends-right '(sideline-eros))) +``` + +## 🛠️ Contribute + +[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com) +[![Elisp styleguide](https://img.shields.io/badge/elisp-style%20guide-purple)](https://github.com/bbatsov/emacs-lisp-style-guide) +[![Donate on paypal](https://img.shields.io/badge/paypal-donate-1?logo=paypal&color=blue)](https://www.paypal.me/jcs090218) +[![Become a patron](https://img.shields.io/badge/patreon-become%20a%20patron-orange.svg?logo=patreon)](https://www.patreon.com/jcs090218) + +If you would like to contribute to this project, you may either +clone and make pull requests to this repository. Or you can +clone the project and establish your own branch of this tool. +Any methods are welcome! + +### 🔬 Development + +To run the test locally, you will need the following tools: + +- [Eask](https://emacs-eask.github.io/) +- [Make](https://www.gnu.org/software/make/) (optional) + +Install all dependencies and development dependencies: + +```sh +$ eask install-deps --dev +``` + +To test the package's installation: + +```sh +$ eask package +$ eask install +``` + +To test compilation: + +```sh +$ eask compile +``` + +**🪧 The following steps are optional, but we recommend you follow these lint results!** + +The built-in `checkdoc` linter: + +```sh +$ eask lint checkdoc +``` + +The standard `package` linter: + +```sh +$ eask lint package +``` + +*📝 P.S. For more information, find the Eask manual at https://emacs-eask.github.io/.* + +## ⚜️ License + +This program is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation, either version 3 of the License, or +(at your option) any later version. + +This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with this program. If not, see . + +See [`LICENSE`](./LICENSE) for details.