Doc fixes

parent fd18ce46
...@@ -107,12 +107,12 @@ function _drush_bootstrap_generate_docs_settings(Theme $bootstrap) { ...@@ -107,12 +107,12 @@ function _drush_bootstrap_generate_docs_settings(Theme $bootstrap) {
$output[] = $definition['id']; $output[] = $definition['id'];
$output[] = ' </td>'; $output[] = ' </td>';
$output[] = ' <td>'; $output[] = ' <td>';
$output[] = ' <div class="help-block">'; if ($description = trim(str_replace('&quot;', '"', $definition['description']))) {
$output[] = str_replace('&quote;', '"', wordwrap($definition['description'])); $output[] = ' <div class="help-block">' . $description . '</div>';
$output[] = ' </div>'; }
$output[] = ' <pre class=" language-yaml"><code>'; if ($example = trim(Yaml::encode([$definition['id'] => $definition['defaultValue']]))) {
$output[] = wordwrap(Yaml::encode([$definition['id'] => $definition['defaultValue']])); $output[] = ' <pre class="language-yaml"><code>' . $example . '</code></pre>';
$output[] = '</code></pre>'; }
$output[] = ' </td>'; $output[] = ' </td>';
$output[] = ' </tr>'; $output[] = ' </tr>';
} }
......
...@@ -8,12 +8,11 @@ are instructions on how to create a [Drupal Bootstrap] based sub-theme. ...@@ -8,12 +8,11 @@ are instructions on how to create a [Drupal Bootstrap] based sub-theme.
There are several different variations on how to accomplish this task, but this There are several different variations on how to accomplish this task, but this
topic will focus on the two primarily and most common ways. topic will focus on the two primarily and most common ways.
{.alert.alert-warning} **Warning** You should never modify any theme or You should never modify any theme or sub-theme that is packaged and released
sub-theme that is packaged and released from Drupal.org, such as Drupal from Drupal.org, such as Drupal Bootstrap. If you do, all changes you have made
Bootstrap. If you do, all changes you have made will be lost once that theme is will be lost once that theme is updated. Instead, you should create a sub-theme
updated. Instead, you should create a subtheme from one of the provided from one of the provided starterkits (this is considered a best practice). Once
starterkits (this is considered a best practice). Once you've done that, you you've done that, you can override CSS, templates, and theme processing.
can override CSS, templates, and theme processing.
#### Choose a Starterkit {#starterkit} #### Choose a Starterkit {#starterkit}
...@@ -23,18 +22,18 @@ can override CSS, templates, and theme processing. ...@@ -23,18 +22,18 @@ can override CSS, templates, and theme processing.
[Bootstrap Framework] [Less] source files and a local [Less] preprocessor. [Bootstrap Framework] [Less] source files and a local [Less] preprocessor.
- @link sub_theming_sass Sass Starterkit @endlink - uses the - @link sub_theming_sass Sass Starterkit @endlink - uses the
[Bootstrap Framework] [Sass] source files and a local [Sass] preprocessor. [Bootstrap Framework] [Sass] source files and a local [Sass] preprocessor.
{.alert.alert-info} **Note** Using the "CDN Starterkit" is the preferred method {.alert.alert-info} **NOTE:** Using the "CDN Starterkit" is the preferred method
for loading Bootstrap CSS and JS on simpler sites that do not use a site-wide for loading Bootstrap CSS and JS on simpler sites that do not use a site-wide
CDN. Using a CDN Provider for loading Bootstrap, however, does mean that it CDN. There are advantages and disadvantages to using a CDN Provider and you will
depends on a third-party service. There is no obligation or commitment made by need to weigh the benefits based on your site's requirements. Using a CDN
this project or these third-party CDN services that guarantees up-time or Provider does mean that it depends on a third-party service. There is no
quality of service. If you need to customize Bootstrap, you must choose one of obligation or commitment made by this project or these third-party CDN services
the Less or Sass Starterkits, compile the source code locally, and disable the that guarantees up-time or quality of service. If you need to customize
"CDN Provider" theme setting. Alternatively, you may also choose to enable a Bootstrap, you must choose one of the Less or Sass Starterkits, compile the
site-wide CDN implementation for performance reasons. source code locally, and disable the "CDN Provider" theme setting.
{.alert.alert-warning} **Warning** All locally compiled versions of Bootstrap {.alert.alert-warning} **WARNING:** All locally compiled versions of Bootstrap
will be superseded by any enabled "CDN Provider"; **do not use both**. will be superseded by any enabled "CDN Provider"; **do not use both**.
Once you've selected one of the above starterkits, here's how to install it: Once you've selected one of the above starterkits, here's how to install it:
......
This diff is collapsed.
...@@ -15,7 +15,7 @@ use Drupal\Core\Form\FormStateInterface; ...@@ -15,7 +15,7 @@ use Drupal\Core\Form\FormStateInterface;
* id = "tooltip_enabled", * id = "tooltip_enabled",
* type = "checkbox", * type = "checkbox",
* title = @Translation("Enable Bootstrap Tooltips"), * title = @Translation("Enable Bootstrap Tooltips"),
* description = @Translation("Elements that have the <code>data-toggle=&quote;tooltip&quote;</code> attribute set will automatically initialize the tooltip upon page load. <strong class='error text-error'>WARNING: This feature can sometimes impact performance. Disable if pages appear to &quote;hang&quote; after initial load.</strong>"), * description = @Translation("Elements that have the <code>data-toggle=&quot;tooltip&quot;</code> attribute set will automatically initialize the tooltip upon page load. <strong class='error text-error'>WARNING: This feature can sometimes impact performance. Disable if pages appear to &quot;hang&quot; after initial load.</strong>"),
* defaultValue = 1, * defaultValue = 1,
* weight = -1, * weight = -1,
* groups = { * groups = {
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment