allow to skip some of the generation process

README.md

@@ -34,7 +34,10 @@ Add to `_config.yml`:
 
 markdown: pandoc
 pandoc:
-    skip: false
+    skip:
+      full: false
+      posts: false
+      categories: false
     bundle_permalink: ':output_ext/:slug.:output_ext'
     papersize: 'a5paper'
     sheetsize: 'a4paper'
@@ -59,8 +62,10 @@ pandoc:
 * `markdown: pandoc` will instruct jekyll to use the pandoc html
   converter.
 
-* `skip` allows you to skip the other formats generation and proceed with the
-regular jekyll site build.
+* `skip` allows you to skip the other formats generation and proceed
+  with the regular jekyll site build.  You can skip some of the
+  generation process or all of it.  Older versions of this plugin
+  required `true` or `false` to skip the process altogether.
 
 * `full_flags` if `full_file` is defined, these flags are used on it.
   By default are set to `--top-level-division=part` so each category is

lib/jekyll-pandoc-multiple-formats/config.rb

 module JekyllPandocMultipleFormats
   class Config
     DEFAULTS = {
-      'skip'              => false,
+      'skip'              => {
+        'posts' => false,
+        'categories' => false,
+        'full' => false
+      },
       'bundle_permalink'  => ':output_ext/:slug.:output_ext',
       'papersize'         => 'a5paper',
       'sheetsize'         => 'a4paper',
@@ -23,7 +27,7 @@ module JekyllPandocMultipleFormats
     end
 
     def skip?
-      @config['skip']
+      @config['skip'].values.all?
     end
 
     def imposition?
@@ -34,13 +38,21 @@ module JekyllPandocMultipleFormats
       @config['binder']
     end
 
-    def full_file?
-      @config['full_file']
-    end
-
     # TODO magic
     def outputs
       @config['outputs']
     end
+
+    def generate_posts?
+      !@config.dig('skip', 'posts')
+    end
+
+    def generate_categories?
+      !@config.dig('skip', 'categories')
+    end
+
+    def generate_full_file?
+      !@config.dig('skip', 'full')
+    end
   end
 end

lib/jekyll-pandoc-multiple-formats/generator.rb

@@ -28,23 +28,12 @@ class PandocGenerator < Generator
 
   attr_accessor :site, :config
 
-  def generate(site)
-    @site     ||= site
-    @config   ||= JekyllPandocMultipleFormats::Config.new(@site.config['pandoc'])
-
-    return if @config.skip?
-
-    # we create a single array of files
-    @pandoc_files = []
-
-    @config.outputs.each_pair do |output, _|
-      Jekyll.logger.info 'Pandoc:', "Generating #{output}"
-      @site.posts.docs.each do |post|
+  def generate_post_for_output(post, output)
     Jekyll.logger.debug 'Pandoc:', post.data['title']
     Jekyll::Hooks.trigger :posts, :pre_render, post, { format: output }
 
     pandoc_file = PandocFile.new(@site, output, post)
-        next unless pandoc_file.write
+    return unless pandoc_file.write
 
     Jekyll::Hooks.trigger :posts, :post_render, post, { format: output }
 
@@ -52,24 +41,24 @@ class PandocGenerator < Generator
     @pandoc_files << pandoc_file
   end
 
-      @site.post_attr_hash('categories').each_pair do |title, posts|
-        Jekyll.logger.info 'Pandoc:', "Generating category #{title}"
+  def generate_category_for_output(category, posts, output)
+    Jekyll.logger.info 'Pandoc:', "Generating category #{category}"
     posts.sort!
-        pandoc_file = PandocFile.new(@site, output, posts, title)
+    pandoc_file = PandocFile.new(@site, output, posts, category)
 
     if @site.keep_files.include? pandoc_file.relative_path
-          puts "#{pandoc_file.relative_path} is a category file AND a post file"
-          puts 'change the category name to fix this'
-          next
+      Jekyll.logger.warn 'Pandoc:',
+        "#{pandoc_file.relative_path} is a category file AND a post file. Change the category name to fix this"
+      return
     end
 
-        next unless pandoc_file.write
+    return unless pandoc_file.write
 
     @site.keep_files << pandoc_file.relative_path
     @pandoc_files << pandoc_file
   end
 
-      if @config.full_file?
+  def general_full_for_output(output)
     title = @site.config.dig('title')
     Jekyll.logger.info 'Pandoc:', "Generating full file #{title}"
     # For parts to make sense, we order articles by date and then by
@@ -87,6 +76,31 @@ class PandocGenerator < Generator
     @site.keep_files << full_file.relative_path
     @pandoc_files << full_file
   end
+
+  def generate(site)
+    @site     ||= site
+    @config   ||= JekyllPandocMultipleFormats::Config.new(@site.config['pandoc'])
+
+    return if @config.skip?
+
+    # we create a single array of files
+    @pandoc_files = []
+
+    @config.outputs.each_pair do |output, _|
+      Jekyll.logger.info 'Pandoc:', "Generating #{output}"
+      if @config.generate_posts?
+        @site.posts.docs.each do |post|
+          generate_post_for_output post, output
+        end
+      end
+
+      if @config.generate_categories?
+        @site.post_attr_hash('categories').each_pair do |title, posts|
+          generate_category_for_output title, posts, output
+        end
+      end
+
+      general_full_for_output(output) if @config.generate_full_file?
     end
 
     @pandoc_files.each do |pandoc_file|