website/docs: ensure yaml code blocks have language tags (#9240)

Signed-off-by: Jens Langhammer <jens@goauthentik.io>

website/docs/core/certificates.md

@@ -42,7 +42,7 @@ You can also bind mount single files into the folder, as long as they fall under
 -   Files can be in any arbitrary file structure, and can have any extension.
 -   If the path contains `archive`, the files will be ignored (to better support certbot setups).
 
-```
+```shell
 certs/
 ├── baz
 │   └── bar.baz

website/docs/installation/kubernetes.md

@@ -21,7 +21,7 @@ You can also [view a video walk-through](https://www.youtube.com/watch?v=O1qUbrk
 
 Start by generating passwords for the database and cache. You can use either of the following commands:
 
-```
+```shell
 pwgen -s 50 1
 openssl rand -base64 36
 ```
@@ -62,7 +62,7 @@ See all configurable values on [ArtifactHub](https://artifacthub.io/packages/hel
 
 Now, execute the following commands to install authentik:
 
-```
+```shell
 helm repo add authentik https://charts.goauthentik.io
 helm repo update
 helm upgrade --install authentik authentik/authentik -f values.yaml

website/docs/providers/ldap/generic_setup.md

@@ -74,14 +74,14 @@ Test connectivity by using ldapsearch.
 :::info
 ldapsearch can be installed on Linux system with these commands
 
-```
+```shell
 sudo apt-get install ldap-utils -y # Debian-based systems
 sudo yum install openldap-clients -y # CentOS-based systems
 ```
 
 :::
 
-```
+```shell
 ldapsearch \
   -x \
   -H ldap://<LDAP Outpost IP address>:<Port number 389> \ # In production it is recommended to use SSL, which also requires `ldaps://` as the protocol and the SSL port

website/docs/releases/2023/v2023.10.md

@@ -43,7 +43,7 @@ This release does not introduce any new requirements.
 
 To upgrade, download the new docker-compose file and update the Docker stack with the new version, using these commands:
 
-```
+```shell
 wget -O docker-compose.yml https://goauthentik.io/version/2023.10/docker-compose.yml
 docker-compose up -d
 ```

website/docs/releases/2023/v2023.5.md

@@ -41,7 +41,7 @@ This release does not introduce any new requirements.
 
 To upgrade, download the new docker-compose file and update the Docker stack with the new version, using these commands:
 
-```
+```shell
 wget -O docker-compose.yml https://goauthentik.io/version/2023.5/docker-compose.yml
 docker-compose up -d
 ```

website/docs/releases/2023/v2023.6.md

@@ -27,7 +27,7 @@ This release does not introduce any new requirements.
 
 To upgrade, download the new docker-compose file and update the Docker stack with the new version, using these commands:
 
-```
+```shell
 wget -O docker-compose.yml https://goauthentik.io/version/2023.6/docker-compose.yml
 docker-compose up -d
 ```

website/docs/releases/2023/v2023.8.md

@@ -39,7 +39,7 @@ This release changes the PostgreSQL dependency to require Version 12 or later, w
 
 To upgrade, download the new docker-compose file and update the Docker stack with the new version, using these commands:
 
-```
+```shell
 wget -O docker-compose.yml https://goauthentik.io/version/2023.8/docker-compose.yml
 docker-compose up -d
 ```

website/docs/releases/2024/next.md

@@ -35,7 +35,7 @@ This release does not introduce any new requirements.
 
 To upgrade, download the new docker-compose file and update the Docker stack with the new version, using these commands:
 
-```
+```shell
 wget -O docker-compose.yml https://goauthentik.io/version/xxxx.x/docker-compose.yml
 docker compose up -d
 ```

website/docs/releases/2024/v2024.2.md

@@ -178,7 +178,7 @@ This release does not introduce any new requirements, but contains some breaking
 
 To upgrade, download the new docker-compose file and update the Docker stack with the new version, using these commands:
 
-```
+```shell
 wget -O docker-compose.yml https://goauthentik.io/version/2024.2/docker-compose.yml
 docker compose up -d
 ```

website/docs/releases/_template.md

@@ -15,7 +15,7 @@ This release does not introduce any new requirements.
 
 To upgrade, download the new docker-compose file and update the Docker stack with the new version, using these commands:
 
-```
+```shell
 wget -O docker-compose.yml https://goauthentik.io/version/xxxx.x/docker-compose.yml
 docker compose up -d
 ```

website/docs/releases/old/v0.10.md

@@ -42,7 +42,7 @@ By default, the new compose file uses a fixed version to prevent unintended upda
 
 Before updating the file, stop all containers. Then download the file, pull the new containers and start the database.
 
-```
+```shell
 docker-compose down
 docker-compose pull
 docker-compose up --no-start

website/docs/releases/old/v0.13.md

@@ -39,7 +39,7 @@ The only manual change you have to do is replace the `PASSBOOK_` prefix in your
 
 Additionally, the database name and username have to be changed, so add this block to your `.env` file:
 
-```
+```shell
 PG_USER=passbook
 PG_DB=passbook
 ```
@@ -50,7 +50,7 @@ Afterwards, you can simply run `docker-compose up -d` and then the normal upgrad
 
 The helm repository changes from passbook to authentik. To update your repository, execute these commands:
 
-```
+```shell
 helm repo remove passbook
 helm repo add authentik https://docker.beryju.org/chartrepo/authentik
 ```
@@ -68,7 +68,7 @@ postgresql:
 
 Afterwards you can upgrade as usual from the new repository:
 
-```
+```shell
 helm upgrade authentik authentik/authentik --devel -f values.yaml
 ```
 

website/docs/releases/old/v0.9.md

@@ -9,14 +9,14 @@ To export data from your old instance, run this command:
 
 -   docker-compose
 
-```
+```shell
 docker-compose exec server ./manage.py dumpdata -o /tmp/authentik_dump.json authentik_core.User authentik_core.Group authentik_crypto.CertificateKeyPair authentik_audit.Event otp_totp.totpdevice otp_static.staticdevice otp_static.statictoken
 docker cp authentik_server_1:/tmp/authentik_dump.json authentik_dump.json
 ```
 
 -   kubernetes
 
-```
+```shell
 kubectl exec -it authentik-web-... -- ./manage.py dumpdata -o /tmp/authentik_dump.json authentik_core.User authentik_core.Group authentik_crypto.CertificateKeyPair authentik_audit.Event otp_totp.totpdevice otp_static.staticdevice otp_static.statictoken
 kubectl cp authentik-web-...:/tmp/authentik_dump.json authentik_dump.json
 ```
@@ -25,14 +25,14 @@ After that, create a new authentik instance in a different namespace (kubernetes
 
 -   docker-compose
 
-```
+```shell
 docker cp authentik_dump.json new_authentik_server_1:/tmp/authentik_dump.json
 docker-compose exec server ./manage.py loaddata /tmp/authentik_dump.json
 ```
 
 -   kubernetes
 
-```
+```shell
 kubectl cp authentik_dump.json authentik-web-...:/tmp/authentik_dump.json
 kubectl exec -it authentik-web-... -- ./manage.py loaddata /tmp/authentik_dump.json
 ```

website/docs/troubleshooting/emails.md

@@ -8,7 +8,7 @@ Some hosting providers block outgoing SMTP ports, in which case you'll have to h
 
 To test if an email stage, or the global email settings are configured correctly, you can run the following command:
 
-```
+```shell
 ak test_email <to address> [-S <stage name>]
 ```
 
@@ -16,12 +16,12 @@ If you omit the `-S` parameter, the email will be sent using the global settings
 
 To run this command with docker-compose, use
 
-```
+```shell
 docker compose exec worker ak test_email [...]
 ```
 
 To run this command with Kubernetes, use
 
-```
+```shell
 kubectl exec -it deployment/authentik-worker -c authentik -- ak test_email [...]
 ```

website/docs/troubleshooting/ldap_source.md

@@ -4,24 +4,24 @@ title: Troubleshooting LDAP Synchronization
 
 To troubleshoot LDAP sources, you can run the command below to run a synchronization in the foreground and see any errors or warnings that might happen directly
 
-```
+```shell
 docker compose run --rm worker ldap_sync *slug of the source*
 ```
 
 or, for Kubernetes, run
 
-```
+```shell
 kubectl exec -it deployment/authentik-worker -c authentik -- ak ldap_sync *slug of the source*
 ```
 
 Starting with authentik 2023.10, you can also run command below to explicitly check the connectivity to the configured LDAP Servers:
 
-```
+```shell
 docker compose run --rm worker ldap_check_connection *slug of the source*
 ```
 
 or, for Kubernetes, run
 
-```
+```shell
 kubectl exec -it deployment/authentik-worker -c authentik -- ak ldap_check_connection *slug of the source*
 ```

website/docs/troubleshooting/login.md

@@ -10,19 +10,19 @@ This recovery key will give whoever has the link direct access to your instances
 
 To create the key, run the following command:
 
-```
+```shell
 docker compose run --rm server create_recovery_key 10 akadmin
 ```
 
 For Kubernetes, run
 
-```
+```shell
 kubectl exec -it deployment/authentik-worker -c authentik -- ak create_recovery_key 10 akadmin
 ```
 
 or, for CLI, run
 
-```
+```shell
 ak create_recovery_key 10 akadmin
 ```
 

website/docs/troubleshooting/missing_admin_group.md

@@ -6,12 +6,12 @@ If all of the Admin groups have been deleted, or misconfigured during sync, you
 
 Run the following command, where _username_ is the user you want to add to the newly created group:
 
-```
+```shell
 docker compose run --rm server create_admin_group username
 ```
 
 or, for Kubernetes, run
 
-```
+```shell
 kubectl exec -it deployment/authentik-worker -c authentik -- ak create_admin_group username
 ```

website/docs/troubleshooting/missing_permission.md

@@ -8,13 +8,13 @@ The error should be temporary and not occur after initial installation.
 
 If it does, you can run the following command to ensure all permissions exist:
 
-```
+```shell
 docker compose run --rm worker repair_permissions
 ```
 
 or, for Kubernetes, run
 
-```
+```shell
 kubectl exec -it deployment/authentik-worker -c authentik -- ak repair_permissions
 ```
 

website/docs/user-group-role/user/invitations.md

@@ -17,7 +17,7 @@ The fastest way to create an invitation is to use our pre-defined `default-enrol
 
 To download the `default-enrollment-flow` file, run this command:
 
-```
+```shell
 wget https://goauthentik.io/blueprints/example/flows-enrollment-2-stage.yaml
 ```
 

website/docs/user-group-role/user/user_ref.md

@@ -93,7 +93,7 @@ underneath `additionalHeaders`:
 
 #### Example:
 
-```
+```yaml
 additionalHeaders:
     REMOTE-USER: joe.smith
     REMOTE-EMAIL: joe@jsmith.com

website/docusaurus.config.ts

@@ -1,6 +1,6 @@
-const fs = require("fs").promises;
 import type { Config } from "@docusaurus/types";
 import type * as Preset from "@docusaurus/preset-classic";
+import { themes as prismThemes } from "prism-react-renderer";
 
 module.exports = async function (): Promise<Config> {
     const remarkGithub = (await import("remark-github")).default;
@@ -82,6 +82,8 @@ module.exports = async function (): Promise<Config> {
                 indexName: "goauthentik",
             },
             prism: {
+                theme: prismThemes.oneLight,
+                darkTheme: prismThemes.oneDark,
                 additionalLanguages: ["python", "diff", "json"],
             },
         },