Migrate all repos into monorepo context folders
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.
This commit is contained in:
@@ -0,0 +1,125 @@
|
||||
# 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
|
||||
Reference in New Issue
Block a user