jekyll-figure 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a210f7cb78ffe64a2b89cb8d15f59c76ff97078827a602a5372eb1e16fa71b96
-  data.tar.gz: 20d71c89144d59e145201d17b7ff86575a31c256b98818db4524c0c5566d4628
+  metadata.gz: d4ef02f57060db513906d950dbf708ddc1237495dd3df4ff783799fd049a908d
+  data.tar.gz: 46f4a6336c409de505479624196de701a22b9bd087a56939f552d24f9ffff987
 SHA512:
-  metadata.gz: 6986384a4a6b14a34544984bd09fb59048258120a7137039b7e7f847bf01fcf579926585ed746960009e3310143338e03686f241f5a6932cce93851ddc15f941
-  data.tar.gz: c0f63044fb45aebb4e36da199d50a49f48c19ecb1e3543107ec0200bbbd1e842e4db6243b1f807f6b80f22632e06560c65326d2b969d243154623002a14f3403
+  metadata.gz: 844cd1bf4a667cf4f2fc006f8fc71d4b32c25cafadacdeab072add72c31cfd71ea07fce71f0871f6075aab42ab24a8d70213fbeb32f071b61f19caff097be094
+  data.tar.gz: 86e3492bcc24ab601d33362da912d227ac538282951589a0b80a72de3e08a3f6c678c5e08a1acec8cd2db94b994191fa43546b53af8b3a09bcd757761a8b4f31

data/.github/dependabot.yml

@@ -0,0 +1,6 @@
+version: 2
+updates:
+  - package-ecosystem: "bundler"
+    directory: "/"
+    schedule:
+      interval: "monthly"

data/.github/workflows/test.yml

@@ -0,0 +1,27 @@
+name: test
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        ruby: [2.6.6]
+        jekyll: [3.0, 4.0]
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Ruby
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: ${{ matrix.ruby }}
+      env:
+        JEKYLL_VERSION: ${{ matrix.jekyll }}
+    - name: Install dependencies
+      run: bundle install
+    - name: Run tests
+      run: bundle exec rake spec

data/README.md

@@ -2,26 +2,26 @@
 
 A liquid tag for Jekyll that generates `<figure>` elements.
 
-[![Gem Version](https://img.shields.io/gem/v/jekyll-figure.svg)](https://rubygems.org/gems/jekyll-figure)
-[![Build Status](https://img.shields.io/travis/paulrobertlloyd/jekyll-figure/master.svg)](https://travis-ci.org/paulrobertlloyd/jekyll-figure)
+[![Gem version](https://img.shields.io/gem/v/jekyll-figure.svg)](https://rubygems.org/gems/jekyll-figure)
+[![Build status](https://github.com/paulrobertlloyd/jekyll-figure/workflows/test/badge.svg)](https://github.com/paulrobertlloyd/jekyll-figure/actions)
 
 ## Installation
 
 1. Add `gem 'jekyll-figure'` to your site’s Gemfile and run `bundle`
 2. Add the following to your site’s `_config.yml`:
 
-
 ```yaml
 plugins:
   - jekyll-figure
 ```
+
 Note: If you are using a Jekyll version less than 3.5.0, use the `gems` key instead of `plugins`.
 
 ## Usage
 
 This plugin provides a liquid tag that enables you to generate a `<figure>` element. It takes optional `caption` and `class` parameters.
 
-```
+```liquid
 {% figure [caption:"Caption (markdown)"] [class:"class1 class2"] %}
 Figure content (markdown)
 {% endfigure %}
@@ -31,7 +31,7 @@ Figure content (markdown)
 
 In simplest usage:
 
-```
+```liquid
 {% figure %}
 Content
 {% endfigure %}
@@ -45,7 +45,7 @@ Content
 
 You can provide a caption, for which any markdown will be rendered:
 
-```
+```liquid
 {% figure caption:"*Markdown* caption" %}
 Content
 {% endfigure %}
@@ -60,7 +60,7 @@ Content
 
 You can also provide a class name(s) for CSS styling:
 
-```
+```liquid
 {% figure caption:"A caption" class:"classname" %}
 Content
 {% endfigure %}
@@ -75,7 +75,7 @@ Content
 
 The `caption` parameter also accepts liquid markup:
 
-```
+```liquid
 {% figure caption:"{{ page.title }}" %}
 Content
 {% endfigure %}
@@ -88,9 +88,30 @@ Content
 </figure>
 ```
 
+You can also add labels and reference them:
+
+```liquid
+{% figure caption:"A caption." label:example %}
+An example figure that can be referenced later.
+{% endfigure %}
+
+You can see an example in {% figref example %}.
+```
+
+```html
+<figure id="example">
+  <p>An example figure that can be referenced later.</p>
+  <figcaption><em>Figure 1:</em> A caption.</figcaption>
+</figure>
+
+<p>You can see an example in <a href="#example">figure 1</a></p>
+```
+
+The word ‘Figure’ in the figcaption is translated according to the `lang` you set in the yaml header of your post. If your language is not supported simple set `figure` to the yaml header of your post to the value you want to use instead of ‘Figure’.
+
 ## Configuration
 
-Any markdown provided within the `{% figure %}` block is rendered using Jekyll's Markdown parser, [Kramdown](https://kramdown.gettalong.org). However, this means images and other content will be wrapped within `<p>` tags, like so:
+Any markdown provided within the `{% figure %}` block is rendered using Jekyll’s Markdown parser, [Kramdown](https://kramdown.gettalong.org). However, this means images and other content will be wrapped within `<p>` tags, like so:
 
 ```html
 <figure>
@@ -112,8 +133,8 @@ Note however that this will remove *all* paragraph tags, even those nested withi
 
 ## Testing
 
-1. `script/bootstrap`
-2. `script/cibuild`
+1. `bundle install`
+2. `bundle exec rake spec`
 
 ## Contributing
 

data/jekyll-figure.gemspec

@@ -19,8 +19,8 @@ Gem::Specification.new do |spec|
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ["lib"]
 
-  spec.add_development_dependency "jekyll", [">= 3.0", "< 4.0"]
+  spec.add_development_dependency "jekyll", [">= 3.0", "< 5.0"]
   spec.add_development_dependency "rspec", "~> 3.0"
-  spec.add_development_dependency 'rake', '~> 0'
-  spec.add_development_dependency "bundler", "~> 1.6"
+  spec.add_development_dependency 'rake', '~> 13.0.1'
+  spec.add_development_dependency "bundler", "~> 2.1"
 end

data/lib/jekyll-figure/version.rb

@@ -1,5 +1,5 @@
 module Jekyll
   module Figure
-    VERSION = "0.1.0"
+    VERSION = "0.2.0"
   end
 end

data/lib/jekyll-figure-ref.rb

@@ -0,0 +1,22 @@
+require 'utils'
+
+module Jekyll
+  module Figure
+
+    class FigRefTag < Liquid::Tag
+      include Utils
+
+      def initialize(tag_name, markup, tokens)
+        @label = markup
+        super
+      end
+
+      def render(context)
+        @context = context
+        print_reference(@label)
+      end
+    end
+  end
+end
+
+Liquid::Template.register_tag("figref", Jekyll::Figure::FigRefTag)

data/lib/jekyll-figure.rb

@@ -1,7 +1,12 @@
+require 'utils'
+require 'jekyll-figure-ref'
+
 module Jekyll
   module Figure
 
     class FigureTag < Liquid::Block
+      include Utils
+
       def initialize(tag_name, markup, tokens)
         @markup = markup
         super
@@ -24,11 +29,14 @@ module Jekyll
         @settings = site.config["jekyll-figure"]
         @caption = attributes["caption"]
         @class = attributes["class"]
+        @label = attributes["label"]
+        @context = context
 
         # Caption: convert markdown and remove paragraphs
         unless @caption.nil?
           figure_caption = @caption.gsub!(/\A"|"\Z/, "")
           figure_caption = converter.convert(figure_caption).gsub(/<\/?p[^>]*>/, "").chomp
+          figure_caption = print_figure_counter(@label) + figure_caption unless @label.nil? || @label.empty?
           figure_caption = "  <figcaption>#{figure_caption}</figcaption>\n"
         end
 
@@ -38,6 +46,8 @@ module Jekyll
           figure_class = " class\=\"#{figure_class}\""
         end
 
+        figure_label = @label.nil? || @label.empty? ? "" : ' id="' + @label.gsub(/A"|"\Z/, "") + '"'
+        
         # Content
         if @settings && @settings["paragraphs"] == false
           # Strip paragraphs
@@ -51,7 +61,7 @@ module Jekyll
         markdown_escape = "\ "
 
         # Render <figure>
-        figure_tag =  "<figure#{figure_class}>"
+        figure_tag =  "<figure#{figure_class}#{figure_label}>"
         figure_tag += "#{figure_main}"
         figure_tag += "#{figure_caption}"
         figure_tag += "</figure>"

data/lib/utils.rb

@@ -0,0 +1,47 @@
+module Jekyll
+  module Figure
+    module Utils
+
+      class I18n
+        @figure_i18n = {'en' => "Figure",
+                        'de' => "Abbildung",
+                        'sv' => "Figur",
+                        'fr' => "Figure"}
+        def self.figure(lang)
+          return @figure_i18n[lang] if @figure_i18n.key?(lang)
+          @figure_i18n['en']
+        end
+      end
+
+      def lang
+        return @context.registers[:page]["lang"].to_s if @context.registers[:page].key?("lang")
+        "en".to_s
+      end
+
+      def figure
+        return @context.registers[:page]["figure"].to_s if @context.registers[:page].key?("figure")
+        I18n.figure(lang)
+      end
+      
+      def print_figure_counter(label)
+        label.gsub!(/\s/, '')
+        @context.registers[:page]["figure_labels"] ||= {}
+        
+        if @context.registers[:page]["figure_labels"].key?(label)
+          value = @context.registers[:page]["figure_labels"][label]
+        else
+          value = @context.registers[:page]["figure_labels"].length + 1
+          @context.registers[:page]["figure_labels"][label] = value
+        end
+        "<em>" + figure + " " + value.to_s + ":</em> "
+      end
+
+      def print_reference(label)
+        label.gsub!(/\s/, '')
+        "<a href=\"\##{label.to_s}\">" + figure.downcase + " " +
+          @context.registers[:page]["figure_labels"][label.to_s].to_s +
+        "</a>"
+      end
+    end
+  end
+end

data/spec/fixtures/_layouts/some_default.html

@@ -23,3 +23,9 @@ Content
 {% figure caption:"{{ page.test }}" %}
 Content
 {% endfigure %}
+
+{% figure caption:"A caption" label:example %}
+Content
+{% endfigure %}
+
+See {% figref example %}

data/spec/jekyll-figure-ref_spec.rb

@@ -0,0 +1,25 @@
+require "spec_helper"
+
+describe(Jekyll) do
+  Jekyll.logger.log_level = :error
+
+  let(:config_overrides) { {} }
+  let(:config) do
+    Jekyll.configuration(
+      config_overrides.merge(
+        "source" => source_dir,
+        "destination" => dest_dir,
+        "url" => "http://example.org",
+      )
+    )
+  end
+  let(:site) { Jekyll::Site.new(config) }
+  let(:contents) { File.read(dest_dir("index.html")) }
+  before(:each) do
+    site.process
+  end
+
+  it "creates a figref element" do
+    expect(contents).to match /See <a href="#example">figure 1<\/a>/
+  end
+end

data/spec/jekyll-figure_spec.rb

@@ -39,6 +39,10 @@ describe(Jekyll) do
     expect(contents).to match /<figure>\n<p>Content<\/p>\n  <figcaption>Page data<\/figcaption>\n<\/figure>/
   end
 
+  it "creates a figure element with caption and label" do
+    expect(contents).to match /<figure id="example">\n<p>Content<\/p>\n  <figcaption><em>Figure 1:<\/em> A caption<\/figcaption>\n<\/figure>/
+  end
+
   context "with paragraphs stripped" do
     let(:config_overrides) do
       {

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-figure
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Paul Robert Lloyd
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2018-12-22 00:00:00.000000000 Z
+date: 2023-09-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -19,7 +19,7 @@ dependencies:
         version: '3.0'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '5.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3.0'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '5.0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -50,57 +50,57 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 13.0.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 13.0.1
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.6'
+        version: '2.1'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.6'
+        version: '2.1'
 description: A liquid tag for Jekyll that generates <figure> elements.
 email: me+rubygems@paulrobertlloyd.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/dependabot.yml"
+- ".github/workflows/test.yml"
 - ".gitignore"
-- ".travis.yml"
 - Gemfile
 - LICENSE
 - README.md
 - Rakefile
 - jekyll-figure.gemspec
+- lib/jekyll-figure-ref.rb
 - lib/jekyll-figure.rb
 - lib/jekyll-figure/version.rb
-- script/bootstrap
-- script/cibuild
-- script/console
-- script/release
+- lib/utils.rb
 - spec/fixtures/_config.yml
 - spec/fixtures/_layouts/some_default.html
 - spec/fixtures/index.html
+- spec/jekyll-figure-ref_spec.rb
 - spec/jekyll-figure_spec.rb
 - spec/spec_helper.rb
 homepage: https://github.com/paulrobertlloyd/jekyll-figure
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -115,14 +115,14 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.7
-signing_key: 
+rubygems_version: 3.3.7
+signing_key:
 specification_version: 4
 summary: Jekyll plugin that generates <figure> elements.
 test_files:
 - spec/fixtures/_config.yml
 - spec/fixtures/_layouts/some_default.html
 - spec/fixtures/index.html
+- spec/jekyll-figure-ref_spec.rb
 - spec/jekyll-figure_spec.rb
 - spec/spec_helper.rb

data/.travis.yml

@@ -1,14 +0,0 @@
-language: ruby
-script: "script/cibuild"
-matrix:
-  include:
-  - rvm: 2.0
-    env: ""
-  - rvm: 2.0
-    env: JEKYLL_VERSION=3.0.0
-  - rvm: 2.1
-    env: ""
-  - rvm: 2.1
-    env: JEKYLL_VERSION=3.0.0
-  - rvm: 2.1
-    env: JEKYLL_VERSION=3.7.4

data/script/bootstrap

@@ -1,3 +0,0 @@
-#! /bin/bash
-
-bundle install

data/script/cibuild

@@ -1,3 +0,0 @@
-#! /bin/bash
-
-bundle exec rspec

data/script/console

@@ -1,34 +0,0 @@
-#! /usr/bin/env ruby
-
-def relative_to_root(path)
-  File.expand_path(path, File.dirname(File.dirname(__FILE__)))
-end
-
-require 'jekyll'
-require relative_to_root('lib/jekyll-figure.rb')
-require 'pry-debugger'
-
-SOURCE_DIR = relative_to_root('spec/fixtures')
-DEST_DIR   = relative_to_root('spec/dest')
-
-def source_dir(*files)
-  File.join(SOURCE_DIR, *files)
-end
-
-def dest_dir(*files)
-  File.join(DEST_DIR, *files)
-end
-
-def config(overrides = {})
-  Jekyll.configuration({
-    "source"      => source_dir,
-    "destination" => dest_dir,
-    "url"         => "http://example.org"
-  }).merge(overrides)
-end
-
-def site(configuration = config)
-  Jekyll::Site.new(configuration)
-end
-
-binding.pry

data/script/release

@@ -1,7 +0,0 @@
-#!/bin/sh
-# Tag and push a release.
-
-set -e
-
-script/cibuild
-bundle exec rake release