ankn
a5f8fb49ab
Bahn: aisupport, Analyse-O2C-C2S, awesome-bahn-mcp-servers, beam-mcp,
Confluence_Bot, db-planet-mcp-server, O2C-Harness, project-audit,
Projekt-KIQ-HP, teamlandkarte-mcp
Dhive: Jury-Voting
Privat: CV, NoteGraph (NOTE: NoteGraph needs complete redo after consolidation)
Shared: AI-Orchestrator, OrgMyLife, power_skills_and_more
Shared/references: symphony (read-only)
Bahn repos remain available as independent remotes - this monorepo
pulls them in via subtree, the originals are untouched.
126 lines
2.8 KiB
Markdown
126 lines
2.8 KiB
Markdown
# Setting Up a New Confluence Project
|
|
|
|
Follow these steps to use this template for a new Confluence space.
|
|
|
|
## 1. Clone the Template
|
|
|
|
```bash
|
|
git clone https://github.com/DoctoDre/Confluence_Bot.git my-new-confluence-project
|
|
cd my-new-confluence-project
|
|
|
|
# Remove the original remote and set your own
|
|
git remote remove origin
|
|
git remote add origin https://github.com/YOUR_USER/my-new-confluence-project.git
|
|
```
|
|
|
|
## 2. Configure
|
|
|
|
### Set your Confluence details
|
|
|
|
Edit `config.ps1`:
|
|
```powershell
|
|
$ConfluenceUrl = "https://your-confluence-instance.com"
|
|
$SpaceKey = "YOUR_SPACE_KEY"
|
|
$RootPageId = "123456789" # Find this in the page URL
|
|
```
|
|
|
|
### Set your token
|
|
|
|
```bash
|
|
cp .secrets.example .secrets
|
|
# Edit .secrets and paste your Personal Access Token
|
|
```
|
|
|
|
**How to get a PAT:**
|
|
- Confluence Cloud: Profile → Settings → Personal Access Tokens → Create
|
|
- Confluence Server: Profile → Personal Access Tokens → Create
|
|
|
|
## 3. Test Connection
|
|
|
|
```powershell
|
|
powershell -ExecutionPolicy Bypass -File scripts/confluence-check.ps1
|
|
```
|
|
|
|
If successful, you'll see a list of child pages under your root page.
|
|
|
|
## 4. Initial Export (Optional)
|
|
|
|
```powershell
|
|
powershell -ExecutionPolicy Bypass -File scripts/confluence-export.ps1
|
|
```
|
|
|
|
This downloads the entire page tree for local analysis.
|
|
|
|
## 5. Push Content
|
|
|
|
Create markdown files in `/pages/`:
|
|
```
|
|
pages/
|
|
├── 01-overview.md
|
|
├── 02-architecture.md
|
|
└── 03-roadmap.md
|
|
```
|
|
|
|
Then push:
|
|
```powershell
|
|
powershell -ExecutionPolicy Bypass -File scripts/confluence-push.ps1
|
|
```
|
|
|
|
## 6. Set Up CI/CD (Optional)
|
|
|
|
### GitHub Actions
|
|
|
|
Add these secrets to your repo:
|
|
- `CONFLUENCE_TOKEN` — your PAT
|
|
|
|
Create `.github/workflows/confluence-push.yml`:
|
|
```yaml
|
|
name: Push to Confluence
|
|
|
|
on:
|
|
push:
|
|
paths: ['pages/**']
|
|
workflow_dispatch: {}
|
|
|
|
jobs:
|
|
push:
|
|
runs-on: windows-latest
|
|
steps:
|
|
- uses: actions/checkout@v4
|
|
- name: Write secrets
|
|
run: |
|
|
"CONFLUENCE_TOKEN=${{ secrets.CONFLUENCE_TOKEN }}" | Out-File .secrets -Encoding UTF8
|
|
- name: Push pages
|
|
run: powershell -ExecutionPolicy Bypass -File scripts/confluence-push.ps1
|
|
```
|
|
|
|
### GitLab CI
|
|
|
|
Add `CONFLUENCE_TOKEN` as a CI/CD variable, then create `.gitlab-ci.yml`:
|
|
```yaml
|
|
push-confluence:
|
|
stage: deploy
|
|
tags: [windows]
|
|
only:
|
|
changes:
|
|
- pages/**
|
|
script:
|
|
- echo "CONFLUENCE_TOKEN=$CONFLUENCE_TOKEN" > .secrets
|
|
- powershell -ExecutionPolicy Bypass -File scripts/confluence-push.ps1
|
|
```
|
|
|
|
## 7. Push to Your Repo
|
|
|
|
```bash
|
|
git add -A
|
|
git commit -m "Initial setup for my Confluence space"
|
|
git push -u origin main
|
|
```
|
|
|
|
## Tips
|
|
|
|
- **Page titles** come from the first `# Heading` in each markdown file
|
|
- **Idempotent** — running push multiple times won't create duplicates
|
|
- **Version tracking** — only updates pages when content actually changed
|
|
- **Safe** — never deletes pages unless you explicitly use the delete function
|