MediaWiki Tutorials — Complete Project-Based Guide
In this tutorial series, you'll learn MediaWiki from zero by building a real project — your own documentation wiki.
MediaWiki is the engine that powers Wikipedia and thousands of other wikis worldwide. Unlike WordPress (built for blogging) or Drupal (built for enterprise content), MediaWiki is designed for collaborative knowledge building — where every reader can be an editor, every change is tracked, and nothing is ever lost.
What You'll Learn
- Install MediaWiki locally and configure Apache, PHP, and MySQL
- Create and format wiki pages with wikitext, tables, and media
- Organize content with namespaces, categories, subpages, and redirects
- Manage users with granular permissions, groups, and bot automation
- Extend MediaWiki with Semantic MediaWiki, VisualEditor, Scribunto, and more
- Maintain, back up, upgrade, and secure your production wiki
How to Use This Series
Each lesson builds on the previous one. Start with Module 1 if you are new to MediaWiki, or jump to any module that matches your skill level.
Module 1: Getting Started
| # | Lesson | What You'll Learn |
|---|---|---|
| 01 | What is MediaWiki | Wikipedia account, first edit, wiki concepts |
| 02 | Installation | XAMPP, download, web installer, LocalSettings.php |
Module 2: Content & Editing
| # | Lesson | What You'll Learn |
|---|---|---|
| 03 | Your First Page | Main Page, wikitext basics, page structure |
| 04 | Linking & Categories | Internal links, categories, category trees |
| 05 | Templates | Infoboxes, template parameters, reuse |
| 06 | Namespaces | Content vs talk namespaces, custom namespaces |
| 07 | Users & Permissions | User groups, blocking, rights management |
| 08 | Extensions | Installing and configuring extensions |
| 09 | Maintenance | Backup, restore, maintenance scripts |
| 10 | FAQ & Troubleshooting | Common problems and solutions |
Module 3: Advanced Content & Editing
| # | Lesson | What You'll Learn |
|---|---|---|
| 11 | Advanced Wikitext | Tables, lists, collapsible sections, magic words |
| 12 | Image & Media | File uploads, galleries, thumbnails, media settings |
| 13 | Transclusion | Templates with parameters, includeonly, noinclude |
| 14 | Parser Functions | if, switch, expr, time, custom parser functions |
Module 4: Organization & Workflow
| # | Lesson | What You'll Learn |
|---|---|---|
| 15 | Subpages | Parent-child pages, breadcrumbs, automatic navigation |
| 16 | Redirects | Page moves, redirects, double redirects, soft redirects |
| 17 | Wiki Categories | Tree categories, category sorting, hidden cats |
| 18 | Special Pages | AllPages, RecentChanges, custom special pages |
| 19 | Watchlist & Recent Changes | Monitoring, patrol, email notifications |
Module 5: Users & Groups
| # | Lesson | What You'll Learn |
|---|---|---|
| 20 | User Groups | Sysop, bureaucrat, bot, custom groups, permissions |
| 21 | User Rights | Fine-grained permissions, blocking, rights management |
| 22 | Email & Notifications | Email confirmation, Echo, digest notifications |
| 23 | Bots & Automation | Pywikibot, AutoWikiBrowser, bot passwords |
| 24 | User Preferences & Skins | Custom CSS, Vector skin, preference settings |
Module 6: Extensions
| # | Lesson | What You'll Learn |
|---|---|---|
| 25 | Extension Management | Extension registry, versioning, installation |
| 26 | Semantic MediaWiki | Structured data, properties, inline queries |
| 27 | VisualEditor | Parsoid, VE configuration, WYSIWYG editing |
| 28 | Scribunto & Lua | Lua modules, scribunto scripting, advanced templates |
| 29 | Cite & References | Footnotes, citation templates, CiteThisPage |
Module 7: Advanced Wiki Features
| # | Lesson | What You'll Learn |
|---|---|---|
| 30 | Interwiki Links | Interwiki prefixes, database config, Wikimedia |
| 31 | Wiki Farms | Multiple wikis, shared code, farm extensions |
| 32 | Content Translation | Translate extension, page translation workflow |
| 33 | Import & Export | XML export/import, page Migration, interwiki import |
| 34 | REST API | Action API, query modules, token authentication |
Module 8: Maintenance & Administration
| # | Lesson | What You'll Learn |
|---|---|---|
| 35 | Database Maintenance | Maintenance scripts, update.php, rebuild indexes |
| 36 | Logging & Monitoring | Log types, log search, Special:Log |
| 37 | Backup & Restore | XML dumps, database backups, file backups |
| 38 | Performance Tuning | Caching, JobQueue, profiling, FileCache |
| 39 | Upgrading MediaWiki | Version compatibility, upgrade procedure, testing |
| 40 | Security | Hardening, CSP, XSS, CAPTCHA, .htaccess |
What You'll Build
By the end of this series, you will build a complete documentation wiki:
- A fully configured wiki with custom namespaces and organized content structure
- User authentication with granular permissions for editors and administrators
- Custom templates using Scribunto Lua modules for dynamic content
- Semantic MediaWiki integration for structured data queries
- Automated backup and upgrade procedures
- Production server with caching, security, and monitoring
Let's begin with Lesson 1.
Published Topics
All 40 topics in MediaWiki Tutorials — Complete Project-Based Guide are published.