VuePress a první stránky

.gitignore

@@ -0,0 +1,5 @@
+.vercel
+node_modules
+.vuepress/.cache
+.vuepress/.temp
+.vuepress/dist

.vuepress/config.ts

@@ -0,0 +1,35 @@
+import { defaultTheme, defineUserConfig } from "vuepress";
+
+export default defineUserConfig({
+	lang: "cs-CZ",
+	title: "Wiki",
+	description: "",
+	theme: defaultTheme({
+		logo: '/assets/favicon.png',
+		navbar: [
+			{
+				text: 'Úvod',
+				link: '/',
+			},
+		],
+		sidebar: [
+			{
+				text: 'API',
+				link: '/api',
+				collapsible: true,
+				children: [
+					{text: 'Email', link: '/api/email'},
+					{text: 'QR', link: '/api/qr'}
+				]
+			},
+		  	{
+				text: 'Software',
+				link: '/software',
+				collapsible: true,
+				children: [
+					{text: 'Firefox', link: '/software/firefox'}
+				]
+			}
+		],
+	})
+});

.vuepress/styles/index.scss

@@ -0,0 +1,17 @@
+
+:root {
+	--c-brand: #d0204a;
+	--c-brand-light: #ca3f60;
+}
+
+html.dark {
+	--c-brand: #cf3559;
+	--c-brand-light: #ca3f60;
+	--c-bg: #0a0a0b;
+	--c-bg-light: #15181d;
+	--c-border: #1a1d20;
+}
+
+.page .theme-default-content {
+	padding-top: 2.5rem;
+}

README.md

@@ -0,0 +1,2 @@
+# Wiki
+

api/README.md

@@ -0,0 +1,14 @@
+# API
+
+Na doméně [**api.znachor.cz**](https://api.znachor.cz) provozuji kromě interních služeb také veřejné API endpointy, které můžete volně používat.
+
+Do budoucna je plánováno vytvoření rozhraní přímo na zmiňované doméně, kde bude možné endpointy interaktivně testovat.
+
+## Jak používat
+
+Na API je možno přistupovat pomocí `GET` i `POST`, můžete tedy použít to, co zrovna potřebujete. Data se odesílají pomocí `GET` parametrů nebo v případě `POST` ve formátu `application/x-www-form-urlencoded`.
+
+## Veřejné endpointy
+
+- [Email](/api/email.md)
+- [QR](/api/qr.md)

api/email.md

@@ -0,0 +1,33 @@
+# Email
+
+V této sekci najdete informace k **emailové API** která se nachází pod cestou `api.znachor.cz/email`.
+
+## Ověření emailu
+
+Tento endpoint slouží k ověřování platnosti emailové adresy. Konkrétně se kontroluje:
+- tvar emailu
+- MX záznamy domény
+- dostupnost emailových serverů
+
+**`API`** `/email/check`
+
+| parametr | typ | popis |
+| -------- | --- | ----- |
+| **email** | string | ověřovaný email |
+
+Ukázková odpověď
+
+```json
+{
+  "data": {
+    "user": "filip",
+    "host": "znachor.cz",
+    "mx_records": [
+      "mx.codespace.cz",
+      "mx2.codespace.cz"
+    ],
+    "valid": true,
+    "reachable": true
+  }
+}
+```

api/qr.md

@@ -0,0 +1,22 @@
+# QR
+
+V této sekci najdete informace ke **QR API** která se nachází pod cestou `api.znachor.cz/qr`.
+
+## Platební QR
+
+Tento endpoint slouží ke generaci platebních QR kódů ve formátu [SPAYD](https://wikijii.com/wiki/Short_Payment_Descriptor). Endpoint je dělaný čistě pro použití v prostředí ČR, proto zatím neumožnuje např. použití IBANu. V budoucnu bude nejspíše upraven.
+
+**`API`** `/qr/pay`
+
+| parametr | typ | popis |
+| -------- | --- | ----- |
+| **to** | string | bankovní číslo příjemce |
+| to_name | string | jméno příjemce |
+| currency | string | měna (např. CZK) |
+| amount | float | posílaná částka |
+| vs | int | variabilní symbol |
+| ks | int | konstantní symbol |
+| ss | int | specifický symbol |
+| message | string | zpráva pro příjemce |
+
+Tučně zvýrazněný parametr je povinný.

package.json

@@ -0,0 +1,7 @@
+{
+	"devDependencies": {
+		"@vuepress/client": "2.0.0-beta.60",
+		"vue": "^3.2.47",
+		"vuepress": "2.0.0-beta.60"
+	}
+}

software/README.md

@@ -0,0 +1,5 @@
+# Software
+
+Zde najdete návody k různému softwaru.
+
+- [Firefox](/software/firefox.md)

software/firefox.md

@@ -0,0 +1,28 @@
+# Firefox
+
+Oblíbený a rychlý webový prohlížeč zaměřený na soukromí. Více na [firefox.com](https://firefox.com).
+
+## Instalace a konfigurace
+
+Na svém [Gitu](https://git.znachor.cz/Znachor/Firefox) jsem vytvořil výchozí konfiguraci prohlížeče Firefox, které je zaměřená na soukromí a lepší zážitek z prohlížeče.
+
+Kromě konfigurace tam najdete taky doporučení na užitečná rozšíření.
+
+## Problémy
+
+Na Fedoře jsem narazil na několik problému s výkonem Firefoxu. Níže najdete, co bylo potřeba změnit.1
+
+### Hardwarová video akcelerace
+
+Díky hardwarové video akceleraci můžete na přehrávání videoobsahu použít GPU, pro aktivaci je potřeba:
+
+1) Nastavit `gfx.webrender.all` a `media.ffmpeg.vaapi.enabled` na `true` v `about:config`.
+2) Pokud používáte **Wayland**, tak je potřeba zapnout Wayland mode pomocí `MOZ_ENABLE_WAYLAND=1`.
+
+### Pomalé načítání stránek
+
+Ve Firefoxu se mi každá stránka načítá trochu pomaleji. Problém se objevuje po aktivaci rozšíření jako je uBlock Origin nebo I dont care about cookies. Zatím netuším, kde by mohl být problém.
+
+## Další zdroje
+
+Spoustu užitečných rad nejen ohledně Firefoxu na Linuxu najdete na [Arch Linux Wiki](https://wiki.archlinux.org/title/Firefox).