Terminal til BookStack

Markdown for Dummies
Slik pusher du til BookStack fra terminalen
push_to_bookstack.sh – Forklaring
Readme.me
Markdown for Dummies
Slik pusher du til BookStack fra terminalen
push_to_bookstack.sh – Forklaring

Markdown for Dummies

Markdown er et lettvekts formateringsspråk som brukes til å skrive ren tekst med struktur. Dette er en nybegynnerguide.

Grunnleggende syntaks

Overskrifter

# H1
## H2
### H3

Tekstformatering

*kursiv* → *kursiv*  
**fet** → **fet**  
~~gjennomstreket~~ → ~~gjennomstreket~~

Lenker og bilder

[tekst](https://example.com)
![bilde](https://example.com/bilde.jpg)

Lister og kodeblokker

- punkt
1. nummerert

\`\`\`bash
echo "kode"
\`\`\`

"Simplicity is the ultimate sophistication." – Leonardo da Vinci

Slik pusher du til BookStack fra terminalen

Denne guiden forklarer steg-for-steg hvordan du går fra en lokal Markdown-fil til en publisert side i BookStack ved hjelp av Python og API.

1. Opprett API-token i BookStack

Gå til din profil → API Tokens
Lag en ny token og lagre ID og hemmelighet

2. Sett opp .env-fil (eller eksporter i shell)

export BOOKSTACK_TOKEN_ID="xxx"
export BOOKSTACK_TOKEN_SECRET="yyy"
export BOOKSTACK_BASE_URL="https://bookstack.dittdomene.com"

3. Python-script

Bruk requests til å gjøre en POST til /api/pages. Scriptet må inneholde:

Auth-header
book_id
markdown-innhold fra fil

4. Kjør script

python push_to_bookstack.py path/to/fil.md

✅ Ferdig! Sjekk at siden vises i riktig bok.

push_to_bookstack.sh – Forklaring

push_to_bookstack.sh – Forklaring linje for linje

Dette scriptet forenkler publisering til BookStack via terminalen.

1. Sjekk at miljøvariabler er satt

BOOKSTACK_TOKEN_ID
BOOKSTACK_TOKEN_SECRET
BOOKSTACK_BASE_URL

2. Script-innhold

#!/bin/bash
# Eksempel
BOOK_ID=28
TITLE="Min tittel"
MARKDOWN_FILE="$1"

python3 push_to_bookstack.py "$MARKDOWN_FILE" "$BOOK_ID" "$TITLE"

3. Tips

Bruk alias: alias protrusive='bash ~/scripts/push_to_bookstack.sh'
Sett filen som kjørbar: chmod +x push_to_bookstack.sh

Sist oppdatert: 2025-04-08

Readme.me

# 📚 Protrusive BookStack-verktøy

Dette prosjektet inneholder verktøy for å publisere innhold direkte til BookStack via terminalen. Alt er satt opp i et isolert Python-venv.

---

## 🟦 push_all.py

**Formål:** Publiserer ferdige `.md`-filer til boka `Terminal til BookStack`.

**Bruk:**
```bash
source .venv/bin/activate
python3 push_all.py
```

---

## 🟩 auto_push_episode.py

**Formål:** Genererer og publiserer en Protrusive Dental Podcast-episode til BookStack basert på URL.

**Bruk:**
```bash
source .venv/bin/activate
python3 auto_push_episode.py "https://protrusive.co.uk/episode-101"
```

---

## 📦 Installere avhengigheter (hvis nytt miljø)

```bash
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
```

---

## 🛠️ Filer

- `.env` – BookStack API-nøkler og base-URL
- `*.md` – Markdown-filer som push_all.py bruker
- `requirements.txt` – Avhengigheter
- `.venv/` – Virtuelt miljø (ikke last opp til Git)

---

## 💡 Tips

Legg til alias i `~/.bashrc` eller `~/.zshrc`:
```bash
alias activate_protrusive="cd ~/protrusive && source .venv/bin/activate"
```