# Publishing On pve-t1

To jest proponowany model publikacji lokalnych dokumentow o Barcelonie na `pve-t1`.

## Dlaczego tak

- `pve-t1` juz jest w Tailscale i ma wlaczone `tailscaled`.
- Nie widac w repo gotowego ogolnego reverse proxy ani serwisu do statycznych plikow.
- Najprostsza i najmniej inwazyjna sciezka to osobny katalog ze statycznymi plikami + prosty lokalny HTTP server + `tailscale serve`.
- Dzieki temu linki przestaja prowadzic do internetu i zaczynaja prowadzic do Waszej kopii dokumentow w tailnecie.

## Proponowany docelowy uklad na serwerze

- katalog z plikami: `/srv/barcelona-docs`
- publikowany katalog: `/srv/barcelona-docs/barcelona`
- lokalny HTTP server na hoście: `127.0.0.1:38123`
- publiczny tailnet URL:
  `https://pve-t1.tail1cbf23.ts.net/barcelona/`

## Co juz jest przygotowane lokalnie

- komplet plikow do publikacji: `pve-site/barcelona`
- wersja pelna:
  `pve-site/barcelona/barcelona-atrakcje-wszystko-pl.md`
- wersja linkowana do `pve-t1`:
  `pve-site/barcelona/barcelona-atrakcje-linki-pve-t1-pl.md`
- osobne notatki o atrakcjach:
  `pve-site/barcelona/atrakcje/*.md`

## Sugerowane wdrozenie na pve-t1

### 1. Skopiuj pliki

Najczystszy wariant:

```bash
rsync -av /home/ja/Documents/Projects/barcelona-02-2026/pve-site/ root@100.109.116.112:/srv/barcelona-docs/
```

Po skopiowaniu na hoście powinno istniec:

```text
/srv/barcelona-docs/barcelona/
/srv/barcelona-docs/barcelona/atrakcje/
```

### 2. Uruchom prosty lokalny serwer HTTP na pve-t1

Wariant prosty:

```bash
python3 -m http.server 38123 --bind 127.0.0.1 --directory /srv/barcelona-docs
```

Wariant trwalszy:

- uzyj jednostki `systemd`, zeby nie trzymac tego w recznym shellu
- przyklad jednostki jest obok w pliku `barcelona-docs.service`

### 3. Wystaw to przez Tailscale Serve

Na `pve-t1`:

```bash
tailscale serve --bg 443 http://127.0.0.1:38123
```

Po tym URL-e powinny wygladac tak:

- `https://pve-t1.tail1cbf23.ts.net/barcelona/barcelona-atrakcje-wszystko-pl.md`
- `https://pve-t1.tail1cbf23.ts.net/barcelona/barcelona-atrakcje-linki-pve-t1-pl.md`
- `https://pve-t1.tail1cbf23.ts.net/barcelona/atrakcje/16-sagrada-familia.md`

## Dlaczego nie Forgejo

- `Forgejo` juz dziala na `docker-core`, ale to inna maszyna i inna usluga niz sam `pve-t1`.
- `Forgejo` lepiej nadaje sie do repo, historii i pracy nad plikami niz do prostego "tu sa lokalne notatki dla rodziny".
- ten wariant daje najprostszy, przewidywalny URL bez wiazania dokumentow z konkretnym repo i bez wymagania logowania do `Forgejo`.

## Ograniczenie na ten moment

- nie wdrozylem tego jeszcze zdalnie, bo aktualna proba wejscia na `pve-t1` zatrzymuje sie na dodatkowym zatwierdzeniu `Tailscale SSH` przez URL logowania
- same pliki i docelowa struktura sa juz przygotowane lokalnie