diff --git a/404.html b/404.html new file mode 100644 index 0000000000000000000000000000000000000000..56efce4a39e6013188a311c8ac3fdd622b571adb --- /dev/null +++ b/404.html @@ -0,0 +1,11 @@ +--- +layout: default +title: Page not found +permalink: /404 +nav_exclude: true +search_exclude: true +--- + +<h1>Page not found</h1> + +<p>The page you requested could not be found. Try using the navigation {% if site.search_enabled %}or search {% endif %}to find what you're looking for or go to this <a href="{{ site.url }}{{ site.baseurl }}">site's home page</a>.</p> diff --git a/README.md b/README.md index dff46d65116ef21f22b4b4cd907b2bf4962d69d0..c78280a88b05eab762725594216b32e1e2def0f6 100644 --- a/README.md +++ b/README.md @@ -4,12 +4,11 @@ <br><br> <p align="center"> <h1 align="center">Just the Docs</h1> - <p align="center">A modern, high customizable, responsive Jekyll theme for documentation with built-in search.<br>Easily hosted on GitHub pages with few dependencies.</p> - <p align="center"><strong><a href="https://pmarsceill.github.io/just-the-docs">See it in action!</a></strong></p> + <p align="center">A modern, high customizable, responsive Jekyll theme for documentation with built-in search.<br>Easily hosted on GitHub Pages with few dependencies.</p> + <p align="center"><strong><a href="https://pmarsceill.github.io/just-the-docs/">See it in action!</a></strong></p> <br><br><br> </p> -  ## Installation @@ -60,7 +59,7 @@ Bug reports and pull requests are welcome on GitHub at https://github.com/pmarsc To set up your environment to develop this theme, run `bundle install`. -Your theme is setup just like a normal Jekyll site! To test your theme, run `bundle exec jekyll serve` and open your browser at `http://localhost:4000`. This starts a Jekyll server using your theme. Add pages, documents, data, etc. like normal to test your theme's contents. As you make modifications to your theme and to your content, your site will regenerate and you should see the changes in the browser after a refresh, just like normal. +Your theme is set up just like a normal Jekyll site! To test your theme, run `bundle exec jekyll serve` and open your browser at `http://localhost:4000`. This starts a Jekyll server using your theme. Add pages, documents, data, etc. like normal to test your theme's contents. As you make modifications to your theme and to your content, your site will regenerate and you should see the changes in the browser after a refresh, just like normal. When the theme is released, only the files in `_layouts`, `_includes`, and `_sass` tracked with Git will be released. diff --git a/_config.yml b/_config.yml index 9b02ede062746ba7e27d56a6a13ff6ef812bf88b..ed1ee2a759b740b1db856caee4d3b6185a93bab7 100644 --- a/_config.yml +++ b/_config.yml @@ -19,7 +19,7 @@ baseurl: "/just-the-docs/" # the subpath of your site, e.g. /blog # url: "" # the base hostname & protocol for your site, e.g. http://example.com permalink: pretty -exclude: ["node_modules/", "*.gemspec", "*.gem", "Gemfile", "Gemfile.lock", "package.json", "script/", "LICENSE.txt", "lib/", "bin/", "README.md", "Rakefile"] +exclude: ["node_modules/", "*.gemspec", "*.gem", "Gemfile", "Gemfile.lock", "package.json", "package-lock.json", "script/", "LICENSE.txt", "lib/", "bin/", "README.md", "Rakefile"] # Enable or disable the site search search_enabled: true diff --git a/_includes/head.html b/_includes/head.html index cbd41f9d3cd65937ded1b7e991001730b4ac19a2..077564e5a628ee96c0ef7df4f43768bcea703f53 100644 --- a/_includes/head.html +++ b/_includes/head.html @@ -1,6 +1,9 @@ <head> <meta charset="UTF-8"> <meta http-equiv="X-UA-Compatible" content="IE=Edge"> + {% if page.description %} + <meta name="Description" content="{{ page.description }}"> + {% endif %} <title>{{ page.title }} - {{ site.title }}</title> <link rel="stylesheet" href="{{ "/assets/css/just-the-docs.css" | absolute_url }}"> diff --git a/_includes/nav.html b/_includes/nav.html index 4ebd91f3f362e3ac442b3047535f6852fabdad1e..2c4bf1eae5fb75d90ac12854e2be94eca70c2f62 100644 --- a/_includes/nav.html +++ b/_includes/nav.html @@ -1,4 +1,4 @@ -<nav> +<nav role="navigation" aria-label="Main navigation"> <ul class="navigation-list"> {% assign pages_list = site.html_pages | sort:"nav_order" %} {% for node in pages_list %} diff --git a/_layouts/default.html b/_layouts/default.html index d6e610596f560c0e9bc3f1b6342341e98d72d683..ddc2dbbefedf01fed4132e913db04531e3d2876a 100644 --- a/_layouts/default.html +++ b/_layouts/default.html @@ -2,6 +2,7 @@ <html lang="en-us"> {% include head.html %} +<body> <div class="page-wrap"> <div class="side-bar"> @@ -20,7 +21,7 @@ {% if site.search_enabled != nil %} <div class="search js-search"> <div class="search-input-wrap"> - <input type="text" class="js-search-input search-input" placeholder="Search {{ site.title }}" aria-label="Search {{ site.title }}" autocomplete="off"> + <input type="text" class="js-search-input search-input" tabindex="0" placeholder="Search {{ site.title }}" aria-label="Search {{ site.title }}" autocomplete="off"> <svg width="14" height="14" viewBox="0 0 28 28" xmlns="http://www.w3.org/2000/svg" class="search-icon"><title>Search</title><g fill-rule="nonzero"><path d="M17.332 20.735c-5.537 0-10-4.6-10-10.247 0-5.646 4.463-10.247 10-10.247 5.536 0 10 4.601 10 10.247s-4.464 10.247-10 10.247zm0-4c3.3 0 6-2.783 6-6.247 0-3.463-2.7-6.247-6-6.247s-6 2.784-6 6.247c0 3.464 2.7 6.247 6 6.247z"/><path d="M11.672 13.791L.192 25.271 3.02 28.1 14.5 16.62z"/></g></svg> </div> <div class="js-search-results search-results-wrap"></div> @@ -35,7 +36,7 @@ {% endif %} </div> </div> - <div class="main-content"> + <div class="main-content js-main-content" tabindex="0"> {% unless page.url == "/" %} {% if page.parent %} <nav class="breadcrumb-nav"> @@ -51,10 +52,10 @@ </nav> {% endif %} {% endunless %} - <div class="page-content"> + <div id="main-content" class="page-content" role="main"> {{ content }} - {% if page.has_children == true %} + {% if page.has_children == true and page.has_toc != false %} <hr> <h2 class="text-delta">Table of contents</h2> {% assign children_list = site.pages | sort:"nav_order" %} @@ -72,4 +73,6 @@ </div> </div> </div> + +</body> </html> diff --git a/_layouts/page.html b/_layouts/page.html new file mode 100644 index 0000000000000000000000000000000000000000..5e7112684af455284afbddb3a0b289ee21b8db69 --- /dev/null +++ b/_layouts/page.html @@ -0,0 +1,5 @@ +--- +layout: default +--- + +{{ content }} diff --git a/_sass/code.scss b/_sass/code.scss index f29a97c105f370618b21d1abeeb125fc3857c047..e8989f31dc038bb40d69fa094cd0aba58d32486b 100644 --- a/_sass/code.scss +++ b/_sass/code.scss @@ -14,6 +14,7 @@ code { pre.highlight { padding: $sp-3; margin-bottom: 0; + -webkit-overflow-scrolling: touch; background-color: $code-background-color; code { @@ -104,7 +105,7 @@ pre.highlight { .code-example { padding: $sp-3; margin-bottom: $sp-3; - overflow: scroll; + overflow: auto; border: 1px solid $border-color; border-radius: $border-radius; diff --git a/_sass/layout.scss b/_sass/layout.scss index 27f15e9ae8003b1ee58ad63cfe1718532c7b3a6b..11be435c09aa1b23418318298ab613d17ef439da 100644 --- a/_sass/layout.scss +++ b/_sass/layout.scss @@ -74,6 +74,10 @@ } } +.js-main-content:focus { + outline: none; +} + .page-header { background-color: $sidebar-color; diff --git a/assets/css/dark-mode-preview.scss b/assets/css/dark-mode-preview.scss index f30f9e0cdc930e9cb2df4f3bcae7dcbc5a8c8d0d..8b77da6a86422fb0fea410952175c34f65525478 100644 --- a/assets/css/dark-mode-preview.scss +++ b/assets/css/dark-mode-preview.scss @@ -10,7 +10,7 @@ @import "./vendor/normalize.scss/normalize.scss"; // -// Import Just the docs scss +// Import Just the Docs scss // // Support diff --git a/assets/css/just-the-docs.scss b/assets/css/just-the-docs.scss index 601cdaa61450c4a7f4763824c3122b18ca8dd4d8..3431ae8839a857200d8f787929cdc55acc3d5cf4 100644 --- a/assets/css/just-the-docs.scss +++ b/assets/css/just-the-docs.scss @@ -10,7 +10,7 @@ @import "./vendor/normalize.scss/normalize.scss"; // -// Import Just the docs scss +// Import Just the Docs scss // // Support diff --git a/assets/js/just-the-docs.js b/assets/js/just-the-docs.js index 3c0a1b5574f3c94fc4648158b75ff2921d8adacf..bc1365d061c0cec22ffdf874d263735e7781b5ba 100644 --- a/assets/js/just-the-docs.js +++ b/assets/js/just-the-docs.js @@ -150,11 +150,18 @@ function initSearch() { } } +function pageFocus() { + var mainContent = document.querySelector('.js-main-content'); + mainContent.focus(); + console.log(mainContent) +} + // Document ready function ready(){ toggleNav(); + pageFocus(); if (typeof lunr !== 'undefined') { initSearch(); } diff --git a/assets/js/search-data.json b/assets/js/search-data.json index 50a4b9f489a2d69a3b45b79ed00aeca29b2718ae..49cbc9dcbc2eeea44a9d48c8f0cbf3a14def27a9 100644 --- a/assets/js/search-data.json +++ b/assets/js/search-data.json @@ -1,12 +1,12 @@ --- --- { - {% for page in site.html_pages %}"{{ forloop.index0 }}": { + {% for page in site.html_pages %}{% if page.search_exclude != true %}"{{ forloop.index0 }}": { "id": "{{ forloop.index0 }}", - "title": "{{ page.title | xml_escape }}", - "content": "{{ page.content | markdownify | strip_html | xml_escape | remove: 'Table of contents' | strip_newlines | replace: '\', ' ' }}", - "url": "{{ page.url | absolute_url | xml_escape }}", - "relUrl": "{{ page.url | xml_escape }}" - }{% if forloop.last %}{% else %}, + "title": "{{ page.title | replace: '&', '&' }}", + "content": "{{ page.content | markdownify | strip_html | escape_once | remove: 'Table of contents' | remove: '```' | remove: '---' | replace: '\', ' ' | normalize_whitespace }}", + "url": "{{ page.url | absolute_url }}", + "relUrl": "{{ page.url }}" + }{% unless forloop.last %},{% endunless %} {% endif %}{% endfor %} } diff --git a/bin/just-the-docs b/bin/just-the-docs index 6404b2125b4c2070fcc695f4c157688e37a94e57..5a622903058b7f1e332e5a34ae639ed9ab9c2f43 100755 --- a/bin/just-the-docs +++ b/bin/just-the-docs @@ -1,7 +1,7 @@ #!/usr/bin/env ruby gem_dir = File.expand_path("..",File.dirname(__FILE__)) -$LOAD_PATH.unshift gem_dir# Look in gem directory for resources first. +$LOAD_PATH.unshift gem_dir # Look in gem directory for resources first. exec_type = ARGV[0] if exec_type == 'rake' then diff --git a/docs/configuration.md b/docs/configuration.md index 5d47bdec54b41dc77f74a14a112aee1bee3d5ac7..64b23f1a2639919ad668fea24e47fe862b2006e2 100644 --- a/docs/configuration.md +++ b/docs/configuration.md @@ -6,18 +6,18 @@ nav_order: 2 # Configuration -Just the Docs has some specific configuration parameters that can be definied in your Jekyll site's `_config.yml` file. +Just the Docs has some specific configuration parameters that can be defined in your Jekyll site's `_config.yml` file. ## Search enabled -```yml +```yaml # Enable or disable the site search search_enabled: true ``` ## Aux links -```yml +```yaml # Aux links for the upper right navigation aux_links: "Just the Docs on GitHub": @@ -26,7 +26,7 @@ aux_links: ## Color scheme -```yml +```yaml # Color scheme currently only supports "dark" or nil (default) color_scheme: "dark" ``` @@ -39,12 +39,12 @@ const originalCssRef = cssFile.getAttribute('href') const darkModeCssRef = originalCssRef.replace('just-the-docs.css', 'dark-mode-preview.css') addEvent(toggleDarkMode, 'click', function(){ -if (cssFile.getAttribute('href') === originalCssRef) { -cssFile.setAttribute('href', darkModeCssRef) -} else { -cssFile.setAttribute('href', originalCssRef) -} + if (cssFile.getAttribute('href') === originalCssRef) { + cssFile.setAttribute('href', darkModeCssRef) + } else { + cssFile.setAttribute('href', originalCssRef) + } }) </script> -See [Customization]({{site.baseurl }}{% link docs/customization.md %}) for more information. +See [Customization]({{ site.baseurl }}{% link docs/customization.md %}) for more information. diff --git a/docs/customization.md b/docs/customization.md index 6f0961b64770c4e3040dc23deff4456bac92ccd6..f3fe1c036d6bb549638f369c48e911b152444c16 100644 --- a/docs/customization.md +++ b/docs/customization.md @@ -5,7 +5,7 @@ nav_order: 6 --- # Customization -{:.no_toc} +{: .no_toc } ## Table of contents {: .no_toc .text-delta } @@ -16,19 +16,19 @@ nav_order: 6 --- ## Color schemes -{: .d-inline-block :} +{: .d-inline-block } New -{: .label .label-green :} +{: .label .label-green } Just the Docs supports two color schemes: light (default), and dark. To enable a color scheme, set the `color_scheme` parameter in your site's `_config.yml` file: #### Example -{: no_toc } +{: .no_toc } -```yml +```yaml # Color scheme currently only supports "dark" or nil (default) color_scheme: "dark" ``` @@ -49,15 +49,14 @@ addEvent(toggleDarkMode, 'click', function(){ }) </script> - ## Specific visual customization -To customize your site’s aesthetic, open `_sass/custom/custom.scss` in your editor to see if there is a variable that you can override. Most styles like fonts, colors, spacing, etc.. are derived from these variables. To override a specific variable, uncomment out it’s line and change it’s value. +To customize your site’s aesthetic, open `_sass/custom/custom.scss` in your editor to see if there is a variable that you can override. Most styles like fonts, colors, spacing, etc. are derived from these variables. To override a specific variable, uncomment its line and change its value. -For example, to change the link color from the purple default to blue, open `_sass/custom/custom.css` and find the `$link-color` variable on line `50`. Uncomment it out, and change it's value to our `$blue-000` variable, or another shade of your choosing. +For example, to change the link color from the purple default to blue, open `_sass/custom/custom.css` and find the `$link-color` variable on line `50`. Uncomment it, and change its value to our `$blue-000` variable, or another shade of your choosing. #### Example -{: no_toc } +{: .no_toc } ```scss // ... @@ -69,7 +68,6 @@ $link-color: $blue-000; // ... ``` -_Note:_ Editing the variables directly in `_sass/support/variables.scss` is not recommended and can cause other dependancies to fail. +_Note:_ Editing the variables directly in `_sass/support/variables.scss` is not recommended and can cause other dependencies to fail. --- - diff --git a/docs/navigation-structure.md b/docs/navigation-structure.md index cd9de43867834393438259978003b6e90bbe662b..98107cfcc3807de00ccbbcd73a8566019f8c8879 100644 --- a/docs/navigation-structure.md +++ b/docs/navigation-structure.md @@ -25,10 +25,11 @@ By default, all pages will appear as top level pages in the main nav unless a pa ## Ordering pages -To specify a page order, use the `nav_order` variable in your pages' YAML front matter. +To specify a page order, use the `nav_order` parameter in your pages' YAML front matter. #### Example {: .no_toc } + ```yaml --- layout: default @@ -41,10 +42,11 @@ nav_order: 4 ## Excluding pages -For specific pages that you do not wish to include in the main navigation, e.g. a 404 page or a landing page. Use the `nav_exclude: true` parameter in the YAML front matter for that page. +For specific pages that you do not wish to include in the main navigation, e.g. a 404 page or a landing page, use the `nav_exclude: true` parameter in the YAML front matter for that page. #### Example {: .no_toc } + ```yaml --- layout: default @@ -57,7 +59,7 @@ nav_exclude: true ## Pages with children -Sometimes you will want to create a page with many children (a section). First, it is recommended that you keep pages that are related in a directory together... For example, in these docs, we keep all of the written documentation in the `./docs` directory and each of the sections in subdirectories like `./docs/ui-components` and `./docs/utilities`. This gives is an organization like: +Sometimes you will want to create a page with many children (a section). First, it is recommended that you keep pages that are related in a directory together... For example, in these docs, we keep all of the written documentation in the `./docs` directory and each of the sections in subdirectories like `./docs/ui-components` and `./docs/utilities`. This gives us an organization like: ``` +-- .. @@ -86,9 +88,9 @@ Sometimes you will want to create a page with many children (a section). First, +-- .. ``` -On the parent pages, add 2 YAML front matter variables: -- `has_children: true` (tells us that this a parent page) -- `permalink:` set this to the site directories that the contains the pages +On the parent pages, add 2 YAML front matter parameters: +- `has_children: true` (tells us that this is a parent page) +- `permalink:` set this to the site directory that contains the child pages #### Example {: .no_toc } @@ -103,7 +105,7 @@ permalink: /docs/ui-components --- ``` -Here we're setting up the UI Components landing page that is available at `/docs/ui-components`, it has children and is ordered second in the main nav. +Here we're setting up the UI Components landing page that is available at `/docs/ui-components`, which has children and is ordered second in the main nav. ### Child pages {: .text-gamma } @@ -112,6 +114,7 @@ On child pages, simply set the `parent:` YAML front matter to whatever the paren #### Example {: .no_toc } + ```yaml --- layout: default @@ -121,12 +124,30 @@ nav_order: 2 --- ``` -The Buttons page appears a child of UI Components and appears second in the UI Components section. +The Buttons page appears as a child of UI Components and appears second in the UI Components section. + +### Auto-generating Table of Contents + +By default, all pages with children will automatically append a Table of Contents which lists the child pages after the parent page's content. To disable this auto Table of Contents, set `has_toc: false` in the parent page's YAML front matter. + +#### Example +{: .no_toc } + +```yaml +--- +layout: default +title: UI Components +nav_order: 2 +has_children: true +has_toc: false +permalink: /docs/ui-components +--- +``` ### Children with children {: .text-gamma } -Child pages can also have children (grand children). This is achieved by using a similar pattern on the child and grand child pages. +Child pages can also have children (grandchildren). This is achieved by using a similar pattern on the child and grandchild pages. 1. Add the `has_children` attribute to the child 1. Add the `parent` and `grand_parent` attribute to the grandchild @@ -154,7 +175,7 @@ nav_order: 1 --- ``` -Would create the following navigation structure: +This would create the following navigation structure: ``` +-- .. @@ -179,10 +200,10 @@ To add a auxiliary navigation item to your site (in the upper right on all pages #### Example {: .no_toc } -```yml +```yaml # Aux links for the upper right navigation aux_links: -"Just the Docs on GitHub": + "Just the Docs on GitHub": - "//github.com/pmarsceill/just-the-docs" ``` @@ -190,7 +211,7 @@ aux_links: ## In-page navigation with Table of Contents -To generate a Table of Contents on your docs pages, you can use the `{:toc}` method from Kramdown, immediately after an `<ol>` in markdown. This will automatically generate an ordered list of anchor links to various sections of page based on headings and heading levels. There may be occasions where you're using a heading and you don't want it to show up in the TOC, to skip a particular heading use the `{: .no_toc }` CSS class. +To generate a Table of Contents on your docs pages, you can use the `{:toc}` method from Kramdown, immediately after an `<ol>` in Markdown. This will automatically generate an ordered list of anchor links to various sections of the page based on headings and heading levels. There may be occasions where you're using a heading and you don't want it to show up in the TOC, so to skip a particular heading use the `{: .no_toc }` CSS class. #### Example {: .no_toc } diff --git a/docs/search.md b/docs/search.md index 0c9543fd056ba35a0a4ed89257a8595adcd1726e..134e3997bccdc02afe30e101dad3ce0804fe124c 100644 --- a/docs/search.md +++ b/docs/search.md @@ -5,8 +5,17 @@ nav_order: 7 --- # Search +{: .no_toc } -Just the docs uses [lunr.js](http://lunrjs.com) to add a client-side search interface powered by a JSON index that Jekyll generates. All search results are shown in an auto-complete style interface (there is no search results page). By default, all generated html pages are indexed using the following data points: +## Table of contents +{: .no_toc .text-delta } + +1. TOC +{:toc} + +--- + +Just the Docs uses [lunr.js](http://lunrjs.com) to add a client-side search interface powered by a JSON index that Jekyll generates. All search results are shown in an auto-complete style interface (there is no search results page). By default, all generated HTML pages are indexed using the following data points: - Page title - Page content @@ -14,41 +23,54 @@ Just the docs uses [lunr.js](http://lunrjs.com) to add a client-side search inte ## Set up search -### 1. Generate search index +### Generate search index -Before you can use search, you must initialize the feature by running this -rake command that comes with the `just-the-docs` +Before you can use search, you must initialize the feature by running this `rake` command that comes with `just-the-docs`: ```bash $ bundle exec just-the-docs rake search:init ``` -This command creates the `search-data.json` file that Jekyll uses to create -your search index. Alternatively, you can create the file manually in the -`assets/js/` of your Jekyll site with this content: +This command creates the `search-data.json` file that Jekyll uses to create your search index. Alternatively, you can create the file manually in the `assets/js/` directory of your Jekyll site with this content: -```{% raw %} ---- +```liquid +{% raw %}--- --- { - {% for page in site.html_pages %}"{{ forloop.index0 }}": { + {% for page in site.html_pages %}{% if page.search_exclude != true %}"{{ forloop.index0 }}": { "id": "{{ forloop.index0 }}", - "title": "{{ page.title | xml_escape }}", - "content": "{{ page.content | markdownify | strip_html | xml_escape | remove: 'Table of contents' | remove: page.title | strip_newlines | replace: '\', ' '}}", - "url": "{{ page.url | absolute_url | xml_escape }}", - "relUrl": "{{ page.url | xml_escape }}" - }{% if forloop.last %}{% else %}, + "title": "{{ page.title | replace: '&', '&' }}", + "content": "{{ page.content | markdownify | strip_html | escape_once | remove: 'Table of contents' | remove: '```' | remove: '---' | replace: '\', ' ' | normalize_whitespace }}", + "url": "{{ page.url | absolute_url }}", + "relUrl": "{{ page.url }}" + }{% unless forloop.last %},{% endunless %} {% endif %}{% endfor %} }{% endraw %} ``` _Note: If you don't run this rake command or create this file manually, search will not work (or it will use the search index data from this docs site, not your site's content)._ -### 2. Enable search in configuration +### Enable search in configuration -In your site's `_config.yml` enable search: +In your site's `_config.yml`, enable search: -```yml +```yaml # Enable or disable the site search search_enabled: true ``` + +## Hiding pages from search + +Sometimes you might have a page that you don't want to be indexed for the search nor to show up in search results, e.g, a 404 page. To exclude a page from search, add the `search_exclude: true` parameter to the page's YAML front matter: + +#### Example +{: .no_toc } + +```yaml +--- +layout: default +title: Page not found +nav_exclude: true +search_exclude: true +--- +``` diff --git a/docs/ui-components/buttons.md b/docs/ui-components/buttons.md index 8da7729d1a595ec6812fd1fb37c1a34901e52a96..3297f29498c36391b9778dce5a00a2f64dea2512 100644 --- a/docs/ui-components/buttons.md +++ b/docs/ui-components/buttons.md @@ -6,7 +6,7 @@ nav_order: 2 --- # Buttons -{:.no_toc} +{: .no_toc } ## Table of contents {: .no_toc .text-delta } @@ -28,7 +28,6 @@ nav_order: 2 [Link button](http://example.com/){: .btn .btn-green } [Link button](http://example.com/){: .btn .btn-outline } - </div> ```markdown [Link button](http://example.com/){: .btn } @@ -42,13 +41,10 @@ nav_order: 2 ### Button element -GitHub flavored markdown does not support the `button` element, so you'll have to use inline HTML for this: - +GitHub Flavored Markdown does not support the `button` element, so you'll have to use inline HTML for this: <div class="code-example"> - <button type="button" name="button" class="btn">Button element</button> - </div> ```html <button type="button" name="button" class="btn">Button element</button> @@ -60,11 +56,9 @@ GitHub flavored markdown does not support the `button` element, so you'll have t ### Button size -Wrap the button in container that uses the [font-size utility classes]({{ -site.baseurl }}{% link docs/utilities/typography.md %}) to scale buttons: +Wrap the button in a container that uses the [font-size utility classes]({{ site.baseurl }}{% link docs/utilities/typography.md %}) to scale buttons: <div class="code-example" markdown="1"> - <span class="fs-6"> [Big ass button](http://example.com/){: .btn } </span> @@ -72,7 +66,6 @@ site.baseurl }}{% link docs/utilities/typography.md %}) to scale buttons: <span class="fs-3"> [Tiny ass button](http://example.com/){: .btn } </span> - </div> ```markdown <span class="fs-8"> @@ -86,20 +79,19 @@ site.baseurl }}{% link docs/utilities/typography.md %}) to scale buttons: ### Spacing between buttons -Use the [margin utility classes]({{ site.baseurl }}{% link docs/utilities/utilities.md %}#spacing) to add spacing between two buttons in the same block. +Use the [margin utility classes]({{ site.baseurl }}{% link docs/utilities/layout.md %}#spacing) to add spacing between two buttons in the same block. <div class="code-example" markdown="1"> +[Button with space](http://example.com/){: .btn .btn-purple .mr-2 } +[Button ](http://example.com/){: .btn .btn-blue .mr-2 } -[Button with space](http://example.com/){: .btn .btn-purple .mr-2} -[Button ](http://example.com/){: .btn .btn-blue .mr-2} - -[Button with more space](http://example.com/){: .btn .btn-green .mr-4} +[Button with more space](http://example.com/){: .btn .btn-green .mr-4 } [Button ](http://example.com/){: .btn .btn-blue } </div> ```markdown -[Button with space](http://example.com/){: .btn .btn-purple .mr-2} +[Button with space](http://example.com/){: .btn .btn-purple .mr-2 } [Button ](http://example.com/){: .btn .btn-blue } -[Button with more space](http://example.com/){: .btn .btn-green .mr-4} +[Button with more space](http://example.com/){: .btn .btn-green .mr-4 } [Button ](http://example.com/){: .btn .btn-blue } ``` diff --git a/docs/ui-components/code.md b/docs/ui-components/code.md index 40faf41272d69cea0e9c4403870d98e9273d14b0..74fbdf9de02299a535b08564d8171eccd2a2cea2 100644 --- a/docs/ui-components/code.md +++ b/docs/ui-components/code.md @@ -6,7 +6,7 @@ nav_order: 6 --- # Code -{:.no_toc} +{: .no_toc } ## Table of contents {: .no_toc .text-delta } @@ -18,12 +18,10 @@ nav_order: 6 ## Inline code -Code can be rendered inline using single ticks by wrapping your code in single back ticks. +Code can be rendered inline by wrapping it in single back ticks. <div class="code-example" markdown="1"> - Lorem ipsum dolor sit amet, `<inline code snippet>` adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. - </div> ```markdown Lorem ipsum dolor sit amet, `<inline code snippet>` adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. @@ -33,7 +31,7 @@ Lorem ipsum dolor sit amet, `<inline code snippet>` adipisicing elit, sed do eiu ## Syntax highlighted code blocks -Use Jekyll's built in syntax highlighting with Rouge for code blocks by using three backticks, followed by the language name: +Use Jekyll's built-in syntax highlighting with Rouge for code blocks by using three backticks, followed by the language name: <div class="code-example" markdown="1"> ```js @@ -58,7 +56,7 @@ var fun = function lang(l) { ## Code blocks with rendered examples -To demonstrate front end code, sometimes it useful to show a rendered example of that code. After including the styles from your project that you'll need to show the rendering, you can use a div with the `code-example` class, followed by the code block syntax. If you want to render your output with Markdown instead of HTML, use the `markdown="1"` attribute to tell Jekyll that the code you are rendering will be in Markdown format... This is about to get meta... +To demonstrate front end code, sometimes it's useful to show a rendered example of that code. After including the styles from your project that you'll need to show the rendering, you can use a `<div>` with the `code-example` class, followed by the code block syntax. If you want to render your output with Markdown instead of HTML, use the `markdown="1"` attribute to tell Jekyll that the code you are rendering will be in Markdown format... This is about to get meta... <div class="code-example" markdown="1"> diff --git a/docs/ui-components/labels.md b/docs/ui-components/labels.md index f3742469f93529db85d4729242c69f77e1470831..05f02d44283a4a711434bf5f441f24767cc6b32f 100644 --- a/docs/ui-components/labels.md +++ b/docs/ui-components/labels.md @@ -10,42 +10,40 @@ nav_order: 3 Use labels as a way to add an additional mark to a section of your docs. Labels come in a few colors. By default, labels will be blue. <div class="code-example" markdown="1"> - Default label {: .label } Blue label -{: .label .label-blue} +{: .label .label-blue } Stable -{: .label .label-green} +{: .label .label-green } New release -{: .label .label-purple} +{: .label .label-purple } Coming soon -{: .label .label-yellow} +{: .label .label-yellow } Deprecated -{: .label .label-red} - +{: .label .label-red } </div> ```markdown Default label {: .label } Blue label -{: .label .label-blue} +{: .label .label-blue } Stable -{: .label .label-green} +{: .label .label-green } New release -{: .label .label-purple} +{: .label .label-purple } Coming soon -{: .label .label-yellow} +{: .label .label-yellow } Deprecated -{: .label .label-red} +{: .label .label-red } ``` diff --git a/docs/ui-components/lists.md b/docs/ui-components/lists.md index 364316e40d171c1f72bd7c39d718ddf25a7272d5..12492c84e90f5a459f1b08e0d146a8c467ca6908 100644 --- a/docs/ui-components/lists.md +++ b/docs/ui-components/lists.md @@ -6,7 +6,7 @@ nav_order: 5 --- # Lists -{:.no_toc} +{: .no_toc } ## Table of contents {: .no_toc .text-delta } @@ -16,9 +16,10 @@ nav_order: 5 --- -Most lists can be rendered with pure markdown... +Most lists can be rendered with pure Markdown. ## Unordered list + <div class="code-example" markdown="1"> - Item 1 - Item 2 @@ -42,18 +43,19 @@ _or_ * Item 3 ``` - ## Ordered list + <div class="code-example" markdown="1"> 1. Item 1 1. Item 2 1. Item 3 </div> - ```markdown +```markdown 1. Item 1 1. Item 2 1. Item 3 - ``` +``` + ## Task list <div class="code-example" markdown="1"> @@ -61,15 +63,15 @@ _or_ - [ ] hello, this is another todo item - [x] goodbye, this item is done </div> - ```markdown +```markdown - [ ] hello, this is a todo item - [ ] hello, this is another todo item - [x] goodbye, this item is done - ``` +``` ## Definition list -Definition lists require HTML syntax and aren't supported with the GitHub flavored markdown compiler. +Definition lists require HTML syntax and aren't supported with the GitHub Flavored Markdown compiler. <div class="code-example" markdown="1"> <dl> @@ -95,4 +97,3 @@ Definition lists require HTML syntax and aren't supported with the GitHub flavor <dd>Green</dd> </dl> ``` - diff --git a/docs/ui-components/typography.md b/docs/ui-components/typography.md index 6cb1df5db95f9465e435d05d0f4fa183e6c82d47..2838a795fff7a83c2250204d8e83e1a1969b489d 100644 --- a/docs/ui-components/typography.md +++ b/docs/ui-components/typography.md @@ -6,7 +6,7 @@ nav_order: 1 --- # Typography -{:.no_toc} +{: .no_toc } ## Table of contents {: .no_toc .text-delta } @@ -24,17 +24,17 @@ By default, Just the Docs uses a native system font stack for sans-serif fonts: -apple-system, BlinkMacSystemFont, "helvetica neue", helvetica, roboto, noto, "segoe ui", arial, sans-serif ``` -ABCDEFGHIJKLMNOPQRSTUVWXYZ +ABCDEFGHIJKLMNOPQRSTUVWXYZ abcdefghijklmnopqrstuvwxyz {: .fs-5 .ls-10 .code-example } -For monospace type, like code snippets or the pre `<pre>` element, Just the Docs uses a native system font stack for monospace fonts: +For monospace type, like code snippets or the `<pre>` element, Just the Docs uses a native system font stack for monospace fonts: ```scss "SFMono-Regular", Menlo, Consolas, Monospace ``` -ABCDEFGHIJKLMNOPQRSTUVWXYZ +ABCDEFGHIJKLMNOPQRSTUVWXYZ abcdefghijklmnopqrstuvwxyz {: .fs-5 .ls-10 .text-mono .code-example } @@ -42,7 +42,7 @@ abcdefghijklmnopqrstuvwxyz ## Responsive type scale -Just the docs uses a responsive type scale that shifts depending on the viewport size. Common elements text elements rendered from markdown use a +Just the Docs uses a responsive type scale that shifts depending on the viewport size. | Selector | Small screen size `font-size` | Large screen size `font-size` | |:----------------------|:---------------------------------|:------------------------------| @@ -51,7 +51,7 @@ Just the docs uses a responsive type scale that shifts depending on the viewport | `h3`, `.text-gamma` | 16px | 18px | | `h4`, `.text-delta` | 14px | 16px | | `h5`, `.text-epsilon` | 16px | 18px | -| `h6`, `.text-zeta ` | 18px | 24px | +| `h6`, `.text-zeta` | 18px | 24px | | `body` | 14px | 16px | --- @@ -109,6 +109,6 @@ Text can be **bold**, _italic_, or ~~strikethrough~~. ## Typographic Utilities -There are a number of specific typographic CSS classes that allow you to do override default styling for font size, font-weight, line height, and capitalization. +There are a number of specific typographic CSS classes that allow you to override default styling for font size, font weight, line height, and capitalization. [View typography utilities]({{ site.baseurl }}{% link docs/utilities/utilities.md %}#typography){: .btn .btn-outline } diff --git a/docs/utilities/color.md b/docs/utilities/color.md index f025f9116b6bf573b3be076a4f2df4b030ce48cb..ba90b3b95530f5a8917bf23f6178d68ce7158e78 100644 --- a/docs/utilities/color.md +++ b/docs/utilities/color.md @@ -1,12 +1,12 @@ --- layout: default title: Color -nav_order: 3 parent: Utilities +nav_order: 3 --- # Color Utilities -{:.no_toc} +{: .no_toc } ## Table of contents {: .no_toc .text-delta } @@ -16,7 +16,7 @@ parent: Utilities --- -All the colors used in Just the Docs have been systemsized into a series of variables that have been extended to both font color and background color utility classes. +All the colors used in Just the Docs have been systematized into a series of variables that have been extended to both font color and background color utility classes. ## Light Greys diff --git a/docs/utilities/layout.md b/docs/utilities/layout.md index a1b564ef3a41c34409cfcb0ecaffcb588441ff1a..ff248b3a598ddd9f5b8a940339c4a4ecb30db417 100644 --- a/docs/utilities/layout.md +++ b/docs/utilities/layout.md @@ -1,13 +1,12 @@ --- layout: default title: Layout -nav_order: 2 parent: Utilities -has_children: true +nav_order: 2 --- # Layout Utilities -{:.no_toc} +{: .no_toc } ## Table of contents {: .no_toc .text-delta } @@ -57,15 +56,14 @@ Spacing values are based on a `1rem = 16px` spacing scale, broken down into thes #### Examples {: .no_toc } -```markdown In Markdown, use the `{: }` wrapper to apply custom classes: +```markdown This paragraph will have a margin bottom of 1rem/16px at large screens. {: .mb-lg-4 } This paragraph will have 2rem/32px of padding on the right and left at all screen sizes. {: .px-6 } - ``` ## Vertical Alignment @@ -96,9 +94,9 @@ Use these classes in conjunction with the responsive modifiers. #### Examples {: .no_toc } -```markdown In Markdown, use the `{: }` wrapper to apply custom classes: +```markdown This button will be hidden until medium screen sizes: [ A button ](#url) @@ -111,5 +109,4 @@ These headings will be `inline-block`: ### heading 3 { .d-inline-block } - ``` diff --git a/docs/utilities/responsive-modifiers.md b/docs/utilities/responsive-modifiers.md index 235a1a838f57f6ca9d65353b8bd13ccef41e28ad..bc5e2cb2def922e11109814a84ff095495bf76c5 100644 --- a/docs/utilities/responsive-modifiers.md +++ b/docs/utilities/responsive-modifiers.md @@ -1,8 +1,8 @@ --- layout: default title: Responsive Modifiers -nav_order: 1 parent: Utilities +nav_order: 1 --- # Responsive modifiers diff --git a/docs/utilities/typography.md b/docs/utilities/typography.md index a517384c65f4e387844aeeeee8e9322918a7dfdd..786b65a504da9e0fa99f7c3198de2e70a589f750 100644 --- a/docs/utilities/typography.md +++ b/docs/utilities/typography.md @@ -1,12 +1,12 @@ --- layout: default title: Typography -nav_order: 3 parent: Utilities +nav_order: 4 --- # Typography Utilities -{:.no_toc} +{: .no_toc } ## Table of contents {: .no_toc .text-delta } @@ -117,33 +117,31 @@ Use the `lh-` classes to explicitly apply line height to text. | `.lh-tight` | 1.1 | Default for headings | | `.lh-default` | 1.4 | Default for body (paragraphs) | - - <div class="code-example" markdown="1"> -No Line height +No Line height No Line height {: .lh-0 } -Tight line height +Tight line height Tight line height {: .lh-tight } -Default line height +Default line height Default line height {: .fh-default } </div> ```markdown In Markdown, use the `{: }` wrapper to apply custom classes: -No Line height +No Line height No Line height {: .lh-0 } -Tight line height +Tight line height Tight line height {: .lh-tight } -Default line height +Default line height Default line height {: .fh-default } ``` diff --git a/docs/utilities/utilities.md b/docs/utilities/utilities.md index b3683375712dba49144c418812763422c3a2d89d..fe4f78056213f03127ea19fc9dd9f8d54cd34557 100644 --- a/docs/utilities/utilities.md +++ b/docs/utilities/utilities.md @@ -7,7 +7,7 @@ permalink: docs/utilities --- # Utilities -{:.no_toc} +{: .no_toc } -CSS utility classes come in handy when you to want to override default styles to give create additional whitespace (margins/padding), unexpected shifts in font-size or weight, add color, or to hide (or show) something a specific screen size. +CSS utility classes come in handy when you to want to override default styles to create additional whitespace (margins/padding), correct unexpected shifts in font size or weight, add color, or hide (or show) something at a specific screen size. {: .fs-6 .fw-300 } diff --git a/index.md b/index.md index e960388095f5fb0c89ed4c2d4b2d6eec2323f756..aef0e2dc6798f9b1a47fdfa92c1365da68a1c6e4 100644 --- a/index.md +++ b/index.md @@ -2,32 +2,36 @@ layout: default title: Home nav_order: 1 +description: "Just the Docs is a responsive Jekyll theme with built-in search that is easily customizable and hosted on GitHub Pages." permalink: / --- - # Focus on writing good documentation {: .fs-9 } -Just the Docs gives your documentation a jumpstart with a responsive Jekyll theme that is easily customizable and hosted on GitHub pages. +Just the Docs gives your documentation a jumpstart with a responsive Jekyll theme that is easily customizable and hosted on GitHub Pages. {: .fs-6 .fw-300 } -[Get started now](#getting-started){: .btn .btn-primary .fs-5 .mb-4 .mb-md-0 .mr-2 } [View it on GitHub](https://github.com/pmarsceill/just-the-docs){: .btn .fs-5 } +[Get started now](#getting-started){: .btn .btn-primary .fs-5 .mb-4 .mb-md-0 .mr-2 } [View it on GitHub](https://github.com/pmarsceill/just-the-docs){: .btn .fs-5 .mb-4 .mb-md-0 } --- ## Getting started + ### Dependencies -Just the Docs is built for [Jekyll](https://jekyllrb.com), a static site generator. View the [quick start guide](https://jekyllrb.com/docs/quickstart/) for more information. Just the Docs requires no special Jekyll plugins and can run on GitHub Pages standard Jekyll compiler. + +Just the Docs is built for [Jekyll](https://jekyllrb.com), a static site generator. View the [quick start guide](https://jekyllrb.com/docs/) for more information. Just the Docs requires no special Jekyll plugins and can run on GitHub Pages' standard Jekyll compiler. ### Quick start: Use as a GitHub Pages remote theme + 1. Add Just the Docs to your Jekyll site's `_config.yml` as a [remote theme](https://blog.github.com/2017-11-29-use-any-theme-with-github-pages/) ```yaml remote_theme: pmarsceill/just-the-docs ``` -<small>You must have GitHub pages enabled on your repo, one or more markdown files, and a `_config.yml` file. [See an example repository](https://github.com/pmarsceill/jtd-remote)</small> +<small>You must have GitHub Pages enabled on your repo, one or more Markdown files, and a `_config.yml` file. [See an example repository](https://github.com/pmarsceill/jtd-remote)</small> ### Local installation: Use the gem-based theme + 1. Install the Ruby Gem ```bash $ gem install just-the-docs @@ -55,8 +59,8 @@ $ bundle exec jekyll serve 4. Point your web browser to [http://localhost:4000](http://localhost:4000) ### Configure Just the Docs -- [See configuration options]({{ site.baseurl }}{% link docs/configuration.md %}) +- [See configuration options]({{ site.baseurl }}{% link docs/configuration.md %}) --- @@ -73,7 +77,6 @@ Just the Docs is distributed by an [MIT license](https://github.com/pmarsceill/j When contributing to this repository, please first discuss the change you wish to make via issue, email, or any other method with the owners of this repository before making a change. Read more about becoming a contributor in [our GitHub repo](https://github.com/pmarsceill/just-the-docs#contributing). - ### Code of Conduct Just the Docs is committed to fostering a welcoming community. diff --git a/just-the-docs.gemspec b/just-the-docs.gemspec index 5ae496b3d36085105655aee70cfffd298ca7b3ec..aba1bb57f3519fe09dd23803adcd016565fce2f0 100644 --- a/just-the-docs.gemspec +++ b/just-the-docs.gemspec @@ -6,7 +6,7 @@ Gem::Specification.new do |spec| spec.authors = ["Patrick Marsceill"] spec.email = ["patrick.marsceill@gmail.com"] - spec.summary = %q{A nice looking, high customizable, responsive Jekyll theme for documention with built-in search.} + spec.summary = %q{A nice looking, highly customizable, responsive Jekyll theme for documentation with built-in search.} spec.homepage = "https://github.com/pmarsceill/just-the-docs" spec.license = "MIT" @@ -16,5 +16,5 @@ Gem::Specification.new do |spec| spec.add_runtime_dependency "jekyll", "~> 3.8.5" spec.add_runtime_dependency "rake", "~> 12.3.1" - spec.add_development_dependency "bundler", "~> 1.17.1" + spec.add_development_dependency "bundler", "~> 2.0.1" end diff --git a/lib/tasks/search.rake b/lib/tasks/search.rake index 02d0b5e421b9421056586783dd3f1e745bd12b80..50ef275c3ec4dea13bcb10031c1eaf43bd786226 100644 --- a/lib/tasks/search.rake +++ b/lib/tasks/search.rake @@ -4,7 +4,7 @@ namespace :search do puts 'Creating search data json file...' mkdir_p 'assets/js' touch 'assets/js/search-data.json' - content = %Q[{{ page.content | markdownify | strip_html | xml_escape | remove: 'Table of contents' | strip_newlines | replace: '\\', ' ' }}] + content = %Q[{{ page.content | markdownify | strip_html | escape_once | remove: 'Table of contents' | remove: '```' | remove: '---' | replace: '\\', ' ' | normalize_whitespace }}] puts 'Done.' puts 'Generating content...' @@ -12,13 +12,13 @@ namespace :search do f.puts '--- --- { - {% for page in site.html_pages %}"{{ forloop.index0 }}": { + {% for page in site.html_pages %}{% if page.search_exclude != true %}"{{ forloop.index0 }}": { "id": "{{ forloop.index0 }}", - "title": "{{ page.title | xml_escape }}", + "title": "{{ page.title | replace: '&', '&' }}", "content": "'+content+'", - "url": "{{ page.url | absolute_url | xml_escape }}", - "relUrl": "{{ page.url | xml_escape }}" - }{% if forloop.last %}{% else %}, + "url": "{{ page.url | absolute_url }}", + "relUrl": "{{ page.url }}" + }{% unless forloop.last %},{% endunless %} {% endif %}{% endfor %} }' end diff --git a/package-lock.json b/package-lock.json index ad8af1441fe25c221ab8ab6fd45b074f53a8c7e4..b5e98c570e0bb5fb402b854f165ce3f53c459783 100644 --- a/package-lock.json +++ b/package-lock.json @@ -682,7 +682,7 @@ }, "chalk": { "version": "1.1.3", - "resolved": "http://registry.npmjs.org/chalk/-/chalk-1.1.3.tgz", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-1.1.3.tgz", "integrity": "sha1-qBFcVeSnAv5NFQq9OHKCKn4J/Jg=", "dev": true, "requires": { @@ -751,7 +751,7 @@ }, "strip-ansi": { "version": "3.0.1", - "resolved": "http://registry.npmjs.org/strip-ansi/-/strip-ansi-3.0.1.tgz", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-3.0.1.tgz", "integrity": "sha1-ajhfuIU9lS1f8F0Oiq+UJ43GPc8=", "dev": true, "requires": { @@ -766,7 +766,7 @@ }, "yargs": { "version": "1.3.3", - "resolved": "http://registry.npmjs.org/yargs/-/yargs-1.3.3.tgz", + "resolved": "https://registry.npmjs.org/yargs/-/yargs-1.3.3.tgz", "integrity": "sha1-BU3oth8i7v23IHBZ6u+da4P7kxo=", "dev": true } @@ -856,7 +856,7 @@ }, "readable-stream": { "version": "1.0.34", - "resolved": "http://registry.npmjs.org/readable-stream/-/readable-stream-1.0.34.tgz", + "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-1.0.34.tgz", "integrity": "sha1-Elgg40vIQtLyqq+v5MKRbuMsFXw=", "dev": true, "requires": { @@ -868,13 +868,13 @@ }, "string_decoder": { "version": "0.10.31", - "resolved": "http://registry.npmjs.org/string_decoder/-/string_decoder-0.10.31.tgz", + "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-0.10.31.tgz", "integrity": "sha1-YuIDvEF2bGwoyfyEMB2rHFMQ+pQ=", "dev": true }, "through2": { "version": "0.6.5", - "resolved": "http://registry.npmjs.org/through2/-/through2-0.6.5.tgz", + "resolved": "https://registry.npmjs.org/through2/-/through2-0.6.5.tgz", "integrity": "sha1-QaucZ7KdVyCQcUEOHXp6lozTrUg=", "dev": true, "requires": { @@ -902,7 +902,7 @@ }, "readable-stream": { "version": "1.1.14", - "resolved": "http://registry.npmjs.org/readable-stream/-/readable-stream-1.1.14.tgz", + "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-1.1.14.tgz", "integrity": "sha1-fPTFTvZI44EwhMY23SB54WbAgdk=", "dev": true, "requires": { @@ -914,7 +914,7 @@ }, "string_decoder": { "version": "0.10.31", - "resolved": "http://registry.npmjs.org/string_decoder/-/string_decoder-0.10.31.tgz", + "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-0.10.31.tgz", "integrity": "sha1-YuIDvEF2bGwoyfyEMB2rHFMQ+pQ=", "dev": true } @@ -1012,7 +1012,6 @@ "integrity": "sha1-AwiOnr+edWtpdRYR0qXvWRSCyZU=", "requires": { "decamelize": "^1.1.1", - "os-locale": "^1.4.0", "window-size": "^0.1.4" } } @@ -1047,119 +1046,11 @@ "yargs": "^12.0.2" }, "dependencies": { - "find-up": { - "version": "3.0.0", - "resolved": "https://registry.npmjs.org/find-up/-/find-up-3.0.0.tgz", - "integrity": "sha512-1yD6RmLI1XBfxugvORwlck6f75tYL+iR0jqwsOrOxMZyGYqUuDhJ0l4AXdO1iX/FTs9cBAMEk1gWSEx1kSbylg==", - "dev": true, - "requires": { - "locate-path": "^3.0.0" - } - }, - "locate-path": { - "version": "3.0.0", - "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-3.0.0.tgz", - "integrity": "sha512-7AO748wWnIhNqAuaty2ZWHkQHRSNfPVIsPIfwEOWO22AmaoVrWavlOcMR5nzTLNYvp36X220/maaRsrec1G65A==", - "dev": true, - "requires": { - "p-locate": "^3.0.0", - "path-exists": "^3.0.0" - } - }, - "os-locale": { - "version": "3.0.1", - "resolved": "https://registry.npmjs.org/os-locale/-/os-locale-3.0.1.tgz", - "integrity": "sha512-7g5e7dmXPtzcP4bgsZ8ixDVqA7oWYuEz4lOSujeWyliPai4gfVDiFIcwBg3aGCPnmSGfzOKTK3ccPn0CKv3DBw==", - "dev": true, - "requires": { - "execa": "^0.10.0", - "lcid": "^2.0.0", - "mem": "^4.0.0" - } - }, - "p-limit": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-2.0.0.tgz", - "integrity": "sha512-fl5s52lI5ahKCernzzIyAP0QAZbGIovtVHGwpcu1Jr/EpzLVDI2myISHwGqK7m8uQFugVWSrbxH7XnhGtvEc+A==", - "dev": true, - "requires": { - "p-try": "^2.0.0" - } - }, - "p-locate": { - "version": "3.0.0", - "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-3.0.0.tgz", - "integrity": "sha512-x+12w/To+4GFfgJhBEpiDcLozRJGegY+Ei7/z0tSLkMmxGZNybVMSfWj9aJn8Z5Fc7dBUNJOOVgPv2H7IwulSQ==", - "dev": true, - "requires": { - "p-limit": "^2.0.0" - } - }, - "p-try": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/p-try/-/p-try-2.0.0.tgz", - "integrity": "sha512-hMp0onDKIajHfIkdRk3P4CdCmErkYAxxDtP3Wx/4nZ3aGlau2VKh3mZpcuFkH27WQkL/3WBCPOktzA9ZOAnMQQ==", - "dev": true - }, - "readable-stream": { - "version": "2.3.6", - "resolved": "http://registry.npmjs.org/readable-stream/-/readable-stream-2.3.6.tgz", - "integrity": "sha512-tQtKA9WIAhBF3+VLAseyMqZeBjW0AHJoxOtYqSUZNJxauErmLbVm2FW1y+J/YA9dUrAC39ITejlZWhVIwawkKw==", - "dev": true, - "requires": { - "core-util-is": "~1.0.0", - "inherits": "~2.0.3", - "isarray": "~1.0.0", - "process-nextick-args": "~2.0.0", - "safe-buffer": "~5.1.1", - "string_decoder": "~1.1.1", - "util-deprecate": "~1.0.1" - } - }, "source-map": { "version": "0.7.3", "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.7.3.tgz", "integrity": "sha512-CkCj6giN3S+n9qrYiBTX5gystlENnRW5jZeNLHpe6aue+SrHcG5VYwujhW9s4dY31mEGsxBDrHR6oI69fTXsaQ==", "dev": true - }, - "string_decoder": { - "version": "1.1.1", - "resolved": "http://registry.npmjs.org/string_decoder/-/string_decoder-1.1.1.tgz", - "integrity": "sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg==", - "dev": true, - "requires": { - "safe-buffer": "~5.1.0" - } - }, - "through2": { - "version": "2.0.5", - "resolved": "https://registry.npmjs.org/through2/-/through2-2.0.5.tgz", - "integrity": "sha512-/mrRod8xqpA+IHSLyGCQ2s8SPHiCDEeQJSep1jqLYeEUClOFG2Qsh+4FU6G9VeqpZnGW/Su8LQGc4YKni5rYSQ==", - "dev": true, - "requires": { - "readable-stream": "~2.3.6", - "xtend": "~4.0.1" - } - }, - "yargs": { - "version": "12.0.5", - "resolved": "https://registry.npmjs.org/yargs/-/yargs-12.0.5.tgz", - "integrity": "sha512-Lhz8TLaYnxq/2ObqHDql8dX8CJi97oHxrjUcYtzKbbykPtVW9WB+poxI+NM2UIzsMgNCZTIf0AQwsjK5yMAqZw==", - "dev": true, - "requires": { - "cliui": "^4.0.0", - "decamelize": "^1.2.0", - "find-up": "^3.0.0", - "get-caller-file": "^1.0.1", - "os-locale": "^3.0.0", - "require-directory": "^2.1.1", - "require-main-filename": "^1.0.1", - "set-blocking": "^2.0.0", - "string-width": "^2.0.0", - "which-module": "^2.0.0", - "y18n": "^3.2.1 || ^4.0.0", - "yargs-parser": "^11.1.1" - } } } }, @@ -1238,7 +1129,7 @@ }, "readable-stream": { "version": "1.1.14", - "resolved": "http://registry.npmjs.org/readable-stream/-/readable-stream-1.1.14.tgz", + "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-1.1.14.tgz", "integrity": "sha1-fPTFTvZI44EwhMY23SB54WbAgdk=", "dev": true, "requires": { @@ -1250,7 +1141,7 @@ }, "string_decoder": { "version": "0.10.31", - "resolved": "http://registry.npmjs.org/string_decoder/-/string_decoder-0.10.31.tgz", + "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-0.10.31.tgz", "integrity": "sha1-YuIDvEF2bGwoyfyEMB2rHFMQ+pQ=", "dev": true } @@ -2383,7 +2274,7 @@ }, "readable-stream": { "version": "1.0.34", - "resolved": "http://registry.npmjs.org/readable-stream/-/readable-stream-1.0.34.tgz", + "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-1.0.34.tgz", "integrity": "sha1-Elgg40vIQtLyqq+v5MKRbuMsFXw=", "dev": true, "requires": { @@ -2395,13 +2286,13 @@ }, "string_decoder": { "version": "0.10.31", - "resolved": "http://registry.npmjs.org/string_decoder/-/string_decoder-0.10.31.tgz", + "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-0.10.31.tgz", "integrity": "sha1-YuIDvEF2bGwoyfyEMB2rHFMQ+pQ=", "dev": true }, "through2": { "version": "0.6.5", - "resolved": "http://registry.npmjs.org/through2/-/through2-0.6.5.tgz", + "resolved": "https://registry.npmjs.org/through2/-/through2-0.6.5.tgz", "integrity": "sha1-QaucZ7KdVyCQcUEOHXp6lozTrUg=", "dev": true, "requires": { @@ -2456,7 +2347,7 @@ }, "readable-stream": { "version": "1.0.34", - "resolved": "http://registry.npmjs.org/readable-stream/-/readable-stream-1.0.34.tgz", + "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-1.0.34.tgz", "integrity": "sha1-Elgg40vIQtLyqq+v5MKRbuMsFXw=", "dev": true, "requires": { @@ -2468,13 +2359,13 @@ }, "string_decoder": { "version": "0.10.31", - "resolved": "http://registry.npmjs.org/string_decoder/-/string_decoder-0.10.31.tgz", + "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-0.10.31.tgz", "integrity": "sha1-YuIDvEF2bGwoyfyEMB2rHFMQ+pQ=", "dev": true }, "through2": { "version": "0.6.5", - "resolved": "http://registry.npmjs.org/through2/-/through2-0.6.5.tgz", + "resolved": "https://registry.npmjs.org/through2/-/through2-0.6.5.tgz", "integrity": "sha1-QaucZ7KdVyCQcUEOHXp6lozTrUg=", "dev": true, "requires": { @@ -2947,26 +2838,14 @@ "dev": true }, "os-locale": { - "version": "1.4.0", - "resolved": "https://registry.npmjs.org/os-locale/-/os-locale-1.4.0.tgz", - "integrity": "sha1-IPnxeuKe00XoveWDsT0gCYA8FNk=", + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/os-locale/-/os-locale-3.0.1.tgz", + "integrity": "sha512-7g5e7dmXPtzcP4bgsZ8ixDVqA7oWYuEz4lOSujeWyliPai4gfVDiFIcwBg3aGCPnmSGfzOKTK3ccPn0CKv3DBw==", + "dev": true, "requires": { - "lcid": "^1.0.0" - }, - "dependencies": { - "invert-kv": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/invert-kv/-/invert-kv-1.0.0.tgz", - "integrity": "sha1-EEqOSqym09jNFXqO+L+rLXo//bY=" - }, - "lcid": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/lcid/-/lcid-1.0.0.tgz", - "integrity": "sha1-MIrMr6C8SDo4Z7S28rlQYlHRuDU=", - "requires": { - "invert-kv": "^1.0.0" - } - } + "execa": "^0.10.0", + "lcid": "^2.0.0", + "mem": "^4.0.0" } }, "p-defer": { @@ -3338,9 +3217,9 @@ "dev": true }, "primer-utilities": { - "version": "4.14.0", - "resolved": "https://registry.npmjs.org/primer-utilities/-/primer-utilities-4.14.0.tgz", - "integrity": "sha512-SzvnGQEcIoyGaC+HrVd9UJ6rSNXFBOSFHmbJdr68m2Pg6ekzZYdvjNEr9qyO17zuMy63ob1geuPYFI16xn93DA==", + "version": "4.14.1", + "resolved": "https://registry.npmjs.org/primer-utilities/-/primer-utilities-4.14.1.tgz", + "integrity": "sha512-fts5+Ml6x9PcOoapUGVPeIH/ENYg4pITeR9EKLCEPYyPlNEBq4RWMPM6wSyUE2VhLqe92/xu7kLsLSo417VERQ==", "dev": true, "requires": { "primer-support": "4.7.0" @@ -3909,7 +3788,7 @@ }, "readable-stream": { "version": "1.0.34", - "resolved": "http://registry.npmjs.org/readable-stream/-/readable-stream-1.0.34.tgz", + "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-1.0.34.tgz", "integrity": "sha1-Elgg40vIQtLyqq+v5MKRbuMsFXw=", "dev": true, "requires": { @@ -3921,13 +3800,13 @@ }, "string_decoder": { "version": "0.10.31", - "resolved": "http://registry.npmjs.org/string_decoder/-/string_decoder-0.10.31.tgz", + "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-0.10.31.tgz", "integrity": "sha1-YuIDvEF2bGwoyfyEMB2rHFMQ+pQ=", "dev": true }, "through2": { "version": "0.6.5", - "resolved": "http://registry.npmjs.org/through2/-/through2-0.6.5.tgz", + "resolved": "https://registry.npmjs.org/through2/-/through2-0.6.5.tgz", "integrity": "sha1-QaucZ7KdVyCQcUEOHXp6lozTrUg=", "dev": true, "requires": { @@ -4087,7 +3966,7 @@ }, "chalk": { "version": "1.1.3", - "resolved": "http://registry.npmjs.org/chalk/-/chalk-1.1.3.tgz", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-1.1.3.tgz", "integrity": "sha1-qBFcVeSnAv5NFQq9OHKCKn4J/Jg=", "dev": true, "requires": { @@ -4173,7 +4052,7 @@ }, "strip-ansi": { "version": "3.0.1", - "resolved": "http://registry.npmjs.org/strip-ansi/-/strip-ansi-3.0.1.tgz", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-3.0.1.tgz", "integrity": "sha1-ajhfuIU9lS1f8F0Oiq+UJ43GPc8=", "dev": true, "requires": { @@ -4245,15 +4124,15 @@ } }, "stylelint-config-primer": { - "version": "3.0.0", - "resolved": "https://registry.npmjs.org/stylelint-config-primer/-/stylelint-config-primer-3.0.0.tgz", - "integrity": "sha512-K0n5UuvL8GsMVyzpYg3MjstimWs5RGAzZhmosu2Q+TbItdv7Ed+GhSgQwKwe4DBekuJg5aP5NkgVpJzrnr5W4Q==", + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/stylelint-config-primer/-/stylelint-config-primer-3.0.1.tgz", + "integrity": "sha512-vxFj0Dtyo+lj5f5z9hU6KDS+GzyOjeCqjnu6x9CYxqTH8bjMD+sXueagr7cQKLgdF5cN2L/0P07Qd+uE3nTpHw==", "dev": true, "requires": { "stylelint-no-unsupported-browser-features": "^1.0.0", "stylelint-order": "^0.4.4", "stylelint-scss": "^1.4.1", - "stylelint-selector-no-utility": "2.0.0" + "stylelint-selector-no-utility": "2.0.1" } }, "stylelint-no-unsupported-browser-features": { @@ -4368,7 +4247,7 @@ }, "camelcase-keys": { "version": "2.1.0", - "resolved": "http://registry.npmjs.org/camelcase-keys/-/camelcase-keys-2.1.0.tgz", + "resolved": "https://registry.npmjs.org/camelcase-keys/-/camelcase-keys-2.1.0.tgz", "integrity": "sha1-MIvur/3ygRkFHvodkyITyRuPkuc=", "dev": true, "requires": { @@ -4378,7 +4257,7 @@ }, "chalk": { "version": "1.1.3", - "resolved": "http://registry.npmjs.org/chalk/-/chalk-1.1.3.tgz", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-1.1.3.tgz", "integrity": "sha1-qBFcVeSnAv5NFQq9OHKCKn4J/Jg=", "dev": true, "requires": { @@ -4467,7 +4346,7 @@ "dependencies": { "source-map": { "version": "0.4.4", - "resolved": "http://registry.npmjs.org/source-map/-/source-map-0.4.4.tgz", + "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.4.4.tgz", "integrity": "sha1-66T12pwNyZneaAMti092FzZSA2s=", "dev": true, "requires": { @@ -4544,6 +4423,12 @@ "repeating": "^2.0.0" } }, + "invert-kv": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/invert-kv/-/invert-kv-1.0.0.tgz", + "integrity": "sha1-EEqOSqym09jNFXqO+L+rLXo//bY=", + "dev": true + }, "is-extglob": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-1.0.0.tgz", @@ -4568,6 +4453,12 @@ "is-extglob": "^1.0.0" } }, + "isarray": { + "version": "0.0.1", + "resolved": "https://registry.npmjs.org/isarray/-/isarray-0.0.1.tgz", + "integrity": "sha1-ihis/Kmo9Bd+Cav8YDiTmwXR7t8=", + "dev": true + }, "kind-of": { "version": "3.2.2", "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-3.2.2.tgz", @@ -4583,9 +4474,18 @@ "integrity": "sha512-UTCzU28rRI9wkb8qSGoZa9pgWvxr4LjP2MEhi9XHb/1XMOJy0uTnIxaxzj8My/PORG+kQG6VzAcGvRw66eIOfA==", "dev": true }, + "lcid": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/lcid/-/lcid-1.0.0.tgz", + "integrity": "sha1-MIrMr6C8SDo4Z7S28rlQYlHRuDU=", + "dev": true, + "requires": { + "invert-kv": "^1.0.0" + } + }, "load-json-file": { "version": "1.1.0", - "resolved": "http://registry.npmjs.org/load-json-file/-/load-json-file-1.1.0.tgz", + "resolved": "https://registry.npmjs.org/load-json-file/-/load-json-file-1.1.0.tgz", "integrity": "sha1-lWkFcI1YtLq0wiYbBPWfMcmTdMA=", "dev": true, "requires": { @@ -4613,7 +4513,7 @@ }, "meow": { "version": "3.7.0", - "resolved": "http://registry.npmjs.org/meow/-/meow-3.7.0.tgz", + "resolved": "https://registry.npmjs.org/meow/-/meow-3.7.0.tgz", "integrity": "sha1-cstmi0JSKCkKu/qFaJJYcwioAfs=", "dev": true, "requires": { @@ -4662,6 +4562,15 @@ "integrity": "sha1-VgiurfwAvmwpAd9fmGF4jeDVl8g=", "dev": true }, + "os-locale": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/os-locale/-/os-locale-1.4.0.tgz", + "integrity": "sha1-IPnxeuKe00XoveWDsT0gCYA8FNk=", + "dev": true, + "requires": { + "lcid": "^1.0.0" + } + }, "parse-json": { "version": "2.2.0", "resolved": "https://registry.npmjs.org/parse-json/-/parse-json-2.2.0.tgz", @@ -4693,7 +4602,7 @@ }, "pify": { "version": "2.3.0", - "resolved": "http://registry.npmjs.org/pify/-/pify-2.3.0.tgz", + "resolved": "https://registry.npmjs.org/pify/-/pify-2.3.0.tgz", "integrity": "sha1-7RQaasBDqEnqWISY59yosVMw6Qw=", "dev": true }, @@ -4711,7 +4620,7 @@ }, "postcss-less": { "version": "0.14.0", - "resolved": "http://registry.npmjs.org/postcss-less/-/postcss-less-0.14.0.tgz", + "resolved": "https://registry.npmjs.org/postcss-less/-/postcss-less-0.14.0.tgz", "integrity": "sha1-xjGwicbM5CK5oQ86lY0r7dOBkyQ=", "dev": true, "requires": { @@ -4771,6 +4680,18 @@ "read-pkg": "^1.0.0" } }, + "readable-stream": { + "version": "1.0.34", + "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-1.0.34.tgz", + "integrity": "sha1-Elgg40vIQtLyqq+v5MKRbuMsFXw=", + "dev": true, + "requires": { + "core-util-is": "~1.0.0", + "inherits": "~2.0.1", + "isarray": "0.0.1", + "string_decoder": "~0.10.x" + } + }, "redent": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/redent/-/redent-1.0.0.tgz", @@ -4799,9 +4720,15 @@ "integrity": "sha512-Nc/QN/A425Qog7j9aHmwOrlwX2e7pNI47ciwxwy4jOlvbbMHkNNJchit+FX+UjF3IAdiaaV5BKeWuDUnws6G1A==", "dev": true }, + "string_decoder": { + "version": "0.10.31", + "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-0.10.31.tgz", + "integrity": "sha1-YuIDvEF2bGwoyfyEMB2rHFMQ+pQ=", + "dev": true + }, "strip-ansi": { "version": "3.0.1", - "resolved": "http://registry.npmjs.org/strip-ansi/-/strip-ansi-3.0.1.tgz", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-3.0.1.tgz", "integrity": "sha1-ajhfuIU9lS1f8F0Oiq+UJ43GPc8=", "dev": true, "requires": { @@ -4938,7 +4865,7 @@ }, "table": { "version": "4.0.3", - "resolved": "http://registry.npmjs.org/table/-/table-4.0.3.tgz", + "resolved": "https://registry.npmjs.org/table/-/table-4.0.3.tgz", "integrity": "sha512-S7rnFITmBH1EnyKcvxBh1LjYeQMmnZtCXSEbHcH6S0NoKit24ZuFO/T1vDcLdYsLQkM188PVVhQmzKIuThNkKg==", "dev": true, "requires": { @@ -4987,6 +4914,16 @@ } } }, + "through2": { + "version": "0.6.5", + "resolved": "https://registry.npmjs.org/through2/-/through2-0.6.5.tgz", + "integrity": "sha1-QaucZ7KdVyCQcUEOHXp6lozTrUg=", + "dev": true, + "requires": { + "readable-stream": ">=1.0.33-1 <1.1.0-0", + "xtend": ">=4.0.0 <4.1.0-0" + } + }, "trim-newlines": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/trim-newlines/-/trim-newlines-1.0.0.tgz", @@ -5001,7 +4938,7 @@ }, "yargs": { "version": "3.32.0", - "resolved": "http://registry.npmjs.org/yargs/-/yargs-3.32.0.tgz", + "resolved": "https://registry.npmjs.org/yargs/-/yargs-3.32.0.tgz", "integrity": "sha1-AwiOnr+edWtpdRYR0qXvWRSCyZU=", "dev": true, "requires": { @@ -5119,7 +5056,7 @@ }, "camelcase-keys": { "version": "2.1.0", - "resolved": "http://registry.npmjs.org/camelcase-keys/-/camelcase-keys-2.1.0.tgz", + "resolved": "https://registry.npmjs.org/camelcase-keys/-/camelcase-keys-2.1.0.tgz", "integrity": "sha1-MIvur/3ygRkFHvodkyITyRuPkuc=", "dev": true, "requires": { @@ -5197,7 +5134,7 @@ "dependencies": { "source-map": { "version": "0.4.4", - "resolved": "http://registry.npmjs.org/source-map/-/source-map-0.4.4.tgz", + "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.4.4.tgz", "integrity": "sha1-66T12pwNyZneaAMti092FzZSA2s=", "dev": true, "requires": { @@ -5274,6 +5211,12 @@ "repeating": "^2.0.0" } }, + "invert-kv": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/invert-kv/-/invert-kv-1.0.0.tgz", + "integrity": "sha1-EEqOSqym09jNFXqO+L+rLXo//bY=", + "dev": true + }, "is-extglob": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-1.0.0.tgz", @@ -5298,6 +5241,12 @@ "is-extglob": "^1.0.0" } }, + "isarray": { + "version": "0.0.1", + "resolved": "https://registry.npmjs.org/isarray/-/isarray-0.0.1.tgz", + "integrity": "sha1-ihis/Kmo9Bd+Cav8YDiTmwXR7t8=", + "dev": true + }, "kind-of": { "version": "3.2.2", "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-3.2.2.tgz", @@ -5313,9 +5262,18 @@ "integrity": "sha512-UTCzU28rRI9wkb8qSGoZa9pgWvxr4LjP2MEhi9XHb/1XMOJy0uTnIxaxzj8My/PORG+kQG6VzAcGvRw66eIOfA==", "dev": true }, + "lcid": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/lcid/-/lcid-1.0.0.tgz", + "integrity": "sha1-MIrMr6C8SDo4Z7S28rlQYlHRuDU=", + "dev": true, + "requires": { + "invert-kv": "^1.0.0" + } + }, "load-json-file": { "version": "1.1.0", - "resolved": "http://registry.npmjs.org/load-json-file/-/load-json-file-1.1.0.tgz", + "resolved": "https://registry.npmjs.org/load-json-file/-/load-json-file-1.1.0.tgz", "integrity": "sha1-lWkFcI1YtLq0wiYbBPWfMcmTdMA=", "dev": true, "requires": { @@ -5337,7 +5295,7 @@ "dependencies": { "chalk": { "version": "1.1.3", - "resolved": "http://registry.npmjs.org/chalk/-/chalk-1.1.3.tgz", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-1.1.3.tgz", "integrity": "sha1-qBFcVeSnAv5NFQq9OHKCKn4J/Jg=", "dev": true, "requires": { @@ -5364,7 +5322,7 @@ }, "meow": { "version": "3.7.0", - "resolved": "http://registry.npmjs.org/meow/-/meow-3.7.0.tgz", + "resolved": "https://registry.npmjs.org/meow/-/meow-3.7.0.tgz", "integrity": "sha1-cstmi0JSKCkKu/qFaJJYcwioAfs=", "dev": true, "requires": { @@ -5413,6 +5371,15 @@ "integrity": "sha1-VgiurfwAvmwpAd9fmGF4jeDVl8g=", "dev": true }, + "os-locale": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/os-locale/-/os-locale-1.4.0.tgz", + "integrity": "sha1-IPnxeuKe00XoveWDsT0gCYA8FNk=", + "dev": true, + "requires": { + "lcid": "^1.0.0" + } + }, "parse-json": { "version": "2.2.0", "resolved": "https://registry.npmjs.org/parse-json/-/parse-json-2.2.0.tgz", @@ -5444,7 +5411,7 @@ }, "pify": { "version": "2.3.0", - "resolved": "http://registry.npmjs.org/pify/-/pify-2.3.0.tgz", + "resolved": "https://registry.npmjs.org/pify/-/pify-2.3.0.tgz", "integrity": "sha1-7RQaasBDqEnqWISY59yosVMw6Qw=", "dev": true }, @@ -5462,7 +5429,7 @@ "dependencies": { "chalk": { "version": "1.1.3", - "resolved": "http://registry.npmjs.org/chalk/-/chalk-1.1.3.tgz", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-1.1.3.tgz", "integrity": "sha1-qBFcVeSnAv5NFQq9OHKCKn4J/Jg=", "dev": true, "requires": { @@ -5485,7 +5452,7 @@ }, "postcss-less": { "version": "0.14.0", - "resolved": "http://registry.npmjs.org/postcss-less/-/postcss-less-0.14.0.tgz", + "resolved": "https://registry.npmjs.org/postcss-less/-/postcss-less-0.14.0.tgz", "integrity": "sha1-xjGwicbM5CK5oQ86lY0r7dOBkyQ=", "dev": true, "requires": { @@ -5506,7 +5473,7 @@ "dependencies": { "chalk": { "version": "1.1.3", - "resolved": "http://registry.npmjs.org/chalk/-/chalk-1.1.3.tgz", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-1.1.3.tgz", "integrity": "sha1-qBFcVeSnAv5NFQq9OHKCKn4J/Jg=", "dev": true, "requires": { @@ -5566,6 +5533,18 @@ "read-pkg": "^1.0.0" } }, + "readable-stream": { + "version": "1.0.34", + "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-1.0.34.tgz", + "integrity": "sha1-Elgg40vIQtLyqq+v5MKRbuMsFXw=", + "dev": true, + "requires": { + "core-util-is": "~1.0.0", + "inherits": "~2.0.1", + "isarray": "0.0.1", + "string_decoder": "~0.10.x" + } + }, "redent": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/redent/-/redent-1.0.0.tgz", @@ -5594,9 +5573,15 @@ "integrity": "sha512-Nc/QN/A425Qog7j9aHmwOrlwX2e7pNI47ciwxwy4jOlvbbMHkNNJchit+FX+UjF3IAdiaaV5BKeWuDUnws6G1A==", "dev": true }, + "string_decoder": { + "version": "0.10.31", + "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-0.10.31.tgz", + "integrity": "sha1-YuIDvEF2bGwoyfyEMB2rHFMQ+pQ=", + "dev": true + }, "strip-ansi": { "version": "3.0.1", - "resolved": "http://registry.npmjs.org/strip-ansi/-/strip-ansi-3.0.1.tgz", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-3.0.1.tgz", "integrity": "sha1-ajhfuIU9lS1f8F0Oiq+UJ43GPc8=", "dev": true, "requires": { @@ -5696,7 +5681,7 @@ }, "table": { "version": "4.0.3", - "resolved": "http://registry.npmjs.org/table/-/table-4.0.3.tgz", + "resolved": "https://registry.npmjs.org/table/-/table-4.0.3.tgz", "integrity": "sha512-S7rnFITmBH1EnyKcvxBh1LjYeQMmnZtCXSEbHcH6S0NoKit24ZuFO/T1vDcLdYsLQkM188PVVhQmzKIuThNkKg==", "dev": true, "requires": { @@ -5708,6 +5693,16 @@ "string-width": "^2.1.1" } }, + "through2": { + "version": "0.6.5", + "resolved": "https://registry.npmjs.org/through2/-/through2-0.6.5.tgz", + "integrity": "sha1-QaucZ7KdVyCQcUEOHXp6lozTrUg=", + "dev": true, + "requires": { + "readable-stream": ">=1.0.33-1 <1.1.0-0", + "xtend": ">=4.0.0 <4.1.0-0" + } + }, "trim-newlines": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/trim-newlines/-/trim-newlines-1.0.0.tgz", @@ -5722,7 +5717,7 @@ }, "yargs": { "version": "3.32.0", - "resolved": "http://registry.npmjs.org/yargs/-/yargs-3.32.0.tgz", + "resolved": "https://registry.npmjs.org/yargs/-/yargs-3.32.0.tgz", "integrity": "sha1-AwiOnr+edWtpdRYR0qXvWRSCyZU=", "dev": true, "requires": { @@ -5751,12 +5746,12 @@ } }, "stylelint-selector-no-utility": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/stylelint-selector-no-utility/-/stylelint-selector-no-utility-2.0.0.tgz", - "integrity": "sha512-ZzFs6WAFq46og3GRR3+bGi4kQwF+SWAB3weXZGmjsH70XZeymcgVfkdMblUlqB2oBgB3aPtCYufalueu2sR/hg==", + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/stylelint-selector-no-utility/-/stylelint-selector-no-utility-2.0.1.tgz", + "integrity": "sha512-rrhHr82q4ivggKOi5mDNJuTiIKRBqe9Htc9j9VLjHGPGxYKsuWYYx+fNm/mPhNIhgmWKZA8P8BNNPvqyLH7LDA==", "dev": true, "requires": { - "primer-utilities": "4.14.0", + "primer-utilities": "4.14.1", "stylelint": "^7.13.0" }, "dependencies": { @@ -5836,7 +5831,7 @@ }, "camelcase-keys": { "version": "2.1.0", - "resolved": "http://registry.npmjs.org/camelcase-keys/-/camelcase-keys-2.1.0.tgz", + "resolved": "https://registry.npmjs.org/camelcase-keys/-/camelcase-keys-2.1.0.tgz", "integrity": "sha1-MIvur/3ygRkFHvodkyITyRuPkuc=", "dev": true, "requires": { @@ -5914,7 +5909,7 @@ "dependencies": { "source-map": { "version": "0.4.4", - "resolved": "http://registry.npmjs.org/source-map/-/source-map-0.4.4.tgz", + "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.4.4.tgz", "integrity": "sha1-66T12pwNyZneaAMti092FzZSA2s=", "dev": true, "requires": { @@ -5991,6 +5986,12 @@ "repeating": "^2.0.0" } }, + "invert-kv": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/invert-kv/-/invert-kv-1.0.0.tgz", + "integrity": "sha1-EEqOSqym09jNFXqO+L+rLXo//bY=", + "dev": true + }, "is-extglob": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-1.0.0.tgz", @@ -6015,6 +6016,12 @@ "is-extglob": "^1.0.0" } }, + "isarray": { + "version": "0.0.1", + "resolved": "https://registry.npmjs.org/isarray/-/isarray-0.0.1.tgz", + "integrity": "sha1-ihis/Kmo9Bd+Cav8YDiTmwXR7t8=", + "dev": true + }, "kind-of": { "version": "3.2.2", "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-3.2.2.tgz", @@ -6030,9 +6037,18 @@ "integrity": "sha512-UTCzU28rRI9wkb8qSGoZa9pgWvxr4LjP2MEhi9XHb/1XMOJy0uTnIxaxzj8My/PORG+kQG6VzAcGvRw66eIOfA==", "dev": true }, + "lcid": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/lcid/-/lcid-1.0.0.tgz", + "integrity": "sha1-MIrMr6C8SDo4Z7S28rlQYlHRuDU=", + "dev": true, + "requires": { + "invert-kv": "^1.0.0" + } + }, "load-json-file": { "version": "1.1.0", - "resolved": "http://registry.npmjs.org/load-json-file/-/load-json-file-1.1.0.tgz", + "resolved": "https://registry.npmjs.org/load-json-file/-/load-json-file-1.1.0.tgz", "integrity": "sha1-lWkFcI1YtLq0wiYbBPWfMcmTdMA=", "dev": true, "requires": { @@ -6054,7 +6070,7 @@ "dependencies": { "chalk": { "version": "1.1.3", - "resolved": "http://registry.npmjs.org/chalk/-/chalk-1.1.3.tgz", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-1.1.3.tgz", "integrity": "sha1-qBFcVeSnAv5NFQq9OHKCKn4J/Jg=", "dev": true, "requires": { @@ -6081,7 +6097,7 @@ }, "meow": { "version": "3.7.0", - "resolved": "http://registry.npmjs.org/meow/-/meow-3.7.0.tgz", + "resolved": "https://registry.npmjs.org/meow/-/meow-3.7.0.tgz", "integrity": "sha1-cstmi0JSKCkKu/qFaJJYcwioAfs=", "dev": true, "requires": { @@ -6130,6 +6146,15 @@ "integrity": "sha1-VgiurfwAvmwpAd9fmGF4jeDVl8g=", "dev": true }, + "os-locale": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/os-locale/-/os-locale-1.4.0.tgz", + "integrity": "sha1-IPnxeuKe00XoveWDsT0gCYA8FNk=", + "dev": true, + "requires": { + "lcid": "^1.0.0" + } + }, "parse-json": { "version": "2.2.0", "resolved": "https://registry.npmjs.org/parse-json/-/parse-json-2.2.0.tgz", @@ -6161,7 +6186,7 @@ }, "pify": { "version": "2.3.0", - "resolved": "http://registry.npmjs.org/pify/-/pify-2.3.0.tgz", + "resolved": "https://registry.npmjs.org/pify/-/pify-2.3.0.tgz", "integrity": "sha1-7RQaasBDqEnqWISY59yosVMw6Qw=", "dev": true }, @@ -6179,7 +6204,7 @@ "dependencies": { "chalk": { "version": "1.1.3", - "resolved": "http://registry.npmjs.org/chalk/-/chalk-1.1.3.tgz", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-1.1.3.tgz", "integrity": "sha1-qBFcVeSnAv5NFQq9OHKCKn4J/Jg=", "dev": true, "requires": { @@ -6202,7 +6227,7 @@ }, "postcss-less": { "version": "0.14.0", - "resolved": "http://registry.npmjs.org/postcss-less/-/postcss-less-0.14.0.tgz", + "resolved": "https://registry.npmjs.org/postcss-less/-/postcss-less-0.14.0.tgz", "integrity": "sha1-xjGwicbM5CK5oQ86lY0r7dOBkyQ=", "dev": true, "requires": { @@ -6223,7 +6248,7 @@ "dependencies": { "chalk": { "version": "1.1.3", - "resolved": "http://registry.npmjs.org/chalk/-/chalk-1.1.3.tgz", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-1.1.3.tgz", "integrity": "sha1-qBFcVeSnAv5NFQq9OHKCKn4J/Jg=", "dev": true, "requires": { @@ -6283,6 +6308,18 @@ "read-pkg": "^1.0.0" } }, + "readable-stream": { + "version": "1.0.34", + "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-1.0.34.tgz", + "integrity": "sha1-Elgg40vIQtLyqq+v5MKRbuMsFXw=", + "dev": true, + "requires": { + "core-util-is": "~1.0.0", + "inherits": "~2.0.1", + "isarray": "0.0.1", + "string_decoder": "~0.10.x" + } + }, "redent": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/redent/-/redent-1.0.0.tgz", @@ -6311,9 +6348,15 @@ "integrity": "sha512-Nc/QN/A425Qog7j9aHmwOrlwX2e7pNI47ciwxwy4jOlvbbMHkNNJchit+FX+UjF3IAdiaaV5BKeWuDUnws6G1A==", "dev": true }, + "string_decoder": { + "version": "0.10.31", + "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-0.10.31.tgz", + "integrity": "sha1-YuIDvEF2bGwoyfyEMB2rHFMQ+pQ=", + "dev": true + }, "strip-ansi": { "version": "3.0.1", - "resolved": "http://registry.npmjs.org/strip-ansi/-/strip-ansi-3.0.1.tgz", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-3.0.1.tgz", "integrity": "sha1-ajhfuIU9lS1f8F0Oiq+UJ43GPc8=", "dev": true, "requires": { @@ -6413,7 +6456,7 @@ }, "table": { "version": "4.0.3", - "resolved": "http://registry.npmjs.org/table/-/table-4.0.3.tgz", + "resolved": "https://registry.npmjs.org/table/-/table-4.0.3.tgz", "integrity": "sha512-S7rnFITmBH1EnyKcvxBh1LjYeQMmnZtCXSEbHcH6S0NoKit24ZuFO/T1vDcLdYsLQkM188PVVhQmzKIuThNkKg==", "dev": true, "requires": { @@ -6425,6 +6468,16 @@ "string-width": "^2.1.1" } }, + "through2": { + "version": "0.6.5", + "resolved": "https://registry.npmjs.org/through2/-/through2-0.6.5.tgz", + "integrity": "sha1-QaucZ7KdVyCQcUEOHXp6lozTrUg=", + "dev": true, + "requires": { + "readable-stream": ">=1.0.33-1 <1.1.0-0", + "xtend": ">=4.0.0 <4.1.0-0" + } + }, "trim-newlines": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/trim-newlines/-/trim-newlines-1.0.0.tgz", @@ -6439,7 +6492,7 @@ }, "yargs": { "version": "3.32.0", - "resolved": "http://registry.npmjs.org/yargs/-/yargs-3.32.0.tgz", + "resolved": "https://registry.npmjs.org/yargs/-/yargs-3.32.0.tgz", "integrity": "sha1-AwiOnr+edWtpdRYR0qXvWRSCyZU=", "dev": true, "requires": { @@ -6525,40 +6578,38 @@ "dev": true }, "through2": { - "version": "0.6.5", - "resolved": "https://registry.npmjs.org/through2/-/through2-0.6.5.tgz", - "integrity": "sha1-QaucZ7KdVyCQcUEOHXp6lozTrUg=", + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/through2/-/through2-2.0.5.tgz", + "integrity": "sha512-/mrRod8xqpA+IHSLyGCQ2s8SPHiCDEeQJSep1jqLYeEUClOFG2Qsh+4FU6G9VeqpZnGW/Su8LQGc4YKni5rYSQ==", "dev": true, "requires": { - "readable-stream": ">=1.0.33-1 <1.1.0-0", - "xtend": ">=4.0.0 <4.1.0-0" + "readable-stream": "~2.3.6", + "xtend": "~4.0.1" }, "dependencies": { "readable-stream": { - "version": "1.0.34", - "resolved": "http://registry.npmjs.org/readable-stream/-/readable-stream-1.0.34.tgz", - "integrity": "sha1-Elgg40vIQtLyqq+v5MKRbuMsFXw=", + "version": "2.3.6", + "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-2.3.6.tgz", + "integrity": "sha512-tQtKA9WIAhBF3+VLAseyMqZeBjW0AHJoxOtYqSUZNJxauErmLbVm2FW1y+J/YA9dUrAC39ITejlZWhVIwawkKw==", "dev": true, "requires": { "core-util-is": "~1.0.0", - "inherits": "~2.0.1", - "isarray": "0.0.1", - "string_decoder": "~0.10.x" - }, - "dependencies": { - "isarray": { - "version": "0.0.1", - "resolved": "https://registry.npmjs.org/isarray/-/isarray-0.0.1.tgz", - "integrity": "sha1-ihis/Kmo9Bd+Cav8YDiTmwXR7t8=", - "dev": true - } + "inherits": "~2.0.3", + "isarray": "~1.0.0", + "process-nextick-args": "~2.0.0", + "safe-buffer": "~5.1.1", + "string_decoder": "~1.1.1", + "util-deprecate": "~1.0.1" } }, "string_decoder": { - "version": "0.10.31", - "resolved": "http://registry.npmjs.org/string_decoder/-/string_decoder-0.10.31.tgz", - "integrity": "sha1-YuIDvEF2bGwoyfyEMB2rHFMQ+pQ=", - "dev": true + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.1.1.tgz", + "integrity": "sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg==", + "dev": true, + "requires": { + "safe-buffer": "~5.1.0" + } } } }, @@ -6915,7 +6966,7 @@ }, "strip-ansi": { "version": "3.0.1", - "resolved": "http://registry.npmjs.org/strip-ansi/-/strip-ansi-3.0.1.tgz", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-3.0.1.tgz", "integrity": "sha1-ajhfuIU9lS1f8F0Oiq+UJ43GPc8=", "dev": true, "requires": { @@ -6963,6 +7014,71 @@ "integrity": "sha512-r9S/ZyXu/Xu9q1tYlpsLIsa3EeLXXk0VwlxqTcFRfg9EhMW+17kbt9G0NrgCmhGb5vT2hyhJZLfDGx+7+5Uj/w==", "dev": true }, + "yargs": { + "version": "12.0.5", + "resolved": "https://registry.npmjs.org/yargs/-/yargs-12.0.5.tgz", + "integrity": "sha512-Lhz8TLaYnxq/2ObqHDql8dX8CJi97oHxrjUcYtzKbbykPtVW9WB+poxI+NM2UIzsMgNCZTIf0AQwsjK5yMAqZw==", + "dev": true, + "requires": { + "cliui": "^4.0.0", + "decamelize": "^1.2.0", + "find-up": "^3.0.0", + "get-caller-file": "^1.0.1", + "os-locale": "^3.0.0", + "require-directory": "^2.1.1", + "require-main-filename": "^1.0.1", + "set-blocking": "^2.0.0", + "string-width": "^2.0.0", + "which-module": "^2.0.0", + "y18n": "^3.2.1 || ^4.0.0", + "yargs-parser": "^11.1.1" + }, + "dependencies": { + "find-up": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/find-up/-/find-up-3.0.0.tgz", + "integrity": "sha512-1yD6RmLI1XBfxugvORwlck6f75tYL+iR0jqwsOrOxMZyGYqUuDhJ0l4AXdO1iX/FTs9cBAMEk1gWSEx1kSbylg==", + "dev": true, + "requires": { + "locate-path": "^3.0.0" + } + }, + "locate-path": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-3.0.0.tgz", + "integrity": "sha512-7AO748wWnIhNqAuaty2ZWHkQHRSNfPVIsPIfwEOWO22AmaoVrWavlOcMR5nzTLNYvp36X220/maaRsrec1G65A==", + "dev": true, + "requires": { + "p-locate": "^3.0.0", + "path-exists": "^3.0.0" + } + }, + "p-limit": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-2.0.0.tgz", + "integrity": "sha512-fl5s52lI5ahKCernzzIyAP0QAZbGIovtVHGwpcu1Jr/EpzLVDI2myISHwGqK7m8uQFugVWSrbxH7XnhGtvEc+A==", + "dev": true, + "requires": { + "p-try": "^2.0.0" + } + }, + "p-locate": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-3.0.0.tgz", + "integrity": "sha512-x+12w/To+4GFfgJhBEpiDcLozRJGegY+Ei7/z0tSLkMmxGZNybVMSfWj9aJn8Z5Fc7dBUNJOOVgPv2H7IwulSQ==", + "dev": true, + "requires": { + "p-limit": "^2.0.0" + } + }, + "p-try": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/p-try/-/p-try-2.0.0.tgz", + "integrity": "sha512-hMp0onDKIajHfIkdRk3P4CdCmErkYAxxDtP3Wx/4nZ3aGlau2VKh3mZpcuFkH27WQkL/3WBCPOktzA9ZOAnMQQ==", + "dev": true + } + } + }, "yargs-parser": { "version": "11.1.1", "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-11.1.1.tgz", diff --git a/package.json b/package.json index 527614cab3e17c03186d9d00c3242b275b2e9de1..4a3094ea2166d6f1cf355845e5eda00a08e7b3ed 100644 --- a/package.json +++ b/package.json @@ -7,7 +7,7 @@ "bugs": "https://github.com/pmarsceill/just-the-docs/issues", "devDependencies": { "stylelint": "^9.9.0", - "stylelint-config-primer": "^3.0.0" + "stylelint-config-primer": "^3.0.1" }, "dependencies": {}, "scripts": {