Skip to content

Latest commit

 

History

History
52 lines (40 loc) · 2.2 KB

README_DOC.md

File metadata and controls

52 lines (40 loc) · 2.2 KB

@mainpage LinkTitles @author Daniel Kraus (bovender) @date 2012-2017 @copyright GNU GPL v2+

%LinkTitles source code documentation

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.

@note The source code that is referenced in this documentation may not necessarily reflect the latest code in the repository! Make sure to check out the Git repository for the latest code.

A note on the publication of the source code documentation

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:

git submodule add -b gh-pages [email protected]:bovender/LinkTitles.git gh-pages

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.