site/docs/configuration/index.html in jekyll-docs-3.7.0 vs site/docs/configuration/index.html in jekyll-docs-3.7.2

- old
+ new

@@ -2,34 +2,34 @@ <html lang="en-US"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width,initial-scale=1"> - <meta name="generator" content="Jekyll v3.7.0"> + <meta name="generator" content="Jekyll v3.7.2"> <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites"> <link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom"> <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900"> <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css"> <link rel="stylesheet" href="/css/screen.css"> <link rel="icon" type="image/x-icon" href="/favicon.ico"> <!-- Begin Jekyll SEO tag v2.4.0 --> <title>Configuration | Jekyll • Simple, blog-aware, static sites</title> -<meta name="generator" content="Jekyll v3.7.0"> +<meta name="generator" content="Jekyll v3.7.2"> <meta property="og:title" content="Configuration"> <meta property="og:locale" content="en_US"> <meta name="description" content="Jekyll allows you to concoct your sites in any way you can dream up, and it’s thanks to the powerful and flexible configuration options that this is possible. These options can either be specified in a _config.yml file placed in your site’s root directory, or can be specified as flags for the jekyll executable in the terminal."> <meta property="og:description" content="Jekyll allows you to concoct your sites in any way you can dream up, and it’s thanks to the powerful and flexible configuration options that this is possible. These options can either be specified in a _config.yml file placed in your site’s root directory, or can be specified as flags for the jekyll executable in the terminal."> <link rel="canonical" href="https://jekyllrb.com/docs/configuration/"> <meta property="og:url" content="https://jekyllrb.com/docs/configuration/"> <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites"> <meta property="og:type" content="article"> -<meta property="article:published_time" content="2018-01-03T02:41:17-08:00"> +<meta property="article:published_time" content="2018-01-25T12:06:43-08:00"> <meta name="twitter:card" content="summary"> <meta name="twitter:site" content="@jekyllrb"> <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY"> <script type="application/ld+json"> -{"headline":"Configuration","dateModified":"2018-01-03T02:41:17-08:00","datePublished":"2018-01-03T02:41:17-08:00","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/configuration/"},"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"url":"https://jekyllrb.com/docs/configuration/","description":"Jekyll allows you to concoct your sites in any way you can dream up, and it’s thanks to the powerful and flexible configuration options that this is possible. These options can either be specified in a _config.yml file placed in your site’s root directory, or can be specified as flags for the jekyll executable in the terminal.","@type":"BlogPosting","@context":"http://schema.org"}</script> +{"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"description":"Jekyll allows you to concoct your sites in any way you can dream up, and it’s thanks to the powerful and flexible configuration options that this is possible. These options can either be specified in a _config.yml file placed in your site’s root directory, or can be specified as flags for the jekyll executable in the terminal.","headline":"Configuration","dateModified":"2018-01-25T12:06:43-08:00","url":"https://jekyllrb.com/docs/configuration/","datePublished":"2018-01-25T12:06:43-08:00","@type":"BlogPosting","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/configuration/"},"@context":"http://schema.org"}</script> <!-- End Jekyll SEO tag --> <!--[if lt IE 9]> <script src="/js/html5shiv.min.js"></script> <script src="/js/respond.min.js"></script> @@ -70,11 +70,11 @@ </div> <div class="meta hide-on-mobiles"> <ul> <li> - <a href="https://github.com/jekyll/jekyll/releases/tag/v3.7.0">v3.7.0</a> + <a href="https://github.com/jekyll/jekyll/releases/tag/v3.7.2">v3.7.2</a> </li> <li> <a href="https://github.com/jekyll/jekyll">GitHub</a> </li> </ul> @@ -832,11 +832,13 @@ </code></pre></div></div> <p>In this example, the <code class="highlighter-rouge">layout</code> is set to <code class="highlighter-rouge">default</code> inside the <a href="../collections/">collection</a> with the name <code class="highlighter-rouge">my_collection</code>.</p> -<p>It is also possible to use glob patterns when matching defaults. For example, it is possible to set specific layout for each <code class="highlighter-rouge">special-page.html</code> in any subfolder of <code class="highlighter-rouge">section</code> folder.<span class="version-badge" title="This feature is available starting version 3.7.0">3.7.0</span></p> +<h3 id="glob-patterns-in-front-matter-defaults">Glob patterns in Front Matter defaults</h3> + +<p>It is also possible to use glob patterns (currently limited to patterns that contain <code class="highlighter-rouge">*</code>) when matching defaults. For example, it is possible to set specific layout for each <code class="highlighter-rouge">special-page.html</code> in any subfolder of <code class="highlighter-rouge">section</code> folder.<span class="version-badge" title="This feature is available starting version 3.7.0">3.7.0</span></p> <div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">collections</span><span class="pi">:</span> <span class="na">my_collection</span><span class="pi">:</span> <span class="na">output</span><span class="pi">:</span> <span class="no">true</span> <span class="na">defaults</span><span class="pi">:</span> @@ -844,9 +846,19 @@ <span class="na">scope</span><span class="pi">:</span> <span class="na">path</span><span class="pi">:</span> <span class="s2">"</span><span class="s">section/*/special-page.html"</span> <span class="na">values</span><span class="pi">:</span> <span class="na">layout</span><span class="pi">:</span> <span class="s2">"</span><span class="s">specific-layout"</span> </code></pre></div></div> + +<div class="note warning"> + <h5>Globbing and Performance</h5> + <p> + Please note that globbing a path is known to have a negative effect on + performance and is currently not optimized, especially on Windows. + Globbing a path will increase your build times in proportion to the size + of the associated collection directory. + </p> +</div> <h3 id="precedence">Precedence</h3> <p>Jekyll will apply all of the configuration settings you specify in the <code class="highlighter-rouge">defaults</code> section of your <code class="highlighter-rouge">_config.yml</code> file. However, you can choose to override settings from other scope/values pair by specifying a more specific path for the scope.</p>