docs: Set stable permalink on markdown files

In Doxygen 1.9.7, the URL generation logic changed such that input files in directories (i.e. /docs/Hooks.md) are published with the slug `md_docs_2Hooks.html` instead of `md_docs_Hooks.html`. Change-Id: Ifeb03602452c1148bd372555bebac9922c583ac2 (cherry picked from commit 5001f91)
TopRealm · Mar 27, 2024 · 423faa3 · 423faa3
1 parent 66dada7
commit 423faa3
Show file tree

Hide file tree

Showing 12 changed files with 20 additions and 14 deletions.
diff --git a/docs/Hooks.md b/docs/Hooks.md
@@ -1,4 +1,4 @@
-Hooks
+Hooks {#hooks}
 =====
 
 ## Introduction

diff --git a/docs/Language.md b/docs/Language.md
@@ -1,4 +1,4 @@
-Language
+Language {#language}
 =======
 
 The Language object handles all readable text produced by the software.

diff --git a/docs/LinkCache.md b/docs/LinkCache.md
@@ -1,3 +1,6 @@
+LinkCache {#linkcache}
+========
+
 The LinkCache class maintains a list of article titles and the information about
 whether or not the article exists in the database. This is used to mark up links
 when displaying a page. If the same link appears more than once on any page,
@@ -11,7 +14,7 @@ purposes of updating the link tables. This application is now deprecated.
 
 To create a batch, you can use the following code:
 
-~~~{.php}
+```php
 $pages = [ 'Main Page', 'Project:Help', /* ... */ ];
 $titles = [];
 
@@ -22,4 +25,4 @@ foreach( $pages as $page ){
 $linkBatchFactory = MediaWikiServices::getInstance()->getLinkBatchFactory();
 $batch = $linkBatchFactory->newLinkBatch( $titles );
 $batch->execute();
-~~~
+```
diff --git a/docs/Skin.md b/docs/Skin.md
@@ -1,4 +1,4 @@
-Skins
+Skins {#skin}
 =======
 
 ## Core Skins

diff --git a/docs/Title.md b/docs/Title.md
@@ -1,3 +1,6 @@
+Title {#title}
+========
+
 The MediaWiki software's "Title" class represents article titles, which are used
 for many purposes: as the human-readable text title of the article, in the URL
 used to access the article, the wikitext link to the article, the key into the

diff --git a/docs/contenthandler.md b/docs/contenthandler.md
@@ -1,4 +1,5 @@
-# ContentHandler
+ContentHandler {#contenthandler}
+=====
 
 The *ContentHandler* facility adds support for arbitrary content types on wiki pages, instead of relying on wikitext for everything. It was introduced in MediaWiki 1.21.
 

diff --git a/docs/database.md b/docs/database.md
@@ -1,4 +1,5 @@
-# Database Access
+Database Access {#database}
+=====
 
 *Some information about database access in MediaWiki. By Tim Starling, January 2006.*
 

diff --git a/docs/magicword.md b/docs/magicword.md
@@ -1,4 +1,4 @@
-Magic Words
+Magic Words {#magicword}
 ====================================
 
 Magic words are localizable keywords used in wikitext. They are used for many

diff --git a/docs/memcached.md b/docs/memcached.md
@@ -1,4 +1,4 @@
-Memcached
+Memcached {#memcached}
 ====================================
 
 MediaWiki has optional support for memcached, a "high-performance,
@@ -251,5 +251,3 @@ Special:Recentchanges (feed):
 	calling Special:Recentchanges?action=purge&feed=rss,
 	Special:Recentchanges?action=purge&feed=atom,
 	but note need $wgGroupPermissions[...]['purge'] permission.
-
-... more to come ...
diff --git a/docs/pageupdater.md b/docs/pageupdater.md
@@ -1,4 +1,4 @@
-PageUpdater
+PageUpdater {#pageupdater}
 ===========
 
 This document provides an overview of the usage of PageUpdater and DerivedPageDataUpdater.

diff --git a/docs/schema.md b/docs/schema.md
@@ -1,4 +1,4 @@
-Schema
+Schema {#schema}
 ======
 
 The most up-to-date schema for the tables in the database

diff --git a/docs/sitelist.md b/docs/sitelist.md
@@ -1,4 +1,4 @@
-Sitelist
+Sitelist {#sitelist}
 ========
 
 This document describes the XML format used to represent information about external sites known to a MediaWiki installation. This information about external sites is used to allow "inter-wiki" links, cross-language navigation, as well as close integration via direct access to the other site's web API or even directly to their database.