site/docs/posts/index.html in jekyll-docs-3.7.3 vs site/docs/posts/index.html in jekyll-docs-3.8.0

- old
+ new

@@ -2,34 +2,35 @@ <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.3"> + <meta name="generator" content="Jekyll v3.8.0"> <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="preconnect" href="https://fonts.gstatic.com/" crossorigin> + <link rel="stylesheet" href="https://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>Writing posts | Jekyll • Simple, blog-aware, static sites</title> -<meta name="generator" content="Jekyll v3.7.3"> +<meta name="generator" content="Jekyll v3.8.0"> <meta property="og:title" content="Writing posts"> <meta property="og:locale" content="en_US"> <meta name="description" content="One of Jekyll’s best aspects is that it is “blog aware”. What does this mean, exactly? Well, simply put, it means that blogging is baked into Jekyll’s functionality. If you write articles and publish them online, you can publish and maintain a blog simply by managing a folder of text-files on your computer. Compared to the hassle of configuring and maintaining databases and web-based CMS systems, this will be a welcome change!"> <meta property="og:description" content="One of Jekyll’s best aspects is that it is “blog aware”. What does this mean, exactly? Well, simply put, it means that blogging is baked into Jekyll’s functionality. If you write articles and publish them online, you can publish and maintain a blog simply by managing a folder of text-files on your computer. Compared to the hassle of configuring and maintaining databases and web-based CMS systems, this will be a welcome change!"> <link rel="canonical" href="https://jekyllrb.com/docs/posts/"> <meta property="og:url" content="https://jekyllrb.com/docs/posts/"> <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-03-27T03:44:17-07:00"> +<meta property="article:published_time" content="2018-05-01T13:26:35-07: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"> -{"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"headline":"Writing posts","dateModified":"2018-03-27T03:44:17-07:00","datePublished":"2018-03-27T03:44:17-07:00","description":"One of Jekyll’s best aspects is that it is “blog aware”. What does this mean, exactly? Well, simply put, it means that blogging is baked into Jekyll’s functionality. If you write articles and publish them online, you can publish and maintain a blog simply by managing a folder of text-files on your computer. Compared to the hassle of configuring and maintaining databases and web-based CMS systems, this will be a welcome change!","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/posts/"},"@type":"BlogPosting","url":"https://jekyllrb.com/docs/posts/","@context":"http://schema.org"}</script> +{"description":"One of Jekyll’s best aspects is that it is “blog aware”. What does this mean, exactly? Well, simply put, it means that blogging is baked into Jekyll’s functionality. If you write articles and publish them online, you can publish and maintain a blog simply by managing a folder of text-files on your computer. Compared to the hassle of configuring and maintaining databases and web-based CMS systems, this will be a welcome change!","@type":"BlogPosting","url":"https://jekyllrb.com/docs/posts/","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"headline":"Writing posts","dateModified":"2018-05-01T13:26:35-07:00","datePublished":"2018-05-01T13:26:35-07:00","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/posts/"},"@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 +71,11 @@ </div> <div class="meta hide-on-mobiles"> <ul> <li> - <a href="https://github.com/jekyll/jekyll/releases/tag/v3.7.2">v3.7.2</a> + <a href="https://github.com/jekyll/jekyll/releases/tag/v3.8.0">v3.8.0</a> </li> <li> <a href="https://github.com/jekyll/jekyll">GitHub</a> </li> </ul> @@ -474,17 +475,40 @@ <span class="nn">---</span> </code></pre></div></div> <p>In this case, the listing pages will be accessible at <code class="highlighter-rouge">{baseurl}/category/blog.html</code></p> -<p>While this example is done with categories, you can easily extend your lists to -filter by tags or any other variable created with extensions.</p> +<p>Although categories and tags are very similar, they are used to group posts, +there are a few differences between them. Categories and sub-categories create +hierarchies that, by default, are reflected in the directory structure of your +site. A post with the following header</p> +<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nn">---</span> +<span class="na">layout</span><span class="pi">:</span> <span class="s">post</span> +<span class="na">title</span><span class="pi">:</span> <span class="s">A Trip</span> +<span class="na">category</span><span class="pi">:</span> <span class="pi">[</span> <span class="nv">blog</span><span class="pi">,</span> <span class="nv">travel</span> <span class="pi">]</span> +<span class="nn">---</span> +</code></pre></div></div> +<p>will be accessible at <code class="highlighter-rouge">{baseurl}/blog/travel/year/month/day/A-Trip.html</code>. On +the other hand, a tagged post</p> +<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nn">---</span> +<span class="na">layout</span><span class="pi">:</span> <span class="s">post</span> +<span class="na">title</span><span class="pi">:</span> <span class="s">A Trip</span> +<span class="na">tags</span><span class="pi">:</span> <span class="pi">[</span> <span class="nv">blog</span><span class="pi">,</span> <span class="nv">travel</span> <span class="pi">]</span> +<span class="nn">---</span> +</code></pre></div></div> +<p>will be saved as <code class="highlighter-rouge">{baseurl}/year/month/day/A-Trip.html</code>. It is up to you to +create <code class="highlighter-rouge">{baseurl}/tag/blog.html</code> and <code class="highlighter-rouge">{baseurl}/tag/travel.html</code> the same way as +described above for categories.</p> +<p>While this example is done with tags and categories, you can easily extend your +lists to filter by any other variable created with extensions.</p> + <h2 id="post-excerpts">Post excerpts</h2> <p>Each post automatically takes the first block of text, from the beginning of -the content to the first occurrence of <code class="highlighter-rouge">excerpt_separator</code>, and sets it as the <code class="highlighter-rouge">post.excerpt</code>. +the content to the first occurrence of <code class="highlighter-rouge">excerpt_separator</code>, and sets it in the +post’s data hash. Take the above example of an index of posts. Perhaps you want to include a little hint about the post’s content by adding the first paragraph of each of your posts:</p> <div class="language-liquid highlighter-rouge"><div class="highlight"><pre class="highlight"><code>&lt;ul&gt; @@ -867,31 +891,14 @@ } }; </script> - <!-- Gauges (http://get.gaug.es/) --> - <script> - var _gauges = _gauges || []; - (function() { - var t = document.createElement('script'); - t.type = 'text/javascript'; - t.async = true; - t.id = 'gauges-tracker'; - t.setAttribute('data-site-id', '503c5af6613f5d0f19000027'); - t.src = '//secure.gaug.es/track.js'; - var s = document.getElementsByTagName('script')[0]; - s.parentNode.insertBefore(t, s); - })(); - </script> - - - <!-- Google Analytics (https://www.google.com/analytics) --> <script> !function(j,e,k,y,l,L){j.GoogleAnalyticsObject=y,j[y]||(j[y]=function(){ (j[y].q=j[y].q||[]).push(arguments)}),j[y].l=+new Date,l=e.createElement(k), - L=e.getElementsByTagName(k)[0],l.src='//www.google-analytics.com/analytics.js', + L=e.getElementsByTagName(k)[0],l.src='https://www.google-analytics.com/analytics.js', L.parentNode.insertBefore(l,L)}(window,document,'script','ga'); ga('create', 'UA-50755011-1', 'jekyllrb.com'); ga('send', 'pageview');