switch to zola

Author: ld3z

.github/workflows/deploy.yml

@@ -1,75 +1,37 @@
-name: Deploy
+name: Build and deploy Zola website
 on:
   push:
     branches:
-      - main
+      - master
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: true
 
 jobs:
-  deploy:
+  build:
     runs-on: ubuntu-latest
-    permissions:
-      contents: write # To push a branch
-      pages: write # To push to a GitHub Pages site
-      id-token: write # To update the deployment status
     steps:
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-      - uses: pnpm/action-setup@v4
-        with:
-          version: 10
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-          cache: pnpm
-      - name: Install npm dependencies
-        run: pnpm install
-      - name: Setup Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: '3.x'
-      - name: Install Python dependencies
-        run: |
-          python -m pip install --upgrade pip
-          pip install markdown
-      - name: Build tooltips
-        run: pnpm run postinstall
-      - name: Install mdbook
-        uses: taiki-e/install-action@v2
-        with:
-          tool: mdbook@0.4.52
-      - name: Install mdbook-admonish
-        uses: taiki-e/install-action@v2
-        with:
-          tool: mdbook-admonish
-      - name: Run mdbook-admonish install
-        run: |
-          mdbook-admonish install
-      - name: Install mdbook-alerts
-        uses: taiki-e/install-action@v2
-        with:
-          tool: mdbook-alerts
-      - name: Install mdbook-embedify
-        uses: taiki-e/install-action@v2
-        with:
-          tool: mdbook-embedify
-      - name: Install mdbook-github-authors
-        uses: taiki-e/install-action@v2
-        with:
-          tool: mdbook-github-authors
-      - name: Build Book
-        run: |
-          # This assumes your book is in the root of your repository.
-          # Just add a `cd` here if you need to change to another directory.
-          mdbook build
-      - name: Setup Pages
-        uses: actions/configure-pages@v4
-      - name: Upload artifact
-        uses: actions/upload-pages-artifact@v3
+      - name: checkout
+        uses: actions/checkout@v6.0.1
+
+      - name: Build Zola + upload Pages artifact
+        uses: getzola/github-pages@066755243e69f508fd1a74739fbf1a65f656c790
         with:
-          # Upload entire repository
-          path: "book"
+          zola_version: v0.22.0
+
+  deploy:
+    runs-on: ubuntu-latest
+    needs: build
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
       - name: Deploy to GitHub Pages
         id: deployment
-        uses: actions/deploy-pages@v4
+        uses: actions/deploy-pages@v4

.gitignore

@@ -0,0 +1,33 @@
++++
+insert_anchor_links = "left"
+title = "Home"
++++
+
+{% crt() %}
+```
+╔═══════════════════════════════════════════════╗
+║ ╔═══╗ ╔═══╗ ╔═══╗ ╔═══╗ ╔═══╗ ╔═══╗ ╔═══╗ ║
+║ ║ B ║ ║ O ║ ║ O ║ ║ K ║ ║   ║ ║ S ║ ║ H ║ ║
+║ ║   ║ ║   ║ ║   ║ ║   ║ ║   ║ ║   ║ ║   ║ ║
+║ ╚═══╝ ╚═══╝ ╚═══╝ ╚═══╝ ╚═══╝ ╚═══╝ ╚═══╝ ║
+╠═══════════════════════════════════════════════╣
+║ ┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐ ║
+║ │░░░░░│ │░░░░░│ │░░░░░│ │░░░░░│ │░░░░░│ ║
+║ │░░░░░│ │░░░░░│ │░░░░░│ │░░░░░│ │░░░░░│ ║
+║ └─────┘ └─────┘ └─────┘ └─────┘ └─────┘ ║
+╠═══════════════════════════════════════════════╣
+║ ┏━━━━━┓ ┏━━━━━┓ ┏━━━━━┓ ┏━━━━━┓ ┏━━━━━┓ ║
+║ ┃░░░░░┃ ┃░░░░░┃ ┃░░░░░┃ ┃░░░░░┃ ┃░░░░░┃ ║
+║ ┃░░░░░┃ ┃░░░░░┃ ┃░░░░░┃ ┃░░░░░┃ ┃░░░░░┃ ║
+║ ┗━━━━━┛ ┗━━━━━┛ ┗━━━━━┛ ┗━━━━━┛ ┗━━━━━┛ ║
+╠═══════════════════════════════════════════════╣
+║ ╭─────╮ ╭─────╮ ╭─────╮ ╭─────╮ ╭─────╮ ║
+║ │░░░░░│ │░░░░░│ │░░░░░│ │░░░░░│ │░░░░░│ ║
+║ │░░░░░│ │░░░░░│ │░░░░░│ │░░░░░│ │░░░░░│ ║
+║ ╰─────╯ ╰─────╯ ╰─────╯ ╰─────╯ ╰─────╯ ║
+╚═══════════════════════════════════════════════╝
+```
+{% end %}
+
+# Homepage
+Welcome to the note book to end note books

README.md

@@ -0,0 +1,45 @@
++++
+insert_anchor_links = "left"
+title = "Creating a Player Shop with ChestShop"
+[extra]
+go_to_top = true
++++
+
+Creating your own shop using the ChestShop plugin is straightforward. Follow these steps:
+
+1.  **Place a Chest:** Begin by placing a chest on the ground where you want your shop to be.
+2.  **Place a Sign:** Place a sign one block away from the chest. A common position is directly above the chest.
+3.  **Write on the Sign:** Interact with the sign to write the shop details. The format for the sign is crucial:
+
+    <figure>
+    {{ image(url="/chest-shop.gif", alt="Example Sign", no_hover=true) }}
+    <figcaption>Example Sign</figcaption>
+    </figure>
+
+    Here's what each line means:
+
+    *   **Line 1:** Leave this line empty. The plugin will automatically fill it with your in-game name.
+    *   **Line 2:** Enter the amount of items you want to buy or sell in a single transaction.
+    *   **Line 3:** Specify the prices for buying and/or selling. This line uses a combination of price indicators and values.
+        *   `B` indicates the price at which *players* can *buy* items from your shop.
+        *   `S` indicates the price at which *players* can *sell* items to your shop.
+        *   Prices are separated by a colon (`:`).
+        *   Examples of valid price combinations:
+            *   `B 5: S 5`: Players can buy for 5, and sell for 5.
+            *   `B 5`: Players can only buy for 5.
+            *   `S free`: Players can sell to your shop for free.
+    *   **Line 4:** Specify the item being traded. You can write `?` on the sign, and the plugin will automatically detect the item from the chest when you're done writing the sign or after you click the sign with the item in your hand. Alternatively, you can write the item's name or ID directly.
+
+  > [!TIP]
+  > You can find the name of the item you are trying to sell by going to the [Minecraft Wiki](https://minecraft.wiki).
+
+4.  **Complete the Shop:** Once the sign is correctly filled out and placed next to the chest, your shop is ready!
+
+<details>
+  <summary>Resulting Shop</summary>
+  {{ image(url="/done-shop.gif", alt="Completed Shop", no_hover=true) }}
+</details>
+
+## Video Guide:
+
+{{ youtube(id="Zap3snBb5Fw", start="625") }}

book.toml

@@ -1,4 +1,9 @@
-# Docker
++++
+insert_anchor_links = "left"
+title = "Docker"
+[extra]
+go_to_top = true
++++
 
 Docker is a platform used for developing, shipping, and running applications in containers. Installing it can sometimes involve several steps, and if you're setting up multiple machines or doing it frequently, remembering the exact process can be tedious.
 
@@ -14,34 +19,33 @@ This note serves as a quick reference for installing Docker using the convenienc
     ```sh
     sudo sh install-docker.sh
     ```
-
-    ```admonish info
+    {% alert(important=true) %}
     This executes the downloaded script with superuser privileges to perform the installation.
-    ```
+    {% end %}
 3.  **Add your user to the `docker` group:**
     ```sh
     sudo usermod -aG docker (username)
     ```
 
-    ```admonish warning
+    {% alert(warning=true) %}
     Replace `(username)` with your actual username. This command adds your current user to the `docker` group. Membership in this group allows you to run Docker commands without needing `sudo`. While convenient, understand that members of the `docker` group have permissions equivalent to the root user regarding Docker, so exercise caution.
-    ```
+    {% end %}
 
 4.  **Reboot your system:**
     ```sh
     sudo reboot
     ```
 
-    ```admonish tip
+    {% alert(tip=true) %}
     A reboot is usually required for the group changes made in the previous step to take effect.
-    ```
+    {% end %}
 
 5.  **Verify the installation:**
     After your system has restarted and you've logged back in, you can verify that Docker is installed and you can run commands without `sudo` by running the `hello-world` container:
     ```sh
     docker run hello-world
     ```
 
-    ```admonish info
+    {% alert(note=true) %}
     This command downloads a test image and runs it in a container. If everything is set up correctly, you should see a message confirming that your Docker installation is working.
-    ```
+    {% end %}

content/_index.md

@@ -1,12 +1,16 @@
-# Managing the Graphical User Interface (GUI)
++++
+insert_anchor_links = "left"
+title = "Managing the Graphical User Interface (GUI)"
+[extra]
+go_to_top = true
++++
 
 This document provides commands to switch your system's default boot target between the graphical user interface (GUI) mode and the command-line interface (CLI) mode.
 
 Switching between these modes can be useful depending on whether you need a graphical environment or prefer working solely from the command line.
 
-```admonish note
-These commands are applicable for systems using `systemd`.
-```
+> [!NOTE]
+> These commands are applicable for systems using `systemd`.
 
 ## Disable GUI (Boot to Command Line):
 

content/chest-shop.md

@@ -1,10 +1,15 @@
-# Some helpful command line programs
++++
+insert_anchor_links = "left"
+title = "Some helpful command line programs"
+[extra]
+go_to_top = true
++++
 
 This page lists some command-line tools that can significantly enhance your productivity and make working in the terminal easier and more efficient.
 
-## Tmux :simple-icons-tmux:
+## Tmux:
 
-Tmux (Terminal Multiplexer)[^tooltip:A tool that lets you switch between several programs in one terminal, detach them, and reattach them later.] allows you to create and control multiple terminal sessions within a single window.
+Tmux (Terminal Multiplexer)[^tmux] allows you to create and control multiple terminal sessions within a single window.
 
 Can be installed by running:
 
@@ -22,10 +27,9 @@ To start a new Tmux session:
 tmux
 ```
 
-```admonish tip
-To detach from a session (leaving it running in the background):
-Press `Ctrl+b` followed by `d`.
-```
+> [!TIP]
+> To detach from a session (leaving it running in the background):
+> Press `Ctrl+b` followed by `d`.
 
 To list existing sessions:
 
@@ -45,13 +49,12 @@ To reattach to a specific session (replace `0` with the session number):
 tmux attach -t 0
 ```
 
-## TLDR :simple-icons-tldraw:
+## TLDR:
 
-```admonish info
-Shows simplified examples for command-line tools.
-```
+>[!NOTE]
+> Shows simplified examples for command-line tools.
 
-TLDR provides simplified, community-maintained examples for command-line programs. It cuts through lengthy man pages to give you just the common use cases.[^tooltip:@tldr-versions]
+TLDR provides simplified, community-maintained examples for command-line programs. It cuts through lengthy man pages to give you just the common use cases.
 
 **Basic Usage:**
 
@@ -67,9 +70,9 @@ To see examples for the `ls` command with macOS options:
 tldr ls --platform osx
 ```
 
-## htop :simple-icons-htop:
+## htop:
 
-htop is an interactive process viewer for Unix-like systems. It provides a dynamic real-time view of processes running on the system, showing CPU usage, memory usage, swap usage, and tasks.[^tooltip:It's an improved version of the standard `top` command with a more user-friendly interface.]
+htop is an interactive process viewer for Unix-like systems. It provides a dynamic real-time view of processes running on the system, showing CPU usage, memory usage, swap usage, and tasks.[^htop]
 
 Can be installed by running:
 
@@ -85,6 +88,8 @@ Simply run `htop` to launch the interactive viewer:
 htop
 ```
 
-```admonish tip
-Inside `htop`, you can use arrow keys to navigate and function keys (like F1 for Help, F3 for Search, F9 for Kill, F10 to Quit) for various actions.
-```
+> [!TIP]
+> Inside `htop`, you can use arrow keys to navigate and function keys (like F1 for Help, F3 for Search, F9 for Kill, F10 to Quit) for various actions.
+
+[^tmux]: A tool that lets you switch between several programs in one terminal, detach them, and reattach them later.
+[^htop]: It's an improved version of the standard `top` command with a more user-friendly interface.

src/docker.md content/docker/_index.mdsrc/docker.md renamed to content/docker/_index.md

@@ -1,4 +1,9 @@
-# Minecraft Servers in Docker
++++
+insert_anchor_links = "left"
+title = "Minecraft Servers in Docker"
+[extra]
+go_to_top = true
++++
 
 I use [itzg/docker-minecraft-server](https://github.com/itzg/docker-minecraft-server) containers whenever possible since they are easy to maintain and run.
 
@@ -15,7 +20,7 @@ docker exec -i mc_server rcon-cli
 > [!NOTE]
 > This command's ```mc_server``` is a placeholder for whatever you called your container name in your compose file
 
-## Some things to keep in mind
+### Some things to keep in mind
 
 There are somethings that you should utilize, regardless of server software. Like online-mode or creating a whitelist.
 Enabling both of those options should protect your server from unauthorized visitors.