88 lines
2.3 KiB
Markdown
88 lines
2.3 KiB
Markdown
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/.
|