al_utils 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 4172a509d0b614f27b124ade7a6e1cd19080ad32572cdc1ac3b4c6cb7e62f18b
+  data.tar.gz: 50807ddc96678be6a77e60c039e308fd2666e1fcb5076d89fd7a8edb57e18a90
+SHA512:
+  metadata.gz: f8c5b1080262e083da3ede8ede56028e604b685a0d0fcb04e71911f28335eaf1e4ebdb724bbb053ba51c7dc405ec773d6fbb9bd277e25521d7ca270de4bb481f
+  data.tar.gz: 03e42c3e94f31a83bf2248f683016badd590ba0946dc1519435b0befc339d52c36c2228d50874a98d56ea4818aa87a6de997ab9ec66fdbd6cc1d9c31e096faa7

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+## 0.1.0 - 2026-02-07
+- Initial gem release.
+- Added reusable utility tags/filters extracted from al-folio.

data/LICENSE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Maruan Al-Shedivat.
+
+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,33 @@
+# Al-Utils
+
+A Jekyll plugin that provides utility Liquid tags and filters extracted from al-folio.
+
+## Features
+
+- `{% details %}` block tag
+- `{% file_exists %}` tag
+- `remove_accents` filter
+- `hideCustomBibtex` filter
+
+## Installation
+
+Add this line to your Jekyll site's Gemfile:
+
+```ruby
+gem 'al_utils'
+```
+
+Then run:
+
+```bash
+bundle install
+```
+
+## Usage
+
+Add the plugin to `_config.yml`:
+
+```yaml
+plugins:
+  - al_utils
+```

data/lib/al_utils.rb

@@ -0,0 +1,73 @@
+require 'jekyll'
+require 'i18n'
+
+module AlUtils
+  module Tags
+    class DetailsTag < Liquid::Block
+      def initialize(tag_name, markup, tokens)
+        super
+        @caption = markup
+      end
+
+      def render(context)
+        site = context.registers[:site]
+        converter = site.find_converter_instance(::Jekyll::Converters::Markdown)
+        caption = converter.convert(@caption).gsub(%r{</?p[^>]*>}, '').chomp
+        body = converter.convert(super(context))
+        "<details><summary>#{caption}</summary>#{body}</details>"
+      end
+    end
+
+    class FileExistsTag < Liquid::Tag
+      def initialize(tag_name, path, tokens)
+        super
+        @path = path
+      end
+
+      def render(context)
+        url = Liquid::Template.parse(@path).render(context)
+        site_source = context.registers[:site].config['source']
+        file_path = "#{site_source}/#{url}"
+        File.exist?(file_path.strip).to_s
+      end
+    end
+  end
+
+  module Filters
+    module HideCustomBibtex
+      def hideCustomBibtex(input)
+        keywords = @context.registers[:site].config['filtered_bibtex_keywords']
+        keywords.each do |keyword|
+          input = input.gsub(/^.*\b#{keyword}\b *= *\{.*$\n/, '')
+        end
+
+        input.gsub(/^.*\bauthor\b *= *\{.*$\n/) { |line| line.gsub(/[*†‡§¶‖&^]/, '') }
+      end
+    end
+
+    module CleanString
+      class RemoveAccents
+        I18n.config.available_locales = :en
+
+        attr_accessor :string
+
+        def initialize(string:)
+          self.string = string
+        end
+
+        def digest!
+          I18n.transliterate(string)
+        end
+      end
+
+      def remove_accents(string)
+        RemoveAccents.new(string: string).digest!
+      end
+    end
+  end
+end
+
+Liquid::Template.register_tag('details', AlUtils::Tags::DetailsTag)
+Liquid::Template.register_tag('file_exists', AlUtils::Tags::FileExistsTag)
+Liquid::Template.register_filter(AlUtils::Filters::HideCustomBibtex)
+Liquid::Template.register_filter(AlUtils::Filters::CleanString)

metadata

@@ -0,0 +1,145 @@
+--- !ruby/object:Gem::Specification
+name: al_utils
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- al-org
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-02-07 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: i18n
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.8'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.8'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.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 with reusable Liquid tags/filters
+  including details, file_exists, hideCustomBibtex, and remove_accents.
+email:
+- dev@al-org.dev
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- lib/al_utils.rb
+homepage: https://github.com/al-org-dev/al-utils
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/al-org-dev/al-utils
+  source_code_uri: https://github.com/al-org-dev/al-utils
+post_install_message: 
+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: 3.0.3.1
+signing_key: 
+specification_version: 4
+summary: Utility Liquid tags and filters for Jekyll
+test_files: []