jekyll-scholar 7.0.0 → 7.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f0e78bd7c9317137c98678772de2dcc7299fcc02f44c9f425334100b87c2f369
-  data.tar.gz: f78feb1a7fccce706830d2a3956bdbf0b3ec4245576e2b454492b20bb6832877
+  metadata.gz: 287c638fa9bd7e062280db1af05a5d98cc9d509c423ce1b8d0f7d948f3498b16
+  data.tar.gz: 606db44855a017a7694b61560ef7779c95118f461301298e7875bc1fbf5d2785
 SHA512:
-  metadata.gz: d6ee7f7510ca466d16ec3112ed47df4bfc02d8a17b736ab323d5ee5ac77d523ab3083dccf073bdb328be397006b67230cf7d8fcff4aaae4e9d8095ddd1665dd5
-  data.tar.gz: 5ea56025a3f93e3cbb3db96f81cc4bc7ffafa4524cdd53beec6b412b1c6d1fc331dc7b38c9d02e7704a89bc28dd51f4b377db8e97bc81805e1814a02deac1f21
+  metadata.gz: babca3507daca599a095c21b0c7d517bc6dd0ad3e4f3cce22763b36784fc8be09fe84d2af9b32efdf221239a4ef4b0bdbbd9b85d7eca513368e2e6e6e99297c7
+  data.tar.gz: c40b99a30e36cce98d1bcc11fb3e9bf53dd0c605f79b1701499f7d21a91fe63f26ad836cff952d9ca8bba7d2c52b89fbb25afff87cade2faf404f4808f5d69a4

data/README.md

@@ -32,7 +32,7 @@ You can keep sources, configuration and plugins in a separate branch; see e.g.
   [here](http://davidensinger.com/2013/07/automating-jekyll-deployment-to-github-pages-with-rake/)
 for details.
 
-
+Alternatively, you can use a [Github Actions](https://github.com/features/actions) called [jekyll-action](https://github.com/helaili/jekyll-action) to deploy your site to Github Pages
 
 Usage
 -----

data/features/nocite.feature

@@ -0,0 +1,78 @@
+Feature: Nocited Bibliographies
+  As a scholar who likes to blog
+  I want to sort my bibliography by hand
+  But do not want to cite anything
+
+  Scenario: Nocite references from a single bibliography
+    Given I have a scholar configuration with:
+      | key    | value             |
+      | source | ./_bibliography   |
+    And I have a "_bibliography" directory
+    And I have a file "_bibliography/references.bib":
+      """
+      @book{ruby1,
+        title     = {The Ruby Programming Language},
+        author    = {Flanagan, David and Matsumoto, Yukihiro},
+        year      = {2008},
+        publisher = {O'Reilly Media}
+      },
+      @book{ruby2,
+        title     = {Ruby Not Cited},
+        author    = {Flanagan, David and Matsumoto, Yukihiro},
+        year      = {2007},
+        publisher = {O'Reilly Media}
+      },
+      @book{smalltalk,
+        title     = {Smalltalk Best Practice Patterns},
+        author    = {Kent Beck},
+        year      = {1996},
+        publisher = {Prentice Hall}
+      }
+
+      """
+    And I have a page "scholar.html":
+      """
+      ---
+      ---
+      {% nocite smalltalk ruby1 %}
+      {% bibliography --cited %}
+      """
+    When I run jekyll
+    Then the _site directory should exist
+    And the "_site/scholar.html" file should exist
+    And I should see "<i>Smalltalk Best Practice Patterns</i>" in "_site/scholar.html"
+    And I should see "<i>The Ruby Programming Language</i>" in "_site/scholar.html"
+    And I should not see "<i>Ruby Not Cited</i>" in "_site/scholar.html"
+
+Scenario: No nocite references results in empty bibliography
+    Given I have a scholar configuration with:
+      | key    | value             |
+      | source | ./_bibliography   |
+    And I have a "_bibliography" directory
+    And I have a file "_bibliography/references.bib":
+      """
+      @book{ruby,
+        title     = {The Ruby Programming Language},
+        author    = {Flanagan, David and Matsumoto, Yukihiro},
+        year      = {2008},
+        publisher = {O'Reilly Media}
+      },
+      @book{smalltalk,
+        title     = {Smalltalk Best Practice Patterns},
+        author    = {Kent Beck},
+        year      = {1996},
+        publisher = {Prentice Hall}
+      }
+
+      """
+    And I have a page "scholar.html":
+      """
+      ---
+      ---
+      {% bibliography --cited %}
+      """
+    When I run jekyll
+    Then the _site directory should exist
+    And the "_site/scholar.html" file should exist
+    And I should not see "<i>Smalltalk Best Practice Patterns</i>" in "_site/scholar.html"
+    And I should not see "<i>The Ruby Programming Language</i>" in "_site/scholar.html"

data/lib/jekyll/scholar/converters/bibtex.rb

@@ -17,7 +17,7 @@ module Jekyll
 
       def initialize(config = {})
         super
-        @config['scholar'] = Scholar.defaults.merge(@config['scholar'] || {})
+        @config = Scholar.defaults.merge(@config['scholar'] || {})
         @markdown = Jekyll::Converters::Markdown.new(config)
       end
 
@@ -31,7 +31,7 @@ module Jekyll
 
       def convert(content)
         content = BibTeX.parse(content, :strict => true, :include => [:meta_content],
-                               :filter => @config['scholar']['bibtex_filters']).map do |b|
+                               :filter => config['bibtex_filters']).map do |b|
           if b.respond_to?(:to_citeproc)
             render_bibliography b
           else

data/lib/jekyll/scholar/tags/nocite.rb

@@ -0,0 +1,28 @@
+module Jekyll
+  class Scholar
+
+    class NoCiteTag < Liquid::Tag
+      include Scholar::Utilities
+
+      attr_reader :pages
+
+      def initialize(tag_name, arguments, tokens)
+        super
+
+        @config = Scholar.defaults.dup
+        @keys, arguments = split_arguments(arguments)
+
+        optparse(arguments)
+      end
+
+      def render(context)
+        set_context_to context
+        nocite keys
+      end
+
+    end
+
+  end
+end
+
+Liquid::Template.register_tag('nocite', Jekyll::Scholar::NoCiteTag)

data/lib/jekyll/scholar/utilities.rb

@@ -384,7 +384,7 @@ module Jekyll
       def month_names
         return @month_names unless @month_names.nil?
 
-        @month_names = config['month_names'].nil? ? Date::MONTHNAMES : config['month_names'].unshift(nil)
+        @month_names = config['month_names'].nil? ? Date::MONTHNAMES : [nil] + config['month_names']
       end
 
       def remove_duplicates?
@@ -731,6 +731,18 @@ module Jekyll
         link_to link_target_for(keys[0]), render_citation(items), {class: config['cite_class']}
       end
 
+      def nocite(keys)
+        items = keys.map do |key|
+          if bibliography.key?(key)
+            entry = bibliography[key]
+            cited_keys << entry.key
+            cited_keys.uniq!
+          else
+            return missing_reference
+          end
+        end
+      end
+
       def cite_details(key, text)
         if bibliography.key?(key)
           link_to details_link_for(bibliography[key]), text || config['details_link']

data/lib/jekyll/scholar/version.rb

@@ -1,5 +1,5 @@
 module Jekyll
   class Scholar
-    VERSION = '7.0.0'.freeze
+    VERSION = '7.1.0'.freeze
   end
 end

data/lib/jekyll/scholar.rb

@@ -18,6 +18,7 @@ require 'jekyll/scholar/tags/bibtex'
 require 'jekyll/scholar/tags/cite'
 require 'jekyll/scholar/tags/cite_details'
 require 'jekyll/scholar/tags/details_link'
+require 'jekyll/scholar/tags/nocite'
 require 'jekyll/scholar/tags/quote'
 require 'jekyll/scholar/tags/reference'
 require 'jekyll/scholar/generators/details'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-scholar
 version: !ruby/object:Gem::Version
-  version: 7.0.0
+  version: 7.1.0
 platform: ruby
 authors:
 - Sylvester Keil
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-03-29 00:00:00.000000000 Z
+date: 2022-05-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -97,6 +97,7 @@ files:
 - features/interpolate.feature
 - features/layout.feature
 - features/multiple_files.feature
+- features/nocite.feature
 - features/page_config.feature
 - features/reference.feature
 - features/removeduplicate.feature
@@ -127,6 +128,7 @@ files:
 - lib/jekyll/scholar/tags/cite.rb
 - lib/jekyll/scholar/tags/cite_details.rb
 - lib/jekyll/scholar/tags/details_link.rb
+- lib/jekyll/scholar/tags/nocite.rb
 - lib/jekyll/scholar/tags/quote.rb
 - lib/jekyll/scholar/tags/reference.rb
 - lib/jekyll/scholar/utilities.rb
@@ -150,7 +152,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: 1.3.6
 requirements: []
-rubygems_version: 3.2.3
+rubygems_version: 3.2.15
 signing_key:
 specification_version: 4
 summary: Jekyll extensions for the academic blogger.
@@ -168,6 +170,7 @@ test_files:
 - features/interpolate.feature
 - features/layout.feature
 - features/multiple_files.feature
+- features/nocite.feature
 - features/page_config.feature
 - features/reference.feature
 - features/removeduplicate.feature