docs(kiosk): Updated escape sequence

.gitea/workflows/latest.yaml

@@ -26,4 +26,5 @@ jobs:
           push: true
           tags: |
             ${{ vars.REGISTRY }}/lfk/docs:latest
+            ${{ vars.REGISTRY }}/lfk/docs:main-${{ gitea.run_number }}
           platforms: linux/amd64,linux/arm64

Dockerfile

@@ -2,7 +2,7 @@ FROM hugomods/hugo:exts AS build
 WORKDIR /app
 
 COPY . /app/
-COPY .git /app/.git
+# COPY .git /app/.git
 RUN hugo
 
 FROM hugomods/hugo:nginx

config.yaml

@@ -7,7 +7,6 @@ module:
     - path: github.com/imfing/hextra
 
 enableRobotsTXT: true
-enableGitInfo: true
 hasCJKLanguage: true
 
 outputs:
@@ -61,10 +60,14 @@ menu:
       name: Scannerstationen
       pageRef: /scanstation
       weight: 4
+    - identifier: kiosk
+      name: Kiosk
+      pageRef: /kiosk
+      weight: 5
     - identifier: beamershow
       name: Beamershow
       pageRef: /beamershow
-      weight: 5
+      weight: 6
     - name: Suche
       identifier: search
       weight: 6
@@ -78,7 +81,6 @@ menu:
 
 params:
   description: Dokumentation für das Lauf für Kaya! Läufersystem.
-  displayUpdatedDate: true
   navbar:
     displayTitle: true
     displayLogo: true

content/_index.de.md

@@ -49,6 +49,12 @@ layout: hextra-home
     style="background: radial-gradient(ellipse at 50% 80%,rgba(59,221,210,0.15),hsla(0,0%,100%,0));"
     link="./scanstation"
   >}}
+  {{< hextra/feature-card
+    title="Kiosk"
+    subtitle="Anmeldekiosk für den Bürgerlauf vor Ort."
+    style="background: radial-gradient(ellipse at 50% 80%,rgba(53,142,74,0.15),hsla(0,0%,100%,0));"
+    link="./kiosk"
+  >}}
   {{< hextra/feature-card
     title="Beamershow"
     subtitle="Aktuelle Statistiken und Toplisten zum Event."

content/_index.en.md

@@ -49,6 +49,12 @@ layout: hextra-home
     style="background: radial-gradient(ellipse at 50% 80%,rgba(59,221,210,0.15),hsla(0,0%,100%,0));"
     link="./scanstation"
   >}}
+  {{< hextra/feature-card
+    title="Kiosk"
+    subtitle="Self-service kiosk for the citizen run on site."
+    style="background: radial-gradient(ellipse at 50% 80%,rgba(53,142,74,0.15),hsla(0,0%,100%,0));"
+    link="./kiosk"
+  >}}
   {{< hextra/feature-card
     title="Beamer Show"
     subtitle="Current statistics and top lists for the event."

content/kiosk/_index.de.md

@@ -0,0 +1,22 @@
+---
+linkTitle: "Kiosk"
+title: Kiosk
+weight: 1
+prev: /
+next: /kiosk/setup
+cascade:
+  type: docs
+---
+
+Der Kiosk kann verwendet werden, um sich vor Ort für die Veranstaltung anzumelden.
+Es handelt sich um eine Webanwendung, die auf jedem Gerät mit einem Webbrowser genutzt werden kann, ist jedoch hauptsächlich für die Verwendung mit dedizierter Hardware (z.B. Tablets) vorgesehen.
+Der Kiosk ist für den Einsatz im öffentlichen Raum konzipiert und sollte daher einfach zu bedienen sein und keine besonderen Kenntnisse oder Schulungen erfordern.
+
+## Bevorzugte Hardware
+
+Wir empfehlen Hardware, die über einen Touchscreen und eine Tastatur verfügt.
+Dies ermöglicht eine einfache Dateneingabe und macht den Kiosk benutzerfreundlicher.
+Die Hardware sollte außerdem robust sein und starker Beanspruchung standhalten können, da sie während der Veranstaltung von vielen Personen genutzt wird.
+
+Bonuspunkte, wenn das System einen Belegdrucker enthält, der es ermöglicht, Anmeldebelege direkt vom Kiosk auszudrucken.
+Diese Belege enthalten einen QR-Code, der bei der Anmeldung gescannt werden kann, um den Benutzer zu registrieren, und vom Benutzer, um auf unser Self-Service-Portal zuzugreifen.

content/kiosk/_index.en.md

@@ -0,0 +1,22 @@
+---
+linkTitle: "Kiosk"
+title: Kiosk
+weight: 1
+prev: /
+next: /kiosk/setup
+cascade:
+  type: docs
+---
+
+The kiosk can be used to sign up to the event on site.
+It's a web application that can be used on any device with a web browser, but is primarily intended for use with dedicated hardware (e.g. tablets).
+The kiosk is designed to be used in a public space, so it should be easy to use and not require any special knowledge or training.
+
+## Prefered Hardware
+
+We recomend hardware that has a touchscreen and a keyboard.
+This allows for easy input of data and makes the kiosk more user-friendly.
+The hardware should also be durable and able to withstand heavy use, as it will be used by many people during the event.
+
+Bonus points if the system includes a receipt printer, this allows for registration receipts to be printed directly from the kiosk.
+These receipts include a QR code that can be scanned at signup to register the user and by the user to access our self-service portal.

content/kiosk/setup.de.md

@@ -0,0 +1,84 @@
+---
+title: Kiosk Einrichtung
+weight: 2
+prev: /kiosk
+---
+
+So richten Sie den Kiosk für die Veranstaltung ein.
+
+## Mit Windows Assigned Access
+
+{{< callout type="info" >}}
+    Dies wurde nur auf Windows 11 Pro und Enterprise getestet.
+{{< /callout >}}
+
+### Voraussetzungen
+
+- Windows 11 Pro oder Enterprise
+- Nur ein konfigurierter Drucker oder Belegdrucker als Standarddrucker eingerichtet
+- Administratorzugriff auf das System
+
+### Einrichtung
+
+1. Laden Sie [psexec](/files/psexec.exe) herunter
+2. Öffnen Sie eine PowerShell mit Administratorrechten
+3. Wechseln Sie zum Download-Ordner `cd C:\Users\<Benutzername>\Downloads`
+4. Führe den psexec-Befehl aus: `.\psexec.exe -i -s powershell.exe`
+5. Führe das folgende Skript aus
+
+    ```powershell
+    $assignedAccessConfiguration = @"
+    <?xml version="1.0" encoding="utf-8"?>
+    <AssignedAccessConfiguration xmlns="http://schemas.microsoft.com/AssignedAccess/2017/config" xmlns:rs5="http://schemas.microsoft.com/AssignedAccess/201810/config" xmlns:v4="http://schemas.microsoft.com/AssignedAccess/2021/config">
+    <Profiles>
+        <Profile Id="{EDB3036B-780D-487D-A375-69369D8A8F78}">
+        <KioskModeApp v4:ClassicAppPath="%ProgramFiles(x86)%\Microsoft\Edge\Application\msedge.exe" v4:ClassicAppArguments="--kiosk https://kiosk.lauf-fuer-kaya.de/ --kiosk-printing --edge-kiosk-type=fullscreen" />
+        <v4:BreakoutSequence Key="Ctrl+E" />
+        </Profile>
+    </Profiles>
+    <Configs>
+        <Config>
+        <AutoLogonAccount rs5:DisplayName="Lfk Kiosk" />
+        <DefaultProfile Id="{EDB3036B-780D-487D-A375-69369D8A8F78}" />
+        </Config>
+    </Configs>
+    </AssignedAccessConfiguration>
+    "@
+
+    $namespaceName="root\cimv2\mdm\dmmap"
+    $className="MDM_AssignedAccess"
+    $obj = Get-CimInstance -Namespace $namespaceName -ClassName $className
+    $obj.Configuration = [System.Net.WebUtility]::HtmlEncode($assignedAccessConfiguration)
+    Set-CimInstance -CimInstance $obj
+    ```
+
+6. Öffne die Windows Befehlseingabe (cmd) mit Administratorrechten und führe diese Befehle aus, um den Energiesparmodus zu deaktivieren
+
+    ```batch
+    powercfg.exe -x -monitor-timeout-ac 0
+    powercfg.exe -x -monitor-timeout-dc 0
+    powercfg.exe -x -disk-timeout-ac 0
+    powercfg.exe -x -disk-timeout-dc 0
+    powercfg.exe -x -standby-timeout-ac 0
+    powercfg.exe -x -standby-timeout-dc 0
+    powercfg.exe -x -hibernate-timeout-ac 0
+    powercfg.exe -x -hibernate-timeout-dc 0
+    ```
+
+7. Reboot via `shutdown /r /t 0`
+
+### Deinstallation
+
+1. Um den Kiosk-Modus zu verlassen, drücken Sie "Strg+Alt+E"
+2. Öffnen Sie eine PowerShell mit Administratorrechten
+3. Wechseln Sie zum Desktop-Ordner (C:\Users\<Benutzername>\Desktop)
+4. Führen Sie den psexec-Befehl aus: `psexec.exe -i -s powershell.exe`
+5. Führen Sie das folgende Skript aus
+
+    ```powershell
+    $namespaceName="root\cimv2\mdm\dmmap"
+    $className="MDM_AssignedAccess"
+    $obj = Get-CimInstance -Namespace $namespaceName -ClassName $className
+    $obj.Configuration = $null
+    Set-CimInstance -CimInstance $obj
+    ```

content/kiosk/setup.en.md

@@ -0,0 +1,84 @@
+---
+title: Kisok Setup
+weight: 2
+prev: /kiosk
+---
+
+How to set up the kiosk for the event.
+
+## With Windows Assigned Access
+
+{{< callout type="info" >}}
+  This is only tested on windows 11 pro and enterprise.
+{{< /callout >}}
+
+### Prerequesites
+
+- Windows 11 Pro or Enterprise
+- Only one configured printer or receipt printer configured as default printer
+- Admin access to the system
+
+### Setup
+
+1. Download [psexec](/files/psexec.exe)
+2. Open a admin windows PowerShell prompt
+3. Cd to Downloads `cd C:\Users\<Username>\Downloads`
+4. Run the psexec command: `.\psexec.exe -i -s powershell.exe`
+5. Run the following script
+
+    ```powershell
+    $assignedAccessConfiguration = @"
+    <?xml version="1.0" encoding="utf-8"?>
+    <AssignedAccessConfiguration xmlns="http://schemas.microsoft.com/AssignedAccess/2017/config" xmlns:rs5="http://schemas.microsoft.com/AssignedAccess/201810/config" xmlns:v4="http://schemas.microsoft.com/AssignedAccess/2021/config">
+    <Profiles>
+        <Profile Id="{EDB3036B-780D-487D-A375-69369D8A8F78}">
+        <KioskModeApp v4:ClassicAppPath="%ProgramFiles(x86)%\Microsoft\Edge\Application\msedge.exe" v4:ClassicAppArguments="--kiosk https://kiosk.lauf-fuer-kaya.de/ --kiosk-printing --edge-kiosk-type=fullscreen" />
+        <v4:BreakoutSequence Key="Ctrl+E" />
+        </Profile>
+    </Profiles>
+    <Configs>
+        <Config>
+        <AutoLogonAccount rs5:DisplayName="Lfk Kiosk" />
+        <DefaultProfile Id="{EDB3036B-780D-487D-A375-69369D8A8F78}" />
+        </Config>
+    </Configs>
+    </AssignedAccessConfiguration>
+    "@
+
+    $namespaceName="root\cimv2\mdm\dmmap"
+    $className="MDM_AssignedAccess"
+    $obj = Get-CimInstance -Namespace $namespaceName -ClassName $className
+    $obj.Configuration = [System.Net.WebUtility]::HtmlEncode($assignedAccessConfiguration)
+    Set-CimInstance -CimInstance $obj
+    ```
+
+6. Open a new admin command prompt (cmd) an run these commands to turn off sleep
+
+    ```batch
+    powercfg.exe -x -monitor-timeout-ac 0
+    powercfg.exe -x -monitor-timeout-dc 0
+    powercfg.exe -x -disk-timeout-ac 0
+    powercfg.exe -x -disk-timeout-dc 0
+    powercfg.exe -x -standby-timeout-ac 0
+    powercfg.exe -x -standby-timeout-dc 0
+    powercfg.exe -x -hibernate-timeout-ac 0
+    powercfg.exe -x -hibernate-timeout-dc 0
+    ```
+
+7. Reboot via `shutdown /r /t 0`
+
+### Teardown
+
+1. To escape the experience press "Ctrl+E"
+2. Open a admin windows PowerShell prompt
+3. Cd to Desktop (C:\Users\<Username>\Desktop
+4. Run the psexec command: `psexec.exe -i -s powershell.exe`
+5. Run the following script
+
+    ```powershell
+    $namespaceName="root\cimv2\mdm\dmmap"
+    $className="MDM_AssignedAccess"
+    $obj = Get-CimInstance -Namespace $namespaceName -ClassName $className
+    $obj.Configuration = $null
+    Set-CimInstance -CimInstance $obj
+    ```

i18n/en.yaml

@@ -2,6 +2,7 @@ user: User
 admin: Administrators
 selfservice: Selfservice
 scanstation: Scanning Stations
+kiosk: Kiosk
 beamershow: Beamer Show
 search: Search
 editThisPage: "Edit this page →"