# Terminal til BookStack

# Markdown for Dummies

# Markdown for Dummies

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

## Grunnleggende syntaks

### Overskrifter
```markdown
# H1
## H2
### H3
```

### Tekstformatering
```markdown
*kursiv* → *kursiv*  
**fet** → **fet**  
~~gjennomstreket~~ → ~~gjennomstreket~~
```

### Lenker og bilder
```markdown
[tekst](https://example.com)
![bilde](https://example.com/bilde.jpg)
```

### Lister og kodeblokker
```markdown
- punkt
1. nummerert

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

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

# Slik pusher du til BookStack fra terminalen

# 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)
```bash
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
```bash
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
```bash
BOOKSTACK_TOKEN_ID
BOOKSTACK_TOKEN_SECRET
BOOKSTACK_BASE_URL
```

## 2. Script-innhold
```bash
#!/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"  
```

# Markdown for Dummies

# Markdown for Dummies

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

## Grunnleggende syntaks

### Overskrifter
```markdown
# H1
## H2
### H3
```

### Tekstformatering
```markdown
*kursiv* → *kursiv*  
**fet** → **fet**  
~~gjennomstreket~~ → ~~gjennomstreket~~
```

### Lenker og bilder
```markdown
[tekst](https://example.com)
![bilde](https://example.com/bilde.jpg)
```

### Lister og kodeblokker
```markdown
- punkt
1. nummerert

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

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

# Slik pusher du til BookStack fra terminalen

# 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)
```bash
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
```bash
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
```bash
BOOKSTACK_TOKEN_ID
BOOKSTACK_TOKEN_SECRET
BOOKSTACK_BASE_URL
```

## 2. Script-innhold
```bash
#!/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