theme/bootstrapbase/readme_moodle.txt

   1 Description of Twitter bootstrap import into Moodle
   2
   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:
   7
   8 https://github.com/twitter/bootstrap.git
   9
  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 css files using grunt
  16 * update ./thirdpartylibs.xml
  17
  18 ** If you want to make changes to the .css generated from these .less files then you
  19 need to install recess (https://github.com/twitter/recess) to compile the .less files,
  20 then run these commands in the bootstrapbase/less/ folder:
  21
  22 bootstrap.js
  23 ------------
  24 Version: 2.3.0
  25
  26 An alteration was made to the JavaScript to allow nested navigation to work properly on small screens (MDL-51819).
  27 Bootstap 3 does away with nested menus (https://github.com/twbs/bootstrap/pull/6342), So a completely different solution
  28 may be required if we upgrade this further.
  29
  30 html5shiv.js
  31 ------------
  32 This theme uses the original unmodified html5shiv.js JavaScript library to enable HTML5 tags in IE7 and IE8.
  33 This library is available on:
  34
  35 https://github.com/aFarkas/html5shiv/blob/master/src/html5shiv.js
  36
  37 To update to the latest release of html5shiv:
  38 * download and replace: javascript/html5shiv.js
  39 * update ./thirdpartylibs.xml
  40
  41 variables.less
  42 ------------
  43 The calculations for the following variables have been enclosed in parentheses in order for them to be correctly output
  44 in the compiled CSS (MDL-53152):
  45 * @fontSizeLarge
  46 * @fontSizeSmall
  47 * @fontSizeMini
  48 * @inputHeight
  49 * @navbarCollapseDesktopWidth
  50 * @popoverArrowOuterWidth
  51 * @gridRowWidth
  52 * @gridRowWidth1200
  53 * @gridRowWidth768
  54
  55 popovers.less
  56 -------------
  57 MDL-60250 - The '/*rtl:ignore*/' directive has been added to the 'left' attribute of the 'popover' class so that
  58 the rtlcss-php tool (https://github.com/moodlehq/rtlcss-php) does not flip this to a 'right' attribute and cause
  59 the popover to be misplaced on the page when the JavaScript calculates the postion of the popover and adds an
  60 overriding inline CSS 'left' attribute which is fine in LTR languages but confuses it in RTL languages.