Merge branch 'wip-MDL-51819-master' of git://github.com/abgreeve/moodle
[moodle.git] / theme / bootstrapbase / readme_moodle.txt
1 Description of Twitter bootstrap import into Moodle
3 Twitter bootstrap
4 -----------------
5 The bootstrap theme uses the original unmodified version 2.3.0 Twitter bootstrap less files. These are
6 Object Oriented CSS files. The bootstrap repository is available on:
8 https://github.com/twitter/bootstrap.git
10 To update to the latest release of twitter bootstrap:
11 * remove all files from less/bootstrap,
12 * download the new less files and store them in less/bootstrap
13 * Apply change in MDL-42195 (We don't want responsive images by default).
14 * Apply change in MDL-48328 (We need to reset the width of the container directly, in ./less/bootstrap/navbar.less, using the calculated value found in ./less/bootstrap/mixin.less).
15 * regenerate files using recess: recess --compile --compress moodle.less > ../style/moodle.css **
16 * regenerate files using recess: recess --compile --compress editor.less > ../style/editor.css **
17 * update ./thirdpartylibs.xml
19 ** If you want to make changes to the .css generated from these .less files then you
20 need to install recess (https://github.com/twitter/recess) to compile the .less files,
21 then run these commands in the bootstrapbase/less/ folder:
23 bootstrap.js
24 ------------
25 Version: 2.3.0
27 An alteration was made to the JavaScript to allow nested navigation to work properly on small screens (MDL-51819).
28 Bootstap 3 does away with nested menus (https://github.com/twbs/bootstrap/pull/6342), So a completely different solution
29 may be required if we upgrade this further.
31 html5shiv.js
32 ------------
33 This theme uses the original unmodified html5shiv.js JavaScript library to enable HTML5 tags in IE7 and IE8.
34 This library is available on:
36 https://github.com/aFarkas/html5shiv/blob/master/src/html5shiv.js
38 To update to the latest release of html5shiv:
39 * download and replace: javascript/html5shiv.js
40 * update ./thirdpartylibs.xml