jekyll-books 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fc3d76a327dca916cc3239711596d92d6c63a500cd9b57735d04fdb3b0b4aa18
-  data.tar.gz: d1d66c85fe90d86d592ccda897d57789119987e3a1fab74dcecf6932853f2d78
+  metadata.gz: 4e17ad0be3b849ff375538efb12e5e4fd1cf350196fab71bc6ade5da7a15285c
+  data.tar.gz: 47e41c342c8ffced55ab9f23f73274e0d500bc7a66a16b368a828fec819d5279
 SHA512:
-  metadata.gz: 8ef5730d173775277aa3245bb759e3def72a5dfae738f8940d361527cad99e95d0277cd96255000eb56ae3278f3c316fac99768834a2a7febc3b063e8063fe0d
-  data.tar.gz: 3fa07efd4ede54d262fb4f38ece3c7fc0b9d9377fe336e21edfd38fa64d0036b205873e0e4ba5db8254dde652d4c93d08ac892cfd9cfcdf1b3e4a291da66d942
+  metadata.gz: ba138b49c0d3962b6d9ebf23ebd7ecd876a5f946e771fb9dc841af7de48c3c942b654ace7f0ad8d8bdf9a9c2233db3250e3938a3647fb2c3847a554cca933eaa
+  data.tar.gz: fdd260cb0c45a412bec8f2b24d4da966fc773818e958aa3e79b26da23b1e394aeed55a8d9bcbe167b3856f76049e77d8a77266d068fac335243bf96c876f387c

data/jekyll-books.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name          = "jekyll-books"
-  spec.version       = "0.1.1"
+  spec.version       = "0.2.0"
   spec.authors       = ["Sharon Zhang"]
   spec.email         = ["zhangshiyu1992@hotmail.com"]
 

data/lib/_config.yml

@@ -0,0 +1,10 @@
+books_settings:
+  # 自动读取书籍的目录
+  source: "_books"
+  # 生成书籍的根目录
+  destination: "/"
+  # 书籍首页的默认布局
+  book:
+    layout: "book"
+  chapter:
+    layout: "chapter"

data/lib/jekyll-books.rb

@@ -1,186 +1,2 @@
-module Jekyll
-  require_relative "util"
-
-  class BookPage < Page
-    def initialize(site, base, dir)
-      @site = site
-      @base = base
-      @dir = dir.gsub(/^_/, "").downcase
-      @name = "index.md"
-
-      self.process(@name)
-
-      read_yaml(File.join(@base, "_books", @dir), @name)
-
-      self.data["layout"] = 'book'
-      
-      Util.init_date_of_book(self.data)
-    end
-  end
-
-  class ChapterPage < Page
-    def initialize(site, base, dir, name, book, config)
-      @site = site
-      @base = base
-
-      if name.include?("/")
-        names = File.split(name)
-        @dir = File.join(dir, names[0])
-        @name = names[1]
-      else
-        @dir = dir
-        @name = name
-      end
-
-      self.process(@name)
-
-      read_yaml(File.join(base, "_books", @dir), @name)
-
-      self.data["layout"] = 'chapter'
-      self.data["book"] = book
-      self.data["title"] = config["title"]
-      self.data["level"] = config["level"]
-    end
-
-    def is_top_level?
-      self.data["level"] == 1
-    end
-  end
-
-  class BooksGenerator < Generator
-    def generate(site)
-
-      books = []
-
-      dir = "_books"
-      begin
-        Dir.foreach(dir) do |book_dir|
-          book_path = File.join(dir, book_dir)
-          if File.directory?(book_path) and book_dir.chars.first != "."
-            book = BookPage.new(site, site.source, book_dir)
-
-            summary = File.read(File.join(book_path, "SUMMARY.md"))
-
-            parts = get_parts_from_summary(summary)
-
-            chapters = create_chapters(site, parts, book_dir, book)
-
-            add_prev_and_next_to_every_chapter(chapters)
-
-            push_chapters_to_site_pages(site, chapters)
-
-            add_next_to_book_and_prev_to_chapter(book, chapters.first)
-
-            books << book
-            site.pages << book
-          end
-        end
-
-        books += get_books_from_data(site)
-
-        sort_books_by_date(books)
-
-        site.config["books"] = books
-      rescue Exception => e
-        puts e
-      end
-    end
-
-    private
-      def get_parts_from_summary(summary)
-        require "nokogiri"
-
-        html = Kramdown::Document.new(summary).to_html
-        parsed_html = Nokogiri::HTML(html)
-
-        chapters = []
-
-        list = parsed_html.xpath("//body/ul/li")
-        list.each do |li|
-          chapters.push( get_chapter_from_li(li, 1) )
-
-          li.xpath("ul/li").each do |sub_li|
-            chapters.push( get_chapter_from_li(sub_li, 2) )
-          end
-        end
-        return chapters
-      end
-
-      def get_chapter_from_li(li, level)
-        chapter = Hash.new
-        chapter["link"] = li.xpath("a/@href").to_s
-        chapter["title"] = li.xpath("a/text()").to_s
-        chapter["level"] = level
-        return chapter
-      end
-
-      def add_prev_and_next_to_every_chapter(chapters)
-        chapters.each_with_index do |chapter, index|
-          if index > 0
-            chapter.data["prev"] = chapters[index - 1]
-          end
-          if index < chapters.size - 1
-            chapter.data["next"] = chapters[index + 1]
-          end
-        end
-      end
-
-      def push_chapters_to_site_pages(site, chapters)
-        chapters.each do |chapter|
-          site.pages << chapter
-        end
-      end
-
-      def add_next_to_book_and_prev_to_chapter(book, chapter)
-        book.data["next"] = chapter
-        chapter.data["prev"] = book
-      end
-
-      def create_index_page(site, books)
-        book_index = IndexPage.new(site, site.source, "", books[0..3])
-        book_index.render(site.layouts, site.site_payload)
-        book_index.write(site.dest)
-        return book_index
-      end
-
-      def create_chapters(site, parts, book_dir, book)
-        chapters = []
-        book.data["parts"] = []
-
-        current = nil
-
-        parts.each do |part|
-          chapter = ChapterPage.new(site, site.source, book_dir, part["link"], book, part)
-
-          if chapter.is_top_level?
-            book.data["parts"].push(chapter)
-            current = chapter
-            chapter.data["parts"] = []
-          else
-            current.data["parts"].push(chapter)
-          end
-
-          chapters.push(chapter)
-        end
-        return chapters
-      end
-
-      def sort_books_by_date(books)
-        books.sort_by! do |book|
-          if book.respond_to? "data"
-            [book.data["end"], book.data["start"]]
-          else
-            [book["end"], book["end"]]
-          end
-        end
-        books.reverse!
-      end
-
-      def get_books_from_data(site)
-        books = site.data["books"]
-        books.each do |book|
-          Util.init_date_of_book(book)
-        end
-      end
-  end
-end
+require "jekyll/generators/book"
+require "jekyll/commands/book"

data/lib/jekyll-books/book_reader.rb

@@ -0,0 +1,85 @@
+require "jekyll/pages/chapter"
+require "jekyll/pages/book"
+require_relative "summary"
+
+class BookReader
+  attr_reader :root, :site, :name, :destination, :params
+  attr_accessor :index, :pages
+
+  def initialize(params, site, name)
+    @root        = params["source"]
+    @destination = params["destination"]
+    @params      = params
+    @site        = site
+    @name        = name
+    @index       = 0
+    @pages       = []
+  end
+
+  def read
+    @pages = [book_page]
+    index = 0
+
+    recursive_read_chapters(summary.read, 1, book_page)
+    add_prev_and_next
+
+    pages
+  end
+
+  def recursive_read_chapters(chapters, level, parent)
+    page = parent
+    chapter = parent
+
+    begin
+      chapter = chapters[index]
+      return unless chapter
+
+      if chapter["level"] > level
+        recursive_read_chapters(chapters, chapter["level"], page)
+      else
+        page = read_chapter(chapter)
+        pages << page
+        parent.data["parts"] << page
+      end
+
+      @index += 1
+    end while chapter["level"] >= level
+  end
+
+  def add_prev_and_next
+    pages.each_with_index do |page, i|
+      if i > 0
+        page.data["prev"] = pages[i - 1]
+      end
+      if i < pages.size - 1
+        page.data["next"] = pages[i + 1]
+      end
+    end
+  end
+
+  def read_chapter(chapter)
+    page = Jekyll::ChapterPage.new(
+      site,
+      params.merge({"name" => name}).merge(chapter)
+    )
+    page.data["book"] = book_page
+    page
+  end
+
+  def summary
+    Summary.new(book_folder)
+  end
+
+  def book_folder
+    File.join(site.source, root, name)
+  end
+
+  def book_page
+    @book_page ||= Jekyll::BookPage.new(
+      site,
+      params.merge({
+        "name" => name
+      })
+    )
+  end
+end

data/lib/jekyll-books/book_writer.rb

@@ -0,0 +1,70 @@
+require_relative "summary"
+require "util"
+
+class BookWriter
+  attr_reader :name, :root, :params, :summary
+  def initialize(name, root, params)
+    @name   = name
+    @root   = root
+    @params = params
+    @summary = Summary.new(book_folder)
+  end
+
+  def run
+    mkdir
+    create_index
+    create_summary
+  end
+
+  def book_folder
+    File.join(root, name)
+  end
+
+  def summary_file
+    summary.file_path
+  end
+
+  def index_file
+    summary.index_path
+  end
+
+  def mkdir
+    unless File.directory?(book_folder)
+      FileUtils.mkdir_p(book_folder)
+    end
+  end
+
+  def create_index
+    return if File.file?(index_file)
+
+    f = File.new(index_file, "w+")
+    f.write(content)
+  end
+
+  def create_summary
+    return if File.file?(summary_file) && !params["forced"]
+
+    summary.write(true)
+  end
+
+  def content
+    front_matter = YAML.dump(
+      Util.cover_default({
+        "title"  => name.capitalize,
+        "start"  => default_year,
+        "end"    => default_year,
+        "img"    => img_url
+      }, params)
+    )
+
+    front_matter + "---\n"
+  end
+
+  def default_year
+    Date.today.year
+  end
+
+  def img_url
+    "/img/home/#{name}.jpg"
+  end
+end

data/lib/jekyll-books/books_parser.rb

@@ -0,0 +1,27 @@
+require_relative "book_reader"
+
+class BooksParser
+  attr_reader :root, :site, :books, :pages
+
+  def initialize(root, site)
+    @root = root
+    @site = site
+    @books = []
+    @pages = []
+  end
+
+  def root_path
+    File.join(site.source, root)
+  end
+
+  def parse(params)
+    Dir.foreach(root_path) do |book_dir|
+      book_path = File.join(root_path, book_dir)
+      if File.directory?(book_path) and book_dir.chars.first != "."
+        pages = BookReader.new(params, site, book_dir).read
+        books << pages[0]
+        @pages += pages
+      end
+    end
+  end
+end

data/lib/jekyll-books/summary.rb

@@ -0,0 +1,95 @@
+require "find"
+require "nokogiri"
+require "kramdown"
+
+class Summary
+  attr_reader :folder
+
+  def initialize(folder)
+    @folder = folder
+  end
+
+  def file_path
+    File.join(folder, "SUMMARY.md")
+  end
+
+  def index_path
+    File.join(folder, "index.md")
+  end
+
+  def chapter_files
+    files = []
+    Find.find(folder) do |f|
+      if File.file?(f) and
+         ![file_path, index_path].include?(f)
+        files << f if File.file?(f)
+      end
+    end
+    files.sort! do |f1, f2|
+      File.ctime(f1) <=> File.ctime(f2) 
+    end
+  end
+
+  def chapters
+    chapter_files.map do |f|
+      {
+        :title => get_title(f),
+        :path => get_relative_path(f)
+      }
+    end
+  end
+
+  def get_title(file)
+    content = File.read(file)
+    html = Kramdown::Document.new(content).to_html
+    parsed_html = Nokogiri::HTML(html)
+    parsed_html.xpath("//h1/text()").to_s
+  end
+
+  def get_relative_path(file)
+    file.sub(folder + "/", "")
+  end
+
+  def write(autoload = false)
+    File.open(file_path, "w+") do |f|
+      f.write summary_title
+      if autoload
+        chapters.each do |chapter|
+          f.write "* [#{chapter[:title]}](#{chapter[:path]})\n"
+        end
+      end
+    end
+  end
+
+  def read
+    content = File.read(file_path)
+    html = Kramdown::Document.new(content).to_html
+    parsed_html = Nokogiri::HTML(html)
+
+    chapters = []
+    parsed_html.xpath("//body/ul/li").each do |li|
+      recursive_parse_chapter(li, 1, chapters)
+    end
+    chapters
+  end
+
+  def recursive_parse_chapter(content, level, result)
+    result << parse_chapter(content, level)
+
+    content.xpath("ul/li").each do |li|
+      recursive_parse_chapter(li, level + 1, result)
+    end
+  end
+
+  def parse_chapter(chapter, level)
+    {
+      "link" => chapter.xpath("a/@href").to_s,
+      "title" => chapter.xpath("a/text()").to_s,
+      "level" => level
+    }
+  end
+
+  def summary_title
+    "# Summary\n\n"
+  end
+end

data/lib/jekyll/commands/book.rb

@@ -0,0 +1,31 @@
+require "jekyll-books/book_writer"
+
+module Jekyll
+  module Commands
+    class Book < Command
+      def self.init_with_program(prog)
+        prog.command(:book) do |c|
+          c.syntax "book [options]"
+          c.description 'Create a new book.'
+  
+          add_options(c)
+  
+          c.action do |args, options|
+            configs = Jekyll.configuration()
+            BookWriter.new(
+              options["name"],
+              File.join(configs["source"], "_books"),
+              options
+            ).run
+          end
+        end
+      end
+  
+      def self.add_options(cmd)
+        cmd.option "name", "-n", "--name NAME"
+        cmd.option "title", "-t", "--title TITLE"
+        cmd.option "forced", "-f", "--forced"
+      end
+    end
+  end
+end

data/lib/jekyll/generators/book.rb

@@ -0,0 +1,55 @@
+require "jekyll-books/books_parser"
+require "util"
+
+module Jekyll
+  class BooksGenerator < Generator
+    def generate(site)
+      params = get_params(site)
+
+      parser = BooksParser.new(params["source"], site)
+      parser.parse(params)
+      site.pages += parser.pages
+
+      books = parser.books
+      books += get_books_from_data(site)
+      sort_books_by_date(books)
+      site.config["books"] = books
+    end
+
+    def get_params(site)
+      default_setting = {
+        "source" => "_books",
+        "destination" => "/",
+        "book" => {
+          "layout" => "book"
+        },
+        "chapter" => {
+          "layout" => "chapter"
+        }
+      }
+
+      default_setting.merge(site.config["books_settings"] || {})
+    end
+
+    private
+      def get_books_from_data(site)
+        books = site.data["books"]
+        return [] unless books
+
+        books.each do |book|
+          Util.init_date_of_book(book)
+        end
+      end
+
+      def sort_books_by_date(books)
+        books.sort_by! do |book|
+          if book.respond_to? "data"
+            [book.data["end"], book.data["start"]]
+          else
+            [book["end"], book["start"]]
+          end
+        end
+        books.reverse!
+      end
+  end
+end

data/lib/jekyll/pages/book.rb

@@ -0,0 +1,24 @@
+require "util"
+
+module Jekyll
+  class BookPage < Page
+    def initialize(site, params)
+      @site = site
+      @base = site.source
+      @dir  = File.join(params["destination"], params["name"])
+      @name = "index.md"
+
+      self.process(@name)
+
+      read_yaml(
+        File.join(@base, params["source"], params["name"]),
+        @name
+      )
+
+      self.data = params["book"].merge(self.data)
+      self.data["parts"] = []
+
+      Util.init_date_of_book(self.data)
+    end
+  end
+end

data/lib/jekyll/pages/chapter.rb

@@ -0,0 +1,25 @@
+module Jekyll
+  class ChapterPage < Page
+    def initialize(site, params)
+      @site = site
+      @base = site.source
+
+      path = File.join(params["name"], File.dirname(params["link"]))
+      @dir = File.join(params["destination"], path)
+
+      @name = File.basename(params["link"])
+
+      self.process(name)
+
+      read_yaml(
+        File.dirname(
+          File.join(@base, params["source"], path)
+        ),
+        name
+      )
+      
+      self.data = params["chapter"].merge(self.data)
+      self.data["parts"] = []
+    end
+  end
+end

data/lib/util.rb

@@ -14,4 +14,11 @@ module Util
       book["date"] = "#{book["start"]}-#{book["end"]}"
     end
   end
+
+  def Util.cover_default(default, params)
+    for key in default
+      default[key] = params[key] unless params[key].nil?
+    end
+    default
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-books
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Sharon Zhang
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-04-11 00:00:00.000000000 Z
+date: 2020-11-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -50,7 +50,16 @@ files:
 - LICENSE.txt
 - README.md
 - jekyll-books.gemspec
+- lib/_config.yml
 - lib/jekyll-books.rb
+- lib/jekyll-books/book_reader.rb
+- lib/jekyll-books/book_writer.rb
+- lib/jekyll-books/books_parser.rb
+- lib/jekyll-books/summary.rb
+- lib/jekyll/commands/book.rb
+- lib/jekyll/generators/book.rb
+- lib/jekyll/pages/book.rb
+- lib/jekyll/pages/chapter.rb
 - lib/util.rb
 homepage: https://github.com/erlzhang/jekyll-books
 licenses: