linus 1.0.0 → 1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 193e320f42093e015f1e04725ca843d9134167e10325e23eec7f4069b3533a8b
-  data.tar.gz: 7ba0dbbeee23fb8940ad48978641e1d42d0240c3c3014656f58a826878230dbe
+  metadata.gz: 7d21bd83ff0aefc3c22487dae931923f6bd0086bc101da47c91693abaeb43fcf
+  data.tar.gz: 5011e04fc10847ff4c9863cad25323fd56931b0f629b4146e7b867d754ec9444
 SHA512:
-  metadata.gz: a7df689959304932e3d92f8d4653d4ee9a155a50313d71ad130ca9bbdc54fb617ef90a224430b0a169f810e207e61e59856f4ef94cd55bcdee613fe027ddd3ae
-  data.tar.gz: 229002d79925c559f1693fc6f284c6d6629805644b51b2ff73e3fd05177f526bc4e75afde1793c96b85f0aba4ed9c272b9d1092013701420144311b43ee0ef3d
+  metadata.gz: a427484ba636c1be648574c0380cb1fa5ee4a07bb4713262497c84c411041ed3c2bb8f53da2010206f9eb07299ffd33723913887d6e89a372ba3a75b5aa85a75
+  data.tar.gz: b3660dd87b1116e9d6811e8b22c498855cd6a31e57df47ec4ce5270e79d31fd72dbba99bcd0f6aeb7e08b02933849ff5a6475d8887d6830de6a0df80d038a5c0

data/README.md

@@ -1,7 +1,10 @@
-# Linus
-
-A minimal Jekyll blog theme. Supports link posts, categories, tags, date archives, pagination, and dark mode out of the box.
+---
+layout: page
+title: Using Linus
+permalink: /about/
+---
 
+Linus is a minimal blog theme for Jekyll. Supports link posts, categories, tags, archives (using [jekyll-archives](https://github.com/jekyll/jekyll-arcihves)) and dark mode out of the box.
 ## Installation
 
 Add this line to your Jekyll site's `Gemfile`:
@@ -51,7 +54,7 @@ tags:
 ---
 ```
 
-**Link posts** — set `title` to an empty string and provide a `source` URL. The post title renders as "↪ [fetched page title]" using `jekyll-url-metadata`:
+**Link posts**: you can have link posts by setting a `post.source` front-matter on your post. If the title is left empty (`""`), Jekyll will try to fetch the link metadata and render the link title as your post title.
 
 ```yaml
 ---
@@ -64,37 +67,43 @@ category: Links
 
 ### Authors
 
-Define authors in `_data/authors.yml`:
+Authors follow the same approach as [jekyll-feed](https://github.com/jekyll-feed) and [jekyll-archives](https://github.com/jekyll/jekyll-archives). You can have an author object set in a post, or in the site `_config.yml`, or in a `authors.yml` data file.
+
+In a post:
 
 ```yaml
-arthur:
-  name: Arthur Freitas
-  uri: https://arthr.me/
+---
+layout: post
+title: My awesome first post
+author:
+  name: Author Name
+  uri: https://example.com
+  picture: /path/to/author-picture.jpg
+---
 ```
 
-Reference them in post front matter with the `author` key.
+In your `_config.yml`:
 
-### Category colors
+```yaml
+author:
+  name: Author Name
+  uri: https://example.com
+  picture: /path/to/author-picture.jpg
+```
 
-Assign a background color to each category pill:
+You can also define authors in `_data/authors.yml`:
 
 ```yaml
-category_colors:
-  - name: Links
-    color: "#f0e68c"
-  - name: Notes
-    color: "#fa8072"
+author_name:
+  name: Author Name
+  uri: https://example.com
+  picture: /path/to/author-picture.jpg
 ```
 
-### Date formats
-
-Customize how dates are displayed using strftime strings:
+Reference them in post front matter with the `author` key:
 
 ```yaml
-date_formats:
-  day: "%b %d, '%y"
-  month: "%b, '%y"
-  year: "%Y"
+author: author_name
 ```
 
 ### Navigation menus
@@ -126,6 +135,7 @@ Override UI strings for archive headings and pagination:
 
 ```yaml
 translations:
+  byline: "By"
   archive_date_title: "Archives from %date"
   archive_tag_title: "Posts tagged with %tag"
   archive_category_title: "Posts filed under %category"
@@ -134,15 +144,30 @@ translations:
   blog_pagination_next_page: "Next page"
 ```
 
-### Pagination
+### Further options
 
-```yaml
-paginate: 12
-paginate_path: "/pg/:num/"
-```
+Linus uses the following Jekyll plugins, which you can set up as you please. Refer to the plugins docs to learn how to change the way your site will handle pagination, archiving, feeds and SEO tags:
+
+- [jekyll-pagination](https://github.com/jekyll/jekyll-pagination)
+- [jekyll-archives](https://github.com/jekyll/jekyll-archives)
+- [jekyll-seo-tag](https://github.com/jekyll/jekyll-seo-tag)
+- [jekyll-sitemap](https://github.com/jekyll/jekyll-sitemap)
+- [jekyll-feed](https://github.com/jekyll/jekyll-feed)
+- [jekyll-json-feed](https://github.com/lildude/jekyll-json-feed)
 
 ## Customization
 
+### Date formats
+
+Customize how dates are displayed using strftime strings:
+
+```yaml
+date_formats:
+  day: "%b %d, '%y"
+  month: "%b, '%y"
+  year: "%Y"
+```
+
 ### Custom styles
 
 Override or extend the theme's CSS by creating `assets/css/theme.css` in your site. This file is loaded last, after all theme styles. Use it to redefine CSS custom properties or add new rules:
@@ -154,6 +179,18 @@ Override or extend the theme's CSS by creating `assets/css/theme.css` in your si
 }
 ```
 
+#### Category colors
+
+Assign a background color to each category pill:
+
+```yaml
+category_colors:
+  - name: Links
+    color: "#f0e68c"
+  - name: Notes
+    color: "#fa8072"
+```
+
 ### Custom fonts
 
 Create `assets/css/fonts.css` in your site to load your own web fonts:
@@ -174,6 +211,14 @@ Then reference it in `theme.css`:
 }
 ```
 
+## Custom includes
+
+Linus offers three custom includes to add markup to different parts of your website:
+
+- `head.html`: right before the closing `</head>` tag.
+- `below-post.html`: after the post footer in post pages.
+- `end.html`: right before the closing `</body>` tag.
+
 ## Development
 
 To set up your environment to develop this theme, run `bundle install`.

data/_config.yml

@@ -18,6 +18,7 @@ date_formats:
   year: "%Y"
   
 translations:
+  byline: "By"
   archive_date_title: "Archives from %date"
   archive_tag_title: "Posts tagged with %tag"
   archive_category_title: "Posts filed under %category"
@@ -30,10 +31,13 @@ main_menu:
   items:
     - url: "/about"
       label: About
-    - url: "/tags/updates"
+    - url: "/changelog"
       label: Changelog
+    - url: "/archive"
+      label: Archive
     - url: "https://tangled.org/arthr.me/linus"
       label: Code
+      external: true
 
 footer_menu:
   title: Follow

data/_data/authors.yml

@@ -0,0 +1,3 @@
+arthur:
+  name: Arthur Freitas
+  uri: https://arthr.me/

data/_includes/below-post.html

@@ -0,0 +1,3 @@
+{% comment %}
+  You can create a `_includes/head.html` in your site to add custom scripts, styles and other markup right after your post in a post page.
+{% endcomment %}

data/_includes/blog/post.html

@@ -50,7 +50,7 @@
   </header>
   
   {%- if include.is_archive -%}
-    {%- if include.post.title == "" -%}
+    {%- if include.post.title == "" and include.post.source == nil -%}
       <div class="post-content p-summary">
         {{ include.post.excerpt }}
       </div>
@@ -71,19 +71,20 @@
         {%- assign author = site.data.authors[include.post.author] -%}
       {%- endif -%}
       
-      {%- if author.uri -%}
-        <p class="post-author p-author h-card">
+      <p class="post-author p-author h-card">
+        <span class="post-byline">
+          {{ site.translations.byline }}
+        </span>
+        {% if author.uri -%}
           <a class="p-name u-url" href="{{- author.uri -}}">
             {{ author.name }}
           </a>
-        </p>
-      {%- else -%}
-        <p class="post-author p-author h-card">
+        {%- else -%}
           <span class="p-name">
             {{- author -}}
           </span>
-        </p>
-      {%- endif -%}
+        {%- endif -%}
+      </p>
     </footer>
   {%- endif -%}
 </article>

data/_includes/end.html

@@ -0,0 +1,3 @@
+{% comment %}
+  You can create a `_includes/head.html` in your site to add custom scripts, styles and other markup as you wish!
+{% endcomment %}

data/_includes/head.html

@@ -0,0 +1,3 @@
+{% comment %}
+  You can create a `_includes/head.html` in your site to add custom scripts, styles and other markup that will be added right before the closing `</head>` tag.
+{% endcomment %}

data/_layouts/archive.html

@@ -0,0 +1,28 @@
+---
+layout: default
+---
+
+<article class="post">
+  <header class="post-header">
+    {%- if page.title and page.title != "" -%}
+      <h1 class="post-titlee">
+        {{- page.title -}}
+      </h1>
+    {%- endif -%}
+  </header>
+  
+    <div class="post-content e-content">
+      {{ content }}
+    </div>
+</article>
+
+
+<div class="blog-list h-feed">
+  {%- include blog/categories.html -%}
+  
+  {% for post in site.posts -%}
+    {%- assign is_archive = true -%}
+    
+    {%- include blog/post.html post=post is_archive=is_archive -%}
+  {%- endfor -%}
+</div>

data/_layouts/default.html

@@ -33,17 +33,21 @@
     <link rel="stylesheet" href="{%- link assets/css/syntax.css -%}" />
     <link rel="stylesheet" href="{%- link assets/css/theme.css -%}" />
     <link rel="stylesheet" href="{%- link assets/css/fonts.css -%}" />
+    
+    {%- include head.html -%}
   </head>
   <body>
     <div class="site">
-      {% include header.html %}
+      {% include site/header.html %}
       
       <main class="site-content">
         {{ content }}
       </main>
       
       
-      {% include footer.html %}
+      {% include site/footer.html %}
     </div>
+    
+    {%- include end.html -%}
   </body>
 </html>

data/_layouts/post.html

@@ -67,19 +67,21 @@ layout: default
         {%- assign author = site.data.authors[page.author] -%}
       {%- endif -%}
       
-      {%- if author.uri -%}
-        <p class="post-author p-author h-card">
+      <p class="post-author p-author h-card" {% if site.author or site.data.authors.size == 1 -%}hidden{%- endif %}>
+        <span class="post-byline">
+          {{ site.translations.byline }}
+        </span>
+        
+        {%- if author.uri -%}
           <a class="p-name u-url" href="{{- author.uri -}}">
             {{ author.name }}
           </a>
-        </p>
-      {%- else -%}
-        <p class="post-author p-author h-card">
+        {%- else -%}
           <span class="p-name">
             {{- author -}}
           </span>
-        </p>
-      {%- endif -%}
+        {%- endif -%}
+      </p>
       
       {%- if page.tags -%}
         <ul class="post-tags">
@@ -97,5 +99,7 @@ layout: default
       {%- endif -%}
     </footer>
   {%- endif -%}
+  
+  {%- include below-post.html -%}
 </article>
 

data/assets/css/layout.css

@@ -24,8 +24,8 @@
     --color-link: #2D5438;
     --color-link-hover: #1E3826;
     --color-support: #D9634E;
-    --color-shadows: color-mix(in srgb, var(--color-text), transparent 75%);
-    --color-shadows-hover: color-mix(in srgb, var(--color-text), transparent 50%);
+    --color-shadows: color-mix(in srgb, var(--color-text), transparent 85%);
+    --color-shadows-hover: color-mix(in srgb, var(--color-text), transparent 75%);
     --color-border: color-mix(in srgb, currentcolor, transparent 50%);
   }
   

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: linus
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: '1.1'
 platform: ruby
 authors:
 - Arthur Freitas
@@ -130,10 +130,15 @@ files:
 - LICENSE.txt
 - README.md
 - _config.yml
+- _data/authors.yml
+- _includes/below-post.html
 - _includes/blog/categories.html
 - _includes/blog/post.html
-- _includes/footer.html
-- _includes/header.html
+- _includes/end.html
+- _includes/head.html
+- _includes/site/footer.html
+- _includes/site/header.html
+- _layouts/archive.html
 - _layouts/blog.html
 - _layouts/default.html
 - _layouts/page.html