diff options
author | Christian Cleberg <hello@cleberg.net> | 2023-12-02 23:27:35 -0600 |
---|---|---|
committer | Christian Cleberg <hello@cleberg.net> | 2023-12-02 23:27:35 -0600 |
commit | 3d4da5ac6000a4871c5caa80d1e61f2782da3069 (patch) | |
tree | 29f36b50823d22f4c7df0a3db3ede83192ae649f /blog/2022-12-17-st.org | |
parent | dcf0186e16b6ac8f0e00a3aeb9734421ce548177 (diff) | |
download | cleberg.net-3d4da5ac6000a4871c5caa80d1e61f2782da3069.tar.gz cleberg.net-3d4da5ac6000a4871c5caa80d1e61f2782da3069.tar.bz2 cleberg.net-3d4da5ac6000a4871c5caa80d1e61f2782da3069.zip |
feat: finish converting md to org
Diffstat (limited to 'blog/2022-12-17-st.org')
-rw-r--r-- | blog/2022-12-17-st.org | 131 |
1 files changed, 71 insertions, 60 deletions
diff --git a/blog/2022-12-17-st.org b/blog/2022-12-17-st.org index 30d46ba..d47993b 100644 --- a/blog/2022-12-17-st.org +++ b/blog/2022-12-17-st.org @@ -1,89 +1,100 @@ -+++ -date = 2022-12-17 -title = "Simple Terminal" -description = "An easy guide on how to build st on Fedora Workstation." -+++ - -## st - -[st](https://st.suckless.org) standards for Simple Terminal, a simple terminal -implementation for X made by the [suckless](https://suckless.org) team. - -This post walks through the dependencies needed and process to build and install -`st` on Fedora Workstation. - -### Obtain Files - -To start, obtain the source files for `st` via `git clone`. - -```sh +#+title: Simple Terminal +#+date: 2022-12-17 + +** st +:PROPERTIES: +:CUSTOM_ID: st +:END: +[[https://st.suckless.org][st]] standards for Simple Terminal, a simple +terminal implementation for X made by the +[[https://suckless.org][suckless]] team. + +This post walks through the dependencies needed and process to build and +install =st= on Fedora Workstation. + +*** Obtain Files +:PROPERTIES: +:CUSTOM_ID: obtain-files +:END: +To start, obtain the source files for =st= via =git clone=. + +#+begin_src sh mkdir ~/suckless && cd ~/suckless git clone https://git.suckless.org/st && cd st -``` - -### Dependencies +#+end_src -Once you have the files and are in the `st` directory, ensure the following -packages are installed. +*** Dependencies +:PROPERTIES: +:CUSTOM_ID: dependencies +:END: +Once you have the files and are in the =st= directory, ensure the +following packages are installed. -```sh +#+begin_src sh sudo dnf update && sudo dnf upgrade sudo dnf install gcc patch libX11-devel libXft-devel -``` - -### Building +#+end_src +*** Building +:PROPERTIES: +:CUSTOM_ID: building +:END: Before building, ensure that you read the README file. -```sh +#+begin_src sh cat README -``` +#+end_src -Once you've read the instructions, open the `config.mk` file and ensure it -matches your setup. If you're not sure, leave the default options within the -file. +Once you've read the instructions, open the =config.mk= file and ensure +it matches your setup. If you're not sure, leave the default options +within the file. -Finally, you can build `st` with the following command. Ensure you run as root -(e.g., `sudo`) or else you may not end up with a usable application file. +Finally, you can build =st= with the following command. Ensure you run +as root (e.g., =sudo=) or else you may not end up with a usable +application file. -```sh +#+begin_src sh sudo make clean install -``` - -### Customization (Patches) +#+end_src -Note that customizing `st` requires you to modify the source files or to -download one of the [available patches](https://st.suckless.org/patches/) for -suckless.org. +*** Customization (Patches) +:PROPERTIES: +:CUSTOM_ID: customization-patches +:END: +Note that customizing =st= requires you to modify the source files or to +download one of the [[https://st.suckless.org/patches/][available +patches]] for suckless.org. -If you've already installed `st` and want to customize or install a patch, start -by uninstalling the current program. +If you've already installed =st= and want to customize or install a +patch, start by uninstalling the current program. -```sh +#+begin_src sh cd ~/suckless/st sudo make uninstall -``` +#+end_src -Next, grab the `<path>.diff` file from the page of the patch you chose. For -example, I will be using the -[defaultfontsize](https://st.suckless.org/patches/defaultfontsize/) patch in the below example. +Next, grab the =<path>.diff= file from the page of the patch you chose. +For example, I will be using the +[[https://st.suckless.org/patches/defaultfontsize/][defaultfontsize]] +patch in the below example. -```sh +#+begin_src sh wget https://st.suckless.org/patches/defaultfontsize/st-defaultfontsize-20210225-4ef0cbd.diff -``` +#+end_src -Once the file is downloaded inside the `st` folder, apply the patch and -re-install the program. You may need to install the `patch` command if you don't -have it installed already (you should have installed it above). +Once the file is downloaded inside the =st= folder, apply the patch and +re-install the program. You may need to install the =patch= command if +you don't have it installed already (you should have installed it +above). -```sh +#+begin_src sh patch -i st-defaultfontsize-20210225-4ef0cbd.diff sudo make clean install -``` +#+end_src -Once installed, you can use the default font size patch to launch `st` with any -font size you wish: +Once installed, you can use the default font size patch to launch =st= +with any font size you wish: -```sh +#+begin_src sh st -z 16 -``` +#+end_src |