aboutsummaryrefslogtreecommitdiff
path: root/content/blog/2022-12-17-st.md
diff options
context:
space:
mode:
authorChristian Cleberg <hello@cleberg.net>2024-04-27 17:01:13 -0500
committerChristian Cleberg <hello@cleberg.net>2024-04-27 17:01:13 -0500
commit74992aaa27eb384128924c4a3b93052961a3eaab (patch)
treed5193997d72a52f7a6d6338ea5da8a6c80b4eddc /content/blog/2022-12-17-st.md
parent3def68d80edf87e28473609c31970507d9f03467 (diff)
downloadcleberg.net-74992aaa27eb384128924c4a3b93052961a3eaab.tar.gz
cleberg.net-74992aaa27eb384128924c4a3b93052961a3eaab.tar.bz2
cleberg.net-74992aaa27eb384128924c4a3b93052961a3eaab.zip
test conversion back to markdown
Diffstat (limited to 'content/blog/2022-12-17-st.md')
-rw-r--r--content/blog/2022-12-17-st.md95
1 files changed, 95 insertions, 0 deletions
diff --git a/content/blog/2022-12-17-st.md b/content/blog/2022-12-17-st.md
new file mode 100644
index 0000000..46f6cec
--- /dev/null
+++ b/content/blog/2022-12-17-st.md
@@ -0,0 +1,95 @@
++++
+date = 2022-12-17
+title = "Simple Terminal"
+description = ""
+draft = false
++++
+
+# 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
+mkdir ~/suckless && cd ~/suckless
+git clone https://git.suckless.org/st && cd st
+```
+
+## Dependencies
+
+Once you have the files and are in the `st` directory, ensure
+the following packages are installed.
+
+```sh
+sudo dnf update && sudo dnf upgrade
+sudo dnf install gcc patch libX11-devel libXft-devel
+```
+
+## Building
+
+Before building, ensure that you read the README file.
+
+```sh
+cat README
+```
+
+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.
+
+```sh
+sudo make clean install
+```
+
+## Customization (Patches)
+
+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.
+
+If you\'ve already installed `st` and want to customize or
+install a patch, start by uninstalling the current program.
+
+```sh
+cd ~/suckless/st
+sudo make uninstall
+```
+
+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.
+
+```sh
+wget https://st.suckless.org/patches/defaultfontsize/st-defaultfontsize-20210225-4ef0cbd.diff
+```
+
+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
+patch -i st-defaultfontsize-20210225-4ef0cbd.diff
+sudo make clean install
+```
+
+Once installed, you can use the default font size patch to launch
+`st` with any font size you wish:
+
+```sh
+st -z 16
+```