initial: zero-trust markdown tutorials site

Single-binary Go service that renders markdown pages from a runtime
volume mount. Targeted at public, no-auth, no-WAF deployment behind a
TLS ingress; security posture is defense-in-depth at every layer:

- goldmark with no WithUnsafe — raw HTML in author markdown is stripped
- CSP without 'unsafe-inline', plus HSTS, COOP, CORP, Permissions-Policy
- static handler rejects non-GET/HEAD, directory listings, dotfiles, traversal
- content loader rejects symlinks that escape the content root, dotfiles,
  and .md files larger than 1 MiB
- per-page template trees (cloned from layout) so define-blocks don't
  collide between home/category/page
- SIGHUP triggers atomic library swap — live edits on volume, no rebuild

Locale layout content/<locale>/<category>/<slug>.md. Categories without
_index.md still appear on the home page with a humanized name. Search is
a ~70-line vanilla JS scan over /search.json?lang=<locale>; swap for a
real indexer if the corpus ever balloons.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-05-13 00:52:53 +02:00
commit aa36b2905a
22 changed files with 1465 additions and 0 deletions
+14
View File
@@ -0,0 +1,14 @@
---
title: Instalace Minecraft klienta
summary: Nainstaluj si Minecraft a připoj se na naše servery.
order: 1
---
# Instalace Minecraft klienta
Vyber edici podle toho, co máš (nebo co chceš hrát offline):
- **Java Edition** — oficiální launcher od Mojangu. Nutný pro naše Fabric/Paper servery.
- **Bedrock Edition** — Windows/konzole/mobil. **Nepodporováno** na našich serverech.
Pokud Minecraft nevlastníš, podívej se na **offline (cracked) klient** — pořád si můžeš zahrát na serverech, které offline režim povolí (po registraci přes Discord).
+50
View File
@@ -0,0 +1,50 @@
---
title: Java Edition (oficiální launcher)
summary: Nainstaluj Mojang launcher a ověř, že tvůj účet funguje.
order: 1
---
# Java Edition (oficiální launcher)
Mojang/Microsoft launcher je jediná oficiálně podporovaná cesta jak hrát Java Edition.
## Stažení
1. Jdi na [minecraft.net/download](https://www.minecraft.net/cs-cz/download).
2. Stáhni launcher pro tvůj OS:
- **Windows:** `.msi` instalátor.
- **macOS:** `.dmg` obraz disku.
- **Linux:** `.deb`, `.tar.gz`, nebo přes balíčkovací systém distra (např. `sudo pacman -S minecraft-launcher` na Archu).
3. Spusť instalátor a launcher.
## Přihlášení
Potřebuješ **Microsoft účet** s licencí Minecraftu. Pokud jsi koupil Minecraft před rokem 2020 a stále používáš Mojang účet, launcher tě vyzve k migraci — postupuj podle pokynů. Migrace je zdarma.
Pokud vidíš "Failed to authenticate":
- Zkontroluj, že tvůj Microsoft účet nebyl přepnut na dětský účet nebo přesunut do rodinné skupiny bez přístupu k Minecraftu.
- Zkus [account.live.com/Authorize](https://account.live.com/Authorize) pro vyčištění tokenů.
## Vyber verzi
Naše servery běží na **Minecraft 1.21.4**. V launcheru:
1. Klikni **Installations** (nahoře).
2. **New installation**.
3. **Version** nastav na `release 1.21.4`.
4. Ulož — launcher si verzi stáhne při prvním spuštění.
## Připojení na server
1. V launcheru klikni **Play** na tvé `1.21.4` instalaci.
2. V Minecraftu: **Multiplayer****Add Server**.
3. Server name: cokoliv (např. "Survival").
4. Server address: adresa od admina (např. `survival.g.timemachine.center`).
5. **Done** → vyber server → **Join Server**.
## Co dál
- Pokud máš placený (Java) účet: nic — server tě rozezná automaticky a spawneš se do světa.
- Pokud placený účet nemáš: viz [offline klient](./offline-client).
- Tak jako tak — nejprve si zaregistruj jméno na Discordu — server tě o to požádá ještě než tě pustí dovnitř.
@@ -0,0 +1,52 @@
---
title: Offline (cracked) klient
summary: Zahraj si bez nákupu Minecraftu — open-source launcher.
order: 2
---
# Offline (cracked) klient
Pokud Minecraft nemáš, můžeš hrát na serverech, které offline režim povolí. Doporučujeme **Prism Launcher** — open-source, zdarma, dobře udržovaný.
> **Pozn.:** offline účty se nepřipojí na oficiální servery (Hypixel atd.). Fungují jen na serverech, které je explicitně povolí. Naše platforma podporuje obojí — při registraci na Discordu si vybereš typ účtu.
## Stažení Prism Launcher
1. Jdi na [prismlauncher.org](https://prismlauncher.org/).
2. Stáhni pro tvůj OS — Windows, macOS, Linux.
3. Nainstaluj a otevři.
## První spuštění
Při prvním spuštění Prism požaduje účet. Klikni **Skip** — offline profil přidáme za chvíli.
1. Vpravo nahoře: **Accounts****Add Offline**.
2. Username: musí odpovídat tomu, co si zaregistruješ na našem Discordu (316 znaků, písmena/čísla/podtržítka).
3. Ulož.
## Přidej Minecraft instalaci
1. Hlavní pohled: **Add Instance**.
2. Vyber **Vanilla** (nebo **Fabric**, pokud admin řekne).
3. Verze: **1.21.4**.
4. Pojmenuj (např. "automc Survival").
5. **OK**.
## Spuštění + připojení
1. Dvojklik na instanci.
2. Prism stáhne potřebné soubory (~100 MB).
3. V Minecraftu: **Multiplayer****Add Server** → adresa od admina.
4. Připoj se.
## Nejdřív registrace na Discordu
Než se připojíš, musíš si zaregistrovat jméno na našem Discordu:
1. Připoj se na Discord server (odkaz od admina).
2. Spusť `/register`.
3. Bot ti pošle DM — vyber **Offline** typ účtu.
4. Napiš stejné jméno, jaké máš v Prism.
5. Bot vygeneruje heslo — také ho pošle DM. Ulož si ho.
Po připojení na MC server se ozve LibreLogin — napíšeš `/login <heslo>` v chatu.
+14
View File
@@ -0,0 +1,14 @@
---
title: Install Minecraft client
summary: Get a working Minecraft client to connect to our servers.
order: 1
---
# Install Minecraft client
Pick the edition that matches what you bought (or want to play offline):
- **Java Edition** — official launcher from Mojang. Required for our Fabric/Paper servers.
- **Bedrock Edition** — Windows/console/mobile. Currently **not supported** by our servers.
If you don't own Minecraft, see the **offline (cracked) client** guide — you can still play on servers that allow offline mode after registering through Discord.
+50
View File
@@ -0,0 +1,50 @@
---
title: Java Edition (official launcher)
summary: Install the Mojang launcher and verify your account works.
order: 1
---
# Java Edition (official launcher)
The Mojang/Microsoft launcher is the only officially supported way to play Java Edition.
## Download
1. Go to [minecraft.net/download](https://www.minecraft.net/en-us/download).
2. Download the launcher for your OS:
- **Windows:** `.msi` installer.
- **macOS:** `.dmg` disk image.
- **Linux:** `.deb`, `.tar.gz`, or via your distro's package manager (e.g. `sudo pacman -S minecraft-launcher` on Arch).
3. Run the installer and launch it.
## Sign in
You need a **Microsoft account** with a Minecraft license attached. If you bought Minecraft before 2020 and still use a Mojang account, the launcher will prompt you to migrate — follow the steps. Migration is free.
If you see "Failed to authenticate":
- Check that your Microsoft account hasn't been switched to a child account or moved to a family group without Minecraft access.
- Try [account.live.com/Authorize](https://account.live.com/Authorize) to clear stale tokens.
## Pick a version
Our servers run **Minecraft 1.21.4**. In the launcher:
1. Click **Installations** (top of the launcher).
2. Click **New installation**.
3. Set **Version** to `release 1.21.4`.
4. Save — the launcher downloads it on first play.
## Connect to a server
1. From the launcher, click **Play** on your `1.21.4` installation.
2. In Minecraft: **Multiplayer****Add Server**.
3. Server name: anything (e.g. "Survival").
4. Server address: the address you got from the admin (e.g. `survival.g.timemachine.center`).
5. **Done** → select the server → **Join Server**.
## What's next
- If you have a paid (Java) account: nothing — the server recognizes you automatically and you'll spawn into the world.
- If you don't have a paid account: see the [offline client](./offline-client) guide.
- Either way, register your username on Discord first — the server will ask you to before it lets you in.
@@ -0,0 +1,52 @@
---
title: Offline (cracked) client
summary: Play without buying Minecraft, using a free open-source launcher.
order: 2
---
# Offline (cracked) client
If you don't own Minecraft, you can still play on our servers that allow offline mode. We recommend **Prism Launcher** — it's open-source, free, and well-maintained.
> **Note:** offline accounts can't connect to Mojang's official servers (Hypixel, etc.). They work only on servers that explicitly allow them. Our platform supports both — when you register on Discord, you choose "Offline" account type.
## Download Prism Launcher
1. Go to [prismlauncher.org](https://prismlauncher.org/).
2. Download for your OS — Windows, macOS, Linux.
3. Install + open.
## First-time setup
On first launch, Prism asks for an account. Click **Skip** for now — we'll add an offline profile after.
1. Top right: **Accounts****Add Offline**.
2. Username: must match what you'll register on our Discord (316 characters, letters/numbers/underscore).
3. Save.
## Add a Minecraft installation
1. Main view: click **Add Instance**.
2. Pick **Vanilla** (or **Fabric** if the admin tells you to).
3. Version: **1.21.4**.
4. Name it something memorable (e.g. "automc Survival").
5. Click **OK**.
## Launch + connect
1. Double-click your instance.
2. Prism downloads the assets first time (~100 MB).
3. In Minecraft: **Multiplayer****Add Server** → enter the address the admin gave you.
4. Connect.
## Register on Discord first
Before connecting, you must register your username on our Discord:
1. Join the Discord server (link from the admin).
2. Run `/register`.
3. The bot DMs you — pick **Offline** account type.
4. Type the same username you set in Prism.
5. The bot saves a password — also DMs it. Keep it.
When you join the MC server, it'll ask for the password in chat: type `/login <password>`.