Upload-Workflow¶

Upload konvertiert Ihre lokalen Markdown-Dateien in das Confluence Storage Format (XHTML) und veröffentlicht sie als Seiten in Ihrem Confluence Space.

Einfacher Upload¶

BashPowerShellCMD

dotnet run --project src/ConfluenceSynkMD -- \
  --mode Upload \
  --path ./docs \
  --conf-space DEV \
  --conf-parent-id 12345

dotnet run --project src/ConfluenceSynkMD -- `
  --mode Upload `
  --path ./docs `
  --conf-space DEV `
  --conf-parent-id 12345

dotnet run --project src/ConfluenceSynkMD -- ^
  --mode Upload ^
  --path .\docs ^
  --conf-space DEV ^
  --conf-parent-id 12345

Dies lädt alle .md-Dateien aus ./docs als Unterseiten der Seite 12345 im Space DEV hoch.

Docker-Upload¶

BashPowerShellCMD

```bash
docker run --rm -it \
    -e CONFLUENCE__BASEURL=https://yoursite.atlassian.net \
    -e CONFLUENCE__AUTHMODE=Basic \
    -e CONFLUENCE__USEREMAIL=user@example.com \
    -e CONFLUENCE__APITOKEN=ihr-token \
    -v ${PWD}:/workspace \
    confluencesynkmd \
    --mode Upload \
    --path /workspace/docs \
    --conf-space DEV \
    --conf-parent-id 12345
```

Pfad-Hinweis

-v ${PWD}:/workspace bleibt unverändert.
Passen Sie nur den Suffix von --path an (z. B. /workspace/docs).
${PWD} ist Ihr aktueller lokaler Ordner.

```powershell
docker run --rm -it `
    -e CONFLUENCE__BASEURL=https://yoursite.atlassian.net `
    -e CONFLUENCE__AUTHMODE=Basic `
    -e CONFLUENCE__USEREMAIL=user@example.com `
    -e CONFLUENCE__APITOKEN=ihr-token `
    -v ${PWD}:/workspace `
    confluencesynkmd `
    --mode Upload `
    --path /workspace/docs `
    --conf-space DEV `
    --conf-parent-id 12345
```

Pfad-Hinweis

-v ${PWD}:/workspace bleibt unverändert.
Passen Sie nur den Suffix von --path an (z. B. /workspace/docs).
${PWD} ist Ihr aktueller lokaler Ordner.

```cmd
docker run --rm -it ^
    -e CONFLUENCE__BASEURL=https://yoursite.atlassian.net ^
    -e CONFLUENCE__AUTHMODE=Basic ^
    -e CONFLUENCE__USEREMAIL=user@example.com ^
    -e CONFLUENCE__APITOKEN=ihr-token ^
    -v %cd%:/workspace ^
    confluencesynkmd ^
    --mode Upload ^
    --path /workspace/docs ^
    --conf-space DEV ^
    --conf-parent-id 12345
```

Pfad-Hinweis

-v %cd%:/workspace bleibt unverändert.
Passen Sie nur den Suffix von --path an (z. B. /workspace/docs).
%cd% ist Ihr aktueller lokaler Ordner.

Hierarchischer Upload¶

Standardmäßig erhält ConfluenceSynkMD Ihre lokale Verzeichnisstruktur als Eltern-Kind-Seitenbaum (--keep-hierarchy ist standardmäßig true).

docs/
├── getting-started.md      → Kind der Elternseite
├── guides/
│   ├── setup.md            → Kind der "guides"-Indexseite
│   └── advanced.md         → Kind der "guides"-Indexseite
└── api/
    └── endpoints.md        → Kind der "api"-Indexseite

Um alle Seiten flach unter die Wurzelseite zu legen:

BashPowerShellCMD

--skip-hierarchy

--skip-hierarchy

--skip-hierarchy

Root-Page verwenden¶

Statt --conf-parent-id können Sie eine Wurzelseite per Titel angeben. Existiert sie nicht, wird sie erstellt:

BashPowerShellCMD

--root-page "Meine Dokumentation"

--root-page "Meine Dokumentation"

--root-page "Meine Dokumentation"

Unveränderte Seiten überspringen¶

Mit --skip-update werden Seiten nicht erneut hochgeladen, deren Inhalt sich nicht geändert hat:

BashPowerShellCMD

--skip-update

--skip-update

--skip-update

Seitentitel-Prefix¶

Fügen Sie allen hochgeladenen Seitentiteln ein Prefix hinzu:

BashPowerShellCMD

--title-prefix "[AUTO] "

--title-prefix "[AUTO] "

--title-prefix "[AUTO] "

Generated-By-Marker¶

Standardmäßig fügt ConfluenceSynkMD einen Generated-By-Info-Makro oben auf jeder Seite ein. Anpassen oder deaktivieren:

BashPowerShellCMD

# Benutzerdefinierte Vorlage
--generated-by "Auto-generiert aus %{filepath}"

# Marker deaktivieren
--generated-by ""

# Benutzerdefinierte Vorlage
--generated-by "Auto-generiert aus %{filepath}"

# Marker deaktivieren
--generated-by ""

REM Benutzerdefinierte Vorlage
--generated-by "Auto-generiert aus %{filepath}"

REM Marker deaktivieren
--generated-by ""

Platzhalter: %{filepath}, %{filename}, %{filedir}, %{filestem}.

Page-ID Write-Back¶

Nach dem Upload schreibt ConfluenceSynkMD Confluence Page-IDs als HTML-Kommentare zurück in Ihre Markdown-Dateien:

<!-- confluence-page-id: 12345 -->
<!-- confluence-space-key: DEV -->

Zum Deaktivieren:

BashPowerShellCMD

--no-write-back

--no-write-back

--no-write-back

Debug-Modus¶

Für die Fehlerbehebung bei Konvertierungsproblemen:

BashPowerShellCMD

--debug-line-markers --loglevel debug

--debug-line-markers --loglevel debug

--debug-line-markers --loglevel debug