|
@@ -1,6 +1,6 @@
|
|
|
# MediaWiki Foreground Skin
|
|
|
|
|
|
-[MediaWiki](http://www.mediawiki.org) skin that focuses on putting your content in the *foreground*. Supports responsive layouts and has classes predefined for [Semantic MediaWiki](http://semantic-mediawiki.org/wiki/Semantic_MediaWiki). Built on the [Zurb Foundation](http://foundation.zurb.com) CSS framework.
|
|
|
+[MediaWiki](https://www.mediawiki.org) skin that focuses on putting your content in the *foreground*. Supports responsive layouts and has classes predefined for [Semantic MediaWiki](https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki). Built on the [Zurb Foundation](http://foundation.zurb.com) CSS framework.
|
|
|
|
|
|
[](https://travis-ci.org/thingles/foreground) [](https://scrutinizer-ci.com/g/thingles/foreground/?branch=develop)
|
|
|
|
|
@@ -21,11 +21,9 @@ After that, you can issue `git pull` to update the code at anytime.
|
|
|
|
|
|
## Setup
|
|
|
|
|
|
-Once the skin is in place add one the following lines to your `LocalSettings.php` file depending on the version of MediaWiki you are using.
|
|
|
+Once the skin is in place add one the following lines to your `LocalSettings.php` file.
|
|
|
|
|
|
- require_once "$IP/skins/foreground/foreground.php"; //MW versions < 1.25.x
|
|
|
-
|
|
|
- wfLoadSkin( 'foreground' ); //MW versions 1.25 and higher
|
|
|
+ wfLoadSkin( 'foreground' );
|
|
|
|
|
|
This will activate Foreground in your installation. At this point you can select it as a user skin in your user preferences.
|
|
|
|
|
@@ -41,11 +39,12 @@ Use following features in `LocalSettings.php` to change the behavior.
|
|
|
- `NavWrapperType => 'divonly'`: only a div with id `navwrapper` will be created. `'0'` - no div will be created (old behavior), other values will be used as class.
|
|
|
- `showHelpUnderTools => true` a Link to "Help" will be created under "Tools".
|
|
|
- `showRecentChangesUnderTools => true` a Link to "recent changes" will be created under "Tools".
|
|
|
+- `'enableTabs' => true` for tabs on page support.
|
|
|
- `wikiName => 'Alternate WikiName'` sets top navbar name to a different output of the wiki's name. Useful if your `$wgSitename` is long but need to keep it for other purposes.
|
|
|
- `navbarIcon => true` to display an icon in the top navbar. See below for more information.
|
|
|
- `IeEdgeCode => 1` will produce a meta tag with "X-UA-Compatible" content="IE=edge", `2` will sent a header, `0` nothing will be done
|
|
|
- `showFooterIcons => 0` suppresses the output of footer icons. Set to `true` or `1` to display them.
|
|
|
-- `addThisFollowPUBID => 'your-id'` add an id to display Follow Us horizontal bar of icons from various social media sites available on [addThis](http://addthis.com).
|
|
|
+- `addThisFollowPUBID => 'your-id'` add an id to display Follow Us horizontal bar of icons from various social media sites available on [addThis](https://addthis.com).
|
|
|
|
|
|
These are the default values:
|
|
|
|
|
@@ -54,6 +53,7 @@ These are the default values:
|
|
|
'NavWrapperType' => 'divonly',
|
|
|
'showHelpUnderTools' => true,
|
|
|
'showRecentChangesUnderTools' => true,
|
|
|
+ 'enableTabs' => false,
|
|
|
'wikiName' => &$GLOBALS['wgSitename'],
|
|
|
'navbarIcon' => false,
|
|
|
'IeEdgeCode' => 1,
|
|
@@ -85,7 +85,7 @@ With a setting like:
|
|
|
|
|
|
'navbarIcon' => true
|
|
|
|
|
|
-A top navbar icon will be set using the current image set by `$wgLogo` in `LocalSettings.php`. See http://www.mediawiki.org/wiki/Manual:$wgLogo for more information about `$wgLogo`.
|
|
|
+A top navbar icon will be set using the current image set by `$wgLogo` in `LocalSettings.php`. See https://www.mediawiki.org/wiki/Manual:$wgLogo for more information about `$wgLogo`.
|
|
|
|
|
|
The icon will be resized to fit into a maximum width of 64px x 36px wide or a 16:9 ratio.
|
|
|
|
|
@@ -99,19 +99,19 @@ With a setting like:
|
|
|
|
|
|
'addThisFollowPUBID' => 'yourAddThis-PubID'
|
|
|
|
|
|
-Important, this feature uses the free or paid version of the http://addthis.com horizontal Follow Buttons only. Choose which social media FollowUs buttons(Twitter, Facebook, YouTube, etc.) and at the bottom of the screen locate the script. Within the script you will see something similar `...#pubid=ra-5378f4902d02197">`. Everything after the `=` sign and up to the `">` is your Publisher ID. To turn on social follow icons, insert your publisher id:
|
|
|
+Important, this feature uses the free or paid version of the https://addthis.com horizontal Follow Buttons only. Choose which social media FollowUs buttons(Twitter, Facebook, YouTube, etc.) and at the bottom of the screen locate the script. Within the script you will see something similar `...#pubid=ra-5378f4902d02197">`. Everything after the `=` sign and up to the `">` is your Publisher ID. To turn on social follow icons, insert your publisher id:
|
|
|
|
|
|
'addThisFollowPUBID' => 'ra-5378f4902d02197'
|
|
|
|
|
|
|
|
|
### Notes on other skins
|
|
|
|
|
|
-As you build a wiki out with Foreground you will likely use the responsive grid from Foundation. This is key to making a responsive wiki, and is one of the largest _migration_ requirements when you want to move a wiki that ppreviously used Vector (and likely a lot of tables for layout) to Foreground. Once you do this, the ability of a user to select whatever skin will be removed. If you take full advantage of Foreground in your templates the lack of the Foundation grid will make viewing the wiki using [Vector](http://wikiapiary.com/wiki/Skin:Vector) or [MonoBook](http://wikiapiary.com/wiki/Skin:MonoBook) very difficult.
|
|
|
+As you build a wiki out with Foreground you will likely use the responsive grid from Foundation. This is key to making a responsive wiki, and is one of the largest _migration_ requirements when you want to move a wiki that ppreviously used Vector (and likely a lot of tables for layout) to Foreground. Once you do this, the ability of a user to select whatever skin will be removed. If you take full advantage of Foreground in your templates the lack of the Foundation grid will make viewing the wiki using [Vector](https://wikiapiary.com/wiki/Skin:Vector) or [MonoBook](https://wikiapiary.com/wiki/Skin:MonoBook) very difficult.
|
|
|
|
|
|
Because of this, it is suggested that you set the `$wgSkipSkins` variable to make sure that everyone sees the site as you intended it. This removes other skins from being user selectable options.
|
|
|
|
|
|
# Foreground is specific, so lets disable other skins
|
|
|
- $wgSkipSkins = array( 'chick', 'cologneblue', 'modern', 'myskin', 'nostalgia', 'simple', 'standard', 'filament', 'monobook', 'vector' );
|
|
|
+ $wgSkipSkins = array( 'cologneblue', 'modern', 'monobook', 'vector' );
|
|
|
|
|
|
You may also want to allow users to set a User CSS if they want to tweak things inside of Foreground. This is entirely optional.
|
|
|
|
|
@@ -120,4 +120,4 @@ You may also want to allow users to set a User CSS if they want to tweak things
|
|
|
|
|
|
## Using Foreground
|
|
|
|
|
|
-There is a [mailing list to discuss Foreground](http://lists.thingelstad.com/cgi-bin/mailman/listinfo/foreground-l). Please join to connect with others and explore questions about using Foreground on your wiki. You can see a list of wikis with [Foreground installed at WikiApiary](http://wikiapiary.com/wiki/Skin:Foreground).
|
|
|
+There is a [mailing list to discuss Foreground](https://lists.wikimedia.org/mailman/listinfo/foreground). Please join to connect with others and explore questions about using Foreground on your wiki. You can see a list of wikis with [Foreground installed at WikiApiary](https://wikiapiary.com/wiki/Skin:Foreground).
|