Sanitized mirror from private repository - 2026-04-20 01:32:01 UTC
This commit is contained in:
67
archive/dokuwiki/README.md
Normal file
67
archive/dokuwiki/README.md
Normal file
@@ -0,0 +1,67 @@
|
||||
# DokuWiki Documentation Format
|
||||
|
||||
This directory contains the homelab documentation formatted for DokuWiki. DokuWiki uses a different syntax than standard Markdown.
|
||||
|
||||
## 📁 File Structure
|
||||
|
||||
- `start.txt` - Main documentation index page
|
||||
- `services-popular.txt` - Popular services guide
|
||||
- `services-individual-index.txt` - **NEW!** Complete index of all 159 individual service docs
|
||||
- `getting-started-quick-start.txt` - Quick start guide
|
||||
|
||||
## 🔧 How to Use
|
||||
|
||||
### Option 1: Copy Individual Files
|
||||
1. Copy the `.txt` files to your DokuWiki `data/pages/` directory
|
||||
2. Create appropriate subdirectories (e.g., `services/`, `getting-started/`)
|
||||
3. Access via your DokuWiki web interface
|
||||
|
||||
### Option 2: Bulk Import
|
||||
1. Create the following directory structure in your DokuWiki:
|
||||
```
|
||||
data/pages/homelab/
|
||||
├── start.txt
|
||||
├── services/
|
||||
│ └── popular.txt
|
||||
├── getting-started/
|
||||
├── infrastructure/
|
||||
├── admin/
|
||||
├── troubleshooting/
|
||||
└── advanced/
|
||||
```
|
||||
|
||||
2. Copy files to appropriate directories
|
||||
3. Access at `http://your-dokuwiki/doku.php?id=homelab:start`
|
||||
|
||||
## 🎨 DokuWiki Syntax Used
|
||||
|
||||
- `======` for main headings
|
||||
- `=====` for subheadings
|
||||
- `====` for sub-subheadings
|
||||
- `^` for table headers
|
||||
- `|` for table cells
|
||||
- `[[namespace:page|Link Text]]` for internal links
|
||||
- `<code>` blocks for code examples
|
||||
- `//italic//` and `**bold**` for emphasis
|
||||
|
||||
## 🔄 Converting from Markdown
|
||||
|
||||
Key differences from Markdown:
|
||||
- Headers use `=` instead of `#`
|
||||
- Tables use `^` for headers and `|` for cells
|
||||
- Links use `[[]]` syntax
|
||||
- Code blocks use `<code>` tags
|
||||
- Lists use ` *` (two spaces + asterisk)
|
||||
|
||||
## 📝 Customization
|
||||
|
||||
You can customize these files for your DokuWiki installation:
|
||||
- Update internal links to match your namespace structure
|
||||
- Modify styling and formatting as needed
|
||||
- Add your own branding or additional content
|
||||
|
||||
## 🔗 Related
|
||||
|
||||
- Main documentation: `../docs/`
|
||||
- Joplin format: `../joplin/`
|
||||
- Original repository structure: `../`
|
||||
Reference in New Issue
Block a user