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 * Apply change in MDL-64091 (We don't want icon-size-n classes to have the icon background image applied).
  16 * regenerate css files using grunt
  17 * update ./thirdpartylibs.xml
  18
  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:
  22
  23 bootstrap.js
  24 ------------
  25 Version: 2.3.0
  26
  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.
  30
  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:
  35
  36 https://github.com/aFarkas/html5shiv/blob/master/src/html5shiv.js
  37
  38 To update to the latest release of html5shiv:
  39 * download and replace: javascript/html5shiv.js
  40 * update ./thirdpartylibs.xml
  41
  42 variables.less
  43 ------------
  44 The calculations for the following variables have been enclosed in parentheses in order for them to be correctly output
  45 in the compiled CSS (MDL-53152):
  46 * @fontSizeLarge
  47 * @fontSizeSmall
  48 * @fontSizeMini
  49 * @inputHeight
  50 * @navbarCollapseDesktopWidth
  51 * @popoverArrowOuterWidth
  52 * @gridRowWidth
  53 * @gridRowWidth1200
  54 * @gridRowWidth768
  55
  56 popovers.less
  57 -------------
  58 MDL-60250 - The '/*rtl:ignore*/' directive has been added to the 'left' attribute of the 'popover' class so that
  59 the rtlcss-php tool (https://github.com/moodlehq/rtlcss-php) does not flip this to a 'right' attribute and cause
  60 the popover to be misplaced on the page when the JavaScript calculates the postion of the popover and adds an
  61 overriding inline CSS 'left' attribute which is fine in LTR languages but confuses it in RTL languages.