pbsimply 3.3.1 → 3.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 38b7c82bfe81f73eb7ce562485bb9e624f9feb0ac6632b0161bef86039b4bf0d
-  data.tar.gz: 97d5d322aa777ae16cfd0064907e088fcfeec60923da4cd1c1fe9e370a863e51
+  metadata.gz: 87e2e59a800bc257a946462c2396a7abe5dcb4d56c005890c633ac8060f21853
+  data.tar.gz: 59d8f531580cb215fba217fb1494539c6cb9a158642789059bb17ceaeb8a871c
 SHA512:
-  metadata.gz: c9667151ac7f946cd50dcde20cc534c1aae15dbd288160b5927394cc9cfc64b60009cc9cf2eee6093e7734ebdea6adcbb20cdd20f3f0805e5e97d50ecd8b9094
-  data.tar.gz: ad3504af0ab19b7780e5890ac6329fbbfb6fd00ff9fc58b529cb9aa469d32571bd3987f3b6b38ff4106645058b2d12a42e1aef8350e6ea8a378a86b574bd3a11
+  metadata.gz: b0ce2e7378becd3db0770612ef499d1924a473cb9e22b14d998e613d952cb2431f992d3605442802c3cd10d4a7f45debc23b2c57cb27db921c032f08ac2823ba
+  data.tar.gz: 2826fa6dca8231a850c31cd336338f00442076d733a594256416c40df2b87e450c95d495208207b444d30e751f40517de24bab50b86a9db44e41ef0b7f449337

data/LICENSE

@@ -0,0 +1,191 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2017 Masaki Haruka
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

data/README.md

@@ -0,0 +1,67 @@
+# Purebuilder Simply
+
+Programmable static site generator supporting Markdown, reStructuredText, and RDoc via pluggable engines and CLI-based workflows.
+
+## What is PureBuilder
+
+PureBuilder Simply is a pre-built website building tool. It is also called a headless CMS or SSG.
+
+It is easy to build and update, excels in writing functions, and is suitable for building text-centric websites.
+
+## What is ACCS
+
+ACCS is site building script for serialized articles.
+
+PB Simply ACCS make `index.md` with indexes build by PureBuilder.
+
+## Install
+
+### Install from rubygems.org
+
+`gem install pbsimply`
+
+### Manually make Gem
+
+* `gem build pbsimply.gemspec`
+* `gem install pbsimply-$version.gem`
+
+### Manually from GitHub
+
+* `git clone https://github.com/reasonset/purebuilder-simply`
+* Copy under `bin/` files on your PATH directory.
+* Copy under `lib/` files on your Ruby library directory.
+
+## Dependency
+
+* Ruby >= 3.0
+* Pandoc >= 2.8
+
+## Usage
+
+### Create a Project
+
+Use `pbsimply-init` to generate a project directory with both the document source root (`Source`) and the document build root (`Build`):
+
+```bash
+pbsimply-init
+```
+
+- You can pass a directory name as an argument.  
+- If omitted, the current directory will be used.  
+- The directory must be empty.  
+
+You can also specify a theme for initialization with the `-t` option.
+
+### Build Documents
+
+Move into the document source root and run:
+
+```bash
+pbsimply directory
+```
+
+PureBuilder Simply will process the documents in the given directory and output HTML files.
+
+## Documentation
+
+For more details, see the [project homepage](https://purebuilder.app/).  

data/lib/pbsimply/accs.rb

@@ -1,4 +1,4 @@
-#!/usr/bin/ruby
+#!/bin/env ruby
 
 # ACCS namespace.
 module PBSimply::ACCS
@@ -62,7 +62,7 @@ EOF
   #
   # This method called on the assumption that processed all documents and run as directory mode.
   def process_accs
-    STDERR.puts "Processing ACCS index..."
+    $stderr.puts "Processing ACCS index..."
     if File.exist?(File.join(@dir, ".accsindex.erb"))
       erbtemplate = File.read(File.join(@dir, ".accsindex.erb"))
     elsif File.exist?(".accsindex.erb")
@@ -107,4 +107,4 @@ EOF
     end
     process_accs
   end
-end
+end

data/lib/pbsimply/config-checker.rb

@@ -0,0 +1,20 @@
+#!/bin/env ruby
+
+class PBSimply
+  class ConfigChecker
+    class InvalidConfigError < StandardError
+    end
+
+    def self.verify_config config
+      # blessmethod_accs_rel
+      if config["blessmethod_accs_rel"] && ! %w:numbering date timestamp lexical:.include?(config["blessmethod_accs_rel"])
+        raise InvalidConfigError.new("blessmethod_accs_rel must be either numbering, date, timestamp or lexical.")
+      end
+
+      # unicode_normalize
+      if config["unicode_normalize"] && ! %w:nfc nfd nfkc nfkd:.include?(config["unicode_normalize"])
+        raise InvalidConfigError.new("unicode_normalize must be either nfc, nfd, nfkc or nfkd.")
+      end
+    end
+  end
+end

data/lib/pbsimply/docdb.rb

@@ -1,4 +1,4 @@
-#!/usr/bin/ruby
+#!/bin/env ruby
 require 'yaml'
 
 class PBSimply

data/lib/pbsimply/docengine/base.rb

@@ -1,4 +1,4 @@
-#!/usr/bin/ruby
+#!/bin/env ruby
 require 'pbsimply/docengine/pandoc.rb'
 require 'pbsimply/docengine/rdoc.rb'
 require 'pbsimply/docengine/misc.rb'

data/lib/pbsimply/docengine/docutils.rb

@@ -1,4 +1,4 @@
-#!/usr/bin/ruby
+#!/bin/env ruby
 
 class PBSimply
   module Processor
@@ -30,7 +30,7 @@ class PBSimply
 
       # Invoke pandoc, parse and format and write out.
       def print_fileproc_msg(filename)
-        STDERR.puts "#{filename} is going Docutils."
+        $stderr.puts "#{filename} is going Docutils."
       end
 
       def process_document(dir, filename, frontmatter, orig_filepath, ext, procdoc)
@@ -57,4 +57,4 @@ class PBSimply
       end
     end
   end
-end
+end

data/lib/pbsimply/docengine/misc.rb

@@ -1,4 +1,4 @@
-#!/usr/bin/ruby
+#!/bin/env ruby
 
 class PBSimply
   module Processor
@@ -15,7 +15,7 @@ class PBSimply
       end
 
       def print_fileproc_msg(filename)
-        STDERR.puts "#{filename} generate with Redcarpet Markdown"
+        $stderr.puts "#{filename} generate with Redcarpet Markdown"
       end
 
       def process_document(dir, filename, frontmatter, orig_filepath, ext, procdoc)
@@ -39,7 +39,7 @@ class PBSimply
       end
 
       def print_fileproc_msg(filename)
-        STDERR.puts "#{filename} generate with Kramdown"
+        $stderr.puts "#{filename} generate with Kramdown"
       end
 
       def process_document(dir, filename, frontmatter, orig_filepath, ext, procdoc)
@@ -66,12 +66,14 @@ class PBSimply
       end
 
       def print_fileproc_msg(filename)
-        STDERR.puts "#{filename} generate with CommonMarker (cmark-gfm)"
+        $stderr.puts "#{filename} generate with CommonMarker (cmark-gfm)"
       end
 
       def process_document(dir, filename, frontmatter, orig_filepath, ext, procdoc)
+        options = @config["commonmarker_options"]&.map(&:to_sym) || [:table, :strikethrough]
+
         # Getting HTML string.
-        article_body = CommonMarker.render_doc(File.read(procdoc), :DEFAULT, [:table, :strikethrough]).to_html
+        article_body = CommonMarker.render_doc(File.read(procdoc), :DEFAULT, options).to_html
 
         # Process with eRuby temaplte.
         erb_template = ERB.new(File.read(@config["template"]), trim_mode: '%<>')
@@ -81,4 +83,4 @@ class PBSimply
       end
     end
   end
-end
+end

data/lib/pbsimply/docengine/pandoc.rb

@@ -1,4 +1,4 @@
-#!/usr/bin/ruby
+#!/bin/env ruby
 
 ###############################################
 #           DOCUMENT PROCESSORS               #
@@ -17,7 +17,14 @@ class PBSimply
           "to" => "html5",
           "standalone" => true
         }
+
         super
+
+        @pandoc_input_extmap = {}
+        @config["pandoc_input_ext"]&.each do |k,v|
+          key = k[0] == "." ? k : "." + k
+          @pandoc_input_extmap[key] = v
+        end
       end
 
       def setup_config(dir)
@@ -46,7 +53,7 @@ class PBSimply
 
       # Invoke pandoc, parse and format and write out.
       def print_fileproc_msg(filename)
-        STDERR.puts "#{filename} is going Pandoc."
+        $stderr.puts "#{filename} is going Pandoc."
       end
 
       def process_document(dir, filename, frontmatter, orig_filepath, ext, procdoc)
@@ -58,9 +65,13 @@ class PBSimply
         # Go Pandoc
         pandoc_cmdline = [(@config["pandoc_command"] || "pandoc")]
         pandoc_cmdline += ["-d", @workfile_pandoc_defaultfiles, "--metadata-file", @workfile_frontmatter, "-M", "title:#{frontmatter["title"]}", "-w", "html5"]
-        pandoc_cmdline += ["-f", frontmatter["input_format"]] if frontmatter["input_format"]
+        if frontmatter["input_format"]
+          pandoc_cmdline += ["-f", frontmatter["input_format"]]
+        elsif @pandoc_input_extmap[File.extname filename]
+          pandoc_cmdline += ["-f", @pandoc_input_extmap[File.extname filename]]
+        end
         pandoc_cmdline += [ procdoc ]
-        pp pandoc_cmdline if ENV["DEBUG"] == "yes"
+        pp pandoc_cmdline if @debug
         IO.popen((pandoc_cmdline)) do |io|
           doc = io.read
         end
@@ -74,8 +85,9 @@ class PBSimply
       end
 
       def target_file_extensions
-        [".md", ".rst"]
+        p [".md", ".rst"] + @pandoc_input_extmap.keys
+        [".md", ".rst"] + @pandoc_input_extmap.keys
       end
     end
   end
-end
+end

data/lib/pbsimply/docengine/rdoc.rb

@@ -1,4 +1,4 @@
-#!/usr/bin/ruby
+#!/bin/env ruby
 
 class PBSimply
   module Processor
@@ -36,7 +36,7 @@ class PBSimply
       end
 
       def print_fileproc_msg(filename)
-        STDERR.puts "#{filename} generate with RDoc/Markdown"
+        $stderr.puts "#{filename} generate with RDoc/Markdown"
       end
 
       def get_markup_document procdoc
@@ -47,7 +47,7 @@ class PBSimply
     # RDoc processor
     class PbsRDoc < PbsRBase
       def print_fileproc_msg(filename)
-        STDERR.puts "#{filename} generate with RDoc"
+        $stderr.puts "#{filename} generate with RDoc"
       end
 
       def get_markup_document procdoc
@@ -59,4 +59,4 @@ class PBSimply
       end
     end
   end
-end
+end

data/lib/pbsimply/frontmatter.rb

@@ -1,4 +1,4 @@
-#!/usr/bin/ruby
+#!/bin/env ruby
 require 'erb'
 require 'yaml'
 
@@ -16,6 +16,14 @@ module PBSimply::Frontmatter
       # Load standalone metadata YAML.
       frontmatter = Psych.unsafe_load(File.read(File.join(dir, (".meta." + filename))))
       pos = 0
+    elsif File.exist? File.join(dir, ".meta." + filename + ".yaml")
+      # Load standalone metadata YAML with .yaml extension.
+      frontmatter = Psych.unsafe_load(File.read(File.join(dir, (".meta." + filename + ".yaml"))))
+      pos = 0
+      elsif File.exist? File.join(dir, ".meta." + filename + ".yml")
+        # Load standalone metadata YAML with .yml extension.
+        frontmatter = Psych.unsafe_load(File.read(File.join(dir, (".meta." + filename + ".yaml"))))
+        pos = 0
     else
 
       case File.extname filename
@@ -40,7 +48,7 @@ module PBSimply::Frontmatter
           begin
             frontmatter = Psych.unsafe_load(lines.join)
           rescue => e
-            STDERR.puts "!CRITICAL: Cannot parse frontmatter."
+            $stderr.puts "!CRITICAL: Cannot parse frontmatter."
             raise e
           end
 
@@ -110,7 +118,7 @@ module PBSimply::Frontmatter
             begin
               frontmatter = Psych.unsafe_load(lines.map {|i| i.sub(/^\s*/, "") }.join)
             rescue
-              STDERR.puts "Error in parsing ReST YAML frontmatter (#{$!})"
+              $stderr.puts "Error in parsing ReST YAML frontmatter (#{$!})"
               next
             end
           else
@@ -149,12 +157,15 @@ module PBSimply::Frontmatter
     frontmatter["normalized_docpath"] = absolute_docpath[pwd_length..]
     # URL in site.
     this_url = (source_path).sub(/^[\.\/]*/) { @config["self_url_prefix"] || "/" }.sub(/\.[a-zA-Z0-9]+$/, ".html")
+    this_url_external = (source_path).sub(/^[\.\/]*/) { @config["self_url_external_prefix"] || "/" }.sub(/\.[a-zA-Z0-9]+$/, ".html")
+    this_url.sub!(%r!/\.([^/]+.html)$!, '/\1')
+    this_url_external.sub!(%r!/\.([^/]+.html)$!, '/\1')
     frontmatter["page_url"] = this_url
     # URL in site with URI encode.
     frontmatter["page_url_encoded"] = ERB::Util.url_encode(this_url)
-    frontmatter["page_url_encoded_external"] = ERB::Util.url_encode((source_path).sub(/^[\.\/]*/) { @config["self_url_external_prefix"] || "/" }.sub(/\.[a-zA-Z0-9]+$/, ".html"))
+    frontmatter["page_url_encoded_external"] = ERB::Util.url_encode(this_url_external)
     frontmatter["page_html_escaped"] = ERB::Util.html_escape(this_url)
-    frontmatter["page_html_escaped_external"] = ERB::Util.html_escape((source_path).sub(/^[\.\/]*/) { @config["self_url_external_prefix"] || "/" }.sub(/\.[a-zA-Z0-9]+$/, ".html"))
+    frontmatter["page_html_escaped_external"] = ERB::Util.html_escape(this_url_external)
     # Title with URL Encoded.
     frontmatter["title_encoded"] = ERB::Util.url_encode(frontmatter["title"])
     frontmatter["title_html_escaped"] = ERB::Util.html_escape(frontmatter["title"])
@@ -209,4 +220,4 @@ module PBSimply::Frontmatter
       ".html"
     end
   end
-end
+end

data/lib/pbsimply/hooks.rb

@@ -1,8 +1,8 @@
-#!/usr/bin/ruby
+#!/bin/env ruby
 
 # Hooks is new in PureBuilder Simply 2.2.
 # Hooks object has instance variables for each timing.
-# 
+#
 class PBSimply::Hooks
 
   # Timing object class.
@@ -29,13 +29,13 @@ class PBSimply::Hooks
     end
 
     def run(arg)
-      STDERR.puts "Hooks processing (#{@name})"
+      $stderr.puts "Hooks processing (#{@name})"
       @hooks.each_with_index do |proc, index|
-        STDERR.puts "Hooks[#{index}]"
+        $stderr.puts "Hooks[#{index}]"
         begin
           proc.(arg)
         rescue
-          STDERR.puts "*** HOOKS PROC ERROR ***"
+          $stderr.puts "*** HOOKS PROC ERROR ***"
           raise
         end
       end
@@ -71,7 +71,7 @@ class PBSimply::Hooks
     @pre = HooksHolderPre.new "pre"
 
     # Called after document was generated.
-    # 
+    #
     # Argument: outpath, frontmatter, procdoc.
     # outpath is generated final document path. You can read output result.
     # procdoc is source document path before generate.
@@ -114,4 +114,4 @@ class PBSimply::Hooks
   attr :accs
 
   attr :config
-end
+end

data/lib/pbsimply/plugger.rb

@@ -18,11 +18,11 @@ module PBSimply::Plugger
   # Porcessing document (same content as source document) path given as first argument.
   def pre_plugins(procdoc, frontmatter)
     if File.directory?(".pre_generate")
-      STDERR.puts("Processing with pre plugins")
+      $stderr.puts("Processing with pre plugins")
       script_file = File.join(".pre_generate", script_file)
       Dir.entries(".pre_generate").sort.each do |script_file|
         next if script_file =~ /^\./
-        STDERR.puts "Running script: #{File.basename script_file}"
+        $stderr.puts "Running script: #{File.basename script_file}"
         pre_script_result = nil
         script_cmdline = case
         when File.executable?(script_file)
@@ -45,16 +45,16 @@ module PBSimply::Plugger
   def post_plugins(frontmatter=nil)
     if File.directory?(".post_generate")
 
-      STDERR.puts("Processing with post plugins")
+      $stderr.puts("Processing with post plugins")
 
       @this_time_processed.each do |v|
-        STDERR.puts "Processing #{v[:dest]} (from #{v[:source]})"
+        $stderr.puts "Processing #{v[:dest]} (from #{v[:source]})"
         procdoc = v[:dest]
         frontmatter ||= @indexes[File.basename v[:source]]
-        File.open(@workfile_frontmatter, "w") {|f| f.write JSON_LIB.dump(frontmatter)}
+        File.open(@workfile_frontmatter, "w") {|f| f.write PBSimply::JSON_LIB.dump(frontmatter)}
         Dir.entries(".post_generate").sort.each do |script_file|
           next if script_file =~ /^\./
-          STDERR.puts "Running script: #{script_file}"
+          $stderr.puts "Running script: #{script_file}"
           script_file = File.join(".post_generate", script_file)
           post_script_result = nil
           script_cmdline = case
@@ -74,4 +74,4 @@ module PBSimply::Plugger
       end
     end
   end
-end
+end

data/lib/pbsimply/prayer.rb

@@ -1,4 +1,4 @@
-#!/usr/bin/ruby
+#!/bin/env ruby
 
 # Module for BLESSING feature.
 module PBSimply::Prayer
@@ -9,14 +9,14 @@ module PBSimply::Prayer
       bless_ruby frontmatter
     end
   end
-  
+
   def bless_ruby(frontmatter)
     # BLESSING (Always)
     if PureBuilder.const_defined?(:BLESS) && Proc === PureBuilder::BLESS
       begin
         PureBuilder::BLESS.(frontmatter, self)
       rescue
-        STDERR.puts "*** BLESSING PROC ERROR ***"
+        $stderr.puts "*** BLESSING PROC ERROR ***"
         raise
       end
     end
@@ -26,7 +26,7 @@ module PBSimply::Prayer
       begin
         PureBuilder::ACCS::BLESS.(frontmatter, self)
       rescue
-        STDERR.puts "*** ACCS BLESSING PROC ERROR ***"
+        $stderr.puts "*** ACCS BLESSING PROC ERROR ***"
         raise
       end
     end
@@ -47,7 +47,7 @@ module PBSimply::Prayer
   end
 
   def bless_cmd(frontmatter)
-    File.open(@workfile_frontmatter, "w") {|f| f.write JSON_LIB.dump(frontmatter) }
+    File.open(@workfile_frontmatter, "w") {|f| f.write PBSimply::JSON_LIB.dump(frontmatter) }
     # BLESSING (Always)
     if @config["bless_cmd"]
       (Array === @config["bless_cmd"] ? system(*@config["bless_cmd"]) : system(@config["bless_cmd"]) ) or abort "*** BLESS COMMAND RETURNS NON-ZERO STATUS"
@@ -104,4 +104,4 @@ module PBSimply::Prayer
       end
     end
   end
-end
+end

data/lib/pbsimply.rb

@@ -17,6 +17,7 @@ require 'pbsimply/plugger'
 require 'pbsimply/hooks'
 require 'pbsimply/frontmatter'
 require 'pbsimply/accs'
+require 'pbsimply/config-checker.rb'
 
 class PBSimply
   include Prayer
@@ -55,6 +56,9 @@ class PBSimply
       File.open(".pbsimply.yaml") do |f|
         config = Psych.unsafe_load(f)
       end
+      ConfigChecker.verify_config config
+    rescue PBSimply::ConfigChecker::InvalidConfigError
+      abort $!.to_s
     rescue
       abort "Failed to load config file (./.pbsimply.yaml)"
     end
@@ -99,7 +103,7 @@ class PBSimply
     end
 
     unless File.exist? outdir
-      STDERR.puts "destination directory is not exist. creating (only one step.)"
+      $stderr.puts "destination directory is not exist. creating (only one step.)"
       FileUtils.mkdir_p outdir
     end
   end
@@ -120,6 +124,8 @@ class PBSimply
     @accs_index = {}
     @now = Time.now
     @hooks = PBSimply::Hooks.new(self, @config)
+
+    @debug = (ENV["DEBUG"] == "yes")
   end
 
   # Process command-line
@@ -176,9 +182,9 @@ class PBSimply
     draft_articles = []
     target_docs = []
     @indexes_orig = {}
-    STDERR.puts "in #{@dir}..."
+    $stderr.puts "in #{@dir}..."
 
-    STDERR.puts "Checking Frontmatter..."
+    $stderr.puts "Checking Frontmatter..."
     Dir.foreach(@dir) do |filename|
       next if filename == "." || filename == ".." || filename == ".index.md"
       if filename =~ /^\./ || filename =~ /^draft-/
@@ -194,7 +200,7 @@ class PBSimply
         next
       end
 
-      STDERR.puts "Checking frontmatter in #{filename}"
+      $stderr.puts "Checking frontmatter in #{filename}"
       frontmatter, pos = read_frontmatter(@dir, filename)
       frontmatter = @frontmatter.merge frontmatter
       frontmatter.merge!(@add_meta) if @add_meta
@@ -235,18 +241,18 @@ class PBSimply
   def proc_docs target_docs
     # Exclude unchanged documents.
     if @indexes && @indexes_orig
-      STDERR.puts "Checking modification..."
+      $stderr.puts "Checking modification..."
       target_docs.delete_if {|filename, frontmatter, pos| !check_modify(filename, frontmatter)}
     end
 
     # Modify frontmatter `BLESSING'
     target_docs.each do |filename, frontmatter, pos|
-      STDERR.puts "Blessing #{filename}..."
+      $stderr.puts "Blessing #{filename}..."
       bless frontmatter
     end
 
     # Ready.
-    STDERR.puts "Okay, Now ready. Process documents..."
+    $stderr.puts "Okay, Now ready. Process documents..."
 
     # Proccess documents
     target_docs.each do |filename, frontmatter, pos|
@@ -256,13 +262,17 @@ class PBSimply
       @index = frontmatter
       File.open(File.join(@dir, filename)) do |f|
         f.seek(pos)
-        File.open(File.join(@workdir, "current_document#{ext}"), "w") {|fo| fo.write f.read}
+        doc_content = f.read
+        if @config["unicode_normalize"] && !frontmatter["skip_normalize"]
+          doc_content.unicode_normalize!(@config["unicode_normalize"].to_sym)
+        end
+        File.open(File.join(@workdir, "current_document#{ext}"), "w") {|fo| fo.write doc_content }
       end
 
-      STDERR.puts "Processing #{filename}"
+      $stderr.puts "Processing #{filename}"
       generate(@dir, filename, frontmatter)
     end
-    
+
     # Call post plugins
     post_plugins
 
@@ -272,13 +282,13 @@ class PBSimply
 
   # Delete turn to draft article.
   def delete_turn_draft draft_articles
-    STDERR.puts "Checking turn to draft..."
+    $stderr.puts "Checking turn to draft..."
     draft_articles.each do |dah|
       df = dah[:article_filename]
       [df, (df + ".html"), File.basename(df, ".*"), (File.basename(df, ".*") + ".html")].each do |tfn|
         tfp = File.join(@config["outdir"], @dir, tfn)
         if File.file?(tfp)
-          STDERR.puts "#{df} was turn to draft."
+          $stderr.puts "#{df} was turn to draft."
           @hooks.delete.run({target_file_path: tfp, source_file_path: dah[:source_file_path]})
           File.delete tfp if @config["auto_delete"]
         end
@@ -290,12 +300,12 @@ class PBSimply
   # Delete missing source
   def delete_missing
     return unless @indexes
-    STDERR.puts "Checking missing article..."
+    $stderr.puts "Checking missing article..."
     missing_keys = []
     @indexes.each do |k, v|
       next if !v["source_path"] || !v["dest_path"]
       unless File.exist? v["source_path"]
-        STDERR.puts "#{k} is missing."
+        $stderr.puts "#{k} is missing."
         missing_keys.push k
         @hooks.delete.run({target_file_path: v["dest_path"] ,source_file_path: v["source_path"]})
         File.delete v["dest_path"] if @config["auto_delete"]
@@ -372,7 +382,7 @@ class PBSimply
 
     ##### Post eRuby
     if @config["post_eruby"]
-      STDERR.puts "Porcessing with eRuby."
+      $stderr.puts "Porcessing with eRuby."
       doc = ERB.new(doc, nil, "%<>").result(binding)
     end
 
@@ -450,14 +460,17 @@ class PBSimply
 
 
     if modify
-      STDERR.puts "#{filename} last modified at #{frontmatter["_mtime"]}, last processed at #{@indexes_orig[filename]&.[]("_last_proced") || 0}"
+      $stderr.puts "#{filename} last modified at #{frontmatter["_mtime"]}, last processed at #{@indexes_orig[filename]&.[]("_last_proced") || 0}"
     else
-      STDERR.puts "#{filename} is not modified."
+      $stderr.puts "#{filename} is not modified."
     end
 
     frontmatter["_last_proced"] = @now.to_i
     frontmatter["last_update"] = @now.strftime("%Y-%m-%d %H:%M:%S")
 
+    if frontmatter["skip_update"]
+      # Document specific skip update
+      false
     if @refresh
       # Refresh (force update) mode.
       true

data/themes/kramdown/init322/.pbsimply.yaml

@@ -57,6 +57,10 @@ self_url_external_prefix: https://example.com/
 # Delete output file automatically when lose source document.
 #auto_delete: yes
 #
+# Unicode normalize in processing document.
+# nfc, nfd, nfkc, nfkd.
+#unicode_normalize: nfkc
+#
 #################################################
 # Pandoc engine option
 #################################################
@@ -74,6 +78,13 @@ self_url_external_prefix: https://example.com/
 #  include-after-body:
 #    - after.html
 #
+# Add extensions and input formats in Pandoc.
+# The extensions specified here are interpreted as source documents,
+# and the values are used as the values of the -f option in pandoc.
+# pandoc_input_ext:
+#   t2t: t2t
+#   mw: mediawiki
+#   muse: muse
 #################################################
 # Kramdown engine option
 #################################################
@@ -89,6 +100,14 @@ pbsimply_processor: kramdown
 #redcarpet_extensions: {}
 #
 #################################################
+# CommonMarker engine option
+#################################################
+#pbsimply_processor: cmark
+#
+# An array showing `CommonMarker.render_doc`'s 3rd agrument.
+#commonmarker_options: []
+#
+#################################################
 # Docutils engine option
 #################################################
 #pbsimply_processor: docutils

data/themes/pandoc/_pandoc_base/.pbsimply.yaml

@@ -12,7 +12,10 @@ template: template.html
 # This values must be *server's URL*.
 # This settings is not avilable on rdoc, rdoc_markdown, kramdown, redcarpet or cmark engine.
 css:
-  - /css/theme.css
+  - /css/base.css
+  - /css/layout.css
+  - /css/lightbox.css
+  - /css/skylighting.css
 # Enable TOC. true or false. false by default.
 # This settings is not avilable on rdoc, rdoc_markdown, kramdown, redcarpet, cmark or docutils engine.
 toc: true
@@ -57,6 +60,10 @@ self_url_external_prefix: https://example.com/
 # Delete output file automatically when lose source document.
 #auto_delete: yes
 #
+# Unicode normalize in processing document.
+# nfc, nfd, nfkc, nfkd.
+#unicode_normalize: nfkc
+#
 #################################################
 # Pandoc engine option
 #################################################
@@ -75,6 +82,13 @@ pandoc_additional_options:
 #  include-after-body:
 #    - after.html
 #
+# Add extensions and input formats in Pandoc.
+# The extensions specified here are interpreted as source documents,
+# and the values are used as the values of the -f option in pandoc.
+# pandoc_input_ext:
+#   t2t: t2t
+#   mw: mediawiki
+#   muse: muse
 #################################################
 # Kramdown engine option
 #################################################
@@ -92,6 +106,14 @@ pandoc_additional_options:
 #redcarpet_extensions: {}
 #
 #################################################
+# CommonMarker engine option
+#################################################
+#pbsimply_processor: cmark
+#
+# An array showing `CommonMarker.render_doc`'s 3rd agrument.
+#commonmarker_options: []
+#
+#################################################
 # Docutils engine option
 #################################################
 #pbsimply_processor: docutils
@@ -104,4 +126,4 @@ pandoc_additional_options:
 #################################################
 #pbsimply_processor: rdoc
 #pbsimply_processor: rdoc_markdown
-#pbsimply_processor: cmark
+#pbsimply_processor: cmark

data/themes/pandoc/_pandoc_base/index.md

@@ -0,0 +1,5 @@
+---
+title: Old Pandoc themes
+---
+
+These themes are come from PureBuiler Simply 1.x.

data/themes/pandoc/_pandoc_new/.pbsimply.yaml

@@ -57,6 +57,10 @@ self_url_external_prefix: https://example.com/
 # Delete output file automatically when lose source document.
 #auto_delete: yes
 #
+# Unicode normalize in processing document.
+# nfc, nfd, nfkc, nfkd.
+#unicode_normalize: nfkc
+#
 #################################################
 # Pandoc engine option
 #################################################
@@ -75,6 +79,13 @@ pandoc_additional_options:
 #  include-after-body:
 #    - after.html
 #
+# Add extensions and input formats in Pandoc.
+# The extensions specified here are interpreted as source documents,
+# and the values are used as the values of the -f option in pandoc.
+# pandoc_input_ext:
+#   t2t: t2t
+#   mw: mediawiki
+#   muse: muse
 #################################################
 # Kramdown engine option
 #################################################
@@ -92,6 +103,14 @@ pandoc_additional_options:
 #redcarpet_extensions: {}
 #
 #################################################
+# CommonMarker engine option
+#################################################
+#pbsimply_processor: cmark
+#
+# An array showing `CommonMarker.render_doc`'s 3rd agrument.
+#commonmarker_options: []
+#
+#################################################
 # Docutils engine option
 #################################################
 #pbsimply_processor: docutils
@@ -104,4 +123,4 @@ pandoc_additional_options:
 #################################################
 #pbsimply_processor: rdoc
 #pbsimply_processor: rdoc_markdown
-#pbsimply_processor: cmark
+#pbsimply_processor: cmark

metadata

@@ -1,30 +1,35 @@
 --- !ruby/object:Gem::Specification
 name: pbsimply
 version: !ruby/object:Gem::Version
-  version: 3.3.1
+  version: 3.4.0
 platform: ruby
 authors:
 - Masaki Haruka
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-12-02 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
-description: Pre compile, static serving website builder.
+description: A flexible, programmable static site generator for Markdown, reStructuredText,
+  and RDoc formats. PureBuilder Simply supports both embedded and external content
+  processors—including Kramdown, Redcarpet, CommonMarker, RDoc, Pandoc, Docutils—and
+  enables customizable conversion workflows and CLI-based project generation.
 email:
 - yek@reasonset.net
 executables:
 - pbsimply
-- pbsimply-testserver
 - pbsimply-init
+- pbsimply-testserver
 extensions: []
 extra_rdoc_files: []
 files:
+- LICENSE
+- README.md
 - bin/pbsimply
 - bin/pbsimply-init
 - bin/pbsimply-testserver
 - lib/pbsimply.rb
 - lib/pbsimply/accs.rb
+- lib/pbsimply/config-checker.rb
 - lib/pbsimply/docdb.rb
 - lib/pbsimply/docengine/base.rb
 - lib/pbsimply/docengine/docutils.rb
@@ -52,6 +57,7 @@ files:
 - themes/pandoc/_pandoc_base/css/layout.css
 - themes/pandoc/_pandoc_base/css/lightbox.css
 - themes/pandoc/_pandoc_base/css/skylightning.css
+- themes/pandoc/_pandoc_base/index.md
 - themes/pandoc/_pandoc_base/javascript/lightbox.js
 - themes/pandoc/_pandoc_base/post/.accs.yaml
 - themes/pandoc/_pandoc_base/post/20231028-untitled.md
@@ -79,11 +85,14 @@ files:
 - themes/pandoc/practical/css/layout.css
 - themes/pandoc/warm/.theme.yaml
 - themes/pandoc/warm/css/base.css
-homepage: https://github.com/reasonset/purebuilder-simply
+homepage: https://purebuilder.app/
 licenses:
 - Apache-2.0
-metadata: {}
-post_install_message:
+metadata:
+  homepage_uri: https://purebuilder.app/
+  source_code_uri: https://github.com/reasonset/purebuilder-simply
+  changelog_uri: https://github.com/reasonset/purebuilder-simply/blob/master/CHANGELOG.md
+  bug_tracker_uri: https://github.com/reasonset/purebuilder-simply/issues
 rdoc_options: []
 require_paths:
 - lib
@@ -98,8 +107,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.16
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
-summary: PureBuiler Simply
+summary: Flexible and programmable static site generator with pluggable Markdown engines
 test_files: []