mirror of https://github.com/Hilbis/Hilbish
docs: slight refactor of the readme
parent
c29b6c6fd4
commit
d58617b173
88
README.md
88
README.md
|
@ -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
|
||||||
|
```
|
||||||
|
|
||||||
|
Or, if you want a stable branch, run these commands:
|
||||||
```
|
```
|
||||||
|
git checkout $(git describe --tags `git rev-list --tags --max-count=1`)
|
||||||
|
make build
|
||||||
|
```
|
||||||
|
|
||||||
If you `git checkout`'d the latest stable release, run
|
After you did all that, run `sudo make install` to install Hilbish globally.
|
||||||
`make build` instead of `make dev`.
|
|
||||||
or want to experiment Hilbiline, instead run
|
|
||||||
`make hilbiline`
|
|
||||||
|
|
||||||
#### Install
|
|
||||||
`sudo make install`
|
|
||||||
|
|
||||||
### Uninstall
|
|
||||||
```sh
|
|
||||||
sudo make uninstall
|
|
||||||
```
|
|
||||||
|
|
||||||
# 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 |
Loading…
Reference in New Issue