tengel/Preloader
Archived
1
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Merge the old Preloader into a README

Browse source
This commit is contained in:
tengel 2015-01-03 09:54:39 -06:00
parent b07d07efde
commit 21978a57ca
1 changed files with 86 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

88
README.md
View file

@ -1,4 +1,88 @@
Preloader
=========
Preloader MediaWiki Extension
=============================
Fork of http://www.mediawiki.org/wiki/Extension:Preloader
## Overview
1. Introduction
2. Requirements
3. Installation
4. Configuration
5. Boilerplate
6. Feedback
## 1. Introduction
The Preloader extension allows the creation of boilerplate text which will be inserted into the edit form when creating new pages. Different boilerplate text can be specified for different namespaces.
This extension supports the standard `<includeonly>` and `<noinclude>` tags in the boilerplate text.
## 2. Requirements
The Preloader extension requires MediaWiki 1.7.0 or later.
## 3. Installation
Clone the Github repository into your extensions subdirectory:
```
cd /path/to/wiki/extensions
git clone https://github.com/troyengel/Preloader/
```
Then edit your `LocalSettings.php` file and add the following line:
```
require_once "$IP/extensions/Preloader/Preloader.php";
```
Installation can be verified through the **Special:Version** page on your wiki.
## 4. Configuration
Configuration of the boilerplate sources is done via the `$wgPreloaderSource` configuration variable, which takes the following format:
```
$wgPreloaderSource[ <namespace index> ] = PAGE TITLE;
```
For instance:
```
$wgPreloaderSource[ NS_MAIN ] = 'Template:Boilerplate';
$wgPreloaderSource[ NS_HELP ] = 'Template:Boilerplate help';
```
...indicates that the boilerplate text for pages in the main namespace should be loaded from **Template:Boilerplate**, while pages in the Help namespace will be preloaded from **Template:Boilerplate_help**. Other namespaces have no boilerplate configured.
## 5. Boilerplate
Using the above example configuration, create the wiki page **Template:Boilerplate** and use the standard include tags to indicate which parts are the template and which are the generic wiki text:
```
<includeonly>
__TOC__
== Overview ==
[[Category:MyDefaultCategory]]
</includeonly>
<noinclude>
This template is included by the Preloader extension on new article creation.
</noinclude>
```
When this template is included into a new wiki page, only this text is included and ready to edit:
```
__TOC__
== Overview ==
[[Category:MyDefaultCategory]]
```
## 6. Feedback
Please submit comments, suggestions and bug reports to https://github.com/troyengel/Preloader/.