docs: slight refactor of the readme

pull/78/head
sammyette 2021-10-12 16:01:17 -04:00
parent c29b6c6fd4
commit d58617b173
No known key found for this signature in database
GPG Key ID: 50EE40A2809851F5
5 changed files with 40 additions and 48 deletions

View File

@ -1,17 +1,23 @@
<div align="center"> <div align="center">
<h1>Hilbish</h1> <img src="./assets/hilbish-flower.png" width=128><br>
<img src="./assets/hilbish-text.png" width=256>
<h1></h1>
<blockquote> <blockquote>
🎀 a nice lil shell for lua people made with go and lua 🌺 The flower shell. A comfy and nice little shell for Lua users and fans!
</blockquote><p align="center"> </blockquote>
<a href="https://github.com/Hilbis/Hilbish/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22"><img src="https://img.shields.io/github/issues/Hilbis/Hilbish/help%20wanted?color=green" alt="help wanted"></a> <p align="center">
<a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg"></a> <img alt="GitHub commit activity" src="https://img.shields.io/github/commit-activity/m/Rosettea/Hilbish?style=flat-square">
<img alt="GitHub commits since latest release (by date)" src="https://img.shields.io/github/commits-since/Rosettea/Hilbish/latest?style=flat-square">
<img alt="GitHub contributors" src="https://img.shields.io/github/contributors/Rosettea/Hilbish?style=flat-square"><br>
<a href="https://github.com/Rosettea/Hilbish/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22"><img src="https://img.shields.io/github/issues/Hilbis/Hilbish/help%20wanted?style=flat-square&color=green" alt="help wanted"></a>
<a href="https://github.com/Rosettea/Hilbish/blob/master/LICENSE"><img alt="GitHub license" src="https://img.shields.io/github/license/Rosettea/Hilbish?style=flat-square"></a>
<a href="https://discord.gg/3PDdcQz"><img alt="Discord" src="https://img.shields.io/discord/732357621503229962?color=blue&style=flat-square"></a>
</p> </p>
</div> </div>
Hilbish is an interactive Unix-like shell written in Go, with the config Hilbish is a new, Unix-like shell which uses Lua as its configuration language.
and other code written in Lua. It's decently fast for interactive use and includes a bunch of utility functions and features
It is sort of in a stable state currently, usable as a daily shell, to make your life in a terminal easier.
but there may still be breaking changes in Lua modules.
# Screenshots # Screenshots
<div align="center"> <div align="center">
@ -42,21 +48,22 @@ like what is highlighted in the screenshot.
<br><img src="https://modeus.is-inside.me/KJ0Puceb.png"><br> <br><img src="https://modeus.is-inside.me/KJ0Puceb.png"><br>
### AUR ### AUR
Arch Linux users can install Hilbish from the AUR. ![AUR maintainer](https://img.shields.io/aur/maintainer/hilbish?logo=arch-linux&style=flat-square)
Arch Linux users can install Hilbish from the AUR with the following command:
```sh ```sh
yay -S hilbish yay -S hilbish
``` ```
If you want the latest and greatest, you can install and compile from the latest git commit Or from the latest `master` commit with:
```sh ```sh
yay -S hilbish-git yay -S hilbish-git
``` ```
### Manual Build ### Manual Build
#### Prerequisites #### Prerequisites
- [Go 1.16](https://go.dev) - [Go 1.16+](https://go.dev)
- GNU Readline - GNU Readline
On Fedora, readline can be installed with: On Fedora or other RPM based distros, readline can be installed with:
``` ```
sudo dnf install readline-devel sudo dnf install readline-devel
``` ```
@ -66,11 +73,6 @@ On Debian/Ubuntu and distros based on them, it can be installed with:
sudo apt install libreadline-dev sudo apt install libreadline-dev
``` ```
On OpenSUSE, it can be installed with:
```
sudo zypper install readline-devel
```
On Arch Linux, it can be installed with: On Arch Linux, it can be installed with:
``` ```
sudo pacman -S readline sudo pacman -S readline
@ -79,48 +81,38 @@ sudo pacman -S readline
#### Build #### Build
First, clone Hilbish: First, clone Hilbish:
```sh ```sh
git clone --recursive https://github.com/Hilbis/Hilbish git clone --recursive https://github.com/Rosettea/Hilbish
cd Hilbish cd Hilbish
# If you want the latest stable release, run this following command go get -d ./...
git checkout $(git describe --tags `git rev-list --tags --max-count=1`)
``` ```
And get dependencies and build: To build, run:
```sh ```
go get -d all
make dev make dev
``` ```
If you `git checkout`'d the latest stable release, run Or, if you want a stable branch, run these commands:
`make build` instead of `make dev`.
or want to experiment Hilbiline, instead run
`make hilbiline`
#### Install
`sudo make install`
### Uninstall
```sh
sudo make uninstall
``` ```
git checkout $(git describe --tags `git rev-list --tags --max-count=1`)
make build
```
After you did all that, run `sudo make install` to install Hilbish globally.
# Contributing # Contributing
Any kind of contributions to Hilbish are welcome! Any kind of contributions to Hilbish are welcome!
Make sure to read [CONTRIBUTING.md](CONTRIBUTING.md) before getting started. Read [CONTRIBUTING.md](CONTRIBUTING.md) before getting started.
### Special Thanks To
Everyone here who has contributed:
##### Thanks to everyone below who's contributed!
<a href="https://github.com/Hilbis/Hilbish/graphs/contributors"> <a href="https://github.com/Hilbis/Hilbish/graphs/contributors">
<img src="https://contrib.rocks/image?repo=Hilbis/Hilbish" /> <img src="https://contrib.rocks/image?repo=Hilbis/Hilbish" />
</a> </a>
*Made with [contributors-img](https://contrib.rocks).* *Made with [contributors-img](https://contrib.rocks).*
### Credits
- [This blog post](https://www.vidarholen.net/contents/blog/?p=878) which
is how Hilbish now inserts a newline even if output doesn't have one.
# License # License
Hilbish is licensed under the MIT license. Hilbish is licensed under the MIT license!
[Read here](LICENSE) for more info. Read the [license here](LICENSE) for more info.
Images in the [assets](assets/) folder are under CC-BY-SA 4.0

Binary file not shown.

After

Width:  |  Height:  |  Size: 16 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 18 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 8.1 KiB

After

Width:  |  Height:  |  Size: 58 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 88 KiB

After

Width:  |  Height:  |  Size: 114 KiB