nhcarrigan/docs
2
0
Fork 0
generated from nhcarrigan/template
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: use codeblock titles for environment

Browse Source
This commit is contained in:
Naomi Carrigan 2025-03-05 16:31:37 -08:00
parent d562560dea
commit 38149e092e
Signed by: naomi
SSH Key Fingerprint: SHA256:rca1iUI2OhAM6n4FIUaFcZcicmri0jgocqKiTTAfrt8
1 changed files with 34 additions and 65 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

99
src/content/docs/dev/environment.md
View File

@ -12,10 +12,7 @@ Naomi's local environment runs on the Arch Linux kernel.
This is the current diagnostic report from `hyfetch`. This is the current diagnostic report from `hyfetch`.
<details> ```bash title="hyfetch"
<summary>Expand Information</summary>
```bash
naomi@technomancer naomi@technomancer
------------------ ------------------
OS: Arch Linux x86_64 OS: Arch Linux x86_64
@ -78,8 +75,6 @@ Editor: Emacs 30.1
└─Nano: 8.3 └─Nano: 8.3
``` ```
</details>
## 2. Packages ## 2. Packages
Naomi uses the following packages. Naomi uses the following packages.
@ -91,7 +86,7 @@ These packages come from unofficial repositories, such as the AUR. This list is
<details> <details>
<summary>Expand List</summary> <summary>Expand List</summary>
```txt ```txt frame="terminal" title="yay -Qm"
1password-cli 2.30.3-1 1password-cli 2.30.3-1
amor 15.08.3-11 amor 15.08.3-11
amor-debug 15.08.3-11 amor-debug 15.08.3-11
@ -188,7 +183,7 @@ These are all of the packages Naomi has specifically installed. This list is gen
<details> <details>
<summary>Expand List</summary> <summary>Expand List</summary>
```txt ```txt frame="terminal" title="yay -Qe"
1password 8.10.60-27 1password 8.10.60-27
1password-cli 2.30.3-1 1password-cli 2.30.3-1
7zip 24.09-3 7zip 24.09-3
@ -469,7 +464,7 @@ zsh 5.9-5
These packages have updates ignored, due to incompatibility issues. This list is generated with `grep "^IgnorePkg" /etc/pacman.conf`. These packages have updates ignored, due to incompatibility issues. This list is generated with `grep "^IgnorePkg" /etc/pacman.conf`.
``` ```ini frame="code" title="pacman.conf"
IgnorePkg = IgnorePkg =
``` ```
@ -484,7 +479,7 @@ This list is quite large.
<details> <details>
<summary>Expand List</summary> <summary>Expand List</summary>
```txt ```txt frame="terminal" title="yay -Q"
1password 8.10.60-27 1password 8.10.60-27
1password-cli 2.30.3-1 1password-cli 2.30.3-1
7zip 24.09-3 7zip 24.09-3
@ -2132,7 +2127,7 @@ zziplib 0.13.78-1
These are portable applications Naomi has installed locally. These are portable applications Naomi has installed locally.
```txt ```txt frame="terminal" title="ls ~/Applications"
0ad-0.0.27-rc1-27645-alpha-2306180726-jammy-x86_64_cbded66ae29716e935227ef4cb299d37.AppImage 0ad-0.0.27-rc1-27645-alpha-2306180726-jammy-x86_64_cbded66ae29716e935227ef4cb299d37.AppImage
Beyond-All-Reason-1.2988.0_9fb3f6a9297f1ec22d919932ae885bd3.AppImage Beyond-All-Reason-1.2988.0_9fb3f6a9297f1ec22d919932ae885bd3.AppImage
CameoMod-playtest-20250216-x86_64_a41bc76b4c0745adb0dfb1d5c63cfcf0.AppImage CameoMod-playtest-20250216-x86_64_a41bc76b4c0745adb0dfb1d5c63cfcf0.AppImage
@ -2160,11 +2155,9 @@ Naomi's specific application configurations are noted here for posterity.
### 3.1. `git` ### 3.1. `git`
The global gitconfig goes in `~/.gitconfig`.
The most important thing to note is that Naomi signs her commits with her SSH key, not a GPG key. The most important thing to note is that Naomi signs her commits with her SSH key, not a GPG key.
```ini ```ini frame="code" title="~/.gitconfig"
[gpg] [gpg]
format = ssh format = ssh
[gpg "ssh"] [gpg "ssh"]
@ -2187,11 +2180,9 @@ The most important thing to note is that Naomi signs her commits with her SSH ke
### 3.2. `zsh` ### 3.2. `zsh`
The zsh config goes in `~/.zshrc`.
Naomi uses Oh My ZSH instead of bash. Naomi uses Oh My ZSH instead of bash.
```bash ```bash frame="code" title="~/.zshrc"
#################### ####################
# Dotfile for Oh My Zsh. # Dotfile for Oh My Zsh.
# Installs on top of zsh, # Installs on top of zsh,
@ -2295,11 +2286,11 @@ eval "$(starship init zsh)"
#### 3.2.1. `starship` #### 3.2.1. `starship`
Naomi uses `starship` to manage her customised shell prompt. This file goes in `~/.config/starship.toml`. Naomi uses `starship` to manage her customised shell prompt.
Note that her config requires your terminal be using a Nerd Font, or the symbols will not render. Note that her config requires your terminal be using a Nerd Font, or the symbols will not render.
```toml ```toml frame="code" title="~/.config/starship.toml"
cat ~/.config/starship.toml cat ~/.config/starship.toml
"$schema" = 'https://starship.rs/config-schema.json' "$schema" = 'https://starship.rs/config-schema.json'
@ -2399,11 +2390,9 @@ success_symbol = '✅'
### 3.3. `pacman` ### 3.3. `pacman`
The pacman config goes in `/etc/pacman.conf`.
Naomi's package manager configuration. Naomi's package manager configuration.
```ini ```ini frame="code" title="/etc/pacman.conf"
[options] [options]
HoldPkg = pacman glibc HoldPkg = pacman glibc
Architecture = auto Architecture = auto
@ -2429,9 +2418,7 @@ Server = https://download.sublimetext.com/arch/stable/x86_64
### 3.4 `sway` ### 3.4 `sway`
This is Naomi's `sway` config, which goes in `~/.config/sway/config`. ```ini frame="code" title="~/.config/sway/config"
```ini
# Logo key. Use Mod1 for Alt. # Logo key. Use Mod1 for Alt.
set $mod Mod4 set $mod Mod4
set $left Left set $left Left
@ -2620,9 +2607,7 @@ include /etc/sway/config.d/*
#### 3.4.1. `swaylock` #### 3.4.1. `swaylock`
This goes in `~/.config/swaylock/config`. ```ini frame="code" title="~/.config/swaylock/config"
```ini
# Background image # Background image
image=/home/naomi/pics/background.png image=/home/naomi/pics/background.png
scaling=fill scaling=fill
@ -2682,11 +2667,9 @@ font-size=24
These manage Naomi's waybar instance. These manage Naomi's waybar instance.
All of these files go in `~/.config/waybar`.
#### `config.jsonc` #### `config.jsonc`
```json ```json frame="code" title="~/.config/waybar/config.jsonc"
{ {
"layer": "top", "layer": "top",
"position": "top", "position": "top",
@ -2890,7 +2873,7 @@ All of these files go in `~/.config/waybar`.
#### `style.css` #### `style.css`
```css ```css frame="code" title="~/.config/waybar/style.css"
* { * {
border: none; border: none;
font-family: "OpenDyslexicM Nerd Font"; font-family: "OpenDyslexicM Nerd Font";
@ -2963,12 +2946,12 @@ tooltip {
#### Scripts #### Scripts
There are a few scripts necessary for waybar to work. These all go in `~/.config/waybar/scripts`: There are a few scripts necessary for waybar to work.
<details> <details>
<summary><code>disk-use.sh</code></summary> <summary><code>disk-use.sh</code></summary>
```sh ```sh frame="code" title="~/.config/waybar/scripts/disk-use.sh"
#!/usr/bin/env sh #!/usr/bin/env sh
home_use=$(df -h /home | tail -1); home_use=$(df -h /home | tail -1);
@ -2991,7 +2974,7 @@ echo "{\"text\":\"${text}\", \"tooltip\":\"${tooltip}\"}";
<details> <details>
<summary><code>cpuinfo.sh</code></summary> <summary><code>cpuinfo.sh</code></summary>
```sh ```sh frame="code" title="~/.config/waybar/scripts/cpuinfo.sh"
#!/usr/bin/env sh #!/usr/bin/env sh
model=$(cat /proc/cpuinfo | grep 'model name' | head -n 1 | awk -F ': ' '{print $2}') model=$(cat /proc/cpuinfo | grep 'model name' | head -n 1 | awk -F ': ' '{print $2}')
@ -3021,7 +3004,7 @@ echo "{\"text\":\"${thermo} ${temp}°C\", \"tooltip\":\"${model}\n${thermo} Temp
<details> <details>
<summary><code>dunst.sh</code></summary> <summary><code>dunst.sh</code></summary>
```sh ```sh frame="code" title="~/.config/waybar/scripts/dunst.sh"
#!/bin/bash #!/bin/bash
if dunstctl is-paused | grep -q "true"; then if dunstctl is-paused | grep -q "true"; then
@ -3036,7 +3019,7 @@ fi
<details> <details>
<summary><code>weather.py</code></summary> <summary><code>weather.py</code></summary>
```py ```py frame="code" title="~/.config/waybar/scripts/weather.py"
#!/usr/bin/env python #!/usr/bin/env python
import subprocess import subprocess
@ -3121,18 +3104,14 @@ print(json.dumps(out_data))
### 3.6 Ghostty ### 3.6 Ghostty
This goes in `~/.config/ghostty/config` (without a file extension). ```ini frame="code" title="~/.config/ghostty/config"
```ini
font-family="OpenDyslexicM Nerd Font" font-family="OpenDyslexicM Nerd Font"
theme="SakuraDreams" theme="SakuraDreams"
background-opacity=1 background-opacity=1
gtk-titlebar=false gtk-titlebar=false
``` ```
And this goes in `~/.config/ghostty/themes/SakuraDreams`. ```ini frame="code" title="~/.config/ghostty/themes/SakuraDreams"
```ini
palette = 0=#fff0f5 palette = 0=#fff0f5
palette = 1=#ff1493 palette = 1=#ff1493
palette = 2=#ff69b4 palette = 2=#ff69b4
@ -3160,9 +3139,7 @@ cursor-text = #fff0f5
### 3.7 Discord ### 3.7 Discord
This file goes in `~/.config/discord/settings.json`. ```json frame="code" title="~/.config/discord/settings.json"
```json
{ {
"chromiumSwitches": {}, "chromiumSwitches": {},
"IS_MAXIMIZED": false, "IS_MAXIMIZED": false,
@ -3181,9 +3158,9 @@ This file goes in `~/.config/discord/settings.json`.
### 3.8 Hyfetch ### 3.8 Hyfetch
There are two config files here. The first is for `hyfetch` itself, and goes in `~/.config/hyfetch.json`. There are two config files here.
```json ```json frame="code" title="~/.config/hyfetch.json"
{ {
"preset": "transfeminine", "preset": "transfeminine",
"mode": "rgb", "mode": "rgb",
@ -3203,9 +3180,7 @@ There are two config files here. The first is for `hyfetch` itself, and goes in
} }
``` ```
The second goes in `~/.config/neofetch/config.conf`. ```ini frame="code" title="~/.config/neofetch/config.conf"
```ini
home_disk_info() { home_disk_info() {
df -h | grep '/home$' | awk '{printf "%s: %s/%s (%s)", $NF, $3, $2, $5}' df -h | grep '/home$' | awk '{printf "%s: %s/%s (%s)", $NF, $3, $2, $5}'
} }
@ -3335,9 +3310,7 @@ stdout="off"
### 3.9 Wofi ### 3.9 Wofi
This file goes in `~/.config/wofi/style.css`. ```css frame="code" title="~/.config/wofi/style.css"
```css
#window { #window {
background-color: rgba(219, 112, 147, 0.75); background-color: rgba(219, 112, 147, 0.75);
border-radius: 1rem; border-radius: 1rem;
@ -3384,9 +3357,9 @@ This file goes in `~/.config/wofi/style.css`.
### 3.10 Dunst ### 3.10 Dunst
`dunst` manages Naomi's system notifications, and (like many other aspects of her environment) has been highly customised. This file goes in `~/.config/dunst/dunstrc`. `dunst` manages Naomi's system notifications, and (like many other aspects of her environment) has been highly customised.
```toml ```toml frame="code" title="~/.config/dunst/dunstrc"
[global] [global]
follow=mouse follow=mouse
width=(0, 750) width=(0, 750)
@ -3423,9 +3396,9 @@ Naomi uses Pulsar as her current code editor.
#### 4.1.1. Settings #### 4.1.1. Settings
This is Naomi's configuration. It goes in `~/.pulsar/config.cson`. This is Naomi's configuration.
```cson ```cson frame="code" title="~/.pulsar/config.cson"
"*": "*":
core: core:
autoHideMenuBar: true autoHideMenuBar: true
@ -3466,7 +3439,7 @@ This is Naomi's configuration. It goes in `~/.pulsar/config.cson`.
Naomi uses the following extensions sourced from the Pulsar marketplace. This list does not include the core extensions bundled with the editor. Naomi uses the following extensions sourced from the Pulsar marketplace. This list does not include the core extensions bundled with the editor.
```txt ```txt frame="terminal" title="Pulsar Extensions"
pulsar-discord pulsar-discord
``` ```
@ -3480,9 +3453,7 @@ Naomi uses `emacs` for her terminal editing.
#### 4.2.1. Config #### 4.2.1. Config
This goes in `~/.config/emacs/init.el`. ```lisp frame="code" title="~/.config/emacs/init.el"
```lisp
;; Initialize package system ;; Initialize package system
(require 'package) (require 'package)
(setq package-archives '(("melpa" . "https://melpa.org/packages/") (setq package-archives '(("melpa" . "https://melpa.org/packages/")
@ -3659,9 +3630,7 @@ This goes in `~/.config/emacs/init.el`.
#### 4.2.2. Theme #### 4.2.2. Theme
This goes in `~/.config/emacs/themes/sakura-dreams-theme.el`. ```lisp frame="code" title="~/.config/emacs/themes/sakura-dreams-theme.el"
```lisp
(deftheme sakura-dreams (deftheme sakura-dreams
"A light pink Emacs theme inspired by cherry blossoms.") "A light pink Emacs theme inspired by cherry blossoms.")