mirror of https://github.com/Hilbis/Hilbish
Compare commits
No commits in common. "39a40fb08ec5a9b9d925776632692128e39cc85f" and "c293d442a915a05713e7ba8e7f72653c72ca3489" have entirely different histories.
39a40fb08e
...
c293d442a9
|
|
@ -4,15 +4,4 @@ layout: doc
|
||||||
weight: -1
|
weight: -1
|
||||||
---
|
---
|
||||||
|
|
||||||
Here lies the documentation for Hilbish, the hyper extensible Lua shell.
|
Hello!
|
||||||
Hilbish provides you with a few quality of life features and useful
|
|
||||||
functions to ensure you can make the shell fully yours.
|
|
||||||
|
|
||||||
These features include:
|
|
||||||
- Completion and history search menus
|
|
||||||
- Hinting and syntax highlighting (scripted by user)
|
|
||||||
|
|
||||||
# Installation
|
|
||||||
Steps on installing Hilbish will be at the Install page in the navigation bar
|
|
||||||
at the top. This also included getting development builds from the GitHub
|
|
||||||
repository.
|
|
||||||
|
|
|
||||||
|
|
@ -3,56 +3,3 @@ title: Getting Started
|
||||||
layout: doc
|
layout: doc
|
||||||
weight: -10
|
weight: -10
|
||||||
---
|
---
|
||||||
|
|
||||||
To start Hilbish, open a terminal. If Hilbish has been installed and is not the
|
|
||||||
default shell, you can simply run `hilbish` to start it. This will launch
|
|
||||||
a normal interactive session.
|
|
||||||
To exit, you can either run the `exit` command or hit Ctrl+D.
|
|
||||||
|
|
||||||
# Setting as Default
|
|
||||||
## Login shell
|
|
||||||
There are a few ways to make Hilbish your default shell. A simple way is
|
|
||||||
to make it your user/login shell.
|
|
||||||
|
|
||||||
{{< warning `It is not recommended to set Hilbish as your login shell. That is expected to be a
|
|
||||||
POSIX compliant shell, which Hilbish is not. At most, there will just be a
|
|
||||||
few variables missing in your environment` >}}
|
|
||||||
|
|
||||||
To do that, simply run `chsh -s /usr/bin/hilbish`.
|
|
||||||
Some distros (namely Fedora) might have `lchsh` instead, which is used like `lchsh <user>`.
|
|
||||||
When prompted, you can put the path for Hilbish.
|
|
||||||
|
|
||||||
## Default with terminal
|
|
||||||
The simpler way is to set the default shell for your terminal. The way of
|
|
||||||
doing this depends on how your terminal settings are configured.
|
|
||||||
|
|
||||||
## Run after login shell
|
|
||||||
Some shells (like zsh) have an rc file, like `.zlogin`, which is ran when the shell session
|
|
||||||
is a login shell. In that file, you can run Hilbish. Example:
|
|
||||||
|
|
||||||
```
|
|
||||||
exec hilbish -S -l
|
|
||||||
```
|
|
||||||
|
|
||||||
This will replace the shell with Hilbish, set $SHELL to Hilbish and launch it as a login shell.
|
|
||||||
|
|
||||||
# Configuration
|
|
||||||
Once installation and setup has been done, you can then configure Hilbish.
|
|
||||||
It is configured and scripted via Lua, so the config file is a Lua file.
|
|
||||||
You can use any pure Lua library to do whatever you want.
|
|
||||||
|
|
||||||
Hilbish's sample configuration is usually located in `hilbish.dataDir .. '/.hilbishrc.lua'`.
|
|
||||||
You can print that path via Lua to see what it is: `print(hilbish.dataDir .. '/.hilbishrc.lua')`.
|
|
||||||
As an example, it will usually will result in `/usr/share/hilbish/.hilbishrc.lua` on Linux.
|
|
||||||
|
|
||||||
To edit your user configuration, you can copy that file to `hilbish.userDir.config .. '/hilbish/init.lua'`,
|
|
||||||
which follows XDG on Linux and MacOS, and is located in %APPDATA% on Windows.
|
|
||||||
|
|
||||||
As the directory is usually `~/.config` on Linux, you can run this command to copy it:
|
|
||||||
`cp /usr/share/hilbish/.hilbishrc.lua ~/.config/hilbish/init.lua`
|
|
||||||
|
|
||||||
Now you can get to editing it. Since it's just a Lua file, having basic
|
|
||||||
knowledge of Lua would help. All of Lua's standard libraries and functions
|
|
||||||
from Lua 5.4 are available. Hilbish has some custom and modules that are
|
|
||||||
available. To see them, you can run the `doc` command. This also works as
|
|
||||||
general documentation for other things.
|
|
||||||
|
|
|
||||||
|
|
@ -1,7 +0,0 @@
|
||||||
{{ define "main"}}
|
|
||||||
<main id="main">
|
|
||||||
<div>
|
|
||||||
<h1><a href="{{ "/" | relURL }}">Go Home</a></h1>
|
|
||||||
</div>
|
|
||||||
</main>
|
|
||||||
{{ end }}
|
|
||||||
|
|
@ -2,18 +2,6 @@
|
||||||
<html>
|
<html>
|
||||||
{{- partial "head.html" . -}}
|
{{- partial "head.html" . -}}
|
||||||
<body class="d-flex flex-column min-vh-100" style="overflow-x: hidden;">
|
<body class="d-flex flex-column min-vh-100" style="overflow-x: hidden;">
|
||||||
<svg xmlns="http://www.w3.org/2000/svg" style="display: none;">
|
|
||||||
<symbol id="check-circle-fill" fill="currentColor" viewBox="0 0 16 16">
|
|
||||||
<path d="M16 8A8 8 0 1 1 0 8a8 8 0 0 1 16 0zm-3.97-3.03a.75.75 0 0 0-1.08.022L7.477 9.417 5.384 7.323a.75.75 0 0 0-1.06 1.06L6.97 11.03a.75.75 0 0 0 1.079-.02l3.992-4.99a.75.75 0 0 0-.01-1.05z"/>
|
|
||||||
</symbol>
|
|
||||||
<symbol id="info-fill" fill="currentColor" viewBox="0 0 16 16">
|
|
||||||
<path d="M8 16A8 8 0 1 0 8 0a8 8 0 0 0 0 16zm.93-9.412-1 4.705c-.07.34.029.533.304.533.194 0 .487-.07.686-.246l-.088.416c-.287.346-.92.598-1.465.598-.703 0-1.002-.422-.808-1.319l.738-3.468c.064-.293.006-.399-.287-.47l-.451-.081.082-.381 2.29-.287zM8 5.5a1 1 0 1 1 0-2 1 1 0 0 1 0 2z"/>
|
|
||||||
</symbol>
|
|
||||||
<symbol id="exclamation-triangle-fill" fill="currentColor" viewBox="0 0 16 16">
|
|
||||||
<path d="M8.982 1.566a1.13 1.13 0 0 0-1.96 0L.165 13.233c-.457.778.091 1.767.98 1.767h13.713c.889 0 1.438-.99.98-1.767L8.982 1.566zM8 5c.535 0 .954.462.9.995l-.35 3.507a.552.552 0 0 1-1.1 0L7.1 5.995A.905.905 0 0 1 8 5zm.002 6a1 1 0 1 1 0 2 1 1 0 0 1 0-2z"/>
|
|
||||||
</symbol>
|
|
||||||
</svg>
|
|
||||||
|
|
||||||
{{- partial "header.html" . -}}
|
{{- partial "header.html" . -}}
|
||||||
{{- block "main" . }}{{- end }}
|
{{- block "main" . }}{{- end }}
|
||||||
{{- partial "footer.html" . -}}
|
{{- partial "footer.html" . -}}
|
||||||
|
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
<div class="alert alert-warning d-flex align-items-center" role="alert">
|
|
||||||
<svg class="bi flex-shrink-0 me-2" width="24" height="24" role="img" aria-label="Warning:"><use xlink:href="#exclamation-triangle-fill"/></svg>
|
|
||||||
<div>
|
|
||||||
{{ .Get 0 }}
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
Loading…
Reference in New Issue