====== 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 ====
<code>
/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
</code>

==== 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 ====
<code bash>
# 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
</code>

==== Step 2: Access URLs ====
**Direct Access:** https://wiki-novalia.drkatestone.duckdns.org/doku.php?id=PAGE_NAME  
**Edit Mode:** https://wiki-novalia.drkatestone.duckdns.org/doku.php?id=PAGE_NAME&do=edit

==== Step 3: Link from Main Page (Optional) ====
Add links to /var/www/wiki-novalia/data/pages/start.txt:
<code>
  * [[page_name|Display Name]]
</code>

===== DokuWiki Syntax Reference =====

==== Headers ====
<code>
====== Level 1 Header ======
===== Level 2 Header =====
==== Level 3 Header ====
=== Level 4 Header ===
== Level 5 Header ==
</code>

==== Text Formatting ====
<code>
**bold text**
//italic text//
__underlined text__
''monospaced text''
</code>

==== Lists ====
<code>
  * Bullet point
  * Another bullet
    * Sub-bullet
    * Another sub-bullet

  - Numbered list
  - Second item
    - Sub-item
    - Another sub-item
</code>

==== Links ====
<code>
[[page_name|Display Text]]           # Internal wiki link
[[page_name]]                        # Internal link (shows page name)
[[https://example.com|External]]     # External link
</code>

==== Code Blocks ====
<code>
Simple code block
</code>

For syntax highlighting:
<code bash>
#!/bin/bash
echo "Code with syntax highlighting"
</code>

==== Tables ====
<code>
^ Header 1 ^ Header 2 ^ Header 3 ^
| Cell 1   | Cell 2   | Cell 3   |
| Cell 4   | Cell 5   | Cell 6   |
</code>

===== Common Operations =====

==== Reading Existing Pages ====
<code bash>
# 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/
</code>

==== Editing Existing Pages ====
<code bash>
# 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'
</code>

==== Adding Images/Media ====
<code bash>
# 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}}
</code>

===== Example Page Creation =====

==== Complete Example ====
<code bash>
# 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)
</code>

//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:
<code bash>
# 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'
</code>

===== 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 ====
<code bash>
# 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"
</code>

===== 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:
  - Creating .txt files in /var/www/wiki-novalia/data/pages/
  - Using DokuWiki syntax for formatting
  - Setting proper permissions with www-data:www-data
  - Accessing via HTTPS URLs with ?id=page_name
  - Linking pages through internal link syntax [[page_name|display]]

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