al_icons 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 11203fa93f91bbeb7733e7e91147c545bf967f10e5e05719b793e314ecd89b0e
+  data.tar.gz: a07f09b6b6dca1c2f78860700760ab1a21b6a56b97a7a261d62cf026a43752e9
+SHA512:
+  metadata.gz: 97bbcc33b007cacee7e7314a3f3f9f156318cb18bfdd28be27e1e8e24e59cd29f2f2752748303673e5b2f57560a5f9fffec5e237c13d702b5e4d48d31f127ef4
+  data.tar.gz: 30fe7dbe78471d1bb5308e4549700edde6b5a58a1417137bd046402c4b192f09dc04fd1a44df9617d7c9ae4ad78a452610283629561da9314bcfbbeac4b5759c

data/CHANGELOG.md

@@ -0,0 +1,6 @@
+# Changelog
+
+## 1.0.0
+
+- Initial extraction of icon runtime ownership from `al_folio_core`.
+- Added `al_icons_styles` Liquid tag for Font Awesome, Academicons, and Scholar Icons.

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) al-org
+
+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,47 @@
+# al-icons
+
+`al-icons` owns icon runtime assets for al-folio v1.x.
+
+## Responsibilities
+
+- Render icon stylesheet tags via `{% al_icons_styles %}`
+- Centralize pinned icon CDN URLs and optional SRI usage
+- Keep icon ownership out of `al_folio_core` and starter runtime files
+
+## Usage
+
+Add plugin to `_config.yml`:
+
+```yml
+plugins:
+  - al_icons
+```
+
+Add parse-safe include wrapper in theme/head templates:
+
+```liquid
+{% include plugins/al_icons_styles.liquid %}
+```
+
+Expected config:
+
+```yml
+third_party_libraries:
+  fontawesome:
+    url:
+      css: https://cdn.jsdelivr.net/npm/@fortawesome/fontawesome-free@7.2.0/css/all.min.css
+    integrity:
+      css: ...
+  academicons:
+    url:
+      css: https://cdn.jsdelivr.net/npm/academicons@1.9.5/css/academicons.min.css
+    integrity:
+      css: ...
+  scholar-icons:
+    url:
+      css: https://cdn.jsdelivr.net/npm/scholar-icons@1.0.3/css/scholar-icons.css
+    integrity:
+      css: ...
+```
+
+`integrity.css` is optional per library; when omitted, the tag renders without integrity/crossorigin attributes.

data/lib/al_icons/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module AlIcons
+  VERSION = '1.0.0'
+end

data/lib/al_icons.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+require 'jekyll'
+require 'liquid'
+require_relative 'al_icons/version'
+
+module AlIcons
+  LIBRARIES = {
+    'fontawesome' => ['fontawesome', 'Font Awesome'],
+    'academicons' => ['academicons', 'Academicons'],
+    'scholar-icons' => ['scholar-icons', 'Scholar Icons']
+  }.freeze
+
+  class IconStylesTag < Liquid::Tag
+    def render(context)
+      site = context.registers[:site]
+      return '' unless site
+
+      libs = site.config['third_party_libraries'] || {}
+
+      rendered = LIBRARIES.map do |config_key, display_name|
+        key, label = display_name
+        cfg = libs[key] || libs[config_key]
+        next '' unless cfg.is_a?(Hash)
+
+        href = cfg.dig('url', 'css')
+        next '' unless href.to_s.strip != ''
+
+        integrity = cfg.dig('integrity', 'css')
+        if integrity.to_s.strip != ''
+          <<~HTML
+            <!-- #{label} -->
+            <link defer rel="stylesheet" href="#{href}" integrity="#{integrity}" crossorigin="anonymous">
+          HTML
+        else
+          <<~HTML
+            <!-- #{label} -->
+            <link defer rel="stylesheet" href="#{href}">
+          HTML
+        end
+      end
+
+      rendered.reject(&:empty?).join("\n")
+    end
+  end
+end
+
+Liquid::Template.register_tag('al_icons_styles', AlIcons::IconStylesTag)

metadata

@@ -0,0 +1,123 @@
+--- !ruby/object:Gem::Specification
+name: al_icons
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- al-org
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: jekyll
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.9'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.9'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: liquid
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+description: Jekyll plugin extracted from al-folio that renders Font Awesome, Academicons,
+  and Scholar Icons assets through Liquid tags.
+email:
+- dev@al-org.dev
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- lib/al_icons.rb
+- lib/al_icons/version.rb
+homepage: https://github.com/al-org-dev/al-icons
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/al-org-dev/al-icons
+  source_code_uri: https://github.com/al-org-dev/al-icons
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.7'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.6
+specification_version: 4
+summary: Icon runtime tag plugin for al-folio
+test_files: []