jekyll-fora 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: d03281bcecd25e58c328786acc741da8d8b0d4e6a1fac8f8c1adb2a95f279306
+  data.tar.gz: d708390c432152e846e66adfec9a746a851961368a187c1c4e481e9230ce1528
+SHA512:
+  metadata.gz: 6d66395e1d96cc93cc235ce60bef9a5bb6ccb9805a9e095aaf1e1bf946d094b428dfd7e30031ed5f4b3282274393c3bda426b65c75566f381e74c72768f9c1a2
+  data.tar.gz: 54710939a782ccc1aeff61f371de349463eeaa3fca00351be28cb21ccfa41f6c37e84bcfdc75758c9e8deeb12bdb0b16405b50e9a3793ceed503663782f60189

data/README.md

@@ -0,0 +1,82 @@
+# jekyll-fora
+
+Jekyll plugin for embedding [Fora](https://giga.mobile) comments — the fastest embeddable comment system, built on Cloudflare's edge.
+
+## Install
+
+### Via Gemfile
+
+```ruby
+gem "jekyll-fora"
+```
+
+Then add to `_config.yml`:
+
+```yaml
+plugins:
+  - jekyll-fora
+```
+
+### Manual
+
+Copy `lib/jekyll-fora.rb` into your project's `_plugins/` directory.
+
+## Usage
+
+### Set your site key in `_config.yml`
+
+```yaml
+fora_site_key: "your-site-key"
+```
+
+### Add comments to any post or page
+
+```liquid
+{% fora_comments %}
+```
+
+### Override per-post
+
+```liquid
+{% fora_comments site_key="other-site-key" theme="dark" %}
+```
+
+### With theming
+
+```liquid
+{% fora_comments accent="#8b5cf6" bg="#0a0a0a" surface="#18181b" text="#e4e4e7" radius="8px" %}
+```
+
+### In a layout
+
+```html
+<article>
+  {{ content }}
+</article>
+
+{% if page.comments != false %}
+  {% fora_comments %}
+{% endif %}
+```
+
+## Parameters
+
+| Parameter | Config key | Default | Description |
+|-----------|-----------|---------|-------------|
+| `site_key` | `fora_site_key` | — | Your Fora site key |
+| `page_id` | — | page URL | Thread identifier |
+| `page_title` | — | page title | Page title |
+| `theme` | — | `auto` | Theme: `auto`, `light`, `dark` |
+| `container_id` | — | `fora-comments` | DOM container ID |
+| `origin` | — | `https://giga.mobile` | Fora API origin |
+| `features` | — | `""` | Feature flags |
+| `accent` | — | — | Accent color |
+| `bg` | — | — | Background color |
+| `surface` | — | — | Surface color |
+| `text` | — | — | Text color |
+| `font` | — | — | Font family |
+| `radius` | — | — | Border radius |
+
+## License
+
+MIT

data/lib/jekyll-fora.rb

@@ -0,0 +1,62 @@
+# Jekyll-Fora — Fora comments tag for Jekyll
+#
+# Usage in _config.yml:
+#   fora_site_key: "your-site-key"
+#
+# Usage in posts/pages:
+#   {% fora_comments %}
+#   {% fora_comments site_key="your-site-key" theme="dark" %}
+#   {% fora_comments site_key="your-site-key" accent="#8b5cf6" radius="8px" %}
+
+module Jekyll
+  class ForaCommentsTag < Liquid::Tag
+    VALID_KEYS = %w[
+      site_key page_id page_title theme container_id origin features
+      accent bg surface text font radius
+    ].freeze
+
+    def initialize(tag_name, markup, tokens)
+      super
+      @attrs = {}
+      markup.scan(/(\w+)\s*=\s*"([^"]*)"/) do |key, value|
+        @attrs[key] = value if VALID_KEYS.include?(key)
+      end
+    end
+
+    def render(context)
+      site_key = @attrs['site_key'] || context.registers[:site].config['fora_site_key'] || ''
+      page_id = @attrs['page_id'] || context['page']['url'] || context['page']['path'] || ''
+      page_title = @attrs['page_title'] || context['page']['title'] || ''
+      theme = @attrs['theme'] || 'auto'
+      container_id = @attrs['container_id'] || 'fora-comments'
+      origin = @attrs['origin'] || 'https://giga.mobile'
+      features = @attrs['features'] || ''
+
+      attrs = %(data-site-key="#{escape(site_key)}")
+      attrs += %( data-page-id="#{escape(page_id)}") unless page_id.empty?
+      attrs += %( data-page-title="#{escape(page_title)}") unless page_title.empty?
+      attrs += %( data-theme="#{escape(theme)}")
+      attrs += %( data-container-id="#{escape(container_id)}")
+      attrs += %( data-features="#{escape(features)}") unless features.empty?
+
+      # Theming overrides
+      %w[accent bg surface text font radius].each do |key|
+        val = @attrs[key]
+        attrs += %( data-#{key}="#{escape(val)}") if val && !val.empty?
+      end
+
+      <<~HTML
+        <div id="#{escape(container_id)}"></div>
+        <script src="#{escape(origin)}/embed.js" #{attrs}></script>
+      HTML
+    end
+
+    private
+
+    def escape(str)
+      CGI.escapeHTML(str.to_s)
+    end
+  end
+end
+
+Liquid::Template.register_tag('fora_comments', Jekyll::ForaCommentsTag)

metadata

@@ -0,0 +1,66 @@
+--- !ruby/object:Gem::Specification
+name: jekyll-fora
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Giga Mobile
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-03-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: jekyll
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+description: A Jekyll plugin that adds a {% fora_comments %} Liquid tag for embedding
+  Fora comment widgets on any Jekyll site.
+email:
+- hello@giga.mobile
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/jekyll-fora.rb
+homepage: https://giga.mobile
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+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: Fora comments for Jekyll — the fastest embeddable comment system
+test_files: []