WikiRevamp

2026-02-19T19:05:33Z

Jmtd: import pandoc conversion

'''Note: this was generated using pandoc to convert MoinMoin's HTML rendering directly into mediawiki syntax. This is an experiment to check fidelity.'''

<div id="content" dir="ltr" lang="en">
 
In DebConf25, a BOF was dedicated to discuss the state of the Debian Wiki. Known historical issues were summarized, in particular: 

* the wiki relies on old software 
* there are no clear guidelines on the scope of wiki content 
* there is no "default" license, most of the pages don't specify one and the few who specify use a number of them. As a consequence, most of the pages probably do not comply with DFSG 
* there is no clear way to handle communications about the wiki 

See also: [https://salsa.debian.org/debconf-team/public/data/dc25/-/blob/main/etherpad/txt/146-debian-wiki-bof.txt Pad from the BOF] 

In the following days action was taken about this. 

<div class="table-of-contents">
Contents

# [[#Participating|Participating]]
# [[#Communication|Communication]]
# [[#Software_migration|Software migration]]
# [[#Content_licensing|Content licensing]]
## [[#Choice_of_license|Choice of license]]
## [[#Old_content|Old content]]
## [[#New_content|New content]]
# [[#Recommendations_and_mass-edits|Recommendations and mass-edits]]
## [[#Specific_mass-edits|Specific mass-edits]]
## [[#Responding_to_a_mass-edit|Responding to a mass-edit]]
# [[#Other_conversations|Other conversations]]
## [[#Debian_Bug_Links|Debian Bug Links]]
## [[#Migrating_user_accounts|Migrating user accounts]]
## [[#Boilerplate_page_headers|Boilerplate page headers]]
## [[#Translations|Translations]]
## [[#Editorial_tasks_.28e.g._CategoryProposedDeletion.29|Editorial tasks (e.g. CategoryProposedDeletion)]]
## [[#Scope|Scope]]
## [[#Milestones_and_gamification|Milestones and gamification]]
## [[#Automated_edits_with_bots|Automated edits with bots]]
## [[#Interwiki_links_vs_templates|Interwiki links vs templates]]
# [[#See_also|See also]]

</div>


== Participating ==


Want to help? See the section below on channels of communication. On IRC, you can ask how you can help and participate in discussions regarding migration and licensing. 

== Communication ==


The [https://lists.debian.org/debian-wiki debian-wiki@lists.debian.org] was created to discuss the Wiki, in addition to the [ircs://irc.oftc.net/debian-wiki #debian-wiki] IRC channel. If you want to participate, you are encouraged to subscribe to both means of communication as discussions often occur on either one. 

== Software migration ==


During the BOF, the possibility of a migration to MediaWiki was brought up, a well-established wiki platform already being used by many others like Wikipedia and the Arch Wiki. 

Since then, @taavi has worked with DSA to setup mozart.d.o, a machine running Debian Trixie that hosts a MediaWiki instance. It can be accessed at https://wiki2025.debian.org/. '''Do not begin to migrate content here yet, it may be wiped without notice.''' 

Currently, the plan is to migrate most pages to the MediaWiki instance using tools being developed by @guillem and @maytham, which will retain edit history as well as convert content to MediaWiki syntax as a final edit at the end. This is achieved by accessing the internal file-based database for [[MoinMoin|MoinMoin]]. You can find a demonstration of this on [https://wiki2025.debian.org/wiki/FreedomBox FreedomBox (new wiki)], where [https://wiki2025.debian.org/index.php?title=FreedomBox&action=history edit history] has been retained. 

Current resources for conversion: 

* @guillem: [https://salsa.debian.org/guillem/mm2mw/ Debian fork of mm2mw Perl scripts] for migrating with both history and syntax conversion 
* @maytham: [https://salsa.debian.org/Maytha8/wiki-scripts/ shell scripts] to retain history but without syntax conversion 
* @sunilmohan: https://salsa.debian.org/sunilmohan/moinmoin_to_mediawiki/ (based on a tool to generate the [[FreedomBox|FreedomBox]] Manual PDF) 
* @AndrewSayers: [https://salsa.debian.org/AndrewSayers/mediawiki-recommendations/ mediawiki-recommendations] (a counterpart to the [[DebianWiki/WikiRevamp/Recommendations|recommendations page]]) 

The configuration and extensions for the new instance have not been finalised yet. @maytham is [https://salsa.debian.org/Maytha8/DebianWiki working on an extension] to provide the Debian navbar that is present on many other Debian sites. New extensions require manual intervention by DSA, which can take some time, especially if they are not packaged. 

See also: ''[https://lists.debian.org/debian-wiki/2025/07/threads.html#00007 MediaWiki next steps]'' 

== Content licensing ==


The migration provides a good opportunity to think about the long-standing licensing problems that mean content from the wiki cannot really be reused or redistributed legally. 

Since 24 July 2025, new content on the existing wiki uses [[copyright.html|CC BY-SA 4.0]] unless otherwise noted, so non-copyrighted work will gradually be replaced even without migrating. 

The migration will most likely work like previous migrations between [[MoinMoin|MoinMoin]] versions - the old edit history is retained, and a new edit updates the formatting. That ensures the migration to MediaWiki isn't blocked on the time-consuming process of rewriting content, but licensing issues will only fade away gradually over the years. 

=== Choice of license ===


The Creative Commons Attribution-ShareAlike 4.0 license was agreed upon between participants in the mailing list and IRC because: 

* it is designed for and applies to content, rather than other licenses that are aimed at software. 
* requires [https://wiki.debian.org/copyright.html#Re-use_of_content attribution] for contributors' hard work. 
* ensures any adaptations of the work remain CC BY-SA 4.0, preventing someone taking the work and making it proprietary. 
* relatively permissive and is compatible with GPL-3. 

'''Why not public domain / CC Zero?''' The license chosen should generally require attribution. Virtually no content from other sources/sites could be copied to the wiki because nothing is compatible with public domain except other public domain content. 

'''Why not Expat (MIT)?''' This license is intended for software. Licenses like the Creative Commons licenses were created specifically with non-software works in mind. Note that the Debian website (www.debian.org) uses this though. 

'''Why not GFDL?''' In 2006, Debian Developers [https://www.debian.org/vote/2006/vote_001 moved a General Resolution] that concluded the GFDL is not a DFSG-compatible license, except when it is used without any of its invariant options. It is also much more restrictive, reducing the possibility of using wiki content elsewhere, like manual pages or official documentation. 

'''Why not CC's NC or ND options?''' These are not DFSG-compatible. 

See also: ''[https://lists.debian.org/debian-wiki/2025/07/msg00005.html Re: Content licensing]'' 

=== Old content ===


@maytham is leading an ongoing [https://salsa.debian.org/Maytha8/wiki-relicensing/ relicensing effort] to contact previous contributors and obtain permission for their work to be relicensed under CC BY-SA 4.0. 

=== New content ===


Notices have been added to the current wiki so that any contribution submitted after 24 July 2025 00:00 UTC is released under the CC BY-SA 4.0, ''unless otherwise noted''. A [[copyright.html|copyright.html]] page has also been written up with details on how to be compliant with the license 

== Recommendations and mass-edits ==


Before we can migrate the wiki, we need to identify all the ways it will behave differently, and work out how to convert those differences. For example, the current wiki has "discussion" pages that end with <code>/Discussion</code> and are linked from within the page body. The equivalent MediaWiki convention is for "Talk" pages to begin with <code>Talk:</code>, <code>Category_talk:</code> etc. and be linked from the menu above the page body. Rules and recommended processes are being written up in [[DebianWiki/WikiRevamp/Recommendations|DebianWiki/WikiRevamp/Recommendations]]. 

Several differences involve converting loose editing conventions to automated rules, by writing pattern-matching code and doing mass-edits to ensure every case matches the pattern. For example, "discussion" links are added by individual editors with page-specific styling, every instance of which will need to be removed during the migration. To achieve that, we plan to change all discussion links to [[HelpOnProcessingInstructions#supplementation|supplementation page instructions]] that can be easily removed during the migration process. Tools for these conversions are available in [https://salsa.debian.org/AndrewSayers/mediawiki-recommendations/ the mediawiki-recommendations repository]. 

=== Specific mass-edits ===


A "mass-edit" is the process of editing many (usually tens or hundreds) of pages at once. Unlike normal edits, they are generally at least partially automated, and aimed at formatting issues instead of content. The term "mass-edit" is a reference to MediaWiki's [https://www.mediawiki.org/wiki/Extension:MassEditRegex MassEditRegex extension]. 

; #language tags (2025-08-17)
: Many pages have a processing instruction like <code>#language pt_BR</code>. This edit changed about 15 pages with errors in their processing instructions. See [https://lists.debian.org/debian-wiki/2025/08/msg00028.html mailing list message]. 
; Category footers (2025-08-17)
: Categories are generally appended to pages after a [[HelpOnRules|horizontal rule]] with four dashes. This edit changed about 620 pages with issues that made it harder to detect the category list. See [https://lists.debian.org/debian-wiki/2025/08/msg00028.html mailing list message]. 
; <<FullSearch>> (2025-09-06 to 2025-09-07)
: [[HelpOnMacros#A:.2BAH4:text.3DFullSearch|MoinMoin's <<FullSearch>> macro]] doesn't have a direct MediaWiki alternative, so we will need to convert it differently depending on its contents. This edit changed about 130 pages to reduce the number of patterns we need to consider. See [https://lists.debian.org/debian-wiki/2025/09/msg00000.html mailing list message]. 
; Translation page names (2025-10-04)
: Translations should have page names that resemble each other, but many pages don't fit the pattern (e.g. because the translation hasn't been updated since the English version was renamed). This edit renamed about 100 pages to fit the normal naming convention. See [https://lists.debian.org/debian-wiki/2025/09/msg00013.html the mailing list message]. 
; Non-wiki #format's (between 2026-02-20 and 2026-02-21)
: MoinMoin's [[HelpOnProcessingInstructions#A.23format|#format processing instruction]] isn't widely used, and adds another special case to the migration process. Use a page-wide [[HelpOnParsers#highlight_parser|#!highlight block]] instead. See [https://lists.debian.org/debian-wiki/2026/02/msg00002.html the mailing list message]. 



=== Responding to a mass-edit ===


If you expect an upcoming mass-edit to affect a lot of pages you maintain, consider making a rule to ignore e-mails with the subject <code>Update of ".*" by <author></code> and a date within the specified range, where <author> is the wiki name of the person doing the edit (e.g. AndrewSayers). 

If you object to an upcoming mass-edit, contact the mailing list (preferably in a reply to the edit's thread) before the edit occurs, and explain your objection. We'll talk through the issue and look for suitable ways to change the upcoming edit. If you're having difficulty phrasing your objection, it's fine to just say "I need time to think through the implications, please postpone by a week", then write a longer reply a few days later. 

If you object to a previous mass-edit, contact the mailing list (preferably in a reply to the edit's thread) after reverting the change, and explain your objection. We'll talk through the issue and look for solutions (e.g. a new mass-edit to fix other pages). Editors are usually notified about changes to pages they've edited, but a mass-edit that affects a thousand pages will generate notifications for all future changes to all thousand pages, so you shouldn't assume the mass-editor has seen your reversion. 

== Other conversations ==


[[File:/htdocs/debwiki/img/alert.png|16x16px|/!\]] This section attempts to summarise conversations from the [https://lists.debian.org/debian-wiki mailing list] and [ircs://irc.oftc.net/debian-wiki IRC channel]. It will always be somewhat out-of-date and incomplete. 

=== Debian Bug Links ===


The current wiki renders Debian and Ubuntu bugs specially - links get a <code>title</code> and closed bugs are struck through. For example, the following bugs should be struck through, and you should see a custom title when you hover over them: [https://bugs.debian.org/399237 Debian Bug #399237] [https://bugs.launchpad.net/bugs/1597017 Launchpad bug 1597017]. 

This is implemented by including [https://salsa.debian.org/debian/wiki.debian.org/-/blob/master/usr/htdocs/bugstatus.js bugstatus.js] in every page, which scans the HTML for appropriate links and sends requests to [https://salsa.debian.org/debian/wiki.debian.org/-/blob/master/bin/bugstatus the bugstatus script] and [https://salsa.debian.org/debian/wiki.debian.org/-/blob/master/bin/launchpad the launchpad script]. The bugstatus script in turn uses the [[DebbugsSoapInterface|Debbugs SOAP interface]], while the launchpad script uses [https://pypi.org/project/launchpadlib/ launchpadlib]. 

MediaWiki alternatives to this solution include: 

<code>MediaWiki:Common.js</code> is a JavaScript file included on every page in a wiki. This is the most direct translation, but can be hard to manage because of the temptation to put unrelated content in the same file. 

[https://www.mediawiki.org/wiki/Extension:Gadgets The Gadgets extension] is a more powerful alternative to <code>MediaWiki:Common.js</code>, and seems like the natural choice for a MediaWiki equivalent of the current implementation. 

[https://www.mediawiki.org/wiki/Manual:$wgEnableScaryTranscluding Scary Transcluding] lets you include pages and templates from other wikis. Data is cached, with [https://www.mediawiki.org/wiki/Manual:$wgEnableScaryTranscluding a configurable timeout]. For example, this would let us run an internal service that generates HTML from some pre-existing Perl library, then transclude that HTML into ordinary wiki pages. It's the wrong tool for this particular job, but may be worth revisiting if other use cases pop up. 

[https://www.mediawiki.org/wiki/Extension:Cargo The Cargo extension] lets MediaWiki store and query data in an internal database, which could potentially be synchronised with an external database somehow. But Cargo has a poor security reputation, and synchronising data could be awkward. 

[https://www.mediawiki.org/wiki/Extension:External_Data The External Data extension] lets MediaWiki interrogate external sources like the [[UltimateDebianDatabase|Ultimate Debian Database]]. This would let us render links server-side instead of in JavaScript, but would introduce questions around caching. Allowing the wiki to query the UDD opens up a lot of interesting possibilities, and this might be a good way to make that possible. This is the solution we currently expect to use. 

See also: [https://lists.debian.org/debian-wiki/2025/07/msg00054.html DebianBug links] on the mailing list. 

=== Migrating user accounts ===


The plan is to switch from [[MoinMoin|MoinMoin]]'s built-in user database to Salsa accounts, so people will need to [https://salsa.debian.org/users/sign_up create a Salsa account]. 

The suggested solution is to disable creation of new wiki accounts at some point, give people Salsa accounts with the same username as the wiki, and ask them to change their information if they want. 

See also: [https://lists.debian.org/debian-wiki/2025/07/msg00073.html How to manage new Salsa accounts with the new wiki] on the mailing list. 

=== Boilerplate page headers ===


Pages often start with some boilerplate text (e.g. translation headers). Putting a common header template on all pages would make it easier to manage that text. See [https://wiki2025.debian.org/wiki/Template:PageHeader the PageHeader template] for an initial demonstration. 

This has been mentioned in passing, but no decision has been made. 

=== Translations ===


We plan to install MediaWiki's [https://www.mediawiki.org/wiki/Help:Extension:Translate Translate Extension] to handle translation. Benefits of this extension include: 

* no need to maintain a 'TAG:TRANSLATION-HEADER' block - just add <code><languages /></code> to the top of the page, and the rest is handled automatically 
** see e.g. the "Languages" block at the top of [https://www.mediawiki.org/wiki/Help:Extension:Translate Translate Extension] 
* provides advanced translation tools, like showing how complete a translation is and suggesting machine translations 
* may be familiar to people coming here from other MediaWiki-based wikis 

We could avoid the need to add <code><languages /></code> by installing MediaWiki's [https://www.mediawiki.org/wiki/Extension:UniversalLanguageSelector Universal Language Selector Extension] and enabling [https://www.mediawiki.org/wiki/Help:Extension:Translate/Configuration#:~:text=$wgTranslatePageTranslationULS wgTranslatePageTranslationULS]. To see how this works, go to [https://en.wikipedia.org/wiki/Debian Debian's Wikipedia page] and click on the [[File:https://en.wikipedia.org/w/load.php?modules=skins.vector.icons&image=language&variant=progressive&format=original&lang=en&skin=vector-2022&version=bayjp|class=external_image|https://en.wikipedia.org/w/load.php?modules=skins.vector.icons&image=language&variant=progressive&format=original&lang=en&skin=vector-2022&version=bayjp]] Languages button near the top of the page. 

An alternative would be to write our own custom templates (see [https://wiki2025.debian.org/wiki/ExampleForTranslation ExampleForTranslation]). They would have no external dependencies and we could modify them more easily, but they'd be harder to maintain and wouldn't have as many features. 

Another alternative is [https://wiki.openstreetmap.org/wiki/Template:Languages OpenStreetMap's languages template]. This uses a [https://wiki.openstreetmap.org/wiki/Module:Languages Lua module], so it only requires the common [https://www.mediawiki.org/wiki/Module Scribunto] extension. It would probably produce a better result than custom templates, but doesn't provide the advanced tools in MediaWiki's solution. 

We plan to include a template to link to localised versions of pages. So for example, if you're translating <code>Page1</code> and find a link to <code>Page2</code>, <code>{{ll|Page2}}</code> will update automatically when translations of <code>Page2</code> are added or removed - see [https://www.mediawiki.org/wiki/Template:Localized_link MediaWiki's Localized link template], [https://wiki2025.debian.org/wiki/Template:ll the custom ll template], and [https://wiki.openstreetmap.org/wiki/Template:LL OpenStreetMap's LL template]. 

See also: [https://lists.debian.org/debian-wiki/2025/08/msg00005.html Info request on new Wiki translations - any automatic handling of translation headers and translated pages?]. 


=== Editorial tasks (e.g. CategoryProposedDeletion) ===


In the current wiki, pages are added to [[DebianWiki/Administration#Current_tasks|editorial categories]] like [[CategoryProposedDeletion|CategoryProposedDeletion]], with the expectation the editorial work will be made at some future date. That editorial process is discussed in [[DebianWiki/EditorGuide|the editor guide]]. 

MediaWiki makes it easy to create more verbose and precise admonitions, with guidance on the page itself - see [https://wiki2025.debian.org/wiki/ExampleForProposedDeletion ExampleForProposedDeletion]. 

See also: [https://lists.debian.org/debian-wiki/2025/07/msg00068.html IRC summary: Issues around CategoryProposedDeletion]. 

=== Scope ===


Discussion on the scope of the wiki is ongoing, but still in early stages. Most of it is happening in ''[https://lists.debian.org/debian-wiki/2025/08/msg00015.html aims of the wiki?]'' on the mailing list. 

A draft for guidelines were published at [[MaythamAlsudany/DraftContentGuidelines|MaythamAlsudany/DraftContentGuidelines]] and is [[MaythamAlsudany/DraftContentGuidelines/Discussion|open for discussion]]. 

=== Milestones and gamification ===


By default, MediaWiki notifies you when you make round-numbered edits (1st, 10th, 100th etc.). This can be disable by going to [https://wiki2025.debian.org/wiki/Special:Preferences#mw-prefsection-echo event preferences] and disabling "Edit milestone", but there doesn't seem to be a way to disable this by default for new users. 

=== Automated edits with bots ===


We don't have bots making edits to the current wiki, but some proposals for the new wiki would benefit from automated edits. 

[[DebianWiki/WikiRevamp#Debian_Bug_Links|Debian Bug Links]] can be implemented without JavaScript, so long as editors write links as <code>{{DebianBug|NNN}}</code> instead of <code>[[DebianBug:NNN]]</code> or <code>https://bugs.debian.org/NNN</code>. That's more likely to happen if a bot fixes those links automatically. 

[[DebianWiki/WikiRevamp#Boilerplate_page_headers|Boilerplate page headers]] (e.g. [[DebianWiki/WikiRevamp#Translations|translations]]) need to be added to the top of each page. Having a bot do that is probably easier than educating each new editor that comes along. 

[[DebianWiki/WikiRevamp#Editorial_tasks_.28e.g._CategoryProposedDeletion.29|Editorial tasks]] involve scheduling some action for a particular future date (e.g. deleting a page if nobody objects for one month). Automating those actions would give everyone more certainty about the issue, and might mean non-admin users don't need permission to delete pages themselves. 

An alternative would be to encourage people to help clean up the wiki in general, rather than just focus on their little corner of it. This hasn't worked before, because doing so is less inherently rewarding, risks treading on others' toes, and is unnecessarily hard work in MoinMoin. 

This hasn't had its own dedicated discussion, and no decision has been made. 

=== Interwiki links vs templates ===


The current wiki's [[InterWikiMap|InterWikiMap]] is quite large, and [[DebianWiki/WikiRevamp#Debian_Bug_Links|Debian Bug Links]] shows there's interest in pushing beyond what it's designed to handle. [https://www.mediawiki.org/wiki/Manual:Interwiki MediaWiki interwiki links] can only be changed by editing a database table, so a direct translation would be harder to use than the current solution. 

Templates are more flexible than interwiki links, and more familiar to users. So far, nobody has objected to the idea of converting interwiki links to templates. 

See also [https://lists.debian.org/debian-wiki/2025/07/msg00053.html#:~:text=DebianIRC a brief mention in Re: Complex conversion issues] and [https://wiki2025.debian.org/wiki/Template:DebianIRC the example DebianIRC template]. 

== See also ==


* [https://lists.debian.org/debian-wiki debian-wiki@lists.debian.org] mailing list 
* [ircs://irc.oftc.net/debian-wiki #debian-wiki] IRC channel 
* [https://wiki2025.debian.org/ demo instance of the new wiki] 
* [https://wiki2025.debian.org/wiki/Category:Example examples of ideas for the new wiki] 

-----

[[CategoryMigration|CategoryMigration]] 

</div>

Debian Wiki - User contributions [en]

WikiRevamp

Main Page

Talk:Main Page

Main Page

Template:Imported from Moin

User:Jmtd

User:Jmtd