Site Tools


Hotfix release available: 2025-05-14b "Librarian". upgrade now! [56.2] (what's this?)
wiki_management_guide

Wiki Management Guide

Overview

This guide provides complete instructions for AI tools and users to add, edit, and access content in the Novalia Research Wiki.

Wiki URL: https://wiki-novalia.drkatestone.duckdns.org/ System: DokuWiki with HTTPS SSL security Last Updated: August 11, 2025

Directory Structure

File Locations

/var/www/wiki-novalia/                    # Main wiki directory
├── data/pages/                           # Wiki content files (.txt)
│   ├── start.txt                         # Main homepage
│   ├── hello_world.txt                   # Example test page
│   └── wiki_management_guide.txt         # This guide
├── data/media/                           # Images and attachments
└── conf/                                # Configuration files

Permission Requirements

  • Owner: www-data:www-data
  • Permissions: 644 for files, 755 for directories
  • Command: sudo chown www-data:www-data filename.txt

Creating New Wiki Pages

Step 1: Create the File

# Template for creating new pages:
sudo bash -c 'cat > /var/www/wiki-novalia/data/pages/PAGE_NAME.txt << "EOF"
====== Page Title ======
 
Your content here using DokuWiki syntax.
 
EOF'
 
# Set proper ownership:
sudo chown www-data:www-data /var/www/wiki-novalia/data/pages/PAGE_NAME.txt

Step 2: Access URLs

Add links to /var/www/wiki-novalia/data/pages/start.txt:

  * [[page_name|Display Name]]

DokuWiki Syntax Reference

Headers

====== Level 1 Header ======
===== Level 2 Header =====
==== Level 3 Header ====
=== Level 4 Header ===
== Level 5 Header ==

Text Formatting

**bold text**
//italic text//
__underlined text__
''monospaced text''

Lists

  * Bullet point
  * Another bullet
    * Sub-bullet
    * Another sub-bullet

  - Numbered list
  - Second item
    - Sub-item
    - Another sub-item
[[page_name|Display Text]]           # Internal wiki link
[[page_name]]                        # Internal link (shows page name)
[[https://example.com|External]]     # External link

Code Blocks

Simple code block

For syntax highlighting:

#!/bin/bash
echo "Code with syntax highlighting"

Tables

^ Header 1 ^ Header 2 ^ Header 3 ^
| Cell 1   | Cell 2   | Cell 3   |
| Cell 4   | Cell 5   | Cell 6   |

Common Operations

Reading Existing Pages

# View page content (raw text):
cat /var/www/wiki-novalia/data/pages/PAGE_NAME.txt
 
# List all pages:
ls -la /var/www/wiki-novalia/data/pages/
 
# Search for content:
grep -r "search_term" /var/www/wiki-novalia/data/pages/

Editing Existing Pages

# Edit via file system:
sudo nano /var/www/wiki-novalia/data/pages/PAGE_NAME.txt
 
# Or replace content:
sudo bash -c 'cat > /var/www/wiki-novalia/data/pages/PAGE_NAME.txt << "EOF"
New content here
EOF'

Adding Images/Media

# Copy images to media directory:
sudo cp image.png /var/www/wiki-novalia/data/media/
 
# Set ownership:
sudo chown www-data:www-data /var/www/wiki-novalia/data/media/image.png
 
# Reference in wiki:
{{image.png|Alt text}}

Example Page Creation

Complete Example

# Create a new research page:
sudo bash -c 'cat > /var/www/wiki-novalia/data/pages/research_notes.txt << "EOF"
====== Research Notes ======
 
===== Project Overview =====
This page contains research notes and findings.
 
**Date:** August 11, 2025  
**Status:** Active  
**Priority:** High
 
===== Key Findings =====
  * Important discovery #1
  * Critical insight #2
  * Next steps identified
 
===== References =====
  * [[patent_analysis|Patent Analysis]]
  * [[methodology|Research Methodology]]
  * [[https://example.com|External Source]]
 
===== Code Examples =====
<code python>
def analyze_patent(patent_id):
    return process_patent_data(patent_id)

Last updated: August 11, 2025 EOF'

# Set permissions: sudo chown www-data:www-data /var/www/wiki-novalia/data/pages/research_notes.txt

# Access at: https://wiki-novalia.drkatestone.duckdns.org/doku.php?id=research_notes </code>

Linking Pages

Adding to Main Navigation

Edit /var/www/wiki-novalia/data/pages/start.txt:

# Add link to start page:
sudo bash -c 'echo "" >> /var/www/wiki-novalia/data/pages/start.txt'
sudo bash -c 'echo "===== New Section =====" >> /var/www/wiki-novalia/data/pages/start.txt'
sudo bash -c 'echo "" >> /var/www/wiki-novalia/data/pages/start.txt'
sudo bash -c 'echo "  * [[page_name|Display Name]]" >> /var/www/wiki-novalia/data/pages/start.txt'

Troubleshooting

Common Issues

  • Page not showing: Check file permissions (www-data:www-data)
  • SSL errors: Use https: not http:
  • Edit conflicts: Only one person should edit at a time
  • Syntax errors: Validate DokuWiki syntax

Useful Commands

# Check wiki directory permissions:
ls -la /var/www/wiki-novalia/data/pages/
 
# Fix permissions for all wiki files:
sudo chown -R www-data:www-data /var/www/wiki-novalia/data/
 
# View Apache error logs:
sudo tail -f /var/log/apache2/wiki-novalia_error.log
 
# Test page accessibility:
curl -s "https://wiki-novalia.drkatestone.duckdns.org/doku.php?id=page_name"

Quick Reference Card

Task Command
Create page sudo bash -c 'cat > /var/www/wiki-novalia/data/pages/NAME.txt'
Set permissions sudo chown www-data:www-data /var/www/wiki-novalia/data/pages/NAME.txt
Access page https://wiki-novalia.drkatestone.duckdns.org/doku.php?id=NAME
Edit URL https://wiki-novalia.drkatestone.duckdns.org/doku.php?id=NAME&do=edit
List pages ls /var/www/wiki-novalia/data/pages/
View content cat /var/www/wiki-novalia/data/pages/NAME.txt

Security Notes

  • Wiki runs on HTTPS with valid SSL certificate
  • SSL certificate auto-renews (expires November 9, 2025)
  • File permissions are critical for security
  • Always use sudo for file operations
  • Regular backups recommended

For AI Tools

This wiki can be programmatically managed by:

  1. Creating .txt files in /var/www/wiki-novalia/data/pages/
  2. Using DokuWiki syntax for formatting
  3. Setting proper permissions with www-data:www-data
  4. Accessing via HTTPS URLs with ?id=page_name
  5. Linking pages through internal link syntax display

Always test page creation with a simple example before complex content.

wiki_management_guide.txt · Last modified: by 127.0.0.1