This is the source code documentation for the LinkTitles extension for MediaWiki.
With version 5.0, the code is more extensively commented than ever. Version 5 brought a major refactoring, and the extension now consists of several classes with clearly defined concerns. Look at the class comments to find out what they do.
The documentation is automatically generated from the source code by Doxygen. A special branch of the Git repository, gh-pages
, was created that holds the GitHub project pages. To make use of the project page facility provided by GitHub, the root directory of a repository needs to be erased first before content is added. Since this would remove the source code from which the documentation is generated, deleting all files in the root directory while on the gh-pages
branch was not feasible.
The solution was to pull down the gh-pages
branch as a submodule into an empty gh-pages\
subdirectory:
This command tells git-submodule to only pull down the gh-pages
branch as a submodule – we don't need to pull down the master branch into the same repository again.