jekyll-theme-centos 0.0.0

data/_data/base/social.yml

@@ -0,0 +1,26 @@
+---
+#
+# site.data.base.social - Provides social networks information.
+#
+media:
+  - name: YouTube
+    icon: "fa-brands fa-youtube"
+    link: "https://youtube.com/TheCentOSProject"
+  - name: Mastodon
+    icon: "fa-brands fa-mastodon"
+    link: "https://fosstodon.org/@centos"
+  - name: Facebook
+    icon: "fa-brands fa-facebook-f"
+    link: "https://www.facebook.com/CentOSProject"
+  - name: LinkedIn
+    icon: "fa-brands fa-linkedin"
+    link: "https://www.linkedin.com/company/centos-project/"
+  - name: X
+    icon: "fa-brands fa-x-twitter"
+    link: "https://x.com/centos"
+  - name: Discourse
+    icon: "fa-brands fa-discourse"
+    link: "https://discussion.fedoraproject.org/c/neighbors/centos/"
+  - name: Reddit
+    icon: "fa-brands fa-reddit"
+    link: "https://www.reddit.com/r/CentOS/"

data/_data/base/social_schema.yml

@@ -0,0 +1,57 @@
+title: Social media icons component configuration
+description: >-
+  Schema for configuring and defining the list of social media links
+  (icons) to be rendered, typically in the footer or navigation area.
+type: object
+properties:
+  with_social:
+    type: boolean
+    default: false
+    description: >-
+      Enables or disables the rendering of the social media icons component.
+      Set to `true` to display the icons; set to `false` (default) to hide them.
+  with_social_data:
+    type: object
+    default: {}
+    description: Configuration object for the social media component.
+    properties:
+      preamble:
+        type: string
+        default: "Follow us:"
+        description: "The social media premable. This is, a text introducing the social media buttons."
+      preamble_class:
+        type: string
+        default: "mb-2"
+        description: "The social media premable customization classes."
+      media:
+        type: array
+        default: []
+        description: A list of objects, where each object defines a single social media link/icon.
+        items:
+          type: object
+          properties:
+            name:
+              type: string
+              description: The name of the social network (e.g., `YouTube`, `LinkedIn`). Used for alt text and labels.
+            icon:
+              type: string
+              description: >-
+                The Font Awesome icon class representing the social network
+                brand (e.g., `fa-brands fa-x-twitter`).
+            link:
+              type: string
+              format: uri
+              description: The absolute URL to the project's profile on this social network (e.g., `https://www.youtube.com/`).
+          required:
+            - name
+            - icon
+            - link
+          additionalProperties: false
+      class:
+        type: string
+        default: ""
+        description: Custom CSS classes applied to the container element wrapping the social media icons list.
+    required:
+      - media
+    additionalProperties: false
+additionalProperties: false

data/_data/base/sponsors.yml

@@ -0,0 +1,41 @@
+---
+title: Sponsors
+icon: "fa-solid fa-hand-holding-heart"
+image_base_path: "/assets/img/base/"
+message: |
+  CentOS would not be possible without the support of our sponsors. We would
+  like to thank the following product/service for being a CentOS sponsor. If
+  you value our work, please consider [becoming a sponsor!](/sponsors)
+members:
+  - name: sponsor-1
+    country: usa
+    image: example-sponsors-logo-1.png
+    url: https://www.example.com/sponsor-1
+  - name: sponsor-2
+    country: usa
+    image: example-sponsors-logo-2.png
+    url: https://www.example.com/sponsor-2
+  - name: sponsor-3
+    country: usa
+    image: example-sponsors-logo-3.png
+    url: https://www.example.com/sponsor-3
+  - name: sponsor-4
+    country: usa
+    image: example-sponsors-logo-4.png
+    url: https://www.example.com/sponsor-4
+  - name: sponsor-5
+    country: usa
+    image: example-sponsors-logo-5.png
+    url: https://www.example.com/sponsor-5
+  - name: sponsor-6
+    country: usa
+    image: example-sponsors-logo-6.png
+    url: https://www.example.com/sponsor-6
+  - name: sponsor-7
+    country: usa
+    image: example-sponsors-logo-7.png
+    url: https://www.example.com/sponsor-7
+  - name: sponsor-8
+    country: usa
+    image: example-sponsors-logo-8.png
+    url: https://www.example.com/sponsor-8

data/_data/base/sponsors_schema.yml

@@ -0,0 +1,73 @@
+title: Sponsors carousel component configuration
+description: >-
+  Schema for configuring the sponsors carousel, which displays sponsor logos
+  in a rotating carousel, typically rendered in the footer.
+type: object
+properties:
+  with_sponsors:
+    type: boolean
+    default: false
+    description: >-
+      Enables or disables the rendering of the sponsors carousel component.
+      Set to `true` to display the carousel; set to `false` (default) to hide it.
+  with_sponsors_data:
+    type: object
+    default: {}
+    description: Configuration object for the sponsors carousel component.
+    properties:
+      title:
+        type: string
+        default: "Sponsors"
+        description: The heading displayed above the carousel.
+      icon:
+        type: string
+        default: "fa-solid fa-hand-holding-heart"
+        description: Font Awesome icon class shown next to the title.
+      message:
+        type: string
+        default: ""
+        description: Introductory text rendered above the carousel, supports Markdown.
+      image_base_path:
+        type: string
+        default: "/assets/img/base/"
+        description: >-
+          Base path prepended to bare logo filenames when building the image `src`
+          attribute. Defaults to `/assets/img/base/`. Set to a different path
+          (e.g. `/assets/img/sponsors/`) to store logos elsewhere on the site.
+          Ignored when `image` is an absolute URL (`http://` or `https://`).
+      members:
+        type: array
+        default: []
+        description: List of sponsor entries to display in the carousel.
+        items:
+          type: object
+          properties:
+            name:
+              type: string
+              description: Display name of the sponsor (used as image alt text).
+            country:
+              type: string
+              description: Country of the sponsor (informational).
+            image:
+              type: string
+              description: >-
+                Logo image source. Accepts a bare filename (resolved using
+                `image_base_path`, e.g. `logo.png`) or an absolute URL
+                (e.g. `https://cdn.example.com/logo.png`, used as-is).
+            url:
+              type: string
+              format: uri
+              description: URL to the sponsor's website.
+            is_active:
+              type: boolean
+              default: true
+              description: Set to `false` to hide this sponsor without removing the entry.
+          required:
+            - name
+            - image
+            - url
+          additionalProperties: false
+    required:
+      - members
+    additionalProperties: false
+additionalProperties: false

data/_data/base/title_schema.yml

@@ -0,0 +1,49 @@
+---
+title: Semantic page h1 heading component configuration
+description: >-
+  Schema for configuring the single, primary H1 heading of a page. This component
+  is reserved for the highest-level title, with subsequent headings (H2-H6)
+  typically generated automatically by the content renderer (e.g., Jekyll Markdown).
+type: object
+properties:
+  with_title:
+    type: boolean
+    default: true
+    description: >-
+      Enables or disables the rendering of the primary H1 heading block. Set
+      to `true` (default) to display the configured H1; set to `false` to hide it.
+  with_title_data:
+    type: object
+    default: {}
+    description: Configuration object defining the text and presentation of the page's primary H1 heading.
+    properties:
+      class:
+        type: string
+        default: "row mt-4"
+        description: >-
+          One or more CSS classes applied to title container element for custom styling,
+          alignment, or spacing.
+      title:
+        type: string
+        default: "`page.title`"
+        description: The main, primary title text to be displayed. This content is always wrapped in the <h1> HTML tag.
+      title_class:
+        type: string
+        default: "h1"
+        description: >-
+          One or more CSS classes applied to the title element for custom
+          styling, alignment, or spacing (e.g., `text-center`, `display-1`).
+      title_lead:
+        type: string
+        default: "`page.title_lead`"
+        description: An optional lead text or introductory paragraph displayed immediately beneath the H1, providing context or summary.
+      title_lead_class:
+        type: string
+        default: "lead"
+        description: >-
+          One or more CSS classes applied to the title_lead element for custom
+          styling, alignment, or spacing.
+    required:
+      - title
+    additionalProperties: false
+additionalProperties: false

data/_data/base/toc_schema.yml

@@ -0,0 +1,114 @@
+title: Table of Contents Component Configuration
+description: >-
+  Schema for configuring the table of contents (TOC) component that automatically
+  generates a navigable list of headings from page content. Uses Highlight.js
+  jekyll-toc library to dynamically create links to headings within the page.
+type: object
+properties:
+  with_toc:
+    type: boolean
+    default: true
+    description: >-
+      Enables or disables the rendering of the table of contents component.
+      Set to `true` (default) to display the TOC; set to `false` to hide it.
+  with_toc_data:
+    type: object
+    default: {}
+    description: >-
+      Configuration object defining the presentation and behavior of the table
+      of contents, including styling and header level filters.
+    properties:
+      class:
+        type: string
+        default: ""
+        description: >-
+          CSS class(es) assigned to the TOC root list element for custom styling.
+          Multiple classes can be specified separated by spaces (e.g., `my-custom-class another-class`).
+      id:
+        type: string
+        default: ""
+        description: >-
+          The HTML ID attribute assigned to the TOC root list element, used for targeting
+          with CSS or JavaScript (e.g., `page-toc`).
+      item_class:
+        type: string
+        default: ""
+        description: >-
+          CSS class(es) applied to each list item in the TOC. Supports the `%level%`
+          placeholder which is replaced with the current heading level (e.g., `my-2.%level%`).
+      anchor_class:
+        type: string
+        default: ""
+        description: >-
+          CSS class(es) applied to each anchor element (link) in the TOC. Used to style
+          the actual clickable links (e.g., `text-decoration-none text-dark`).
+      h_min:
+        type: integer
+        default: 1
+        minimum: 1
+        maximum: 6
+        description: >-
+          The minimum heading level to include in the TOC. Headers smaller than this
+          level (e.g., h1, h2) will be excluded. Valid range: 1-6.
+      h_max:
+        type: integer
+        default: 6
+        minimum: 1
+        maximum: 6
+        description: >-
+          The maximum heading level to include in the TOC. Headers larger than this
+          level will be excluded. Valid range: 1-6.
+      ordered:
+        type: boolean
+        default: false
+        description: >-
+          When set to `true`, the TOC will be rendered as an ordered list (`<ol>`)
+          instead of an unordered list (`<ul>`). Default is `false` (unordered list).
+      submenu_class:
+        type: string
+        default: ""
+        description: >-
+          CSS class(es) applied to each nested list group representing subheadings.
+          Supports the `%level%` placeholder which is replaced with the submenu level
+          (e.g., `submenu.%level%`).
+      base_url:
+        type: string
+        format: uri
+        default: ""
+        description: >-
+          Base URL prepended to TOC links. Use when the TOC is displayed on a different
+          page than the actual content (e.g., `/docs/`).
+      sanitize:
+        type: boolean
+        default: true
+        description: >-
+          When set to `true`, HTML tags within headings will be stripped from the TOC
+          display text. Default is `true` (HTML is stripped). Enabling sanitization
+          is particularly important when heading anchors are active, as it prevents
+          the anchor icon markup from appearing inside TOC entry links.
+      skip_no_ids:
+        type: boolean
+        default: false
+        description: >-
+          When set to `true`, headings without an `id` attribute will be excluded from
+          the TOC. Default is `false` (all headings are included, with or without IDs).
+      flat_toc:
+        type: boolean
+        default: false
+        description: >-
+          When set to `true`, the TOC will be rendered as a single-level flat list
+          instead of a hierarchical nested structure. Default is `false` (hierarchical).
+      baseurl:
+        type: string
+        deprecated: true
+        description: >-
+          Deprecated. Use `base_url` instead. When provided, a deprecation warning
+          comment is emitted in the HTML output.
+      skipNoIDs:
+        type: boolean
+        deprecated: true
+        description: >-
+          Deprecated. Use `skip_no_ids` instead. When provided, a deprecation warning
+          comment is emitted in the HTML output.
+    additionalProperties: false
+additionalProperties: false