aboutsummaryrefslogtreecommitdiff
path: root/blog/2022-12-17-st.org
diff options
context:
space:
mode:
authorChristian Cleberg <hello@cleberg.net>2023-12-02 23:27:35 -0600
committerChristian Cleberg <hello@cleberg.net>2023-12-02 23:27:35 -0600
commit3d4da5ac6000a4871c5caa80d1e61f2782da3069 (patch)
tree29f36b50823d22f4c7df0a3db3ede83192ae649f /blog/2022-12-17-st.org
parentdcf0186e16b6ac8f0e00a3aeb9734421ce548177 (diff)
downloadcleberg.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.org131
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