al_math 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 6100b2d816b9358fc08c305fe44ebf08176a6fb3d374fcc9ecff853232039fbf
+  data.tar.gz: 8ee3574df9a8aa2c1bb7b05376c75c4ca9988cef8c57e287cacfb3780e0d4d2a
+SHA512:
+  metadata.gz: de57b560084e6098a0ddbbb67c12c7723d14a6641af54c5edb5d1582406928d7771e0415f410517f3527591e49b617366cfd9efa5ca1e90925e5e8a789a13a2d
+  data.tar.gz: 3277f6587721a9c9802ff5bf86139b379f85901af96c3d6be87501ac3a73b4346c435eccb0d74760c75a04e3385cff792565037270fe090d1b8d7394c80eccb7

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+## 0.1.0 - 2026-02-07
+- Initial gem release.
+- Added standalone math script/style tags and assets (MathJax, pseudocode, TikZJax).

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,23 @@
+# Al-Math
+
+A Jekyll plugin that provides math-related assets and script loading.
+
+## Installation
+
+```ruby
+gem 'al_math'
+```
+
+Enable in `_config.yml`:
+
+```yaml
+plugins:
+  - al_math
+```
+
+## Usage
+
+```liquid
+{% al_math_styles %}
+{% al_math_scripts %}
+```

data/lib/al_math.rb

@@ -0,0 +1,80 @@
+require 'jekyll'
+
+module AlMath
+  PLUGIN_NAME = 'al_math'
+  ASSETS_DIR = 'assets'
+
+  class PluginStaticFile < Jekyll::StaticFile; end
+
+  class AssetsGenerator < Jekyll::Generator
+    safe true
+    priority :low
+
+    def generate(site)
+      plugin_lib_path = File.expand_path('.', __dir__)
+      Dir.glob(File.join(plugin_lib_path, ASSETS_DIR, PLUGIN_NAME, '**', '*')).each do |source_path|
+        next if File.directory?(source_path)
+
+        relative_dir = File.dirname(source_path).sub("#{plugin_lib_path}/", '')
+        site.static_files << PluginStaticFile.new(site, plugin_lib_path, relative_dir, File.basename(source_path))
+      end
+    end
+  end
+
+  class MathStylesTag < Liquid::Tag
+    def render(context)
+      site = context.registers[:site]
+      page = context.registers[:page] || context['page'] || {}
+      return '' unless site
+      return '' unless truthy?(page['tikzjax'])
+
+      baseurl = site.config['baseurl'] || ''
+      %(<link defer rel="stylesheet" type="text/css" href="#{baseurl}/assets/al_math/css/tikzjax.min.css">)
+    end
+
+    private
+
+    def truthy?(value)
+      value == true || value.to_s == 'true'
+    end
+  end
+
+  class MathScriptsTag < Liquid::Tag
+    def render(context)
+      site = context.registers[:site]
+      page = context.registers[:page] || context['page'] || {}
+      return '' unless site
+
+      cfg = site.config
+      libs = cfg['third_party_libraries'] || {}
+      baseurl = cfg['baseurl'] || ''
+      out = []
+
+      if truthy?(cfg['enable_math'])
+        out << %(<script defer type="text/javascript" id="MathJax-script" src="#{libs.dig('mathjax', 'url', 'js')}" integrity="#{libs.dig('mathjax', 'integrity', 'js')}" crossorigin="anonymous"></script>)
+        if truthy?(page['pseudocode'])
+          out << %(<script src="#{baseurl}/assets/al_math/js/pseudocode-setup.js"></script>)
+          out << %(<script type="text/javascript" src="#{libs.dig('pseudocode', 'url', 'js')}" integrity="#{libs.dig('pseudocode', 'integrity', 'js')}" crossorigin="anonymous"></script>)
+        else
+          out << %(<script src="#{baseurl}/assets/al_math/js/mathjax-setup.js"></script>)
+          out << %(<script defer src="#{libs.dig('polyfill', 'url', 'js')}" crossorigin="anonymous"></script>)
+        end
+      end
+
+      if truthy?(page['tikzjax'])
+        out << %(<script defer src="#{baseurl}/assets/al_math/js/tikzjax.min.js" type="text/javascript"></script>)
+      end
+
+      out.join("\n")
+    end
+
+    private
+
+    def truthy?(value)
+      value == true || value.to_s == 'true'
+    end
+  end
+end
+
+Liquid::Template.register_tag('al_math_styles', AlMath::MathStylesTag)
+Liquid::Template.register_tag('al_math_scripts', AlMath::MathScriptsTag)