From 1eaa031414dd00b1c114e677a10d2f926ebb02ca Mon Sep 17 00:00:00 2001 From: owine Date: Sat, 12 Jul 2025 11:03:17 -0500 Subject: [PATCH 01/14] refactor: convert inline HTML to Markdown --- docs/faq/Plex.md | 12 ++++------ docs/index.md | 12 ++++------ docs/saltbox/install/install.md | 5 +--- docs/saltbox/inventory/index.md | 38 +++++++----------------------- docs/sandbox/apps/chrome.md | 4 ---- docs/sandbox/apps/plextraktsync.md | 16 +++++-------- docs/sandbox/apps/watchstate.md | 12 ++++------ 7 files changed, 28 insertions(+), 71 deletions(-) diff --git a/docs/faq/Plex.md b/docs/faq/Plex.md index 1c0f9c6ec..958c31a25 100644 --- a/docs/faq/Plex.md +++ b/docs/faq/Plex.md @@ -30,15 +30,11 @@ SOME COMMANDS ON THIS PAGE IRREVOCABLY DELETE DATA !!! warning **THIS IS DESTRUCTIVE AND WILL DELETE ALL PLEX LIBRARIES AND DATA. THERE IS NO UNDO.** -
- I understand the risk! Show me! -
+ ??? danger "I understand the risk! Show me!" - ```shell - sudo rm -rf /opt/plex - ``` - -
+ ```shell + sudo rm -rf /opt/plex + ``` - Reinstall the Plex container: diff --git a/docs/index.md b/docs/index.md index 6ddbb70df..2fe03b3dc 100644 --- a/docs/index.md +++ b/docs/index.md @@ -6,14 +6,10 @@ hide: ## Created with the help of -
- -- :simple-ansible: [__Ansible__](https://www.ansible.com/){target=_blank} -- :simple-docker: [__Docker__](https://www.docker.com/){target=_blank} -- :material-bash: [__Bash__](https://www.gnu.org/software/bash/){target=_blank} -- :simple-python: [__Python__](https://www.python.org/){target=_blank} - -
+- :simple-ansible: [**Ansible**](https://www.ansible.com/){target=_blank} +- :simple-docker: [**Docker**](https://www.docker.com/){target=_blank} +- :material-bash: [**Bash**](https://www.gnu.org/software/bash/){target=_blank} +- :simple-python: [**Python**](https://www.python.org/){target=_blank} ### What is it? diff --git a/docs/saltbox/install/install.md b/docs/saltbox/install/install.md index c035c1255..de8456152 100644 --- a/docs/saltbox/install/install.md +++ b/docs/saltbox/install/install.md @@ -65,9 +65,7 @@ However, it is safe to run any saltbox tag[s] [including the install tags] at wi ``` -
-What will I see in the terminal? -
+??? info "What will I see in the terminal?" Something like this: @@ -78,7 +76,6 @@ x86_64 is currently supported. Installing Saltbox Dependencies. /srv/git/saltbox$ ``` -
!!! info See [here](../../reference/dependencies.md) for more information about the dependencies. diff --git a/docs/saltbox/inventory/index.md b/docs/saltbox/inventory/index.md index 4a94ca78f..40c8947df 100644 --- a/docs/saltbox/inventory/index.md +++ b/docs/saltbox/inventory/index.md @@ -54,26 +54,11 @@ The variables that can be used for customization within the Inventory are listed === "GitHub File View" - - - - - - - - - - - - - -
Saltbox - [:fontawesome-solid-folder-tree: https://github.com/saltyorg/Saltbox/tree/master/roles/](https://github.com/saltyorg/Saltbox/tree/master/roles)**<role_name>/defaults/main.yml** -
Sandbox - [:fontawesome-solid-folder-tree: https://github.com/saltyorg/Sandbox/tree/master/roles/](https://github.com/saltyorg/Sandbox/tree/master/roles)**<role_name>/defaults/main.yml** -
Global - [:fontawesome-solid-folder-tree: https://github.com/saltyorg/Saltbox/blob/master/inventories/group_vars/all.yml](https://github.com/saltyorg/Saltbox/blob/master/inventories/group_vars/all.yml) -
+ | Repository | Location | + |------------|----------| + | Saltbox | [:fontawesome-solid-folder-tree: https://github.com/saltyorg/Saltbox/tree/master/roles/](https://github.com/saltyorg/Saltbox/tree/master/roles)**<role_name>/defaults/main.yml** | + | Sandbox | [:fontawesome-solid-folder-tree: https://github.com/saltyorg/Sandbox/tree/master/roles/](https://github.com/saltyorg/Sandbox/tree/master/roles)**<role_name>/defaults/main.yml** | + | Global | [:fontawesome-solid-folder-tree: https://github.com/saltyorg/Saltbox/blob/master/inventories/group_vars/all.yml](https://github.com/saltyorg/Saltbox/blob/master/inventories/group_vars/all.yml) | === "File Path on Saltbox Host" @@ -105,9 +90,8 @@ The variables that can be used for customization within the Inventory are listed For use cases involving Docker parameters beyond those exposed in the role files, it is still possible to construct usable Saltbox variables. The following resources provide the required syntax elements: - - - + - + - === "Something Missing?" @@ -137,10 +121,8 @@ sonarr_docker_image_tag: "release" sonarr_docker_image: "{{ lookup('vars', sonarr_name + '_docker_image_repo', default=sonarr_docker_image_repo) + ':' + lookup('vars', sonarr_name + '_docker_image_tag', default=sonarr_docker_image_tag) }}" ``` -
-!!! info "\`default\` Variables" +!!! info "`default` Variables" Variables suffixed with `_default` and variables predefined with non-empty values (specifically, not followed by a blank, an empty string `""`, list `[]` or dictionary `{}`) fall under this category. Using the Inventory to define one of these variables is therefore considered an override, as it will cause the value(s) originally stored in it to be discarded. -
Note: `sonarr_docker_image_tag: "release"`. @@ -167,10 +149,8 @@ code_server_docker_volumes_default: - "{{ server_appdata_path }}:/host_opt" code_server_docker_volumes_custom: [] ``` -
-!!! info "\`custom\` Variables" +!!! info "`custom` Variables" Variables suffixed with `_custom` and variables defined with an empty string fall under this category. Respectively, this is used to add custom values to a list or a dictionary without discarding existing values, and to assign a value to an exposed role-specific setting. -
Note the list syntax. Since we want the container to preserve existing volumes, the `_docker_volumes_default` list should not be overridden. Instead, we use the `_docker_volumes_custom` list. diff --git a/docs/sandbox/apps/chrome.md b/docs/sandbox/apps/chrome.md index c2106ea8c..ab7fbf14a 100644 --- a/docs/sandbox/apps/chrome.md +++ b/docs/sandbox/apps/chrome.md @@ -4,14 +4,10 @@ Headless container running Google Chrome. Useful for testing, filling out forms, This was created for use with Hoarder which calls for a specific version (123) -
- [:material-bookshelf: Github Repo](https://github.com/jlandure/alpine-chrome/blob/master/Dockerfile){ .md-button .md-button--stretch } [:material-git: Google Artifact](https://console.cloud.google.com/artifacts/docker/zenika-hub/us/gcr.io/alpine-chrome/sha256:e38563d4475a3d791e986500a2e4125c9afd13798067138881cf770b1f6f3980){ .md-button .md-button--stretch } -
- This role is not exposed by default. ## Deployment diff --git a/docs/sandbox/apps/plextraktsync.md b/docs/sandbox/apps/plextraktsync.md index 90678209f..df67210a8 100644 --- a/docs/sandbox/apps/plextraktsync.md +++ b/docs/sandbox/apps/plextraktsync.md @@ -8,17 +8,13 @@ tags: Self-hosted application that adds a two-way-sync between trakt.tv and Plex Media Server. It requires a trakt.tv account but no Plex premium and no Trakt VIP subscriptions, unlike the Plex app provided by Trakt. -
+[:material-home: Homepage](https://github.com/Taxel/PlexTraktSync){ .md-button .md-button--stretch } -[:material-home: Homepage  ](https://github.com/Taxel/PlexTraktSync){ .md-button .md-button--stretch } +[:material-bookshelf: Manual](https://github.com/Taxel/PlexTraktSync/blob/main/README.md#setup){ .md-button .md-button--stretch } -[:material-bookshelf: Manual  ](https://github.com/Taxel/PlexTraktSync/blob/main/README.md#setup){ .md-button .md-button--stretch } +[:octicons-container-16: Releases](https://github.com/taxel/PlexTraktSync/pkgs/container/plextraktsync){ .md-button .md-button--stretch } -[:octicons-container-16: Releases  ](https://github.com/taxel/PlexTraktSync/pkgs/container/plextraktsync){ .md-button .md-button--stretch } - -[:fontawesome-brands-github: Community  ](https://github.com/Taxel/PlexTraktSync/discussions){ .md-button .md-button--stretch } - -
+[:fontawesome-brands-github: Community](https://github.com/Taxel/PlexTraktSync/discussions){ .md-button .md-button--stretch } --- @@ -46,11 +42,11 @@ docker exec -it plextraktsync plextraktsync login ## Usage -### Daemon +### Daemon Once configured, the selected Plex user's streaming activity is automatically scrobbled. -### CLI +### CLI To perform a one-time sync of the data you have specified in the configuration file: diff --git a/docs/sandbox/apps/watchstate.md b/docs/sandbox/apps/watchstate.md index be5609f90..7e7c49913 100644 --- a/docs/sandbox/apps/watchstate.md +++ b/docs/sandbox/apps/watchstate.md @@ -10,17 +10,13 @@ tags: This tool's primary goal is to sync your backends' play states without relying on third party services. Out of the box, it supports Jellyfin, Plex and Emby media servers. -
+[:material-home: Homepage](https://github.com/arabcoders/watchstate){ .md-button .md-button--stretch } -[:material-home: Homepage  ](https://github.com/arabcoders/watchstate){ .md-button .md-button--stretch } +[:material-bookshelf: Manual](https://github.com/ArabCoders/watchstate/blob/master/FAQ.md){ .md-button .md-button--stretch } -[:material-bookshelf: Manual  ](https://github.com/ArabCoders/watchstate/blob/master/FAQ.md){ .md-button .md-button--stretch } +[:octicons-container-16: Releases](https://github.com/arabcoders/watchstate/pkgs/container/watchstate){ .md-button .md-button--stretch } -[:octicons-container-16: Releases  ](https://github.com/arabcoders/watchstate/pkgs/container/watchstate){ .md-button .md-button--stretch } - -[:fontawesome-brands-discord: Community  ](https://discord.gg/haUXHJyj6Y){ .md-button .md-button--stretch } - -
+[:fontawesome-brands-discord: Community](https://discord.gg/haUXHJyj6Y){ .md-button .md-button--stretch } --- From 11e7211b4a69bcddae417a66236f69883e45b6ca Mon Sep 17 00:00:00 2001 From: owine Date: Sat, 12 Jul 2025 11:14:14 -0500 Subject: [PATCH 02/14] organize buttons in table layout --- docs/sandbox/apps/chrome.md | 6 +++--- docs/sandbox/apps/plextraktsync.md | 11 ++++------- docs/sandbox/apps/watchstate.md | 11 ++++------- 3 files changed, 11 insertions(+), 17 deletions(-) diff --git a/docs/sandbox/apps/chrome.md b/docs/sandbox/apps/chrome.md index ab7fbf14a..75009c710 100644 --- a/docs/sandbox/apps/chrome.md +++ b/docs/sandbox/apps/chrome.md @@ -4,9 +4,9 @@ Headless container running Google Chrome. Useful for testing, filling out forms, This was created for use with Hoarder which calls for a specific version (123) -[:material-bookshelf: Github Repo](https://github.com/jlandure/alpine-chrome/blob/master/Dockerfile){ .md-button .md-button--stretch } - -[:material-git: Google Artifact](https://console.cloud.google.com/artifacts/docker/zenika-hub/us/gcr.io/alpine-chrome/sha256:e38563d4475a3d791e986500a2e4125c9afd13798067138881cf770b1f6f3980){ .md-button .md-button--stretch } +| | | +|---|---| +| [:material-bookshelf: Github Repo](https://github.com/jlandure/alpine-chrome/blob/master/Dockerfile){ .md-button .md-button--stretch } | [:material-git: Google Artifact](https://console.cloud.google.com/artifacts/docker/zenika-hub/us/gcr.io/alpine-chrome/sha256:e38563d4475a3d791e986500a2e4125c9afd13798067138881cf770b1f6f3980){ .md-button .md-button--stretch } | This role is not exposed by default. diff --git a/docs/sandbox/apps/plextraktsync.md b/docs/sandbox/apps/plextraktsync.md index df67210a8..28dbcf496 100644 --- a/docs/sandbox/apps/plextraktsync.md +++ b/docs/sandbox/apps/plextraktsync.md @@ -8,13 +8,10 @@ tags: Self-hosted application that adds a two-way-sync between trakt.tv and Plex Media Server. It requires a trakt.tv account but no Plex premium and no Trakt VIP subscriptions, unlike the Plex app provided by Trakt. -[:material-home: Homepage](https://github.com/Taxel/PlexTraktSync){ .md-button .md-button--stretch } - -[:material-bookshelf: Manual](https://github.com/Taxel/PlexTraktSync/blob/main/README.md#setup){ .md-button .md-button--stretch } - -[:octicons-container-16: Releases](https://github.com/taxel/PlexTraktSync/pkgs/container/plextraktsync){ .md-button .md-button--stretch } - -[:fontawesome-brands-github: Community](https://github.com/Taxel/PlexTraktSync/discussions){ .md-button .md-button--stretch } +| | | +|---|---| +| [:material-home: Homepage](https://github.com/Taxel/PlexTraktSync){ .md-button .md-button--stretch } | [:material-bookshelf: Manual](https://github.com/Taxel/PlexTraktSync/blob/main/README.md#setup){ .md-button .md-button--stretch } | +| [:octicons-container-16: Releases](https://github.com/taxel/PlexTraktSync/pkgs/container/plextraktsync){ .md-button .md-button--stretch } | [:fontawesome-brands-github: Community](https://github.com/Taxel/PlexTraktSync/discussions){ .md-button .md-button--stretch } | --- diff --git a/docs/sandbox/apps/watchstate.md b/docs/sandbox/apps/watchstate.md index 7e7c49913..810f6ae9b 100644 --- a/docs/sandbox/apps/watchstate.md +++ b/docs/sandbox/apps/watchstate.md @@ -10,13 +10,10 @@ tags: This tool's primary goal is to sync your backends' play states without relying on third party services. Out of the box, it supports Jellyfin, Plex and Emby media servers. -[:material-home: Homepage](https://github.com/arabcoders/watchstate){ .md-button .md-button--stretch } - -[:material-bookshelf: Manual](https://github.com/ArabCoders/watchstate/blob/master/FAQ.md){ .md-button .md-button--stretch } - -[:octicons-container-16: Releases](https://github.com/arabcoders/watchstate/pkgs/container/watchstate){ .md-button .md-button--stretch } - -[:fontawesome-brands-discord: Community](https://discord.gg/haUXHJyj6Y){ .md-button .md-button--stretch } +| | | +|---|---| +| [:material-home: Homepage](https://github.com/arabcoders/watchstate){ .md-button .md-button--stretch } | [:material-bookshelf: Manual](https://github.com/ArabCoders/watchstate/blob/master/FAQ.md){ .md-button .md-button--stretch } | +| [:octicons-container-16: Releases](https://github.com/arabcoders/watchstate/pkgs/container/watchstate){ .md-button .md-button--stretch } | [:fontawesome-brands-discord: Community](https://discord.gg/haUXHJyj6Y){ .md-button .md-button--stretch } | --- From e9a1a78c1abe0ba7dc406107cdc86f661e658170 Mon Sep 17 00:00:00 2001 From: owine Date: Sat, 12 Jul 2025 11:20:18 -0500 Subject: [PATCH 03/14] remove table borders from button layouts --- docs/sandbox/apps/chrome.md | 1 + docs/sandbox/apps/plextraktsync.md | 1 + docs/sandbox/apps/watchstate.md | 1 + 3 files changed, 3 insertions(+) diff --git a/docs/sandbox/apps/chrome.md b/docs/sandbox/apps/chrome.md index 75009c710..cb5a327f6 100644 --- a/docs/sandbox/apps/chrome.md +++ b/docs/sandbox/apps/chrome.md @@ -7,6 +7,7 @@ This was created for use with Hoarder which calls for a specific version (123) | | | |---|---| | [:material-bookshelf: Github Repo](https://github.com/jlandure/alpine-chrome/blob/master/Dockerfile){ .md-button .md-button--stretch } | [:material-git: Google Artifact](https://console.cloud.google.com/artifacts/docker/zenika-hub/us/gcr.io/alpine-chrome/sha256:e38563d4475a3d791e986500a2e4125c9afd13798067138881cf770b1f6f3980){ .md-button .md-button--stretch } | +{ .borderless } This role is not exposed by default. diff --git a/docs/sandbox/apps/plextraktsync.md b/docs/sandbox/apps/plextraktsync.md index 28dbcf496..7da8190c3 100644 --- a/docs/sandbox/apps/plextraktsync.md +++ b/docs/sandbox/apps/plextraktsync.md @@ -12,6 +12,7 @@ Self-hosted application that adds a two-way-sync between trakt.tv and Plex Media |---|---| | [:material-home: Homepage](https://github.com/Taxel/PlexTraktSync){ .md-button .md-button--stretch } | [:material-bookshelf: Manual](https://github.com/Taxel/PlexTraktSync/blob/main/README.md#setup){ .md-button .md-button--stretch } | | [:octicons-container-16: Releases](https://github.com/taxel/PlexTraktSync/pkgs/container/plextraktsync){ .md-button .md-button--stretch } | [:fontawesome-brands-github: Community](https://github.com/Taxel/PlexTraktSync/discussions){ .md-button .md-button--stretch } | +{ .borderless } --- diff --git a/docs/sandbox/apps/watchstate.md b/docs/sandbox/apps/watchstate.md index 810f6ae9b..9b7c356a4 100644 --- a/docs/sandbox/apps/watchstate.md +++ b/docs/sandbox/apps/watchstate.md @@ -14,6 +14,7 @@ This tool's primary goal is to sync your backends' play states without relying o |---|---| | [:material-home: Homepage](https://github.com/arabcoders/watchstate){ .md-button .md-button--stretch } | [:material-bookshelf: Manual](https://github.com/ArabCoders/watchstate/blob/master/FAQ.md){ .md-button .md-button--stretch } | | [:octicons-container-16: Releases](https://github.com/arabcoders/watchstate/pkgs/container/watchstate){ .md-button .md-button--stretch } | [:fontawesome-brands-discord: Community](https://discord.gg/haUXHJyj6Y){ .md-button .md-button--stretch } | +{ .borderless } --- From 0485ac1070d56e53117dda5a8a7fabc00e6a50a4 Mon Sep 17 00:00:00 2001 From: owine Date: Sat, 12 Jul 2025 11:26:40 -0500 Subject: [PATCH 04/14] convert to pure Markdown button layout --- docs/sandbox/apps/chrome.md | 7 +++---- docs/sandbox/apps/plextraktsync.md | 12 +++++++----- docs/sandbox/apps/watchstate.md | 12 +++++++----- 3 files changed, 17 insertions(+), 14 deletions(-) diff --git a/docs/sandbox/apps/chrome.md b/docs/sandbox/apps/chrome.md index cb5a327f6..ab7fbf14a 100644 --- a/docs/sandbox/apps/chrome.md +++ b/docs/sandbox/apps/chrome.md @@ -4,10 +4,9 @@ Headless container running Google Chrome. Useful for testing, filling out forms, This was created for use with Hoarder which calls for a specific version (123) -| | | -|---|---| -| [:material-bookshelf: Github Repo](https://github.com/jlandure/alpine-chrome/blob/master/Dockerfile){ .md-button .md-button--stretch } | [:material-git: Google Artifact](https://console.cloud.google.com/artifacts/docker/zenika-hub/us/gcr.io/alpine-chrome/sha256:e38563d4475a3d791e986500a2e4125c9afd13798067138881cf770b1f6f3980){ .md-button .md-button--stretch } | -{ .borderless } +[:material-bookshelf: Github Repo](https://github.com/jlandure/alpine-chrome/blob/master/Dockerfile){ .md-button .md-button--stretch } + +[:material-git: Google Artifact](https://console.cloud.google.com/artifacts/docker/zenika-hub/us/gcr.io/alpine-chrome/sha256:e38563d4475a3d791e986500a2e4125c9afd13798067138881cf770b1f6f3980){ .md-button .md-button--stretch } This role is not exposed by default. diff --git a/docs/sandbox/apps/plextraktsync.md b/docs/sandbox/apps/plextraktsync.md index 7da8190c3..df67210a8 100644 --- a/docs/sandbox/apps/plextraktsync.md +++ b/docs/sandbox/apps/plextraktsync.md @@ -8,11 +8,13 @@ tags: Self-hosted application that adds a two-way-sync between trakt.tv and Plex Media Server. It requires a trakt.tv account but no Plex premium and no Trakt VIP subscriptions, unlike the Plex app provided by Trakt. -| | | -|---|---| -| [:material-home: Homepage](https://github.com/Taxel/PlexTraktSync){ .md-button .md-button--stretch } | [:material-bookshelf: Manual](https://github.com/Taxel/PlexTraktSync/blob/main/README.md#setup){ .md-button .md-button--stretch } | -| [:octicons-container-16: Releases](https://github.com/taxel/PlexTraktSync/pkgs/container/plextraktsync){ .md-button .md-button--stretch } | [:fontawesome-brands-github: Community](https://github.com/Taxel/PlexTraktSync/discussions){ .md-button .md-button--stretch } | -{ .borderless } +[:material-home: Homepage](https://github.com/Taxel/PlexTraktSync){ .md-button .md-button--stretch } + +[:material-bookshelf: Manual](https://github.com/Taxel/PlexTraktSync/blob/main/README.md#setup){ .md-button .md-button--stretch } + +[:octicons-container-16: Releases](https://github.com/taxel/PlexTraktSync/pkgs/container/plextraktsync){ .md-button .md-button--stretch } + +[:fontawesome-brands-github: Community](https://github.com/Taxel/PlexTraktSync/discussions){ .md-button .md-button--stretch } --- diff --git a/docs/sandbox/apps/watchstate.md b/docs/sandbox/apps/watchstate.md index 9b7c356a4..7e7c49913 100644 --- a/docs/sandbox/apps/watchstate.md +++ b/docs/sandbox/apps/watchstate.md @@ -10,11 +10,13 @@ tags: This tool's primary goal is to sync your backends' play states without relying on third party services. Out of the box, it supports Jellyfin, Plex and Emby media servers. -| | | -|---|---| -| [:material-home: Homepage](https://github.com/arabcoders/watchstate){ .md-button .md-button--stretch } | [:material-bookshelf: Manual](https://github.com/ArabCoders/watchstate/blob/master/FAQ.md){ .md-button .md-button--stretch } | -| [:octicons-container-16: Releases](https://github.com/arabcoders/watchstate/pkgs/container/watchstate){ .md-button .md-button--stretch } | [:fontawesome-brands-discord: Community](https://discord.gg/haUXHJyj6Y){ .md-button .md-button--stretch } | -{ .borderless } +[:material-home: Homepage](https://github.com/arabcoders/watchstate){ .md-button .md-button--stretch } + +[:material-bookshelf: Manual](https://github.com/ArabCoders/watchstate/blob/master/FAQ.md){ .md-button .md-button--stretch } + +[:octicons-container-16: Releases](https://github.com/arabcoders/watchstate/pkgs/container/watchstate){ .md-button .md-button--stretch } + +[:fontawesome-brands-discord: Community](https://discord.gg/haUXHJyj6Y){ .md-button .md-button--stretch } --- From 585f8b2f2d2782e84d505e5fa03db1b255e8bfa2 Mon Sep 17 00:00:00 2001 From: owine Date: Sat, 12 Jul 2025 11:33:12 -0500 Subject: [PATCH 05/14] use standard grid button layout --- docs/sandbox/apps/chrome.md | 4 ++++ docs/sandbox/apps/plextraktsync.md | 4 ++++ docs/sandbox/apps/watchstate.md | 4 ++++ 3 files changed, 12 insertions(+) diff --git a/docs/sandbox/apps/chrome.md b/docs/sandbox/apps/chrome.md index ab7fbf14a..99fb0b5e7 100644 --- a/docs/sandbox/apps/chrome.md +++ b/docs/sandbox/apps/chrome.md @@ -4,10 +4,14 @@ Headless container running Google Chrome. Useful for testing, filling out forms, This was created for use with Hoarder which calls for a specific version (123) +
+ [:material-bookshelf: Github Repo](https://github.com/jlandure/alpine-chrome/blob/master/Dockerfile){ .md-button .md-button--stretch } [:material-git: Google Artifact](https://console.cloud.google.com/artifacts/docker/zenika-hub/us/gcr.io/alpine-chrome/sha256:e38563d4475a3d791e986500a2e4125c9afd13798067138881cf770b1f6f3980){ .md-button .md-button--stretch } +
+ This role is not exposed by default. ## Deployment diff --git a/docs/sandbox/apps/plextraktsync.md b/docs/sandbox/apps/plextraktsync.md index df67210a8..8f3487812 100644 --- a/docs/sandbox/apps/plextraktsync.md +++ b/docs/sandbox/apps/plextraktsync.md @@ -8,6 +8,8 @@ tags: Self-hosted application that adds a two-way-sync between trakt.tv and Plex Media Server. It requires a trakt.tv account but no Plex premium and no Trakt VIP subscriptions, unlike the Plex app provided by Trakt. +
+ [:material-home: Homepage](https://github.com/Taxel/PlexTraktSync){ .md-button .md-button--stretch } [:material-bookshelf: Manual](https://github.com/Taxel/PlexTraktSync/blob/main/README.md#setup){ .md-button .md-button--stretch } @@ -16,6 +18,8 @@ Self-hosted application that adds a two-way-sync between trakt.tv and Plex Media [:fontawesome-brands-github: Community](https://github.com/Taxel/PlexTraktSync/discussions){ .md-button .md-button--stretch } +
+ --- ## Deployment diff --git a/docs/sandbox/apps/watchstate.md b/docs/sandbox/apps/watchstate.md index 7e7c49913..b5d9392c1 100644 --- a/docs/sandbox/apps/watchstate.md +++ b/docs/sandbox/apps/watchstate.md @@ -10,6 +10,8 @@ tags: This tool's primary goal is to sync your backends' play states without relying on third party services. Out of the box, it supports Jellyfin, Plex and Emby media servers. +
+ [:material-home: Homepage](https://github.com/arabcoders/watchstate){ .md-button .md-button--stretch } [:material-bookshelf: Manual](https://github.com/ArabCoders/watchstate/blob/master/FAQ.md){ .md-button .md-button--stretch } @@ -18,6 +20,8 @@ This tool's primary goal is to sync your backends' play states without relying o [:fontawesome-brands-discord: Community](https://discord.gg/haUXHJyj6Y){ .md-button .md-button--stretch } +
+ --- ## Deployment From 13d194a02f4c3f31d40bbe8dbb2ea3a86b9f90be Mon Sep 17 00:00:00 2001 From: owine Date: Sat, 12 Jul 2025 11:36:08 -0500 Subject: [PATCH 06/14] set explicit 2-column grid layout for buttons --- docs/sandbox/apps/chrome.md | 2 +- docs/sandbox/apps/plextraktsync.md | 2 +- docs/sandbox/apps/watchstate.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/sandbox/apps/chrome.md b/docs/sandbox/apps/chrome.md index 99fb0b5e7..cb78b3853 100644 --- a/docs/sandbox/apps/chrome.md +++ b/docs/sandbox/apps/chrome.md @@ -4,7 +4,7 @@ Headless container running Google Chrome. Useful for testing, filling out forms, This was created for use with Hoarder which calls for a specific version (123) -
+
[:material-bookshelf: Github Repo](https://github.com/jlandure/alpine-chrome/blob/master/Dockerfile){ .md-button .md-button--stretch } diff --git a/docs/sandbox/apps/plextraktsync.md b/docs/sandbox/apps/plextraktsync.md index 8f3487812..f22867c69 100644 --- a/docs/sandbox/apps/plextraktsync.md +++ b/docs/sandbox/apps/plextraktsync.md @@ -8,7 +8,7 @@ tags: Self-hosted application that adds a two-way-sync between trakt.tv and Plex Media Server. It requires a trakt.tv account but no Plex premium and no Trakt VIP subscriptions, unlike the Plex app provided by Trakt. -
+
[:material-home: Homepage](https://github.com/Taxel/PlexTraktSync){ .md-button .md-button--stretch } diff --git a/docs/sandbox/apps/watchstate.md b/docs/sandbox/apps/watchstate.md index b5d9392c1..4405ff085 100644 --- a/docs/sandbox/apps/watchstate.md +++ b/docs/sandbox/apps/watchstate.md @@ -10,7 +10,7 @@ tags: This tool's primary goal is to sync your backends' play states without relying on third party services. Out of the box, it supports Jellyfin, Plex and Emby media servers. -
+
[:material-home: Homepage](https://github.com/arabcoders/watchstate){ .md-button .md-button--stretch } From bab56a72eb0d8e6aac2073a75026d55ea23875b4 Mon Sep 17 00:00:00 2001 From: owine Date: Sat, 12 Jul 2025 11:39:39 -0500 Subject: [PATCH 07/14] clean up grid spacing to fix layout --- docs/sandbox/apps/chrome.md | 3 --- docs/sandbox/apps/plextraktsync.md | 5 ----- docs/sandbox/apps/watchstate.md | 5 ----- 3 files changed, 13 deletions(-) diff --git a/docs/sandbox/apps/chrome.md b/docs/sandbox/apps/chrome.md index cb78b3853..468895c72 100644 --- a/docs/sandbox/apps/chrome.md +++ b/docs/sandbox/apps/chrome.md @@ -5,11 +5,8 @@ Headless container running Google Chrome. Useful for testing, filling out forms, This was created for use with Hoarder which calls for a specific version (123)
- [:material-bookshelf: Github Repo](https://github.com/jlandure/alpine-chrome/blob/master/Dockerfile){ .md-button .md-button--stretch } - [:material-git: Google Artifact](https://console.cloud.google.com/artifacts/docker/zenika-hub/us/gcr.io/alpine-chrome/sha256:e38563d4475a3d791e986500a2e4125c9afd13798067138881cf770b1f6f3980){ .md-button .md-button--stretch } -
This role is not exposed by default. diff --git a/docs/sandbox/apps/plextraktsync.md b/docs/sandbox/apps/plextraktsync.md index f22867c69..859ac44f6 100644 --- a/docs/sandbox/apps/plextraktsync.md +++ b/docs/sandbox/apps/plextraktsync.md @@ -9,15 +9,10 @@ tags: Self-hosted application that adds a two-way-sync between trakt.tv and Plex Media Server. It requires a trakt.tv account but no Plex premium and no Trakt VIP subscriptions, unlike the Plex app provided by Trakt.
- [:material-home: Homepage](https://github.com/Taxel/PlexTraktSync){ .md-button .md-button--stretch } - [:material-bookshelf: Manual](https://github.com/Taxel/PlexTraktSync/blob/main/README.md#setup){ .md-button .md-button--stretch } - [:octicons-container-16: Releases](https://github.com/taxel/PlexTraktSync/pkgs/container/plextraktsync){ .md-button .md-button--stretch } - [:fontawesome-brands-github: Community](https://github.com/Taxel/PlexTraktSync/discussions){ .md-button .md-button--stretch } -
--- diff --git a/docs/sandbox/apps/watchstate.md b/docs/sandbox/apps/watchstate.md index 4405ff085..011184682 100644 --- a/docs/sandbox/apps/watchstate.md +++ b/docs/sandbox/apps/watchstate.md @@ -11,15 +11,10 @@ tags: This tool's primary goal is to sync your backends' play states without relying on third party services. Out of the box, it supports Jellyfin, Plex and Emby media servers.
- [:material-home: Homepage](https://github.com/arabcoders/watchstate){ .md-button .md-button--stretch } - [:material-bookshelf: Manual](https://github.com/ArabCoders/watchstate/blob/master/FAQ.md){ .md-button .md-button--stretch } - [:octicons-container-16: Releases](https://github.com/arabcoders/watchstate/pkgs/container/watchstate){ .md-button .md-button--stretch } - [:fontawesome-brands-discord: Community](https://discord.gg/haUXHJyj6Y){ .md-button .md-button--stretch } -
--- From 33d1831a8e1031436a8898fe11907ca886d91a21 Mon Sep 17 00:00:00 2001 From: owine Date: Sat, 12 Jul 2025 11:44:06 -0500 Subject: [PATCH 08/14] restore proper spacing for grid items --- docs/sandbox/apps/chrome.md | 3 +++ docs/sandbox/apps/plextraktsync.md | 5 +++++ docs/sandbox/apps/watchstate.md | 5 +++++ 3 files changed, 13 insertions(+) diff --git a/docs/sandbox/apps/chrome.md b/docs/sandbox/apps/chrome.md index 468895c72..cb78b3853 100644 --- a/docs/sandbox/apps/chrome.md +++ b/docs/sandbox/apps/chrome.md @@ -5,8 +5,11 @@ Headless container running Google Chrome. Useful for testing, filling out forms, This was created for use with Hoarder which calls for a specific version (123)
+ [:material-bookshelf: Github Repo](https://github.com/jlandure/alpine-chrome/blob/master/Dockerfile){ .md-button .md-button--stretch } + [:material-git: Google Artifact](https://console.cloud.google.com/artifacts/docker/zenika-hub/us/gcr.io/alpine-chrome/sha256:e38563d4475a3d791e986500a2e4125c9afd13798067138881cf770b1f6f3980){ .md-button .md-button--stretch } +
This role is not exposed by default. diff --git a/docs/sandbox/apps/plextraktsync.md b/docs/sandbox/apps/plextraktsync.md index 859ac44f6..f22867c69 100644 --- a/docs/sandbox/apps/plextraktsync.md +++ b/docs/sandbox/apps/plextraktsync.md @@ -9,10 +9,15 @@ tags: Self-hosted application that adds a two-way-sync between trakt.tv and Plex Media Server. It requires a trakt.tv account but no Plex premium and no Trakt VIP subscriptions, unlike the Plex app provided by Trakt.
+ [:material-home: Homepage](https://github.com/Taxel/PlexTraktSync){ .md-button .md-button--stretch } + [:material-bookshelf: Manual](https://github.com/Taxel/PlexTraktSync/blob/main/README.md#setup){ .md-button .md-button--stretch } + [:octicons-container-16: Releases](https://github.com/taxel/PlexTraktSync/pkgs/container/plextraktsync){ .md-button .md-button--stretch } + [:fontawesome-brands-github: Community](https://github.com/Taxel/PlexTraktSync/discussions){ .md-button .md-button--stretch } +
--- diff --git a/docs/sandbox/apps/watchstate.md b/docs/sandbox/apps/watchstate.md index 011184682..4405ff085 100644 --- a/docs/sandbox/apps/watchstate.md +++ b/docs/sandbox/apps/watchstate.md @@ -11,10 +11,15 @@ tags: This tool's primary goal is to sync your backends' play states without relying on third party services. Out of the box, it supports Jellyfin, Plex and Emby media servers.
+ [:material-home: Homepage](https://github.com/arabcoders/watchstate){ .md-button .md-button--stretch } + [:material-bookshelf: Manual](https://github.com/ArabCoders/watchstate/blob/master/FAQ.md){ .md-button .md-button--stretch } + [:octicons-container-16: Releases](https://github.com/arabcoders/watchstate/pkgs/container/watchstate){ .md-button .md-button--stretch } + [:fontawesome-brands-discord: Community](https://discord.gg/haUXHJyj6Y){ .md-button .md-button--stretch } +
--- From 8195a012ac45e032b450f5fbe7b214937a4b99e2 Mon Sep 17 00:00:00 2001 From: owine Date: Sat, 12 Jul 2025 11:47:34 -0500 Subject: [PATCH 09/14] use standard grid layout matching existing pages --- docs/sandbox/apps/chrome.md | 6 +++--- docs/sandbox/apps/plextraktsync.md | 10 +++++----- docs/sandbox/apps/watchstate.md | 10 +++++----- 3 files changed, 13 insertions(+), 13 deletions(-) diff --git a/docs/sandbox/apps/chrome.md b/docs/sandbox/apps/chrome.md index cb78b3853..89b2daa0c 100644 --- a/docs/sandbox/apps/chrome.md +++ b/docs/sandbox/apps/chrome.md @@ -4,11 +4,11 @@ Headless container running Google Chrome. Useful for testing, filling out forms, This was created for use with Hoarder which calls for a specific version (123) -
+
-[:material-bookshelf: Github Repo](https://github.com/jlandure/alpine-chrome/blob/master/Dockerfile){ .md-button .md-button--stretch } +[:material-bookshelf: Github Repo  ](https://github.com/jlandure/alpine-chrome/blob/master/Dockerfile){ .md-button .md-button--stretch } -[:material-git: Google Artifact](https://console.cloud.google.com/artifacts/docker/zenika-hub/us/gcr.io/alpine-chrome/sha256:e38563d4475a3d791e986500a2e4125c9afd13798067138881cf770b1f6f3980){ .md-button .md-button--stretch } +[:material-git: Google Artifact  ](https://console.cloud.google.com/artifacts/docker/zenika-hub/us/gcr.io/alpine-chrome/sha256:e38563d4475a3d791e986500a2e4125c9afd13798067138881cf770b1f6f3980){ .md-button .md-button--stretch }
diff --git a/docs/sandbox/apps/plextraktsync.md b/docs/sandbox/apps/plextraktsync.md index f22867c69..776d5fd63 100644 --- a/docs/sandbox/apps/plextraktsync.md +++ b/docs/sandbox/apps/plextraktsync.md @@ -8,15 +8,15 @@ tags: Self-hosted application that adds a two-way-sync between trakt.tv and Plex Media Server. It requires a trakt.tv account but no Plex premium and no Trakt VIP subscriptions, unlike the Plex app provided by Trakt. -
+
-[:material-home: Homepage](https://github.com/Taxel/PlexTraktSync){ .md-button .md-button--stretch } +[:material-home: Homepage  ](https://github.com/Taxel/PlexTraktSync){ .md-button .md-button--stretch } -[:material-bookshelf: Manual](https://github.com/Taxel/PlexTraktSync/blob/main/README.md#setup){ .md-button .md-button--stretch } +[:material-bookshelf: Manual  ](https://github.com/Taxel/PlexTraktSync/blob/main/README.md#setup){ .md-button .md-button--stretch } -[:octicons-container-16: Releases](https://github.com/taxel/PlexTraktSync/pkgs/container/plextraktsync){ .md-button .md-button--stretch } +[:octicons-container-16: Releases  ](https://github.com/taxel/PlexTraktSync/pkgs/container/plextraktsync){ .md-button .md-button--stretch } -[:fontawesome-brands-github: Community](https://github.com/Taxel/PlexTraktSync/discussions){ .md-button .md-button--stretch } +[:fontawesome-brands-github: Community  ](https://github.com/Taxel/PlexTraktSync/discussions){ .md-button .md-button--stretch }
diff --git a/docs/sandbox/apps/watchstate.md b/docs/sandbox/apps/watchstate.md index 4405ff085..be5609f90 100644 --- a/docs/sandbox/apps/watchstate.md +++ b/docs/sandbox/apps/watchstate.md @@ -10,15 +10,15 @@ tags: This tool's primary goal is to sync your backends' play states without relying on third party services. Out of the box, it supports Jellyfin, Plex and Emby media servers. -
+
-[:material-home: Homepage](https://github.com/arabcoders/watchstate){ .md-button .md-button--stretch } +[:material-home: Homepage  ](https://github.com/arabcoders/watchstate){ .md-button .md-button--stretch } -[:material-bookshelf: Manual](https://github.com/ArabCoders/watchstate/blob/master/FAQ.md){ .md-button .md-button--stretch } +[:material-bookshelf: Manual  ](https://github.com/ArabCoders/watchstate/blob/master/FAQ.md){ .md-button .md-button--stretch } -[:octicons-container-16: Releases](https://github.com/arabcoders/watchstate/pkgs/container/watchstate){ .md-button .md-button--stretch } +[:octicons-container-16: Releases  ](https://github.com/arabcoders/watchstate/pkgs/container/watchstate){ .md-button .md-button--stretch } -[:fontawesome-brands-discord: Community](https://discord.gg/haUXHJyj6Y){ .md-button .md-button--stretch } +[:fontawesome-brands-discord: Community  ](https://discord.gg/haUXHJyj6Y){ .md-button .md-button--stretch }
From 1d5e2b924dd1193c845ec622d9e67e264225cfbc Mon Sep 17 00:00:00 2001 From: owine Date: Sat, 12 Jul 2025 11:49:18 -0500 Subject: [PATCH 10/14] restore grid layout for index page cards --- docs/index.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/index.md b/docs/index.md index 2fe03b3dc..801d9f457 100644 --- a/docs/index.md +++ b/docs/index.md @@ -6,11 +6,15 @@ hide: ## Created with the help of +
+ - :simple-ansible: [**Ansible**](https://www.ansible.com/){target=_blank} - :simple-docker: [**Docker**](https://www.docker.com/){target=_blank} - :material-bash: [**Bash**](https://www.gnu.org/software/bash/){target=_blank} - :simple-python: [**Python**](https://www.python.org/){target=_blank} +
+ ### What is it? You can read more about what Saltbox is [here](saltbox/basics/basics.md). From 05a1e7516035c6ff52f93ac3ddb99dd14825945d Mon Sep 17 00:00:00 2001 From: owine Date: Sat, 12 Jul 2025 11:52:07 -0500 Subject: [PATCH 11/14] fix admonition content indentation --- docs/saltbox/install/install.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/saltbox/install/install.md b/docs/saltbox/install/install.md index de8456152..b9affcaaf 100644 --- a/docs/saltbox/install/install.md +++ b/docs/saltbox/install/install.md @@ -67,15 +67,15 @@ However, it is safe to run any saltbox tag[s] [including the install tags] at wi ??? info "What will I see in the terminal?" -Something like this: + Something like this: -``` -~$ curl -sL https://install.saltbox.dev | sudo -H bash && cd /srv/git/saltbox -jammy is currently supported. -x86_64 is currently supported. -Installing Saltbox Dependencies. -/srv/git/saltbox$ -``` + ``` + ~$ curl -sL https://install.saltbox.dev | sudo -H bash && cd /srv/git/saltbox + jammy is currently supported. + x86_64 is currently supported. + Installing Saltbox Dependencies. + /srv/git/saltbox$ + ``` !!! info See [here](../../reference/dependencies.md) for more information about the dependencies. From 2811a9bd12ce6b27200cc8b50e38f1b1be899280 Mon Sep 17 00:00:00 2001 From: owine Date: Sat, 12 Jul 2025 11:57:17 -0500 Subject: [PATCH 12/14] restore colored table styling for better readability --- docs/saltbox/inventory/index.md | 25 ++++++++++++++++++++----- 1 file changed, 20 insertions(+), 5 deletions(-) diff --git a/docs/saltbox/inventory/index.md b/docs/saltbox/inventory/index.md index 40c8947df..318c2e68e 100644 --- a/docs/saltbox/inventory/index.md +++ b/docs/saltbox/inventory/index.md @@ -54,11 +54,26 @@ The variables that can be used for customization within the Inventory are listed === "GitHub File View" - | Repository | Location | - |------------|----------| - | Saltbox | [:fontawesome-solid-folder-tree: https://github.com/saltyorg/Saltbox/tree/master/roles/](https://github.com/saltyorg/Saltbox/tree/master/roles)**<role_name>/defaults/main.yml** | - | Sandbox | [:fontawesome-solid-folder-tree: https://github.com/saltyorg/Sandbox/tree/master/roles/](https://github.com/saltyorg/Sandbox/tree/master/roles)**<role_name>/defaults/main.yml** | - | Global | [:fontawesome-solid-folder-tree: https://github.com/saltyorg/Saltbox/blob/master/inventories/group_vars/all.yml](https://github.com/saltyorg/Saltbox/blob/master/inventories/group_vars/all.yml) | + + + + + + + + + + + + + +
Saltbox + [:fontawesome-solid-folder-tree: https://github.com/saltyorg/Saltbox/tree/master/roles/](https://github.com/saltyorg/Saltbox/tree/master/roles)**<role_name>/defaults/main.yml** +
Sandbox + [:fontawesome-solid-folder-tree: https://github.com/saltyorg/Sandbox/tree/master/roles/](https://github.com/saltyorg/Sandbox/tree/master/roles)**<role_name>/defaults/main.yml** +
Global + [:fontawesome-solid-folder-tree: https://github.com/saltyorg/Saltbox/blob/master/inventories/group_vars/all.yml](https://github.com/saltyorg/Saltbox/blob/master/inventories/group_vars/all.yml) +
=== "File Path on Saltbox Host" From 0668b2c02cd2598e82b250f67264f54b9f442770 Mon Sep 17 00:00:00 2001 From: owine Date: Sat, 12 Jul 2025 12:15:52 -0500 Subject: [PATCH 13/14] convert color span to Markdown emphasis in actualbudget.md --- docs/sandbox/apps/actualbudget.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sandbox/apps/actualbudget.md b/docs/sandbox/apps/actualbudget.md index 02afb6e73..700220c30 100644 --- a/docs/sandbox/apps/actualbudget.md +++ b/docs/sandbox/apps/actualbudget.md @@ -18,4 +18,4 @@ To access Actual Budget, visit ``https://actualbudget._yourdomain.com_`` ## **3. Usage** -[Documentation: Actual Budget Docs](https://actualbudget.org/docs/) +**[Documentation: Actual Budget Docs](https://actualbudget.org/docs/)** From c4373848ac91137652140eb75de9ae477a5c1972 Mon Sep 17 00:00:00 2001 From: owine Date: Sat, 12 Jul 2025 12:26:23 -0500 Subject: [PATCH 14/14] replace HTML spans with Material Design icons in firefox.md Convert icon-indent-right spans to semantic Material Design icons for better accessibility and consistency with MkDocs Material theme. --- docs/sandbox/apps/firefox.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/sandbox/apps/firefox.md b/docs/sandbox/apps/firefox.md index bbdd715f3..29de332d1 100644 --- a/docs/sandbox/apps/firefox.md +++ b/docs/sandbox/apps/firefox.md @@ -52,11 +52,11 @@ sb install sandbox-firefox ## Usage -### Web +### :material-web: Web Visit `https://firefox._yourdomain.com_`. -### VNC +### :material-remote-desktop: VNC The role supports VNC access over an SSH tunnel (local port forwarding) to Saltbox.