Använd mallen

Bygg en sida för ditt lokala MeshCore-nätverk med samma upplägg som den här demon. Innehållet skrivs i Markdown och byggs till en statisk webbplats med Zensical. Inget eget serverprogram behövs.

Hämta mallen på Codeberg. Du kan använda filerna på Codeberg, en annan Forgejo-server eller GitHub.

Gör sidan till din

1. Skapa ett eget repository från mallen eller kopiera filerna, inklusive .forgejo/ för Codeberg eller .github/ för GitHub. Använd grenen main.

2. Ändra zensical.toml, till exempel:

   [project]
   site_name = "MeshCore i Mitt område"
   site_description = "Guider och lokal information för vårt MeshCore-nätverk."
   site_url = "https://mesh.example.org/"
   

   Behåll resten av konfigurationen, inklusive nav och temat. Byt exempeladressen till den adress du faktiskt ska publicera på. site_url anger webbplatsens fullständiga adress, med https:// och avslutande /. Om sidan ligger under /REPO/ ska även den delen ingå. 3. Ersätt platshållarna i startsidan, lokala inställningar och kontaktuppgifter. Ta bort demorutan i docs/index.md. 4. Välj publicering nedan och spara ändringarna på main.

template.meshat.se tillhör originalets demo. Använd din egen adress. Att ändra site_url registrerar ingen domän och skapar inga DNS-poster.

Codeberg Pages

Aktivera Actions och en tillgänglig runner för repot. Det medföljande arbetsflödet använder codeberg-small. Sätt exempelvis:

site_url = "https://DITT-KONTO.codeberg.page/REPO/"

Arbetsflödet .forgejo/workflows/bygg.yml använder site_url som publiceringsmål. Kontrollera körningen under Actions efter push till main. Du kan även starta arbetsflödet manuellt där.

Egen domän på Codeberg

För exempeladressen mesh.example.org, lägg in följande DNS-poster. Byt DITT-KONTO och REPO till ditt eget repository:

I Cloudflares zon example.org anger du namnen mesh respektive _git-pages-forge-allowlist.mesh. Använd DNS only för CNAME-posten.

Sätt site_url = "https://mesh.example.org/" och publicera. Arbetsflödet anger redan server: codeberg.page, även vid första publiceringen. Ingen .domains-fil behövs med denna metod.

För en rotdomän, exempelvis example.org, följ Codebergs anvisningar för DNS och egna domäner. Se även Forgejo Actions för Codeberg Pages.

Annan Forgejo-server

Forgejo är plattformen för koden och arbetsflödena. Webbhotellet väljs separat. Det medföljande arbetsflödet är anpassat till Codeberg Pages. På en annan Forgejo-instans behöver du välja dess runner och ersätta publiceringssteget med en metod som ditt webbhotell stöder.

Du kan också bygga själv:

uv sync --locked --python 3.12
uv run zensical build --clean --strict

Ladda upp innehållet i site/ till webbhotellets webbrot. Behåll katalogstrukturen.

Förhandsvisa lokalt med uv

Installera uv, öppna en terminal i projektet och kör:

uv sync --locked --python 3.12
uv run zensical serve

Öppna adressen som visas i terminalen. uv hanterar Python och projektets virtuella miljö. Beroendena finns i pyproject.toml och deras exakta versioner i uv.lock, som även används av arbetsflödena på Codeberg och GitHub.

GitHub Pages

1. Lägg filerna, inklusive .github/workflows/bygg.yml, i ditt GitHub-repository.
2. Välj Settings → Pages → Build and deployment → GitHub Actions.
3. Sätt site_url = "https://DITT-KONTO.github.io/REPO/" i zensical.toml.
4. Spara på main och följ publiceringen under Actions.

Egen domän på GitHub

1. Ange exempelvis mesh.example.org under Settings → Pages → Custom domain.
2. Lägg en CNAME-post för mesh hos DNS-leverantören som pekar på DITT-KONTO.github.io, utan repository-namn. I Cloudflare: DNS only.
3. Sätt site_url = "https://mesh.example.org/" och spara på main.
4. Aktivera Enforce HTTPS när GitHub erbjuder det.

Arbetsflödet använder GitHub Actions; ingen CNAME-fil behövs i repot. Codebergs TXT-post ovan används bara för Codeberg. För rotdomäner och fler detaljer, följ GitHubs domänanvisningar.

När din sida är klar

Ta gärna bort den här sidan och dess post Använd mallen i nav i zensical.toml. Behåll källhänvisningar och licensinformation enligt Källor och licens.