Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

A MediaWiki skin using Bootstrap 3 from Twitter

branch: master

Style tweaks

latest commit 3eb09cd124
Matthew Batchelder authored
README.md

Bootstrap Mediawiki

This is a MediaWiki skin that uses Bootstrap 2 from Twitter! The framework gives a boatload of features that play really nicely with a MediaWiki installation. To get up and rolling, there's a few things that should be done.

Installation

First, clone the repository into your skins/ directory.

git clone https://github.com/borkweb/bootstrap-mediawiki.git

Next, in LocalSettings.php set:

$wgDefaultSkin = 'bootstrapmediawiki';

Then add at the bottom:

require_once( "$IP/skins/bootstrap-mediawiki/bootstrap-mediawiki.php" );

Setup

Once you've enabled the skin, you'll want to create a few pages.

Customization Vars

$wgTOCLocation = 'sidebar'; - moves the TOC to a sidebar.

Create: Bootstrap:Footer

This MediaWiki page will contain what appears in your footer. I've set mine to the following:

<div class="row">
    <div class="span6">
        === Stuff ===
        * [[Link to some place]]
        * [[Another link]]
    </div>
    <div class="span6">
        === More Stuff ===
        * [http://external.resource.org Go here]
    </div>
</div>

Create: Bootstrap:TitleBar

This MediaWiki page will control the links that appear in the Bootstrap navbar after the logo/site title. The format that this page is expecting is as follows:

* Menu Item Title
** [[Page 1]]
** [[Page 2]]
** [[Page 3]]
* Another Menu
** [[Whee]]
** [[OMG hai]]
* [[A Link Menu]]

Create: Template:Alert

This template is used to leverage Bootstrap's alert box:

<div class="alert {{{2}}}"><strong>Heads Up!</strong> {{{1}}}</div>

Usage:

{{alert|Message you want to say|alert-danger}}

Create: Template:Tip

This template is used to do Bootstrap tooltips!

<span title="{{{2}}}" class="tip" rel="tooltip">{{{1}}}</span>

Usage:

{{tip|Something|This is the tooltip!}}

or

{{tip|[[Bacon]]|Delicious snack}}

Create: Template:Pop

This template is used to do Bootstrap popovers!

<span data-original-title="{{{2}}}" data-content="{{{3}}}" class="pop">{{{1}}}</span>

Usage:

{{pop|Whatever triggers the popover|Popover Title|Popover Content}}

Short Title

If you want a shorter title to appear in your navbar, you can add $wgSitenameshort = 'Short Name'; to your LocalSettings.php file.

Custom CSS

If you want a custom CSS file for overrides or site-specific features, you can declare $wgSiteCSS = 'bootstrap-mediawiki/custom.css'

Custom JS

If you want a custom JS file for overrides or site-specific features, you can declare $wgSiteJS = 'bootstrap-mediawiki/custom.js'

Something went wrong with that request. Please try again.