Skin:Chameleon

Chameleon is a highly customizable MediaWiki skin that uses Twitter Bootstrap 3.

It currently provides five different layouts to chose from. The standard layout features a horizontal navigation menu with dropdowns at the top and a horizontal menu with dropups for the language links at the bottom. Each layout is defined in an XML file and as such easily adaptable to your needs.

Installation
The Chameleon skin requires Composer for installation. (But why!?)
 * 1)    If necessary install Composer.
 * 2)    Go to your MediaWiki installation directory
 * 3)    If necessary (on MediaWiki up to 1.23) copy the file   to
 * 4)    With Composer installed, run
 * 5)    ✅ – Navigate to Special:Version on your wiki to verify that the skin is successfully installed.

Remarks

 * To actually activate Chameleon as the default skin of your wiki, include  in your
 * It is not necessary to install any dependencies anymore. Composer will take care of that.
 * If instead of a proper installation you end up with a  subdirectory in the   directory of your MediaWiki installation directory,
 * remove that  subdirectory and all its contents from the   directory and
 * run  from the MediaWiki installation directory again (or   if applicable)

Documentation
The documentation will be successively moved into the sourcecode repository. This allows to better keep it in sync with the development of the code. Moreover it allows to go back in time and see the documentation for a particular version of the skin.

Use the documentation index page as a starting point.

Fonts and Colors
You can customize the skin by loading additional LESS files and by setting LESS variables.

To import additional LESS files, add them to the array  in  :

If your LESS file does not reference any other files (fonts, images, ...), you may omit the remote path. Just write:

To add or change LESS variables add them to the array  in  :

Regardless of the order of the calls, variables will always override imported files. A good starting point for customization is Bootstrap's list of variables: http://getbootstrap.com/customize/#less-variables

Example
To use the Amelia theme from Bootswatch you could download the  and the   file to your MediaWiki installation directory and rename them to   and. You then add the following code to your :

To make the navigation bar a bit narrower you could add

Layout of page elements
The layout of the page elements (nav bar, logo, search bar, etc.) is defined in an XML file. There are currently four pre-defined layouts available: standard, navhead, fixedhead and stickyhead. They can be activated by setting the variable  in LocalSettings.php. E.g. to activate the fixedhead layout you could add

You can of course also define and use your own layout. Have a look at the available XML files to see what is possible. (Better documentation to follow.)

Live examples

 * Solutions-web.eu and its test page of bootstrap features with $wgRawHtml set to false
 * Docupedia-Zeitgeschichte (in German)
 * Bootstrap.sémantique and its test page of bootstrap features with a paid skin and $wgRawHtml set to true
 * German Star Citizen Wiki
 * Laws of Australia
 * OGD Cockpit
 * a complete set of examples from geybootstrap.com (in wiki-markup mode and in raw html mode)
 * add your wiki here

For further examples see Chameleon's page on WikiApiary

Contributing to the project
see https://github.com/wikimedia/mediawiki-skins-chameleon/blob/master/docs/contribute.md

Bugs and feature requests should preferably be reported on the Wikimedia bug tracker.

Comments, questions and suggestions should be sent or posted to:
 * the Chameleon discussion page
 * the author

Roadmap (kind of)

 * Improve documentation
 * Add many more components and layouts (suggestions welcome)
 * Improve responsiveness
 * Improve accessibility (see )
 * Make customizable (colors, fonts, sizes) via a Special page
 * Put a selector for the layout on the user preferences page
 * Compatibility with extensions

Credits
see https://github.com/wikimedia/mediawiki-skins-chameleon/blob/master/docs/credits.md