Fix FAQ.md Markdown formatting for better rendering

- Replace HTML <h4> tags with proper Markdown ## headers
- Replace HTML <strong> tags with **bold** Markdown formatting
- Convert mixed HTML/Markdown structure to pure Markdown
- Improve rendering compatibility across all Markdown renderers
- All keybindings and sections now display properly
This commit is contained in:
Don Williams
2025-08-15 23:00:58 -04:00
parent b1c5d93eda
commit ee4026c883

88
FAQ.md
View File

@@ -3,15 +3,15 @@
- **Revision v1.19**
- **Date:** 30-May-2025
<h4>---> ZaneyOS related</h4>
## ZaneyOS related
<strong>⌨ Where can I see the Hyprland keybindings?</strong>
**⌨ Where can I see the Hyprland keybindings?**
- The SUPER key + K opens a searchable menu with the bindings
- The "keys" icon on the right side of the waybar will also bring up this menu.
<details>
<summary><strong>🖥️ ZCLI: What is it and how do I use it?</strong></summary>
<summary>**🖥️ ZCLI: What is it and how do I use it?**</summary>
<div style="margin-left: 20px;">
The `zcli` utility is a command-line tool designed to simplify the management of
@@ -130,7 +130,7 @@ Below are the keybindings for Hyprland, formatted for easy reference.
<details>
<summary><strong>❄ Why did you create ZaneyOS ? </strong></summary>
<summary>**❄ Why did you create ZaneyOS ? **</summary>
<div style="margin-left: 20px;">
@@ -152,12 +152,12 @@ Below are the keybindings for Hyprland, formatted for easy reference.
</details>
<details>
<summary><strong>🖼️ Settings and configuration</strong></summary>
<summary>**🖼️ Settings and configuration**</summary>
<div style="margin-left: 20px;">
<details>
<summary><strong>How to I change the waybar?</strong></summary>
<summary>**How to I change the waybar?**</summary>
- Go to the `~/zaneyos/host/HOSTNAME`
- Edit the `variables.nix` file
@@ -177,7 +177,7 @@ waybarChoice = ../../modules/home/waybar/waybar-ddubs.nix;
</details>
<details>
<summary><strong> How do I change the Timezone? </strong></summary>
<summary>** How do I change the Timezone? **</summary>
1. In the file, `~/zaneyos/modules/core/system.nix`
2. Edit the line: time.timeZone = "America/New_York";
@@ -186,7 +186,7 @@ waybarChoice = ../../modules/home/waybar/waybar-ddubs.nix;
</details>
<details>
<summary><strong>How do I change the monitor settings? </strong></summary>
<summary>**How do I change the monitor settings? **</summary>
Monitor settings are in the file: `~/zaneyos/hosts/<HOSTNAME>/variables.nix`
@@ -260,7 +260,7 @@ More information on configuring monitors is available on the
</details>
<details>
<summary><strong>How do I add applications to ZaneyOS? </strong></summary>
<summary>**How do I add applications to ZaneyOS? **</summary>
### There are two options. One for all hosts you have, another for a specific host.
@@ -326,7 +326,7 @@ You can add additional packages, or for example change `discord` to
<details>
<summary><strong> I added the package names, now how do I install them ? </strong></summary>
<summary>** I added the package names, now how do I install them ? **</summary>
- Use the `fr`, Flake Rebuild alias.
@@ -336,7 +336,7 @@ will be created.
</details>
<details>
<summary><strong> How do I update the packages I've already installed? </strong></summary>
<summary>** How do I update the packages I've already installed? **</summary>
- Use the `fu`, Flake Update alias. This will check for updated packages,
download and install them.
@@ -344,7 +344,7 @@ will be created.
</details>
<details>
<summary><strong> I made a change to my ZaneyOS configuration, how do I activate it? </strong></summary>
<summary>** I made a change to my ZaneyOS configuration, how do I activate it? **</summary>
- Use the `fr` Flake Rebuild alias. If you **created a new file** please note
you will need to run a `git add .` command in the zaneyos folder. If
@@ -354,7 +354,7 @@ will be created.
</details>
<details>
<summary><strong> How can I configure a different kernel on a specific host? </strong></summary>
<summary>** How can I configure a different kernel on a specific host? **</summary>
1. You have to edit the `hardware.nix` file for that host in
`~/zaneyos/hosts/HOSTNAME/hardware.nix` and override the default.
@@ -388,7 +388,7 @@ boot.extraModulePackages = [];
<details>
<summary><strong> What are the major Kernel options in NixOS? </strong></summary>
<summary>** What are the major Kernel options in NixOS? **</summary>
NixOS offers several major kernel types to cater to different needs and preferences. Below are the available options, excluding specific kernel versions:
1. **`linuxPackages`**
@@ -429,7 +429,7 @@ NixOS offers several major kernel types to cater to different needs and preferen
<details>
<summary><strong> I have older generations I want to delete, how can I do that? </strong></summary>
<summary>** I have older generations I want to delete, how can I do that? **</summary>
- The `ncg` NixOS Clean Generations alias will remove **ALL** but the most
current generation. Make sure you have booted from that generation before
@@ -440,7 +440,7 @@ NixOS offers several major kernel types to cater to different needs and preferen
<details>
<summary><strong>How do I change the hostname? </strong></summary>
<summary>**How do I change the hostname? **</summary>
To change the hostname, there are several steps and you will have to reboot to
make the change effective.
@@ -462,7 +462,7 @@ make the change effective.
</details>
<details>
<summary><strong> How do I disable the spinning snowflake at startup? </strong></summary>
<summary>** How do I disable the spinning snowflake at startup? **</summary>
1. Edit the `~/zaneyos/modules/core/boot.nix` file.
2. Look for:
@@ -479,7 +479,7 @@ make the change effective.
</details>
<details>
<summary><strong> How do I configure my hybrid laptop with Intel/NVIDIA GPUs? </strong></summary>
<summary>** How do I configure my hybrid laptop with Intel/NVIDIA GPUs? **</summary>
1. Either run the `install-zaneyos.sh` script and select `nvidia-laptop`
template or if configuring manually, set the template in the `flake.nix` to
@@ -504,7 +504,7 @@ make the change effective.
</details>
<details>
<summary><strong>🎨 Stylix</strong></summary>
<summary>**🎨 Stylix**</summary>
<div style="margin-left: 20px;">
@@ -603,12 +603,12 @@ stylixImage = ../../wallpapers/AnimeGirlNightSky.jpg;
</details>
<details>
<summary><strong>🌃 Wallpapers</strong></summary>
<summary>**🌃 Wallpapers**</summary>
<div style="margin-left: 20px;">
<details>
<summary><strong> How do I add more wallpapers? </strong></summary>
<summary>** How do I add more wallpapers? **</summary>
- Wallpapers are stored in the `~/zaneyos/wallpapers` directory.
- Simply copy the new ones to that directory.
@@ -620,7 +620,7 @@ stylixImage = ../../wallpapers/AnimeGirlNightSky.jpg;
<details>
<summary><strong> How do I change the background? </strong></summary>
<summary>** How do I change the background? **</summary>
- SUPER + ALT + W will select a new background
@@ -628,7 +628,7 @@ stylixImage = ../../wallpapers/AnimeGirlNightSky.jpg;
<details>
<summary><strong> How can I set a timer to change the wallpaper automatically? </strong></summary>
<summary>** How can I set a timer to change the wallpaper automatically? **</summary>
1. Edit the `~/zaneyos/modules/home/hyprland/config.nix` file.
2. Comment out the line `sleep 1.5 && swww img ...`
@@ -657,7 +657,7 @@ settings = {
<details>
<summary><strong>How do I change the interval the wallpaper changes? </strong></summary>
<summary>**How do I change the interval the wallpaper changes? **</summary>
1. Edit the `~/zaneyos/modules/home/scripts/wallsetter`
2. Change the `TIMEOUT =` value. Which is in seconds.
@@ -671,7 +671,7 @@ settings = {
</details>
<details>
<summary><strong>⬆ How do I update ZaneyOS? </strong></summary>
<summary>**⬆ How do I update ZaneyOS? **</summary>
<div style="margin-left: 20px;">
@@ -750,11 +750,11 @@ It will be announced on the Zaney [Discord](https://discord.gg/W7efsSDS) server.
</div>
<details><summary><strong>📂 ZaneyOS v2.3 Layout</strong></summary>
<details><summary>**📂 ZaneyOS v2.3 Layout**</summary>
<div style="margin-left: 25px;">
<h4> 📂 ~/zaneyos </h4>
#### 📂 ~/zaneyos
```text
~/zaneyos/
@@ -795,11 +795,11 @@ It will be announced on the Zaney [Discord](https://discord.gg/W7efsSDS) server.
</details>
<h4>---> 🧰 Miscellaneous</h4>
## 🧰 Miscellaneous
<details>
<summary><strong>🪧 Rebuild or update fails with Home Manager error can't backup a file</strong></summary>
<summary>**🪧 Rebuild or update fails with Home Manager error can't backup a file**</summary>
<div style="margin-left: 20px;">
<br>
@@ -832,7 +832,7 @@ May 08 18:33:57 explorer systemd[1]: Failed to start Home Manager environment fo
<details>
<summary><strong>📚 What is the difference between Master and Dwindle layouts</strong></summary>
<summary>**📚 What is the difference between Master and Dwindle layouts**</summary>
<div style="margin-left: 20px;">
<br>
@@ -870,7 +870,7 @@ To check which layout is currently active, use the `hyprctl` command:
</details>
<details>
<summary><strong>📦 What are the Yazi keybindings and how can I change them? </strong></summary>
<summary>**📦 What are the Yazi keybindings and how can I change them? **</summary>
<div style="margin-left: 20px;"> <br>
@@ -885,7 +885,7 @@ The keymap is in the `~/zaneyos/modules/home/yazi/keymap.toml` file
<details>
<summary><strong> What fonts are avialable in NixOS</strong></summary>
<summary>** What fonts are avialable in NixOS**</summary>
```nix
{pkgs, ...}: {
@@ -991,10 +991,10 @@ The keymap is in the `~/zaneyos/modules/home/yazi/keymap.toml` file
</details>
<h4>---> 🖥️ Terminals </h4>
## 🖥️ Terminals
<details>
<summary><strong>🐱 Kitty</strong></summary>
<summary>**🐱 Kitty**</summary>
<details>
@@ -1074,7 +1074,7 @@ The defaults are:
<details>
<summary><strong>🇼 WezTerm</strong></summary>
<summary>**🇼 WezTerm**</summary>
<div style="margin-left: 20px;">
@@ -1126,7 +1126,7 @@ ALT + Up Arrow Move to pane -- Down
</details>
<details>
<summary><strong>👻 Ghostty </strong></summary>
<summary>**👻 Ghostty **</summary>
<div style="margin-left: 20px;">
@@ -1204,12 +1204,10 @@ theme = Dracula
</div>
</details>
<h4>
--> 🪧 General NixOS related topics
</h4>
## 🪧 General NixOS related topics
<details>
<summary><strong>❄ What are Flakes in NixOS? </strong></summary>
<summary>**❄ What are Flakes in NixOS? **</summary>
<div style="margin-left: 20px;">
@@ -1218,7 +1216,7 @@ standardizes how configurations, dependencies, and packages are managed. If
you're familiar with tools like `package.json` in JavaScript or `Cargo.toml` in
Rust, flakes serve a similar purpose in the Nix ecosystem.
<h4> Key Features of Flakes: </h4>
#### Key Features of Flakes:
1. **Pin Dependencies**:
- Flakes lock the versions of dependencies in a `flake.lock` file, ensuring
@@ -1240,7 +1238,7 @@ portable and reliable way.
</details>
<details>
<summary><strong>🏡 What is NixOS Home Manager? </strong></summary>
<summary>**🏡 What is NixOS Home Manager? **</summary>
**Home Manager** is a powerful tool in the Nix ecosystem that allows you to
declaratively manage user-specific configurations and environments. With Home
@@ -1271,7 +1269,7 @@ way to tailor your user experience.
</details>
<details>
<summary><strong>🏭 What are Atomic Builds?</strong></summary>
<summary>**🏭 What are Atomic Builds?**</summary>
**Atomic builds** in NixOS ensure that any system change (like installing
software or updating the configuration) is applied in a safe and fail-proof way.
@@ -1311,7 +1309,7 @@ philosophy, ensuring that system management is predictable and stress-free.
</details>
<details>
<summary><strong>❓ I am new to NIXOS where can I go to get more info? </strong></summary>
<summary>**❓ I am new to NIXOS where can I go to get more info? **</summary>
- [NIXOS Config Guide](https://www.youtube.com/watch?v=AGVXJ-TIv3Y&t=34s)
- [VIMJOYER YouTube Channel](https://www.youtube.com/@vimjoyer/videos)
@@ -1322,7 +1320,7 @@ philosophy, ensuring that system management is predictable and stress-free.
</details>
<details>
<summary><strong>🏤 Where can I get info on using GIT repositories </strong></summary>
<summary>**🏤 Where can I get info on using GIT repositories **</summary>
- [Managing NIXOS config with GIT](https://www.youtube.com/watch?v=20BN4gqHwaQ)
- [GIT for dummies](https://www.youtube.com/watch?v=K6Q31YkorUE)