Complete Tools Reference

Detailed documentation for all available tools in the MediaWiki Migration toolkit.

Quick Navigation: Migration Tools | Utility Tools | Setup Tools

🚀 Migration Tools

azure_devops_migrator.py Production Ready

Purpose: Main migration tool for transferring Azure DevOps Wiki content to MediaWiki.

Basic Usage

python migration/azure_devops_migrator.py --wiki "WikiName"

Command-Line Options

Option	Description	Default
`--wiki`	Name of the Azure DevOps wiki to migrate	Required
`--dry-run`	Preview migration without making changes	False
`--batch-size`	Number of pages to process at once	50
`--page`	Migrate specific page only	None
`--folder`	Migrate specific folder only	None
`--skip-validation`	Skip post-migration validation	False

Examples

# Dry run to preview migration
python migration/azure_devops_migrator.py --wiki "TeamDocs" --dry-run

# Migrate specific page
python migration/azure_devops_migrator.py --wiki "TeamDocs" --page "Setup Guide"

# Migrate in small batches
python migration/azure_devops_migrator.py --wiki "LargeWiki" --batch-size 10

# Migrate specific folder
python migration/azure_devops_migrator.py --wiki "TeamDocs" --folder "/Documentation"
                            

migration_planner.py Production Ready

Purpose: Analyses Azure DevOps Wiki structure and content to plan migration strategy.

Basic Usage

python migration/migration_planner.py --wiki "WikiName"

Command-Line Options

Option	Description	Default
`--wiki`	Name of the Azure DevOps wiki to analyse	Required
`--detailed`	Generate detailed analysis report	False
`--export-analysis`	Export analysis to JSON file	False
`--output`	Output file path for export	analysis.json

Analysis Output

Total page count and size
Content complexity score
Estimated migration time
Potential issues and warnings
Resource requirements

content_previewer.py Production Ready

Purpose: Preview how Azure DevOps content will appear after conversion to MediaWiki format.

Basic Usage

python migration/content_previewer.py --page "PageName"

Command-Line Options

Option	Description	Default
`--page`	Specific page to preview	None
`--sample-pages`	Number of random pages to preview	5
`--output-dir`	Directory to save preview files	./previews
`--format`	Output format (html, markdown, both)	both
`--verbose`	Show detailed conversion information	False

validation_tool.py Production Ready

Purpose: Validates migrated content for accuracy and completeness.

Basic Usage

python migration/validation_tool.py --wiki "WikiName"

Validation Checks

Page count verification
Content integrity checks
Link validation
Image reference verification
Template usage validation
Formatting consistency

Output

Generates validation_report.md with:

Summary statistics
List of issues found
Recommendations for fixes
Success/failure status for each page

🔧 Utility Tools

mediawiki_import.py Available

Purpose: Import templates and infoboxes into MediaWiki.

Location: templates/mediawiki_import.py

Features

Import Wikipedia templates
Convert template syntax
Handle template dependencies
Batch import support

generate_repolist_html.py Available

Purpose: Generate HTML documentation for repository catalogue.

Basic Usage

python generate_repolist_html.py

Generates the repository list page at docs/site/repolist.html

⚙️ Setup & Configuration Tools

getting_started.py Production Ready

Purpose: Interactive setup wizard for configuring the migration toolkit.

Basic Usage

python getting_started.py

Features

Interactive menu system
Environment detection
Automatic configuration file creation
Dependency checking
Test mode for development

Menu Options

📦 Azure DevOps Wiki Migration
🔄 Wiki Sync Tool
🎨 Template Import Tool
📊 Wiki Monitoring Dashboard
🛠️ Maintenance Scripts
ℹ️ About this Toolkit

Need Help? All tools support the --help flag for detailed usage information. For example:

python migration/azure_devops_migrator.py --help