Obsidian-Hugo Sync

Obsidian vault szinkronizálása Hugo statikus weboldalra.

Mire való?

Ez a rendszer összeköti az Obsidian jegyzetelő alkalmazást egy Hugo statikus weboldallal. Amit Obsidianban megírsz, egy paranccsal feltöltheted a weboldaladra.

Telepítés

1. Klónozás

git clone https://github.com/felhasznalo/obsidian-hugo-sync.git
cd obsidian-hugo-sync

2. Vault inicializálás

chmod +x init-vault.sh
./init-vault.sh

A script interaktívan végigvezet a mappastruktúra létrehozásán.

3. Sync script beállítása

Másold a sync-to-hugo.sh fájlt a vault gyökerébe, majd szerkeszd a beállításokat:

REMOTE_USER=""           # SSH felhasználónév
REMOTE_HOST=""           # Szerver IP vagy domain
REMOTE_CONTENT=""        # Hugo content mappa útvonala
REMOTE_STATIC=""         # Hugo static mappa útvonala
SECTIONS=""              # Szekciók, szóközzel elválasztva

4. Templater beállítása

Obsidian > Settings > Templater > Template folder location:

03_archive/_templates

Mappastruktúra

vault/
├── 00_inbox/        <- Új tartalmak gyűjtőhelye
├── 01_working/      <- Aktív munkaterület
├── 02_publish/      <- Publikálásra kész tartalmak
│   ├── [szekciók]/
│   └── _assets/
│       ├── images/
│       └── audio/
├── 03_archive/      <- Lezárt, publikált anyagok
│   └── _templates/  <- Templater sablonok
└── sync-to-hugo.sh

Használat

Munkafolyamat

1. Új tartalom érkezik 00_inbox/ mappába
2. Feldolgozás közben 01_working/ mappában van
3. Amikor kész, átkerül 02_publish/[szekció]/ mappába
4. Frontmatterben: draft: false
5. Publikálás: ./sync-to-hugo.sh
6. Archiválás: 03_archive/ mappába

Publikálás

./sync-to-hugo.sh

A script:

• Megkeresi a draft: false fájlokat a 02_publish/ mappában
• Feltölti a szerverre rsync-kel
• Szinkronizálja a képeket és hangfájlokat

Frontmatter

Minden publikálandó fájl elején:

---
title: "Cím"
date: 2024-01-01T12:00:00+01:00
draft: true
---

A draft: false beállítással jelzed, hogy a fájl publikálásra kész.

Template-ek

Az init-vault.sh létrehozza a következő template-eket:

Template	Leírás
t-filozofia.md	Esszék, elmélkedések
t-vers.md	Versek, költemények
t-poszt.md	Blog bejegyzések
t-podcast.md	Podcast epizódok
t-idea.md	Ötletek, jegyzetek

Részletes leírás: 03_archive/_templates/_README.md

Követelmények

• Obsidian (Templater plugin)
• Hugo weboldal
• SSH hozzáférés a szerverhez
• rsync

Hibaelhárítás

A script nem fut

chmod +x sync-to-hugo.sh

SSH kapcsolat sikertelen

ssh-copy-id felhasznalo@szerver

Sortörések eltűnnek

A hugo.toml fájlban:

[markup.goldmark.renderer]
  hardWraps = true

Licenc

MIT