aleph1.co.uk Git - yaffs-website/blob - web/themes/contrib/bootstrap/starterkits/less/README.md

   1 <!-- @file Instructions for subtheming using the Less Starterkit. -->
   2 <!-- @defgroup sub_theming_less -->
   3 <!-- @ingroup sub_theming -->
   4 # Less Starterkit
   5
   6 Below are instructions on how to create a Bootstrap sub-theme using a Less
   7 preprocessor.
   8
   9 - [Prerequisites](#prerequisites)
  10 - [Additional Setup](#setup)
  11 - [Overrides](#overrides)
  12
  13 ## Prerequisites
  14 - Read the @link getting_started Getting Started @endlink and @link sub_theming Sub-theming @endlink documentation topics.
  15 - You must understand the basic concept of using the [Less] CSS pre-processor.
  16 - You must use a **[local Less compiler](https://www.google.com/search?q=less+compiler)**.
  17 - You must use the [Bootstrap Framework Source Files] ending in the `.less`
  18   extension, not files ending in `.css`.
  19
  20 ## Additional Setup {#setup}
  21 Download and extract the **latest** 3.x.x version of
  22 [Bootstrap Framework Source Files] into the root of your new sub-theme. After
  23 it has been extracted, the directory should be renamed (if needed) so it reads
  24 `./THEMENAME/bootstrap`.
  25
  26 If for whatever reason you have an additional `bootstrap` directory wrapping the
  27 first `bootstrap` directory (e.g. `./THEMENAME/bootstrap/bootstrap`), remove the
  28 wrapping `bootstrap` directory. You will only ever need to touch these files if
  29 or when you upgrade your version of the [Bootstrap Framework].
  30
  31 {.alert.alert-warning} **WARNING:** Do not modify the files inside of
  32 `./THEMENAME/bootstrap` directly. Doing so may cause issues when upgrading the
  33 [Bootstrap Framework] in the future.
  34
  35 ## Overrides {#overrides}
  36 The `./THEMENAME/less/variable-overrides.less` file is generally where you will
  37 the majority of your time overriding the variables provided by the [Bootstrap
  38 Framework].
  39
  40 The `./THEMENAME/less/bootstrap.less` file is nearly an exact copy from the
  41 [Bootstrap Framework Source Files]. The only difference is that it injects the
  42 `variable-overrides.less` file directly after it has imported the [Bootstrap
  43 Framework]'s `variables.less` file. This allows you to easily override variables
  44 without having to constantly keep up with newer or missing variables during an
  45 upgrade.
  46
  47 The `./THEMENAME/less/overrides.less` file contains various Drupal overrides to
  48 properly integrate with the [Bootstrap Framework]. It may contain a few
  49 enhancements, feel free to edit this file as you see fit.
  50
  51 The `./THEMENAME/less/style.less` file is the glue that combines the
  52 [Bootstrap Framework Source Files] and `overrides.less` files together.
  53 Generally, you will not need to modify this file unless you need to add or
  54 remove files to be imported. This is the file that you should compile to
  55 `./THEMENAME/css/styles.css` (note the same file name, using a different
  56 extension of course).
  57
  58 #### See also:
  59 - @link theme_settings Theme Settings @endlink
  60 - @link templates Templates @endlink
  61 - @link plugins Plugin System @endlink
  62
  63 [Bootstrap Framework]: http://getbootstrap.com
  64 [Bootstrap Framework Source Files]: https://github.com/twbs/bootstrap/releases
  65 [Less]: http://lesscss.org