diff --git a/README.adoc b/README.adoc new file mode 100644 index 0000000..c842e47 --- /dev/null +++ b/README.adoc @@ -0,0 +1,38 @@ += _Hermes_ +:source-highlighter: highlightjs + +== About + +_Hermes_ configures _Ubuntu_ by installing various packages and placing (new) configuration files. The configuration enhances the out-of-the-box experience of Ubuntu. It will automatically detect the installed version (starting from _Ubuntu_ 23.10 "_Mantic Minotaur_"). You can also optionally install and configure the GUI. + +IMPORTANT: Only `x86_64` (full support) and `aarch64` (only non-GUI) are supported. + +== Usage + +The installation script can be downloaded and executed in the terminal. + +```console +$ curl -sSfL https://raw.githubusercontent.com/georglauterbach/hermes/main/setup.sh | bash +``` + +If you want to configure your graphical user interface too, you can use the `--gui` flag. With this flag, additional programs are installed that are only necessary when you have a GUI. + +You may also use the `--local-installation` flag when you cloned this repository. This flag will causes the setup to be completely local, without requiring an internet connection. Only this repository has to be cloned in its entirety. + +== Supplementary Projects + +You might want to take a look at the following outstanding projects. Their installation does not yet come with _Hermes_. + +=== General + +1. https://github.com/akinomyoga/ble.sh[`akinomyoga/ble.sh`]: command line editor that replaces the default GNU Readline +2. https://gitlab.com/volian/nala[`volian/nala`]: frontend for `libapt-pkg` + +=== Written in Rust + +TIP: Check out https://github.com/cargo-bins/cargo-binstall[`cargo-bins/cargo-binstall`] first. This way, you may be able to save yourself time by not requiring local compilation; use `cargo binstall` instead of `cargo install`. + +1. https://github.com/mozilla/sccache[`mozilla/sccache`]: compiler wrapper that avoids compilation when possible +2. https://github.com/Canop/bacon[`Canop/bacon`]: background Rust code checker +3. https://github.com/zellij-org/zellij[`zellij-org/zellij`]: terminal workspace (multiplexer) +4. https://github.com/casey/just[`casey/just`]: command runner diff --git a/README.md b/README.md deleted file mode 100644 index 7866583..0000000 --- a/README.md +++ /dev/null @@ -1,43 +0,0 @@ -# _Hermes_ - -## :mailbox: About - -_Hermes_ configures _Ubuntu_ by installing various packages and placing (new) configuration files. The configuration enhances the out-of-the-box experience of Ubuntu. It will automatically detect the installed version (starting from _Ubuntu_ 23.10 "_Mantic Minotaur_"). You can also optionally install and configure the GUI. - -> [!NOTE] -> -> We do not support platforms apart from `x86_64` (full support) and `aarch64` (only non-GUI), because differentiating between platforms involves a complexity explosion. - -## :rocket: Usage - -The installation script can be downloaded and executed in the terminal. - -```console -$ wget https://raw.githubusercontent.com/georglauterbach/hermes/main/setup.sh -$ bash setup.sh -... -``` - -If you want to configure your graphical user interface too, you can use the `--gui` flag. With this flag, additional programs are installed that are only necessary when you have a GUI. - -You may also use the `--local-installation` flag when you cloned this repository. This flag will causes the setup to be completely local, without requiring an internet connection. Only this repository has to be cloned in its entirety. - -## :mega: Supplementary Projects - -You might want to take a look at the following outstanding projects. Their installation does not yet come with _Hermes_. - -### General - -1. [`akinomyoga/ble.sh`](https://github.com/akinomyoga/ble.sh): command line editor that replaces the default GNU Readline -2. [`volian/nala`](https://gitlab.com/volian/nala): frontend for `libapt-pkg` - -### Written in Rust - -> [!TIP] -> -> Check out [`cargo-bins/cargo-binstall`](https://github.com/cargo-bins/cargo-binstall) first. This way, you may be able to save yourself time by not requiring local compilation; use `cargo binstall` instead of `cargo install`. - -1. [`mozilla/sccache`](https://github.com/mozilla/sccache): compiler wrapper that avoids compilation when possible -2. [`Canop/bacon`](https://github.com/Canop/bacon): background Rust code checker -3. [`zellij-org/zellij`](https://github.com/zellij-org/zellij): terminal workspace (multiplexer) -4. [`casey/just`](https://github.com/casey/just): command runner