publish 3.4 docs

2026-06-08 17:22:31 +03:00 · 2018-12-13 15:57:10 -08:00
parent ea4129886a
commit 5b27630cb4
125 changed files with 55951 additions and 0 deletions
@@ -0,0 +1,180 @@
+// NOTICE!! DO NOT USE ANY OF THIS JAVASCRIPT
+// IT'S ALL JUST JUNK FOR OUR DOCS!
+// ++++++++++++++++++++++++++++++++++++++++++
+
+/*!
+ * JavaScript for Bootstrap's docs (https://getbootstrap.com/)
+ * Copyright 2011-2018 Twitter, Inc.
+ * Licensed under the Creative Commons Attribution 3.0 Unported License. For
+ * details, see https://creativecommons.org/licenses/by/3.0/.
+ */
+
+/* global ClipboardJS: false, anchors: false */
+
+!function ($) {
+  'use strict';
+
+  $(function () {
+
+    // Scrollspy
+    var $window = $(window)
+    var $body   = $(document.body)
+
+    $body.scrollspy({
+      target: '.bs-docs-sidebar'
+    })
+    $window.on('load', function () {
+      $body.scrollspy('refresh')
+    })
+
+    // Kill links
+    $('.bs-docs-container [href="#"]').click(function (e) {
+      e.preventDefault()
+    })
+
+    // Sidenav affixing
+    setTimeout(function () {
+      var $sideBar = $('.bs-docs-sidebar')
+
+      $sideBar.affix({
+        offset: {
+          top: function () {
+            var offsetTop      = $sideBar.offset().top
+            var sideBarMargin  = parseInt($sideBar.children(0).css('margin-top'), 10)
+            var navOuterHeight = $('.bs-docs-nav').height()
+
+            return (this.top = offsetTop - navOuterHeight - sideBarMargin)
+          },
+          bottom: function () {
+            return (this.bottom = $('.bs-docs-footer').outerHeight(true))
+          }
+        }
+      })
+    }, 100)
+
+    setTimeout(function () {
+      $('.bs-top').affix()
+    }, 100)
+
+    // Theme toggler
+    ;(function () {
+      var $stylesheetLink = $('#bs-theme-stylesheet')
+      var $themeBtn = $('.bs-docs-theme-toggle')
+
+      var activateTheme = function () {
+        $stylesheetLink.attr('href', $stylesheetLink.attr('data-href'))
+        $themeBtn.text('Disable theme preview')
+        localStorage.setItem('previewTheme', true)
+      }
+
+      if (localStorage.getItem('previewTheme')) {
+        activateTheme()
+      }
+
+      $themeBtn.click(function () {
+        var href = $stylesheetLink.attr('href')
+        if (!href || href.indexOf('data') === 0) {
+          activateTheme()
+        } else {
+          $stylesheetLink.attr('href', '')
+          $themeBtn.text('Preview theme')
+          localStorage.removeItem('previewTheme')
+        }
+      })
+    })();
+
+    // Tooltip and popover demos
+    $('.tooltip-demo').tooltip({
+      selector: '[data-toggle="tooltip"]',
+      container: 'body'
+    })
+    $('.popover-demo').popover({
+      selector: '[data-toggle="popover"]',
+      container: 'body'
+    })
+
+    // Demos within modals
+    $('.tooltip-test').tooltip()
+    $('.popover-test').popover()
+
+    // Popover demos
+    $('.bs-docs-popover').popover()
+
+    // Button state demo
+    $('#loading-example-btn').on('click', function () {
+      var $btn = $(this)
+      $btn.button('loading')
+      setTimeout(function () {
+        $btn.button('reset')
+      }, 3000)
+    })
+
+    // Modal relatedTarget demo
+    $('#exampleModal').on('show.bs.modal', function (event) {
+      var $button = $(event.relatedTarget)      // Button that triggered the modal
+      var recipient = $button.data('whatever')  // Extract info from data-* attributes
+      // If necessary, you could initiate an AJAX request here (and then do the updating in a callback).
+      // Update the modal's content. We'll use jQuery here, but you could use a data binding library or other methods instead.
+      var $modal = $(this)
+      $modal.find('.modal-title').text('New message to ' + recipient)
+      $modal.find('.modal-body input').val(recipient)
+    })
+
+    // Activate animated progress bar
+    $('.bs-docs-activate-animated-progressbar').on('click', function () {
+      $(this).siblings('.progress').find('.progress-bar-striped').toggleClass('active')
+    })
+
+    // Insert copy to clipboard button before .highlight
+    $('figure.highlight, div.highlight').each(function () {
+      var btnHtml = '<div class="bs-clipboard"><button type="button" class="btn-clipboard" title="Copy to clipboard">Copy</button></div>'
+      $(this).before(btnHtml)
+      $('.btn-clipboard')
+        .tooltip()
+        .on('mouseleave', function () {
+          // Explicitly hide tooltip, since after clicking it remains
+          // focused (as it's a button), so tooltip would otherwise
+          // remain visible until focus is moved away
+          $(this).tooltip('hide')
+        })
+    })
+
+    var clipboard = new ClipboardJS('.btn-clipboard', {
+      target: function (trigger) {
+        return trigger.parentNode.nextElementSibling
+      }
+    })
+
+    clipboard.on('success', function (e) {
+      $(e.trigger)
+        .attr('title', 'Copied!')
+        .tooltip('fixTitle')
+        .tooltip('show')
+        .attr('title', 'Copy to clipboard')
+        .tooltip('fixTitle')
+
+      e.clearSelection()
+    })
+
+    clipboard.on('error', function (e) {
+      var modifierKey = /Mac/i.test(navigator.userAgent) ? '\u2318' : 'Ctrl-'
+      var fallbackMsg = 'Press ' + modifierKey + 'C to copy'
+
+      $(e.trigger)
+        .attr('title', fallbackMsg)
+        .tooltip('fixTitle')
+        .tooltip('show')
+        .attr('title', 'Copy to clipboard')
+        .tooltip('fixTitle')
+    })
+
+  })
+
+}(jQuery)
+
+;(function () {
+  'use strict';
+
+  anchors.options.placement = 'left';
+  anchors.add('.bs-docs-section > h1, .bs-docs-section > h2, .bs-docs-section > h3, .bs-docs-section > h4, .bs-docs-section > h5')
+})();
@@ -0,0 +1,414 @@
+/*!
+ * Bootstrap Customizer (http://getbootstrap.com/customize/)
+ * Copyright 2011-2018 Twitter, Inc.
+ *
+ * Licensed under the Creative Commons Attribution 3.0 Unported License. For
+ * details, see https://creativecommons.org/licenses/by/3.0/.
+ */
+
+/* global JSON, JSZip, less, autoprefixer, saveAs, UglifyJS, __configBridge, __js, __less, __fonts */
+
+window.onload = function () { // wait for load in a dumb way because B-0
+  'use strict';
+
+  var cw = '/*!\n' +
+           ' * Bootstrap v3.4.0 (https://getbootstrap.com/)\n' +
+           ' * Copyright 2011-' + new Date().getFullYear() + ' Twitter, Inc.\n' +
+           ' * Licensed under the MIT license\n' +
+           ' */\n\n'
+
+  var $importDropTarget = $('#import-drop-target')
+
+  function showError(msg, err) {
+    $('<div id="bsCustomizerAlert" class="bs-customizer-alert">' +
+        '<div class="container">' +
+          '<a href="#bsCustomizerAlert" data-dismiss="alert" class="close pull-right" aria-label="Close" role="button"><span aria-hidden="true">&times;</span></a>' +
+          '<p class="bs-customizer-alert-text"><span class="glyphicon glyphicon-warning-sign" aria-hidden="true"></span><span class="sr-only">Warning:</span>' + msg + '</p>' +
+          (err.message ? $('<p></p>').text('Error: ' + err.message)[0].outerHTML : '') +
+          (err.extract ? $('<pre class="bs-customizer-alert-extract"></pre>').text(err.extract.join('\n'))[0].outerHTML : '') +
+        '</div>' +
+      '</div>').appendTo('body').alert()
+    throw err
+  }
+
+  function showAlert(type, msg, insertAfter) {
+    $('<div class="alert alert-' + type + '">' + msg + '<button type="button" class="close" data-dismiss="alert" aria-label="Close"><span aria-hidden="true">&times;</span></button></div>')
+      .insertAfter(insertAfter)
+  }
+
+  function getQueryParam(key) {
+    key = key.replace(/[*+?^$.\[\]{}()|\\\/]/g, '\\$&') // escape RegEx meta chars
+    var match = location.search.match(new RegExp('[?&]' + key + '=([^&]+)(&|$)'))
+    return match && decodeURIComponent(match[1].replace(/\+/g, ' '))
+  }
+
+  function getCustomizerData() {
+    var vars = {}
+
+    $('#less-variables-section input')
+      .each(function () {
+        $(this).val() && (vars[$(this).prev().text()] = $(this).val())
+      })
+
+    var data = {
+      vars: vars,
+      css: $('#less-section input:checked')  .map(function () { return this.value }).toArray(),
+      js:  $('#plugin-section input:checked').map(function () { return this.value }).toArray()
+    }
+
+    if ($.isEmptyObject(data.vars) && !data.css.length && !data.js.length) return null
+
+    return data
+  }
+
+  function updateCustomizerFromJson(data) {
+    if (data.js) {
+      $('#plugin-section input').each(function () {
+        $(this).prop('checked', ~$.inArray(this.value, data.js))
+      })
+    }
+    if (data.css) {
+      $('#less-section input').each(function () {
+        $(this).prop('checked', ~$.inArray(this.value, data.css))
+      })
+    }
+    if (data.vars) {
+      for (var i in data.vars) {
+        $('input[data-var="' + i + '"]').val(data.vars[i])
+      }
+    }
+  }
+
+  function parseUrl() {
+    var id = getQueryParam('id')
+
+    if (!id) return
+
+    $.ajax({
+      url: 'https://api.github.com/gists/' + id,
+      type: 'GET',
+      dataType: 'json'
+    })
+    .success(function (result) {
+      var data = JSON.parse(result.files['config.json'].content)
+      updateCustomizerFromJson(data)
+    })
+    .error(function (err) {
+      showError('Error fetching bootstrap config file', err)
+    })
+  }
+
+  function generateZip(css, js, fonts, config, complete) {
+    if (!css && !js) return showError('<strong>Ruh roh!</strong> No Bootstrap files selected.', new Error('no Bootstrap'))
+
+    var zip = new JSZip()
+
+    if (css) {
+      var cssFolder = zip.folder('css')
+      for (var fileName in css) {
+        cssFolder.file(fileName, css[fileName])
+      }
+    }
+
+    if (js) {
+      var jsFolder = zip.folder('js')
+      for (var jsFileName in js) {
+        jsFolder.file(jsFileName, js[jsFileName])
+      }
+    }
+
+    if (fonts) {
+      var fontsFolder = zip.folder('fonts')
+      for (var fontsFileName in fonts) {
+        fontsFolder.file(fontsFileName, fonts[fontsFileName], { base64: true })
+      }
+    }
+
+    if (config) {
+      zip.file('config.json', config)
+    }
+
+    var content = zip.generate({ type: 'blob' })
+
+    complete(content)
+  }
+
+  function generateCustomLess(vars) {
+    var result = ''
+
+    for (var key in vars) {
+      result += key + ': ' + vars[key] + ';\n'
+    }
+
+    return result + '\n\n'
+  }
+
+  function generateFonts() {
+    var $glyphicons = $('#less-section [value="glyphicons.less"]:checked')
+    if ($glyphicons.length) {
+      return __fonts
+    }
+  }
+
+  // Returns an Array of @import'd filenames in the order
+  // in which they appear in the file.
+  function includedLessFilenames(lessFilename) {
+    var IMPORT_REGEX = /^@import \"(.*?)\";$/
+    var lessLines = __less[lessFilename].split('\n')
+
+    var imports = []
+    $.each(lessLines, function (index, lessLine) {
+      var match = IMPORT_REGEX.exec(lessLine)
+      if (match) {
+        var importee = match[1]
+        var transitiveImports = includedLessFilenames(importee)
+        $.each(transitiveImports, function (index, transitiveImportee) {
+          if ($.inArray(transitiveImportee, imports) === -1) {
+            imports.push(transitiveImportee)
+          }
+        })
+        imports.push(importee)
+      }
+    })
+
+    return imports
+  }
+
+  function generateLESS(lessFilename, lessFileIncludes, vars) {
+    var lessSource = __less[lessFilename]
+
+    var lessFilenames = includedLessFilenames(lessFilename)
+    $.each(lessFilenames, function (index, filename) {
+      var fileInclude = lessFileIncludes[filename]
+
+      // Files not explicitly unchecked are compiled into the final stylesheet.
+      // Core stylesheets like 'normalize.less' are not included in the form
+      // since disabling them would wreck everything, and so their 'fileInclude'
+      // will be 'undefined'.
+      if (fileInclude || fileInclude == null)    lessSource += __less[filename]
+
+      // Custom variables are added after Bootstrap variables so the custom
+      // ones take precedence.
+      if (filename === 'variables.less' && vars) lessSource += generateCustomLess(vars)
+    })
+
+    lessSource = lessSource.replace(/@import[^\n]*/gi, '') // strip any imports
+    return lessSource
+  }
+
+  function compileLESS(lessSource, baseFilename, intoResult) {
+    var promise = $.Deferred()
+    var parser = new less.Parser({
+      paths: ['variables.less', 'mixins.less'],
+      optimization: 0,
+      filename: baseFilename + '.css'
+    })
+
+    parser.parse(lessSource, function (parseErr, tree) {
+      if (parseErr) {
+        return promise.reject(parseErr)
+      }
+      try {
+        intoResult[baseFilename + '.css']     = tree.toCSS()
+        intoResult[baseFilename + '.min.css'] = tree.toCSS({ compress: true })
+      } catch (compileErr) {
+        return promise.reject(compileErr)
+      }
+      promise.resolve()
+    })
+
+    return promise.promise()
+  }
+
+  function generateCSS(preamble) {
+    var promise = $.Deferred()
+    var oneChecked = false
+    var lessFileIncludes = {}
+    $('#less-section input').each(function () {
+      var $this = $(this)
+      var checked = $this.is(':checked')
+      lessFileIncludes[$this.val()] = checked
+
+      oneChecked = oneChecked || checked
+    })
+
+    if (!oneChecked) return false
+
+    var result = {}
+    var vars = {}
+
+    $('#less-variables-section input')
+      .each(function () {
+        $(this).val() && (vars[$(this).prev().text()] = $(this).val())
+      })
+
+    var bsLessSource    = preamble + generateLESS('bootstrap.less', lessFileIncludes, vars)
+    var themeLessSource = preamble + generateLESS('theme.less',     lessFileIncludes, vars)
+
+    var prefixer = autoprefixer(__configBridge.autoprefixer)
+
+    $.when(
+      compileLESS(bsLessSource, 'bootstrap', result),
+      compileLESS(themeLessSource, 'bootstrap-theme', result)
+    ).done(function () {
+      for (var key in result) {
+        result[key] = prefixer.process(result[key]).css
+      }
+      promise.resolve(result)
+    }).fail(function (err) {
+      showError('<strong>Ruh roh!</strong> Problem parsing or compiling Less files.', err)
+      promise.reject()
+    })
+
+    return promise.promise()
+  }
+
+  function uglify(js) {
+    var ast = UglifyJS.parse(js)
+    ast.figure_out_scope()
+
+    var compressor = UglifyJS.Compressor()
+    var compressedAst = ast.transform(compressor)
+
+    compressedAst.figure_out_scope()
+    compressedAst.compute_char_frequency()
+    compressedAst.mangle_names()
+
+    var stream = UglifyJS.OutputStream()
+    compressedAst.print(stream)
+
+    return stream.toString()
+  }
+
+  function generateJS(preamble) {
+    var $checked = $('#plugin-section input:checked')
+    var jqueryCheck = __configBridge.jqueryCheck.join('\n')
+    var jqueryVersionCheck = __configBridge.jqueryVersionCheck.join('\n')
+
+    if (!$checked.length) return false
+
+    var js = $checked
+      .map(function () { return __js[this.value] })
+      .toArray()
+      .join('\n')
+
+    preamble = preamble + cw
+    js = jqueryCheck + jqueryVersionCheck + js
+
+    return {
+      'bootstrap.js': preamble + js,
+      'bootstrap.min.js': preamble + uglify(js)
+    }
+  }
+
+  function removeImportAlerts() {
+    $importDropTarget.nextAll('.alert').remove()
+  }
+
+  function handleConfigFileSelect(e) {
+    e.stopPropagation()
+    e.preventDefault()
+
+    var file = e.originalEvent.target.files[0]
+    var reader = new FileReader()
+
+    reader.onload = function (e) {
+      var text = e.target.result
+
+      try {
+        var json = JSON.parse(text)
+
+        if (!$.isPlainObject(json)) {
+          throw new Error('JSON data from config file is not an object.')
+        }
+
+        updateCustomizerFromJson(json)
+        showAlert('success', '<strong>Woohoo!</strong> Your configuration was successfully uploaded. Tweak your settings, then hit Download.', $importDropTarget)
+      } catch (err) {
+        return showAlert('danger', '<strong>Shucks.</strong> We can only read valid <code>.json</code> files. Please try again.', $importDropTarget)
+      }
+    }
+
+    reader.readAsText(file, 'utf-8')
+  }
+
+  $('#import-file-select').on('change', handleConfigFileSelect)
+  $('#import-manual-trigger').on('click', removeImportAlerts)
+
+  var $inputsComponent = $('#less-section input')
+  var $inputsPlugin    = $('#plugin-section input')
+  var $inputsVariables = $('#less-variables-section input')
+
+  $('#less-section .toggle').on('click', function (e) {
+    e.preventDefault()
+    $inputsComponent.prop('checked', !$inputsComponent.is(':checked'))
+  })
+
+  $('#plugin-section .toggle').on('click', function (e) {
+    e.preventDefault()
+    $inputsPlugin.prop('checked', !$inputsPlugin.is(':checked'))
+  })
+
+  $('#less-variables-section .toggle').on('click', function (e) {
+    e.preventDefault()
+    $inputsVariables.val('')
+  })
+
+  $('[data-dependencies]').on('click', function () {
+    if (!$(this).is(':checked')) return
+    var dependencies = this.getAttribute('data-dependencies')
+    if (!dependencies) return
+    dependencies = dependencies.split(',')
+    for (var i = 0, len = dependencies.length; i < len; i++) {
+      var $dependency = $('[value="' + dependencies[i] + '"]')
+      $dependency && $dependency.prop('checked', true)
+    }
+  })
+
+  $('[data-dependents]').on('click', function () {
+    if ($(this).is(':checked')) return
+    var dependents = this.getAttribute('data-dependents')
+    if (!dependents) return
+    dependents = dependents.split(',')
+    for (var i = 0, len = dependents.length; i < len; i++) {
+      var $dependent = $('[value="' + dependents[i] + '"]')
+      $dependent && $dependent.prop('checked', false)
+    }
+  })
+
+  var $compileBtn = $('#btn-compile')
+
+  $compileBtn.on('click', function (e) {
+    e.preventDefault()
+
+    $compileBtn.attr('disabled', 'disabled')
+
+    function generate() {
+      var configData = getCustomizerData()
+      var configJson = JSON.stringify(configData, null, 2)
+      var origin = window.location.protocol + '//' + window.location.host
+      var customizerUrl = origin + window.location.pathname
+
+      var preamble = '/*!\n' +
+        ' * Generated using the Bootstrap Customizer (' + customizerUrl + ')\n' +
+        ' */\n\n'
+
+      $.when(
+        generateCSS(preamble),
+        generateJS(preamble),
+        generateFonts()
+      ).done(function (css, js, fonts) {
+        generateZip(css, js, fonts, configJson, function (blob) {
+          $compileBtn.removeAttr('disabled')
+          setTimeout(function () {
+            saveAs(blob, 'bootstrap.zip')
+          }, 0)
+        })
+      })
+    }
+
+    generate()
+  });
+
+  parseUrl()
+}
@@ -0,0 +1,51 @@
+// NOTICE!! DO NOT USE ANY OF THIS JAVASCRIPT
+// IT'S ALL JUST JUNK FOR OUR DOCS!
+// ++++++++++++++++++++++++++++++++++++++++++
+
+(function () {
+  'use strict'
+
+  var inputElement = document.getElementById('search-input')
+
+  if (!window.docsearch || !inputElement) {
+    return
+  }
+
+  function getOrigin() {
+    var location = window.location
+    var origin = location.origin
+
+    if (!origin) {
+      var port = location.port ? ':' + location.port : ''
+
+      origin = location.protocol + '//' + location.hostname + port
+    }
+
+    return origin
+  }
+
+  window.docsearch({
+    apiKey: 'c8948afa20e6437a6e829f7e87b9ac11',
+    indexName: 'bootstrap-v3',
+    inputSelector: '#search-input',
+    transformData: function (hits) {
+      return hits.map(function (hit) {
+        var siteurl = getOrigin()
+        var urlRE = /^https?:\/\/getbootstrap\.com/
+
+        // When in production, return the result as is,
+        // otherwise remove our url from it.
+        hit.url = siteurl.match(urlRE) ? hit.url : hit.url.replace(urlRE, '')
+
+        // Prevent jumping to first header
+        if (hit.anchor === 'content') {
+          hit.url = hit.url.replace(/#content$/, '')
+          hit.anchor = null
+        }
+
+        return hit
+      })
+    },
+    debug: false // Set debug to true if you want to inspect the dropdown
+  })
+}())