asciidoctor-html 0.1.14 → 0.1.15

data/lib/asciidoctor/html/book.rb

@@ -11,6 +11,7 @@ require_relative "bi_inline_macro"
 require_relative "text_inline_macro"
 require_relative "template"
 require_relative "pagination"
+require_relative "search"
 
 module Asciidoctor
   module Html
@@ -53,16 +54,15 @@ module Asciidoctor
       # - title
       # - short_title
       # - authors
-      # - se_id
       # - chapname
       def initialize(opts = {})
         opts = DEFAULT_OPTS.merge opts
         @title = ERB::Escape.html_escape opts[:title]
         @short_title = ERB::Escape.html_escape opts[:short_title]
         @authors = opts[:authors]
-        @se_id = opts[:se_id]
         @base_url = opts[:base_url]
         @chapname = opts[:chapname]
+        @search_index = {} # Hash(docname => Array[SearchData])
         @refs = {} # Hash(docname => Hash(id => reftext))
         @templates = {} # Hash(docname => TData)
       end
@@ -94,32 +94,17 @@ module Asciidoctor
         read(chapters, appendices).each do |name, html|
           filename = "#{name}.html"
           File.write("#{outdir}/#{filename}", html)
+          build_index(name, html) unless omit_search?
           entries << Template.sitemap_entry("#{@base_url}#{filename}") if needs_sitemap
         end
-        File.write("#{outdir}/#{SEARCH_PAGE}", search_page(@se_id)) if @se_id
+        File.write "#{outdir}/#{SEARCH_PAGE}", search_page unless omit_search?
         File.write("#{outdir}/sitemap.xml", Template.sitemap(entries)) if needs_sitemap
       end
 
       private
 
       include Pagination
-
-      def search_page(se_id)
-        content = <<~HTML
-          <script async src="https://cse.google.com/cse.js?cx=#{se_id}"></script>
-          <div class="gcse-search"></div>
-        HTML
-        Template.html(
-          content,
-          nav_items,
-          title: @title,
-          short_title: @short_title,
-          authors: display_authors,
-          date: @date,
-          chapsubheading: "Search",
-          langs: []
-        )
-      end
+      include Search
 
       def register!(docs, filename, doc)
         key = key filename
@@ -194,17 +179,18 @@ module Asciidoctor
         node.reftext || (node.title unless node.inline?) || "[#{node.id}]" if node.id
       end
 
-      def display_authors(doc)
-        authors = doc.authors.map do |author|
-          doc.sub_replacements author.name
+      def display_authors(doc = nil)
+        authors = []
+        if doc
+          authors = doc.authors.map do |author|
+            doc.sub_replacements author.name
+          end
         end
-
         if authors.empty? && @authors
           authors = @authors.map do |author|
             ERB::Escape.html_escape author
           end
         end
-
         return if authors.empty?
 
         [
@@ -231,6 +217,10 @@ module Asciidoctor
         html
       end
 
+      def omit_search?
+        @templates.size < 2 && @search_index.empty?
+      end
+
       def nav_items(active_key = -1, doc = nil)
         items = @templates.map do |k, td|
           active = (k == active_key)
@@ -238,7 +228,7 @@ module Asciidoctor
           navtext = Template.nav_text td.chapprefix, td.chaptitle
           Template.nav_item "#{k}.html", navtext, subnav, active:
         end
-        return items unless @se_id
+        return items if omit_search?
 
         items.unshift(Template.nav_item(
                         SEARCH_PAGE,

data/lib/asciidoctor/html/cli.rb

@@ -85,7 +85,7 @@ module Asciidoctor
 
       def self.generate_bookopts(config)
         book_opts = {}
-        %i[title short_title authors se_id base_url chapname].each do |opt|
+        %i[title short_title authors base_url chapname].each do |opt|
           key = opt.to_s
           book_opts[opt] = config[key] if config.include?(key)
         end

data/lib/asciidoctor/html/pagination.rb

@@ -5,7 +5,7 @@ module Asciidoctor
     # Mixin to add pagination support to Book class
     module Pagination
       # Pagination item
-      PagItem = Struct.new("PagItem", :url, :title)
+      PagItem = Struct.new "PagItem", :url, :title
 
       def display_paginator(prv, nxt)
         return "" unless prv || nxt

data/lib/asciidoctor/html/search.rb

@@ -0,0 +1,146 @@
+# frozen_string_literal: true
+
+require "nokogiri"
+
+module Asciidoctor
+  module Html
+    # Mixed in to Book class to provide full text search
+    module Search
+      SEARCH_RESULT_OVERFLOW = 10 # characters
+
+      def search_page
+        content = <<~HTML
+          <div class="search-form-container">
+            <form id="search-form" class="search-form">
+              <input type="text" id="search-text" name="search-text" class="form-control search-box" placeholder="Search">
+              <button type="submit" class="btn btn-primary search-btn">Go</button>
+            </form>
+          </div>
+          <div id="search-results-container" class="hidden">
+          <h4>Found <span id="search-nmatches">0 matches</span></h4>
+          <ul id="search-results" class="search-results list-group list-group-flush"></ul>
+          </div>
+          <script src="https://unpkg.com/lunr/lunr.js"></script>
+          <script>#{lunr_script}</script>
+        HTML
+        Template.html(
+          content,
+          nav_items,
+          title: @title,
+          short_title: @short_title,
+          authors: display_authors,
+          date: @date,
+          chapsubheading: "Search",
+          langs: []
+        )
+      end
+
+      def build_index(key, html)
+        doctree = Nokogiri::HTML5.parse html
+        ref = @refs[key]
+        page_text = "#{doctree.at_css(".chaptitle")&.text} #{doctree.at_css(".preamble")&.text}"
+        index = [{
+          id: "#{key}.html",
+          title: ref["chapref"],
+          text: page_text
+        }]
+        doctree.css("section[id]").each do |section|
+          sectid = section["id"]
+          id = "#{key}.html##{sectid}"
+          title = "#{ref["chapref"]} › #{ref[sectid]}"
+          text = section.text
+          index << { id:, title:, text: }
+        end
+        @search_index[key] = index
+      end
+
+      def search_json
+        index_arr = []
+        @search_index.each_value do |search_data|
+          index_arr.concat search_data
+        end
+        index_arr.to_json
+      end
+
+      def lunr_script
+        <<~JS
+          (function() {
+            const resultsContainer = document.getElementById('search-results-container');
+            const nmatches = document.getElementById('search-nmatches');
+            const searchResults = document.getElementById('search-results');
+            const searchForm = document.getElementById('search-form');
+            const searchBox = document.getElementById('search-text');
+            const positionOverflow = 20;
+            const documents = #{search_json};
+            const idx = lunr(function() {
+              this.ref('id');
+              this.field('title');
+              this.field('text');
+              this.metadataWhitelist = ['position'];
+
+              documents.forEach(doc => {
+                this.add(doc)
+              });
+            });
+            function processSearchText(searchText) {
+              const results = idx.search(searchText).map(match => {
+                const doc = documents.find(d => d.id == match.ref);
+                const result = document.createElement('li');
+                result.classList.add('list-group-item');
+                const link = document.createElement('a');
+                const br = document.createElement('br');
+                link.setAttribute('href', match.ref);
+                link.innerHTML = doc.title;
+                result.append(link, br);
+                const metadata = match.matchData.metadata;
+                for(const term in metadata) {
+                  const datum = metadata[term];
+                  for(const type in datum) {
+                    datum[type].position.forEach(pos => {
+                      const start = pos[0];
+                      const end = pos[0] + pos[1];
+                      const text = doc[type];
+                      const textMatch = text.substring(start, end)
+                      const matchingText = document.createElement('mark');
+                      const overflowLeft = document.createElement('span');
+                      overflowLeft.classList.add('overflow-text-left');
+                      const overflowRight = document.createElement('span');
+                      overflowRight.classList.add('overflow-text-right');
+                      const reLeft = /.{#{SEARCH_RESULT_OVERFLOW}}$/s;
+                      let left = text.substring(0, start - 1).search(reLeft) + 1;
+                      while(text[left] && text[left].trim() == text[left]) {
+                        left--;
+                      }
+                      const reRight = /^.{#{SEARCH_RESULT_OVERFLOW}}/s;
+                      let right = text.length;
+                      if(rightMatch = text.substring(end + 1).match(reRight)) {
+                        right = rightMatch[0].length + end;
+                        while(text[right] && text[right].trim() == text[right]) {
+                          right++;
+                        }
+                      }
+                      overflowLeft.textContent = text.substring(left, start - 1);
+                      matchingText.textContent = textMatch;
+                      overflowRight.textContent = text.substring(end + 1, right);
+                      result.append(overflowLeft, matchingText, overflowRight);
+                    });
+                  }
+                }
+                return result;
+              });
+              searchResults.replaceChildren(...results);
+              const n = results.length;
+              nmatches.textContent = n == 1 ? (n + ' match') : (n + ' matches');
+              resultsContainer.classList.remove('hidden');
+            }
+            searchForm.addEventListener('submit', e => {
+              e.preventDefault();
+              const searchText = searchBox.value;
+              processSearchText(searchText);
+            });
+          })();
+        JS
+      end
+    end
+  end
+end

data/lib/asciidoctor/html.rb

@@ -8,6 +8,7 @@ module Asciidoctor
     CSS_PATH = "#{ASSETS_PATH}/css".freeze
     IMG_PATH = "#{ASSETS_PATH}/img".freeze
     SEARCH_PAGE = "search.html"
+    SEARCH_INDEX = "search-index.json"
   end
 end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: asciidoctor-html
 version: !ruby/object:Gem::Version
-  version: 0.1.14
+  version: 0.1.15
 platform: ruby
 authors:
 - Ravi Rajani
@@ -37,6 +37,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.1'
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.18'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.18'
 - !ruby/object:Gem::Dependency
   name: psych
   requirement: !ruby/object:Gem::Requirement
@@ -102,6 +116,7 @@ files:
 - lib/asciidoctor/html/popovers.rb
 - lib/asciidoctor/html/ref_tree_processor.rb
 - lib/asciidoctor/html/scroll.rb
+- lib/asciidoctor/html/search.rb
 - lib/asciidoctor/html/sidebar.rb
 - lib/asciidoctor/html/table.rb
 - lib/asciidoctor/html/template.rb