linus 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 193e320f42093e015f1e04725ca843d9134167e10325e23eec7f4069b3533a8b
+  data.tar.gz: 7ba0dbbeee23fb8940ad48978641e1d42d0240c3c3014656f58a826878230dbe
+SHA512:
+  metadata.gz: a7df689959304932e3d92f8d4653d4ee9a155a50313d71ad130ca9bbdc54fb617ef90a224430b0a169f810e207e61e59856f4ef94cd55bcdee613fe027ddd3ae
+  data.tar.gz: 229002d79925c559f1693fc6f284c6d6629805644b51b2ff73e3fd05177f526bc4e75afde1793c96b85f0aba4ed9c272b9d1092013701420144311b43ee0ef3d

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Arthur Freitas
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,187 @@
+# Linus
+
+A minimal Jekyll blog theme. Supports link posts, categories, tags, date archives, pagination, and dark mode out of the box.
+
+## Installation
+
+Add this line to your Jekyll site's `Gemfile`:
+
+```ruby
+gem "linus"
+```
+
+And add this line to your Jekyll site's `_config.yml`:
+
+```yaml
+theme: linus
+```
+
+Then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install linus
+
+## Usage
+
+### Layouts
+
+| Layout | Purpose |
+|---|---|
+| `default` | Base layout — full HTML document, loads CSS, renders header and footer |
+| `blog` | Blog index listing with pagination; also used for date, tag, and category archives |
+| `post` | Single post view |
+| `page` | Simple content page |
+
+### Writing posts
+
+Create files in `_posts/` with this front matter:
+
+```yaml
+---
+layout: post
+title: "My Post Title"
+date: 2026-01-01
+category: Notes
+author: arthur
+tags:
+  - some tag
+---
+```
+
+**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`:
+
+```yaml
+---
+layout: post
+title: ""
+source: "https://example.com/article"
+category: Links
+---
+```
+
+### Authors
+
+Define authors in `_data/authors.yml`:
+
+```yaml
+arthur:
+  name: Arthur Freitas
+  uri: https://arthr.me/
+```
+
+Reference them in post front matter with the `author` key.
+
+### Category colors
+
+Assign a background color to each category pill:
+
+```yaml
+category_colors:
+  - name: Links
+    color: "#f0e68c"
+  - name: Notes
+    color: "#fa8072"
+```
+
+### Date formats
+
+Customize how dates are displayed using strftime strings:
+
+```yaml
+date_formats:
+  day: "%b %d, '%y"
+  month: "%b, '%y"
+  year: "%Y"
+```
+
+### Navigation menus
+
+```yaml
+main_menu:
+  title: Navigate
+  items:
+    - url: "/about"
+      label: About
+
+footer_menu:
+  title: Follow
+  items:
+    - label: RSS
+      url: /feed.xml
+      rel: alternate
+    - label: External Site
+      url: https://example.com
+      rel: me
+      external: true
+```
+
+Set `external: true` on any item to open it in a new tab.
+
+### Translations
+
+Override UI strings for archive headings and pagination:
+
+```yaml
+translations:
+  archive_date_title: "Archives from %date"
+  archive_tag_title: "Posts tagged with %tag"
+  archive_category_title: "Posts filed under %category"
+  blog_pagination_title: "Blog pagination"
+  blog_pagination_prev_page: "Previous page"
+  blog_pagination_next_page: "Next page"
+```
+
+### Pagination
+
+```yaml
+paginate: 12
+paginate_path: "/pg/:num/"
+```
+
+## Customization
+
+### 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:
+
+```css
+:root {
+  --font-body: Georgia, serif;
+  --color-accent: tomato;
+}
+```
+
+### Custom fonts
+
+Create `assets/css/fonts.css` in your site to load your own web fonts:
+
+```css
+@font-face {
+  font-family: 'My Font';
+  font-weight: 400;
+  src: url('/assets/fonts/myfont.woff2') format('woff2');
+}
+```
+
+Then reference it in `theme.css`:
+
+```css
+:root {
+  --font-body: 'My Font', sans-serif;
+}
+```
+
+## Development
+
+To set up your environment to develop this theme, run `bundle install`.
+
+The repository is also a working Jekyll site for local development. To preview the theme, run `bundle exec jekyll serve` and open your browser at `http://localhost:4000`. As you modify theme files, the site regenerates automatically.
+
+Posts in `_posts/` and `index.html` exist only for local testing and are not included in the published gem.
+
+## License
+
+The theme is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/_config.yml

@@ -0,0 +1,81 @@
+title: Linus
+description: A blog theme for Jekyll.
+
+lang: en
+
+logo: /assets/icon.png
+
+# Theme Settings / TODO: Doc
+category_colors:
+  - name: Links
+    color: "#f0e68c"
+  - name: Notes
+    color: "#fa8072"
+
+date_formats:
+  day: "%b %d, ’%y"
+  month: "%b, ’%y"
+  year: "%Y"
+  
+translations:
+  archive_date_title: "Archives from %date"
+  archive_tag_title: "Posts tagged with %tag"
+  archive_category_title: "Posts filed under %category"
+  blog_pagination_title: "Blog pagination"
+  blog_pagination_prev_page: "Previous page"
+  blog_pagination_next_page: "Next page"
+
+main_menu:
+  title: Navigate
+  items:
+    - url: "/about"
+      label: About
+    - url: "/tags/updates"
+      label: Changelog
+    - url: "https://tangled.org/arthr.me/linus"
+      label: Code
+
+footer_menu:
+  title: Follow
+  items:
+    - label: Tangled
+      url: https://tangled.org/arthr.me/linus
+      rel: me
+      external: true
+    - label: RSS
+      url: /feed.xml
+      rel: alternate
+    - label: JSON Feed
+      url: /feed.json
+      rel: alternate
+
+# Build Settings
+permalink: "/:year/:month/:day/:title:output_ext"
+
+paginate: 12
+paginate_path: "/pg/:num/"
+
+plugins:
+  - jekyll-feed
+  - jekyll-json-feed
+  - jekyll-seo-tag
+  - jekyll-archives
+  - jekyll-url-metadata
+  - jekyll-sitemap
+  - jekyll-paginate
+
+jekyll-archives:
+  enabled: all
+  layout: blog
+  permalinks:
+    category: "/:name/"
+    tag: "/tag/:name/"
+    year: "/:year/"
+    month: "/:year/:month/"
+    day: "/:year/:month/:day/"
+    
+seo:
+  name: Linus
+  links:
+    - https://tangled.org/arthr.me/linus
+    - https://bsky.app/profile/arthr.me

data/_includes/blog/categories.html

@@ -0,0 +1,11 @@
+{%- if site.categories -%}
+  <nav class="blog-categories">
+    {%- for category in site.categories %}
+      {% assign category_slug = category | first | slugify: site.slug_mode %}
+      {%- assign category_url = site.jekyll-archives.permalinks.category | replace: ":name", category_slug -%}
+      <a class="blog-category category {{ category_slug | prepend: '_' -}}" href="{{- category_url -}}">
+        {{- category | first -}}
+      </a>
+    {% endfor -%}
+  </nav>
+{%- endif -%}

data/_includes/blog/post.html

@@ -0,0 +1,89 @@
+<article class="post h-entry">
+  <header class="post-header">
+    <a class="post-permalink u-url" href="{{- include.post.url | absolute_url -}}" rel="bookmark">
+      <time class="post-date dt-published" datetime="{{ include.post.date | date_to_xmlschema }}">
+        {{- include.post.date | date: site.date_formats.day -}}
+      </time>
+    </a>
+      
+    {%- if include.post.title and include.post.title != "" -%}
+      <h2 class="post-title p-name">
+        <a href="{{- include.post.url | relative_url -}}">
+          {{- include.post.title -}}
+        </a>
+      </h2>
+      {%- assign post_title = include.post.title -%}
+    {%- elsif include.post.source -%}
+      {%- assign link_metadata = include.post.source | metadata -%}
+      
+     <h2 class="post-title p-name">
+       {%- if link_metadata.title -%}
+         <cite class="post-title u-in-reply-to h-cite">
+           <a class="post-source-title u-url" href="{{- include.post.source -}}">
+             {{- link_metadata['og:title'] | default: link_metadata.title | prepend: "↪ " -}}
+           </a>
+         </cite>
+       {%- else -%}
+         <cite class="post-source-title u-in-reply-to h-cite">
+           <a class="post-source u-url p-name" href="{{- include.post.source -}}">
+             {{- include.post.source | remove: "https://" | remove: "http://" | prepend: "↪ " -}}
+           </a>
+         </cite>
+       {%- endif -%}
+     </h2>
+    {%- endif -%}
+    
+    {%- if include.post.categories -%}
+      {% for category in include.post.categories %}
+          {%- assign category_slug = category | slugify: site.slug_mode -%}
+          {%- assign category_url = site.jekyll-archives.permalinks.category | replace: ":name", category_slug -%}
+          
+          <a
+            class="post-category category {{ category_slug | prepend: "_" }} p-category"
+            href="{{ category_url | relative_url }}"
+            rel="tag"
+          >
+            {{- category -}}
+          </a>
+      {% endfor %}
+    {%- endif -%}
+  </header>
+  
+  {%- if include.is_archive -%}
+    {%- if include.post.title == "" -%}
+      <div class="post-content p-summary">
+        {{ include.post.excerpt }}
+      </div>
+    {%- endif -%}
+  {%- else -%}
+    <div class="post-content e-content">
+      {{ include.post.content }}
+    </div>
+  {%- endif -%}
+  
+  {%- if include.post.author or site.author -%}
+    <footer class="post-footer" {%- if include.is_archive or site.author or site.data.authors.size == 1 -%}hidden{%- endif -%}>
+      {%- assign author = include.post.author -%}
+      
+      {%- if site.author -%}
+        {% assign author = site.author %}
+      {%- elsif site.data.authors -%}
+        {%- assign author = site.data.authors[include.post.author] -%}
+      {%- endif -%}
+      
+      {%- if author.uri -%}
+        <p class="post-author p-author h-card">
+          <a class="p-name u-url" href="{{- author.uri -}}">
+            {{ author.name }}
+          </a>
+        </p>
+      {%- else -%}
+        <p class="post-author p-author h-card">
+          <span class="p-name">
+            {{- author -}}
+          </span>
+        </p>
+      {%- endif -%}
+    </footer>
+  {%- endif -%}
+</article>

data/_includes/footer.html

@@ -0,0 +1,20 @@
+<footer class="site-footer">
+  <p>
+    <strong>{{ site.title }}</strong> &mdash; {{ site.description }}
+  </p>
+  
+  {% if site.footer_menu %}
+    <nav class="footer-menu" aria-label="{{ site.footer_menu.title }}">
+      {% for item in site.footer_menu.items %}
+        <a
+          class="menu-item"
+          href="{{ item.url }}"
+          {%- if item.external %} target="_blank" {%- endif -%}
+          {%- if item.rel %} rel="{{ item.rel }}" {%- endif -%}
+        >
+        {{- item.label -}}
+        </a>
+      {% endfor %}
+    </nav>
+  {% endif %}
+</footer>

data/_includes/header.html

@@ -0,0 +1,44 @@
+{%- assign is_personal_website = false -%}
+
+{%- if site.author or site.data.authors == 1 -%}
+  {%- assign is_personal_website = true -%}
+{%- endif -%}
+
+{%- capture site_branding -%}
+    <a class="site-branding h-card u-url" href="{{ '/' | absolute_url }}">
+      {% if site.logo %}
+        <img
+          class="site-logo u-photo"
+          src="{{ site.logo }}"
+          alt=""
+        />
+      {% endif %}
+      
+      <span class="site-name p-name {%- unless is_personal_website %} p-org {%- endunless -%}">
+        {{ site.title }}
+      </span>
+    </a>
+{%- endcapture -%}
+
+
+<header class="site-header">
+  {% if page.title and page.title != "" %}
+    <span class="site-title">
+      {{ site_branding }}
+    </span>
+  {% else %}
+    <h1 class="site-title">
+      {{ site_branding }}
+    </h1>
+  {% endif %}
+  
+  {% if site.main_menu %}
+    <nav class="site-menu" aria-label="{{ site.main_menu.title }}">
+      {% for item in site.main_menu.items %}
+        <a class="menu-item" href="{{ item.url }}" {% if item.external %}target="_blank"{% endif %}>
+          {{- item.label -}}
+        </a>
+      {% endfor %}
+    </nav>
+  {% endif %}
+</header>

data/_layouts/blog.html

@@ -0,0 +1,60 @@
+---
+layout: default
+---
+
+{%- capture archive_title -%}
+  {%- if page.type or page.date -%}
+    <h1 class="archive-title p-name">
+      {%- if page.date -%}
+        {%- assign archive_date = page.date | date: site.date_formats[page.type] -%}
+        
+        {{- site.translations.archive_date_title | replace: "%date", archive_date -}}
+      {%- else -%}
+        {%- if page.type == "tag" -%}
+          {{- site.translations.archive_tag_title | replace: "%tag", page.title -}}
+        {%- else -%}
+          {{- site.translations.archive_category_title | replace: "%category", page.title -}}
+        {%- endif -%}
+      {%- endif -%}
+    </h1>
+  {%- endif -%}
+{%- endcapture -%}
+
+{%- assign blog_posts = site.posts -%}
+
+{%- if paginator.posts -%}
+  {%- assign blog_posts = paginator.posts -%}
+{%- elsif page.posts -%}
+  {%- assign blog_posts = page.posts -%}
+{%- endif -%}
+
+<div class="blog-list h-feed">
+  {%- include blog/categories.html -%}
+  
+  {{- archive_title }}
+  
+  {% for post in blog_posts -%}
+    {%- assign is_archive = false -%}
+    {%- if page.type or page.date -%}
+      {%- assign is_archive = true -%}
+    {%- endif -%}
+    
+    {%- include blog/post.html post=post is_archive=is_archive -%}
+  {%- endfor -%}
+  
+  {% if paginator.previous_page or paginator.next_page -%}
+    <nav class="blog-pagination" aria-label="{{- site.translations.blog_pagination_title -}}">
+      {% if paginator.previous_page -%}
+        <a class="as-button prev-page menu-item" href="{{ paginator.previous_page_path | relative_url }}" rel="prev">
+          {{- site.translations.blog_pagination_prev_page -}}
+        </a>
+      {%- endif %}
+      
+      {% if paginator.next_page -%}
+        <a class="as-button next-page menu-item" href="{{ paginator.next_page_path | relative_url }}" rel="next">
+          {{- site.translations.blog_pagination_next_page -}}
+        </a>
+      {%- endif %}
+    </nav>
+  {%- endif %}
+</div>

data/_layouts/default.html

@@ -0,0 +1,49 @@
+<!DOCTYPE html>
+<html lang="{{ page.lang | default: site.lang }}">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    
+    {% if page.title and page.title != "" -%}
+      <title>{{ page.title }} ({{- site.title -}})</title>
+    {%- else -%}
+      <title>{{ site.title }} {%- if site.tagline %} ~ {{ site.tagline }}{%- endif -%}</title>
+    {%- endif %}
+    {% seo title=false %}
+    
+    {%- feed_meta -%}
+    {%- json_feed_meta -%}
+    
+    {% for link in site.seo.links %}
+      <link rel="me" href="{{ link }}" />
+    {% endfor %}
+    
+    {%- if site.category_colors -%}
+      <style id="category-colors">
+        {%- for category in site.category_colors %}
+          .{{- category.name | slugify: site.slug_mode | prepend: "_" }} {
+            background-color: {{ category.color -}};
+          }
+        {%- endfor -%}
+      </style>
+    {%- endif -%}
+    
+    <link rel="stylesheet" href="{%- link assets/css/base.css -%}" />
+    <link rel="stylesheet" href="{%- link assets/css/layout.css -%}" />
+    <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 -%}" />
+  </head>
+  <body>
+    <div class="site">
+      {% include header.html %}
+      
+      <main class="site-content">
+        {{ content }}
+      </main>
+      
+      
+      {% include footer.html %}
+    </div>
+  </body>
+</html>

data/_layouts/page.html

@@ -0,0 +1,19 @@
+---
+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>
+
+

data/_layouts/post.html

@@ -0,0 +1,101 @@
+---
+layout: default
+---
+
+{%- include blog/categories.html -%}
+
+<article class="post h-entry">
+  <header class="post-header">
+    <a class="post-permalink u-url" href="{{- page.url | absolute_url -}}" rel="bookmark">
+      <time class="post-date dt-published" datetime="{{ page.date | date_to_xmlschema }}">
+        {{- page.date | date: site.date_formats.day -}}
+      </time>
+    </a>
+      
+    {%- if page.title and page.title != "" -%}
+      <h1 class="post-title p-name">
+        {{- page.title -}}
+      </h1>
+      {%- assign post_title = page.title -%}
+    {%- elsif page.source -%}
+      {%- assign link_metadata = page.source | metadata -%}
+      
+     <h2 class="post-title p-name">
+       {%- if link_metadata.title -%}
+         <cite class="post-title u-in-reply-to h-cite">
+           <a class="post-source-title u-url" href="{{- page.source -}}">
+             {{- link_metadata['og:title'] | default: link_metadata.title | prepend: "↪ " -}}
+           </a>
+         </cite>
+       {%- else -%}
+         <cite class="post-source-title u-in-reply-to h-cite">
+           <a class="post-source u-url p-name" href="{{- page.source -}}">
+             {{- page.source | remove: "https://" | remove: "http://" | prepend: "↪ " -}}
+           </a>
+         </cite>
+       {%- endif -%}
+     </h2>
+    {%- endif -%}
+    
+    {%- if page.categories -%}
+      {% for category in page.categories %}
+          {%- assign category_slug = category | slugify: site.slug_mode -%}
+          {%- assign category_url = site.jekyll-archives.permalinks.category | replace: ":name", category_slug -%}
+          
+          <a
+            class="post-category category {{ category_slug | prepend: "_" }} p-category"
+            href="{{ category_url | relative_url }}"
+            rel="tag"
+          >
+            {{- category -}}
+          </a>
+      {% endfor %}
+    {%- endif -%}
+  </header>
+  
+    <div class="post-content e-content">
+      {{ page.content }}
+    </div>
+  
+  {%- if page.author or site.author or page.tags -%}
+    <footer class="post-footer">
+      {%- assign author = page.author -%}
+      
+      {%- if site.author -%}
+        {% assign author = site.author %}
+      {%- elsif site.data.authors -%}
+        {%- assign author = site.data.authors[page.author] -%}
+      {%- endif -%}
+      
+      {%- if author.uri -%}
+        <p class="post-author p-author h-card">
+          <a class="p-name u-url" href="{{- author.uri -}}">
+            {{ author.name }}
+          </a>
+        </p>
+      {%- else -%}
+        <p class="post-author p-author h-card">
+          <span class="p-name">
+            {{- author -}}
+          </span>
+        </p>
+      {%- endif -%}
+      
+      {%- if page.tags -%}
+        <ul class="post-tags">
+          {%- for tag in page.tags -%}
+            {%- assign tag_slug = tag | slugify: site.slug_mode -%}
+            {%- assign tag_url = site.jekyll-archives.permalinks.tag | replace: ":name", tag_slug -%}
+            
+            <li class="tag-item">
+              <a class="p-category" href="{{ tag_url }}" rel="tag">
+                {{ tag }}
+              </a>
+            </li>
+          {%- endfor -%}
+        </ul>
+      {%- endif -%}
+    </footer>
+  {%- endif -%}
+</article>
+