gerrit.onap Code Review - vnfsdk/refrepo.git/blob

   1 ---
   2 layout: docs
   3 title: Download
   4 description: Download Bootstrap to get the compiled CSS and JavaScript, source code, or include it with your favorite package managers like npm, RubyGems, and more.
   5 group: getting-started
   6 toc: true
   7 ---
   8
   9 ## Compiled CSS and JS
  10
  11 Download ready-to-use compiled code for **Bootstrap v{{ site.current_version}}** to easily drop into your project, which includes:
  12
  13 - Compiled and minified CSS bundles (see [CSS files comparison]({{ site.baseurl }}/docs/{{ site.docs_version }}/getting-started/contents/#comparison-of-css-files))
  14 - Compiled and minified JavaScript plugins
  15
  16 This doesn't include documentation, source files, or any optional JavaScript dependencies (jQuery and Popper.js).
  17
  18 <a href="{{ site.download.dist }}" class="btn btn-bd-primary" onclick="ga('send', 'event', 'Getting started', 'Download', 'Download Bootstrap');">Download</a>
  19
  20 ## Source files
  21
  22 Compile Bootstrap with your own asset pipeline by downloading our source Sass, JavaScript, and documentation files. This option requires some additional tooling:
  23
  24 - Sass compiler (Libsass or Ruby Sass is supported) for compiling your CSS.
  25 - [Autoprefixer](https://github.com/postcss/autoprefixer) for CSS vendor prefixing
  26
  27 Should you require [build tools]({{ site.baseurl }}/docs/{{ site.docs_version }}/getting-started/build-tools/#tooling-setup), they are included for developing Bootstrap and its docs, but they're likely unsuitable for your own purposes.
  28
  29 <a href="{{ site.download.source }}" class="btn btn-bd-primary" onclick="ga('send', 'event', 'Getting started', 'Download', 'Download source');">Download source</a>
  30
  31 ## BootstrapCDN
  32
  33 Skip the download with [BootstrapCDN](https://www.bootstrapcdn.com/) to deliver cached version of Bootstrap's compiled CSS and JS to your project.
  34
  35 {% highlight html %}
  36 <link rel="stylesheet" href="{{ site.cdn.css }}" integrity="{{ site.cdn.css_hash }}" crossorigin="anonymous">
  37 <script src="{{ site.cdn.js }}" integrity="{{ site.cdn.js_hash }}" crossorigin="anonymous"></script>
  38 {% endhighlight %}
  39
  40 If you're using our compiled JavaScript, don't forget to include CDN versions of jQuery and Popper.js before it.
  41
  42 {% highlight html %}
  43 <script src="{{ site.cdn.jquery }}" integrity="{{ site.cdn.jquery_hash }}" crossorigin="anonymous"></script>
  44 <script src="{{ site.cdn.popper }}" integrity="{{ site.cdn.popper_hash }}" crossorigin="anonymous"></script>
  45 {% endhighlight %}
  46
  47 ## Package managers
  48
  49 Pull in Bootstrap's **source files** into nearly any project with some of the most popular package managers. No matter the package manager, Bootstrap will **require a Sass compiler and [Autoprefixer](https://github.com/postcss/autoprefixer)** for a setup that matches our official compiled versions.
  50
  51 ### npm
  52
  53 Install Bootstrap in your Node.js powered apps with [the npm package](https://www.npmjs.com/package/bootstrap):
  54
  55 {% highlight sh %}
  56 npm install bootstrap
  57 {% endhighlight %}
  58
  59 `require('bootstrap')` will load all of Bootstrap's jQuery plugins onto the jQuery object. The `bootstrap` module itself does not export anything. You can manually load Bootstrap's jQuery plugins individually by loading the `/js/*.js` files under the package's top-level directory.
  60
  61 Bootstrap's `package.json` contains some additional metadata under the following keys:
  62
  63 - `sass` - path to Bootstrap's main [Sass](http://sass-lang.com/) source file
  64 - `style` - path to Bootstrap's non-minified CSS that's been precompiled using the default settings (no customization)
  65
  66 ### RubyGems
  67
  68 Install Bootstrap in your Ruby apps using [Bundler](https://bundler.io/) (**recommended**) and [RubyGems](https://rubygems.org/) by adding the following line to your [`Gemfile`](https://bundler.io/gemfile.html):
  69
  70 {% highlight ruby %}
  71 gem 'bootstrap', '~> {{ site.current_ruby_version }}'
  72 {% endhighlight %}
  73
  74 Alternatively, if you're not using Bundler, you can install the gem by running this command:
  75
  76 {% highlight sh %}
  77 gem install bootstrap -v {{ site.current_ruby_version }}
  78 {% endhighlight %}
  79
  80 [See the gem's README](https://github.com/twbs/bootstrap-rubygem/blob/master/README.md) for further details.
  81
  82 ### Composer
  83
  84 You can also install and manage Bootstrap's Sass and JavaScript using [Composer](https://getcomposer.org/):
  85
  86 {% highlight sh %}
  87 composer require twbs/bootstrap:{{ site.current_version }}
  88 {% endhighlight %}
  89
  90 ### NuGet
  91
  92 If you develop in .NET, you can also install and manage Bootstrap's [CSS](https://www.nuget.org/packages/bootstrap/) or [Sass](https://www.nuget.org/packages/bootstrap.sass/) and JavaScript using [NuGet](https://www.nuget.org/):
  93
  94 {% highlight powershell %}
  95 Install-Package bootstrap
  96 {% endhighlight %}
  97
  98 {% highlight powershell %}
  99 Install-Package bootstrap.sass
 100 {% endhighlight %}