jekyll-theme-centos 2.52.0.beta.96 → 2.52.0.beta.97

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f5d7826e37033ad225ba8f67091b714b4486821b56ddb41b7259c9593f6f777a
-  data.tar.gz: 859ec7818eee6e8fdba4f1d97e439c2ba2318422b864f43180b1ba1b0fb6e757
+  metadata.gz: 02c33817b8b756a8de30c5e96c06b4c2defd9c65600ac6a82adce543427c86ec
+  data.tar.gz: 9d14e11510ea28e7ac5a29229a190a9d9340a915e10f66d8cbc19e80dbceb0df
 SHA512:
-  metadata.gz: 944084fc09f8ac08efc3e7d6d054b4f8e33d4a415cf2d534422dd3241c62298d132bf1e624002d0f4877ac03a189fceeb6fe5ae3cf3968af60f8741a450cbf08
-  data.tar.gz: 18e70fcc850b108ce04909d329475a2498eb77f78d07f72f17c225ce896ff34d5796d48bbf9474a24e87363b301e61ee01bab95c38946565adf627a2e65d18e0
+  metadata.gz: 04ce54202918e0da657e661a0a03de681b3c83c1b68240695f7a11a4b910fe797712e024fdfc49d4558ba84f330fa24d6ca43bca61225312b6aa6853c33c683c
+  data.tar.gz: c4e526cad99918c56f708a5a0434ce30de714f4adfb3f3ff1a2da0d9b7f1a10231074b20bc5d6c1a6d6f766cff339e7056da3cbd64530dc41d64d2053adf333e

data/_data/base/bits.yml

@@ -8,7 +8,7 @@
     Lorem ipsum odor amet, consectetuer adipiscing elit. Varius imperdiet
     convallis at efficitur in eros. Sagittis morbi scelerisque faucibus
     conubia consectetur.
-  screenshot: base/screenshot-1600x1200.webp
+  preamble: false
   finale: "Derivatives:"
   actions:
     - name: Action 1
@@ -36,7 +36,6 @@
   description: |
     Lorem ipsum odor amet, consectetuer adipiscing elit. Varius imperdiet
     convallis at efficitur in eros. Sagittis morbi scelerisque faucibus
-  screenshot: base/screenshot-1600x1200.webp
   image: centos-symbol.svg
   actions:
     - name: Action 1
@@ -56,7 +55,6 @@
     - Upstream card example 1
 - name: Downstream example 1-2
   icon: fa-solid fa-arrow-right
-  screenshot: base/screenshot-1600x1200.webp
   type: downstream
   description: |
     Lorem ipsum odor amet, consectetuer adipiscing elit. Varius imperdiet
@@ -69,7 +67,6 @@
       icon_position: end
       link: "#"
 - name: Downstream example 1-3
-  screenshot: base/screenshot-1600x1200.webp
   type: downstream
   description: |
     Lorem ipsum odor amet, consectetuer adipiscing elit. Varius imperdiet
@@ -82,7 +79,6 @@
       icon_position: end
       link: "#"
 - name: Downstream example 1-4
-  screenshot: base/screenshot-1600x1200.webp
   type: downstream
   description: |
     Lorem ipsum odor amet, consectetuer adipiscing elit. Varius imperdiet

data/_data/base/ogp.yml

@@ -2,12 +2,10 @@
 locale: en_US
 og:
   type: website
-  title: true
   url: true
   description: true
   logo: /assets/icons/apple-touch-icon.png
   image:
-    url: true
     alt: The CentOS Project
     type: image/png
     width: 1200
@@ -16,9 +14,7 @@ twitter:
   card: summary_large_image
   site: "@CentOS"
   creator: "@CentOS"
-  title: true
   url: true
   description: true
   image:
-    url: true
     alt: The CentOS Project

data/_data/base/ogp_schema.yml

@@ -26,7 +26,13 @@ properties:
           title:
             type: string
             default: The CentOS Project
-            description: The title of the content via the `og:title` tag.
+            description: >-
+              The title of the content via the `og:title` tag. Falls back to
+              `page.title` when omitted, then to this default. Set explicitly
+              to `false` or an empty string to omit the tag entirely; `true`
+              is treated the same as omitting it (kept for backward
+              compatibility with this component's own earlier documented
+              convention).
           description:
             type: string
             default: ""
@@ -38,13 +44,22 @@ properties:
               url:
                 type: string
                 format: uri
-                default: "{{ site.url }}{{ site.baseurl }}/assets/img/centos-social-share.png"
-                description: The non-secure URL via the `og:image:url` tag.
+                default: "/assets/img/centos-social-share.png"
+                description: >-
+                  The non-secure URL via the `og:image:url` tag. Falls back
+                  to this default (treated as a path relative to
+                  `site.url + site.baseurl`, same convention as `logo`) when
+                  omitted; `true` is treated the same as omitted, for
+                  backward compatibility with this component's own earlier
+                  documented convention. Set to a real string to override
+                  with a different image.
               secure_url:
                 type: string
                 format: uri
-                default: "{{ site.url }}{{ site.baseurl }}/assets/img/centos-social-share.png"
-                description: The secure HTTPS URL via the `og:image:secure_url` tag.
+                default: "/assets/img/centos-social-share.png"
+                description: >-
+                  The secure HTTPS URL via the `og:image:secure_url` tag.
+                  Same fallback and `true`-tolerance as `url` above.
               type:
                 type: string
                 default: image/png
@@ -154,13 +169,17 @@ properties:
               url:
                 type: string
                 format: uri
-                default: "{{ site.url }}{{ site.baseurl }}/assets/img/centos-social-share.png"
-                description: The image URL via the `twitter:image:url` tag.
+                default: "/assets/img/centos-social-share.png"
+                description: >-
+                  The image URL via the `twitter:image:url` tag. Same
+                  fallback and `true`-tolerance as `og.image.url`.
               secure_url:
                 type: string
                 format: uri
-                default: "{{ site.url }}{{ site.baseurl }}/assets/img/centos-social-share.png"
-                description: The secure HTTPS image URL.
+                default: "/assets/img/centos-social-share.png"
+                description: >-
+                  The secure HTTPS image URL. Same fallback and
+                  `true`-tolerance as `og.image.secure_url`.
               type:
                 type: string
                 default: image/png

data/_data/base/shortcut_schema.yml

@@ -46,11 +46,13 @@ properties:
                 An icon class (e.g., from Font Awesome) to display alongside the heading.
             visible_on:
               type: array
-              default: ["footer"]
               description: >-
                 Controls where this item is displayed. For the Shortcut component,
-                this array must contain `"footer"` to be rendered. Other values
-                (like `"navbar"`) are ignored in this context.
+                this array must contain `"footer"` to be rendered — there is no
+                standalone default for this property here; an item with no
+                `visible_on` at all is not shown in the footer (it falls back to
+                navbar-visible instead, per the Navbar component's own default).
+                Other values (like `"navbar"`) are ignored in this context.
               items:
                 type: string
                 enum:

data/_data/base/social.yml

@@ -2,6 +2,7 @@
 #
 # site.data.base.social - Provides social networks information.
 #
+preamble: "Follow us:"
 media:
   - name: YouTube
     icon: "fa-brands fa-youtube"

data/_data/base/social_schema.yml

@@ -18,7 +18,13 @@ properties:
       preamble:
         type: string
         default: "Follow us:"
-        description: "The social media premable. This is, a text introducing the social media buttons."
+        description: >-
+          The social media premable. This is, a text introducing the social
+          media buttons. This default is applied automatically whenever the
+          resolved data source omits the property — set it explicitly to
+          `false` or an empty string to render no preamble `<p>` at all; the
+          icon row's own margin then reclaims the vertical space. Any other
+          string value renders as the preamble text.
       preamble_class:
         type: string
         default: "mb-2"

data/_includes/base/bits.html.liquid

@@ -25,7 +25,9 @@ Required Inputs (from data objects):
 
 Optional Inputs (from data objects):
 - description, screenshot, icon, image, actions, color
-- preamble, finale: Text before/after the upstream card
+- preamble, finale: Text before/after the upstream card; each falls back to
+its own schema-documented default when omitted — set explicitly to `false`
+or an empty string to render neither element instead
 - class, card_class, preamble_class, finale_class: Custom styling
 - downstream_style: 'card' (default) or 'accordion'
 - downstream_limit: accordion style only; caps items shown, omit for
@@ -71,6 +73,14 @@ Data Source Hierarchy (priority order):
   {%- assign upstream_bit_index_page_url        = upstream_bit.index_page_url   | default: with_bits_schema.index_page_url.default %}
   {%- assign upstream_bit_screenshot_class      = upstream_bit.screenshot_class | default: with_bits_schema.screenshot_class.default %}
   {%- assign upstream_bit_actions_class         = upstream_bit.actions_class    | default: with_bits_schema.actions_class.default %}
+  {%- assign upstream_bit_preamble = upstream_bit.preamble %}
+  {%- if upstream_bit.preamble == nil %}
+    {%- assign upstream_bit_preamble = with_bits_schema.preamble.default %}
+  {%- endif %}
+  {%- assign upstream_bit_finale = upstream_bit.finale %}
+  {%- if upstream_bit.finale == nil %}
+    {%- assign upstream_bit_finale = with_bits_schema.finale.default %}
+  {%- endif %}
   {%- assign upstream_bit_btn_class             = "btn btn-sm m-1 btn-"         | append: upstream_bit_color %}
   {%- assign upstream_bit_downstream_style      = upstream_bit.downstream_style  | default: with_bits_schema.downstream_style.default %}
   {%- assign upstream_bit_downstream_limit      = upstream_bit.downstream_limit %}
@@ -79,8 +89,8 @@ Data Source Hierarchy (priority order):
   <div class="d-flex flex-column{% if upstream_bit_class != "" %} {{ upstream_bit_class }}{% endif %}">
 
     {%- comment %} --- Upstream Preamble --- {% endcomment %}
-    {%- if upstream_bit.preamble %}
-      <p{% if upstream_bit_preamble_class != "" %} class="{{ upstream_bit_preamble_class }}"{% endif %}>{{ upstream_bit.preamble }}</p>
+    {%- if upstream_bit_preamble and upstream_bit_preamble != empty %}
+      <p{% if upstream_bit_preamble_class != "" %} class="{{ upstream_bit_preamble_class }}"{% endif %}>{{ upstream_bit_preamble }}</p>
     {%- endif %}
 
     {%- comment %} --- Upstream Card --- {% endcomment %}
@@ -120,9 +130,9 @@ Data Source Hierarchy (priority order):
       {%- assign show_index_link = true %}
     {%- endif %}
 
-    {%- if upstream_bit.finale %}
+    {%- if upstream_bit_finale and upstream_bit_finale != empty %}
       <div class="d-flex flex-row w-100 justify-content-between align-items-center">
-        <p class="m-1{% if upstream_bit_finale_class != "" %} {{ upstream_bit_finale_class }}{% endif %}">{{ upstream_bit.finale }}</p>
+        <p class="m-1{% if upstream_bit_finale_class != "" %} {{ upstream_bit_finale_class }}{% endif %}">{{ upstream_bit_finale }}</p>
         {%- if show_index_link %}
           <div class="m-1">
             {%- include base/link.html.liquid

data/_includes/base/navbar.html.liquid

@@ -10,7 +10,8 @@ Design Logic:
 - Responsive hamburger menu: collapses on mobile
 - Dropdown menus: multi-level navigation
 - Brand image and manifestation text support
-- Filtered navitems by visible_on='navbar'
+- Filtered navitems by visible_on='navbar'; an item that omits visible_on
+entirely falls back to being navbar-visible (schema default `["navbar"]`)
 
 Required Inputs:
 - brand_image: Logo image filename
@@ -50,7 +51,7 @@ Data Source Hierarchy (priority):
 {%- assign navbar_brand_image_height        = with_navbar_data.brand_image_height                       | default: with_navbar_schema.brand_image_height.default %}
 {%- assign navbar_brand_manifestation       = with_navbar_data.brand_manifestation                      | default: with_navbar_schema.brand_manifestation.default %}
 {%- assign navbar_brand_manifestation_class = with_navbar_data.brand_manifestation_class                | default: with_navbar_schema.brand_manifestation_class.default %}
-{%- assign navbar_navitems                  = with_navbar_data.navitems | where: "visible_on", "navbar" | default: with_navbar_schema.navitems.default %}
+{%- assign navbar_navitems                  = with_navbar_data.navitems | where_exp: "item", "item.visible_on == nil or item.visible_on contains 'navbar'" | default: with_navbar_schema.navitems.default %}
 
 <nav class="navbar bg-dark fixed-top navbar-expand-lg shadow{% if navbar_class != "" %} {{ navbar_class }}{% endif %}" aria-label="{{ include.arialable | default: 'navbar'}}" data-bs-theme="dark">
   <div class="container">

data/_includes/base/ogp.html.liquid

@@ -24,6 +24,14 @@ Optional Inputs:
 - page.locale: BCP 47 locale code set by jekyll-l10n on localized pages
 
 Data Source Hierarchy:
+- og:title, twitter:title: with_ogp_data[property].title (real string override)
+  → page.title → schema default. `true` (this component's own previously
+  documented convention) is treated the same as omitted, for backward
+  compatibility; `false` or "" suppresses the tag entirely.
+- og:image:url, :secure_url (+ twitter): with_ogp_data[property].image.url/
+  .secure_url (real string override) → schema default
+  (/assets/img/centos-social-share.png). Same `true`-tolerance as
+  title, for the same reason.
 - og:type:             with_ogp_data.og.type → schema default → 'website'
 - og:site_name:       with_ogp_data.og.site_name → site.title
 - og:logo:            with_ogp_data.og.logo → schema default → '/assets/icons/apple-touch-icon.png'
@@ -35,7 +43,6 @@ Data Source Hierarchy:
 - twitter:card:       with_ogp_data.twitter.card → schema default → 'summary_large_image'
 - twitter:site:       with_ogp_data.twitter.site → schema default → '@CentOS'
 - twitter:creator:    with_ogp_data.twitter.creator → schema default → '@CentOS'
-- Default image path: /assets/img/centos-social-share.png
 ================================================================================
 {% endcomment %}
 
@@ -89,8 +96,14 @@ Data Source Hierarchy:
     {%- endif %}
 
     {%- comment %} --- Title --- {% endcomment %}
-    {%- if with_ogp_data[property].title %}
-      <meta {{ meta_attr }}="{{ property }}:title" content="{{ page.title | escape }}" />
+    {%- assign ogp_title_raw = with_ogp_data[property].title %}
+    {%- if ogp_title_raw == nil or ogp_title_raw == true %}
+      {%- assign ogp_title = page.title | default: with_ogp_schema.og.properties.title.default %}
+    {%- else %}
+      {%- assign ogp_title = ogp_title_raw %}
+    {%- endif %}
+    {%- if ogp_title and ogp_title != empty %}
+      <meta {{ meta_attr }}="{{ property }}:title" content="{{ ogp_title | escape }}" />
     {%- endif %}
 
     {%- comment %} --- OG type and logo (after title, before url) --- {% endcomment %}
@@ -119,10 +132,24 @@ Data Source Hierarchy:
     {%- endif %}
 
     {%- comment %} --- Image --- {% endcomment %}
+    {%- assign ogp_image_url_raw = with_ogp_data[property].image.url %}
+    {%- if ogp_image_url_raw == nil or ogp_image_url_raw == true %}
+      {%- assign ogp_image_url = with_ogp_og_image_schema.url.default %}
+    {%- else %}
+      {%- assign ogp_image_url = ogp_image_url_raw %}
+    {%- endif %}
+
+    {%- assign ogp_image_secure_url_raw = with_ogp_data[property].image.secure_url %}
+    {%- if ogp_image_secure_url_raw == nil or ogp_image_secure_url_raw == true %}
+      {%- assign ogp_image_secure_url = with_ogp_og_image_schema.secure_url.default %}
+    {%- else %}
+      {%- assign ogp_image_secure_url = ogp_image_secure_url_raw %}
+    {%- endif %}
+
     {%- if with_ogp_data[property].image %}
-      <meta {{ meta_attr }}="{{ property }}:image" content="{{ site.url }}{{ site.baseurl }}/assets/img/centos-social-share.png" />
+      <meta {{ meta_attr }}="{{ property }}:image" content="{{ site.url }}{{ site.baseurl }}{{ ogp_image_url }}" />
       {%- if property == "og" %}
-        <meta {{ meta_attr }}="{{ property }}:image:secure_url" content="{{ site.url }}{{ site.baseurl }}/assets/img/centos-social-share.png" />
+        <meta {{ meta_attr }}="{{ property }}:image:secure_url" content="{{ site.url }}{{ site.baseurl }}{{ ogp_image_secure_url }}" />
         <meta {{ meta_attr }}="{{ property }}:image:type" content="{{ ogp_image_type }}" />
         <meta {{ meta_attr }}="{{ property }}:image:width" content="{{ ogp_image_width }}" />
         <meta {{ meta_attr }}="{{ property }}:image:height" content="{{ ogp_image_height }}" />

data/_includes/base/shortcut.html.liquid

@@ -8,7 +8,9 @@ sections of related links in multi-column layout suitable for footer placement.
 Strategic Design Logic:
 - Grouped navigation: categories of related links
 - Column layout: multi-column footer display
-- Filtered items: only shows items with visible_on='footer'
+- Filtered items: only shows items with visible_on='footer', required
+explicitly — an item that omits visible_on is not shown here (it defaults
+to navbar-visible instead, per navbar.html.liquid)
 - Reusable link component: consistent styling
 - Empty state handling: no output if no items
 - Category headings: uppercase section titles
@@ -46,7 +48,7 @@ Conditional Logic:
 | default: site.data.base.navbar
 %}
 
-{%- assign shortcut_navitems = with_shortcut_data.navitems | where: "visible_on", "footer" %}
+{%- assign shortcut_navitems = with_shortcut_data.navitems | where_exp: "item", "item.visible_on contains 'footer'" %}
 
 {%- if with_shortcut -%}
 

data/_includes/base/social.html.liquid

@@ -2,12 +2,13 @@
 ================================================================================
 Template: Social Links Component
 Purpose: Renders a collection of social media and external links as styled
-buttons with icons. Includes optional site description header.
+buttons with icons, with an optional preamble line introducing them.
 ================================================================================
 
-Strategic Design Logic:
+Design Logic:
 - Multi-level data source hierarchy for flexible configuration
-- Site description display for context/branding purposes
+- Optional preamble text and CSS class, and an optional CSS class on the
+  container wrapping the icon row, for full presentational customization
 - Link rendering via reusable link component with icon support
 - Icon-based visual identification for different platforms
 - Accessibility-first approach with proper ARIA labels
@@ -21,9 +22,6 @@ Required Fields (per item in the media array):
 Optional Inputs (from include):
 - data: Array of social link objects (overrides all fallbacks)
 
-Optional Inputs (from site configuration):
-- site.description: Brief site description displayed above social links
-
 Data Source Hierarchy (in priority order):
 1. include.data           - Explicitly passed social link array
 2. page.with_social_data  - Page front matter configuration
@@ -31,7 +29,10 @@ Data Source Hierarchy (in priority order):
 4. site.data.base.social  - Theme default social links
 
 Conditional Logic:
-- Site description displays only if site.description is defined
+- Preamble <p> falls back to the schema-documented default when omitted
+  from the resolved data source; set it explicitly to `false` or an empty
+  string to hide it entirely — no element is emitted in its place, so the
+  icon row's own margin reclaims the vertical space
 - Loops through all social links in resolved data source
 - Each link rendered with consistent button styling
 ================================================================================
@@ -50,27 +51,33 @@ Conditional Logic:
 {%- assign with_social_schema = site.data.base.social_schema.properties.with_social_data.properties %}
 
 {%- assign social_class          = with_social_data.class          | default: with_social_schema.class.default %}
-{%- assign social_preamble       = with_social_data.preamble       | default: with_social_schema.preamble.default %}
 {%- assign social_preamble_class = with_social_data.preamble_class | default: with_social_schema.preamble_class.default %}
 {%- assign social_media          = with_social_data.media          | default: with_social_schema.media.default %}
 
+{%- assign social_preamble = with_social_data.preamble %}
+{%- if with_social_data.preamble == nil %}
+  {%- assign social_preamble = with_social_schema.preamble.default %}
+{%- endif %}
+
 {% if with_social %}
 
   {%- comment %} === Presentation (Begin) === {% endcomment %}
-  {%- if social_preamble %}
+  {%- if social_preamble and social_preamble != empty %}
     <p class="{{ social_preamble_class }}">{{ social_preamble }}</p>
   {%- endif %}
 
-  {%- for item in social_media -%}
-    {%- include base/link.html.liquid
-    class                = "btn btn-outline-primary m-1"
-    link                 = item.link
-    role                 = "button"
-    icon                 = item.icon
-    aria_label           = item.name
-    data_bs_title        = item.name
-    %}
-  {%- endfor %}
+  <div class="{{ social_class }}">
+    {%- for item in social_media -%}
+      {%- include base/link.html.liquid
+      class                = "btn btn-outline-primary m-1"
+      link                 = item.link
+      role                 = "button"
+      icon                 = item.icon
+      aria_label           = item.name
+      data_bs_title        = item.name
+      %}
+    {%- endfor %}
+  </div>
   {%- comment %} === Presentation (End) === {% endcomment %}
 
 {% endif %}

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-theme-centos
 version: !ruby/object:Gem::Version
-  version: 2.52.0.beta.96
+  version: 2.52.0.beta.97
 platform: ruby
 authors:
 - Alain Reguera Delgado