middlemac 3.1.0 → 3.1.1

data/ext/trie/trie.h

@@ -0,0 +1,40 @@
+#include "darray.h"
+#include "tail.h"
+
+typedef struct _Trie {
+    DArray     *da;
+    Tail       *tail;
+} Trie;
+
+typedef struct _TrieState {
+    const Trie *trie;       /**< the corresponding trie */
+    TrieIndex   index;      /**< index in double-array/tail structures */
+    short       suffix_idx; /**< suffix character offset, if in suffix */
+    short       is_suffix;  /**< whether it is currently in suffix part */
+} TrieState;
+
+
+#define trie_da_is_separate(da,s)      (da_get_base ((da), (s)) < 0)
+#define trie_da_get_tail_index(da,s)   (-da_get_base ((da), (s)))
+#define trie_da_set_tail_index(da,s,v) (da_set_base ((da), (s), -(v)))
+#define trie_state_is_terminal(s) trie_state_is_walkable((s),TRIE_CHAR_TERM)
+
+
+Trie* trie_new();
+void trie_free(Trie *trie);
+static Bool trie_branch_in_branch (Trie *trie, TrieIndex sep_node, const TrieChar *suffix, TrieData data);
+static Bool trie_branch_in_tail(Trie *trie, TrieIndex sep_node, const TrieChar *suffix, TrieData data);
+Bool trie_store (Trie *trie, const TrieChar *key, TrieData data);
+Bool trie_retrieve (const Trie *trie, const TrieChar *key, TrieData *o_data);
+Bool trie_delete (Trie *trie, const TrieChar *key);
+TrieState * trie_root (const Trie *trie);
+static TrieState * trie_state_new (const Trie *trie, TrieIndex index, short suffix_idx, short is_suffix);
+TrieState * trie_state_clone (const TrieState *s);
+void trie_state_free (TrieState *s);
+void trie_state_rewind (TrieState *s);
+Bool trie_state_walk (TrieState *s, TrieChar c);
+Bool trie_state_is_walkable (const TrieState *s, TrieChar c);
+Bool trie_state_is_leaf (const TrieState *s);
+TrieData trie_state_get_data (const TrieState *s);
+
+

data/ext/trie/triedefs.h

@@ -0,0 +1,73 @@
+/* -*- Mode: C; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
+/*
+ * triedefs.h - General typedefs for trie
+ * Created: 2006-08-11
+ * Author:  Theppitak Karoonboonyanan <thep@linux.thai.net>
+ */
+
+#ifndef __TRIEDEFS_H
+#define __TRIEDEFS_H
+
+#include "typedefs.h"
+
+/**
+ * @file triedefs.h
+ * @brief General typedefs for trie
+ */
+
+/**
+ * @brief Trie IO modes
+ */
+typedef enum {
+    TRIE_IO_READ   = 0x01,
+    TRIE_IO_WRITE  = 0x02,
+    TRIE_IO_CREATE = 0x04
+} TrieIOMode;
+
+/**
+ * @brief Trie character type for alphabet
+ */
+typedef uint32         AlphaChar;
+
+/**
+ * @brief Error value for alphabet character
+ */
+#define ALPHA_CHAR_ERROR   (~(AlphaChar)0)
+
+/**
+ * @brief Trie character type for key
+ */
+typedef unsigned char  TrieChar;
+/**
+ * @brief Trie terminator character
+ */
+#define TRIE_CHAR_TERM    '\0'
+#define TRIE_CHAR_MAX     255
+
+/**
+ * @brief Type of Trie index
+ */
+typedef int32          TrieIndex;
+/**
+ * @brief Trie error index
+ */
+#define TRIE_INDEX_ERROR  0
+/**
+ * @brief Maximum trie index value
+ */
+#define TRIE_INDEX_MAX    0x7fffffff
+
+/**
+ * @brief Type of value associated to trie entries
+ */
+typedef unsigned long TrieData;
+/**
+ * @brief Trie error data
+ */
+#define TRIE_DATA_ERROR  -1
+
+#endif  /* __TRIEDEFS_H */
+
+/*
+vi:ts=4:ai:expandtab
+*/

data/ext/trie/typedefs.h

@@ -0,0 +1,117 @@
+/* -*- Mode: C; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
+/*
+ * typedefs.h - general types
+ * Created : 11 Aug 2006
+ * Author  : Theppitak Karoonboonyanan <thep@linux.thai.net>
+ */
+
+#ifndef __TYPEDEFS_H
+#define __TYPEDEFS_H
+
+#include <limits.h>
+
+// fix for fast_trie on Windows. Should be easy to merge with future changes to libdatrie. MH
+#include <stdbool.h>
+#define Bool  bool
+#define FALSE false
+#define TRUE  true
+
+# if UCHAR_MAX == 0xff
+#   ifndef UINT8_TYPEDEF
+#     define UINT8_TYPEDEF
+      typedef unsigned char  uint8;
+#   endif /* UINT8_TYPEDEF */
+# endif /* UCHAR_MAX */
+
+# if SCHAR_MAX == 0x7f
+#   ifndef INT8_TYPEDEF
+#     define INT8_TYPEDEF
+      typedef signed char    int8;
+#   endif /* INT8_TYPEDEF */
+# endif /* SCHAR_MAX */
+
+# if UINT_MAX == 0xffff
+#   ifndef UINT16_TYPEDEF
+#     define UINT16_TYPEDEF
+      typedef unsigned int   uint16;
+#   endif /* UINT16_TYPEDEF */
+# endif /* UINT_MAX */
+
+# if INT_MAX == 0x7fff
+#   ifndef INT16_TYPEDEF
+#     define INT16_TYPEDEF
+      typedef int            int16;
+#   endif /* INT16_TYPEDEF */
+# endif /* INT_MAX */
+
+# if USHRT_MAX == 0xffff
+#   ifndef UINT16_TYPEDEF
+#     define UINT16_TYPEDEF
+      typedef unsigned short uint16;
+#   endif /* UINT16_TYPEDEF */
+# endif /* USHRT_MAX */
+
+# if SHRT_MAX == 0x7fff
+#   ifndef INT16_TYPEDEF
+#     define INT16_TYPEDEF
+      typedef short          int16;
+#   endif /* INT16_TYPEDEF */
+# endif /* SHRT_MAX */
+
+# if UINT_MAX == 0xffffffff
+#   ifndef UINT32_TYPEDEF
+#     define UINT32_TYPEDEF
+      typedef unsigned int   uint32;
+#   endif /* UINT32_TYPEDEF */
+# endif /* UINT_MAX */
+
+# if INT_MAX == 0x7fffffff
+#   ifndef INT32_TYPEDEF
+#     define INT32_TYPEDEF
+      typedef int            int32;
+#   endif /* INT32_TYPEDEF */
+# endif /* INT_MAX */
+
+# if ULONG_MAX == 0xffffffff
+#   ifndef UINT32_TYPEDEF
+#     define UINT32_TYPEDEF
+      typedef unsigned long  uint32;
+#   endif /* UINT32_TYPEDEF */
+# endif /* ULONG_MAX */
+
+# if LONG_MAX == 0x7fffffff
+#   ifndef INT32_TYPEDEF
+#     define INT32_TYPEDEF
+      typedef long           int32;
+#   endif /* INT32_TYPEDEF */
+# endif /* LONG_MAX */
+
+# ifndef UINT8_TYPEDEF
+#   error "uint8 type is undefined!"
+# endif
+# ifndef INT8_TYPEDEF
+#   error "int8 type is undefined!"
+# endif
+# ifndef UINT16_TYPEDEF
+#   error "uint16 type is undefined!"
+# endif
+# ifndef INT16_TYPEDEF
+#   error "int16 type is undefined!"
+# endif
+# ifndef UINT32_TYPEDEF
+#   error "uint32 type is undefined!"
+# endif
+# ifndef INT32_TYPEDEF
+#   error "int32 type is undefined!"
+# endif
+
+typedef uint8  byte;
+typedef uint16 word;
+typedef uint32 dword;
+
+
+#endif /* __TYPEDEFS_H */
+
+/*
+vi:ts=4:ai:expandtab
+*/

data/features/helpers_features.feature

@@ -34,19 +34,18 @@ Feature: Provide helpers and resource items to make multiple targets easy to man
     And the file "goodbye_world_file.html" should contain '[hello_world_file]: #/topic-en.lproj-hello_world_file "Hello World"'
     And the file "goodbye_world_file.html" should contain '[testing_world_file]: #/topic-en.lproj-testing_world_file "Testing World"'
     
-    
   Scenario:
     The extended image tag should include srcset automatically if @2x images are
     present, and not include a srcset if not.
     When I cd to "New_Project_(pro).help/Contents/Resources/en.lproj/"
-    And the file "goodbye_world_file.html" should contain 'img src="/Resources/SharedGlobalAssets/convention/icon_32x32.png" srcset="/Resources/SharedGlobalAssets/convention/icon_32x32.png 1x, /Resources/SharedGlobalAssets/convention/icon_32x32@2x.png 2x" alt="Icon 32x32"'
-    And the file "goodbye_world_file.html" should contain 'img src="/Resources/SharedGlobalAssets/convention/icon_256x256.png" srcset="/Resources/SharedGlobalAssets/convention/icon_256x256.png 1x, /Resources/SharedGlobalAssets/convention/icon_256x256@2x.png 2x" alt="Icon 256x256"'
-    And the file "goodbye_world_file.html" should contain 'img src="/Resources/en.lproj/assets/images/subdirectory/logo_32x32.png" alt="Logo 32x32"'
-    And the file "goodbye_world_file.html" should contain 'img src="/Resources/en.lproj/assets/images/neat_thing_32x32.png" alt="Neat thing 32x32"'
-    And the file "goodbye_world_file.html" should contain 'img src="/Resources/en.lproj/assets/images/subdirectory/pro-image_32x32.png" alt="Pro image 32x32"'
-    And the file "goodbye_world_file.html" should contain 'img src="/Resources/en.lproj/assets/images/all-graphic_32x32.png" alt="All graphic 32x32'
-    And the file "goodbye_world_file.html" should contain 'img src="/Resources/SharedGlobalAssets/images/myfile-NOT_IN_SITEMAP" alt="Myfile not in sitemap"'
-    And the file "goodbye_world_file.html" should contain 'img src="/Resources/SharedGlobalAssets/images/myfile-NOT_IN_SITEMAP.png" alt="Myfile not in sitemap"'
+    And the file "goodbye_world_file.html" should contain 'img src="/Resources/SharedGlobalAssets/convention/icon_32x32.png" srcset="/Resources/SharedGlobalAssets/convention/icon_32x32.png 1x, /Resources/SharedGlobalAssets/convention/icon_32x32@2x.png 2x" alt=""'
+    And the file "goodbye_world_file.html" should contain 'img src="/Resources/SharedGlobalAssets/convention/icon_256x256.png" srcset="/Resources/SharedGlobalAssets/convention/icon_256x256.png 1x, /Resources/SharedGlobalAssets/convention/icon_256x256@2x.png 2x" alt=""'
+    And the file "goodbye_world_file.html" should contain 'img src="/Resources/en.lproj/assets/images/subdirectory/logo_32x32.png" alt=""'
+    And the file "goodbye_world_file.html" should contain 'img src="/Resources/en.lproj/assets/images/neat_thing_32x32.png" alt=""'
+    And the file "goodbye_world_file.html" should contain 'img src="/Resources/en.lproj/assets/images/subdirectory/pro-image_32x32.png" alt=""'
+    And the file "goodbye_world_file.html" should contain 'img src="/Resources/en.lproj/assets/images/all-graphic_32x32.png" alt=""'
+    And the file "goodbye_world_file.html" should contain 'img src="/Resources/SharedGlobalAssets/images/myfile-NOT_IN_SITEMAP" alt=""'
+    And the file "goodbye_world_file.html" should contain 'img src="/Resources/SharedGlobalAssets/images/myfile-NOT_IN_SITEMAP.png" alt=""'
 
 
   Scenario:

data/features/main_features.feature

@@ -5,8 +5,8 @@ Feature: Middlemac produces plist and strings files, uses correct HTML formats,
   I want to build useable macOS help books.
   
   Background:
-    Given a built app at "middlemac_app"
-    
+	Given a built app at "middlemac_app"
+   
   Scenario:
     The correct HTML version must be used on generated files.
     When I cd to "New_Project_(pro).help/Contents/Resources/en.lproj/"
@@ -42,7 +42,7 @@ Feature: Middlemac produces plist and strings files, uses correct HTML formats,
     And the file "testing_world_file.html" should contain "com.sample.project.pro.help"
     And the file "testing_world_file.html" should contain "New Project"
     And the file "testing_world_file.html" should contain "New Project Pro"
-    And the file "testing_world_file.html" should contain "3.1.0"
+    And the file "testing_world_file.html" should contain "3.1.1"
     And the file "testing_world_file.html" should contain "http://www.sample.com"
     And the file "testing_world_file.html" should contain "_new_style_partial"
     And the file "testing_world_file.html" should contain "_partials_dir_partial"

data/fixtures/middlemac_app/Gemfile

@@ -17,14 +17,14 @@ source 'https://rubygems.org'
 #######################################
 # Middlemac, natch.
 #######################################
-gem 'middlemac', '~> 3.1.0'
+gem 'middlemac', '~> 3.1.1'
 gem 'middleman-targets', '~> 1.0.12'
 
 
 #######################################
 # Core gems
 #######################################
-gem 'middleman', '~> 4.2.0'
+gem 'middleman', '~> 4.3.7'
 gem 'middleman-core'
 gem 'middleman-cli'
 gem 'middleman-livereload' # Live-reloading plugin

data/fixtures/middlemac_app/config.rb

@@ -73,8 +73,8 @@ config[:target] = :pro
 # for the current target will be available via the `product_uri` helper.
 
 # :ProductCopyright
-# You should specify a copyright string to be included in the Apple Help Book,
-# and is display on the bottom of each help book page.
+# You should specify a copyright string to be included in the Apple Help Book.
+# This typically appears when you print a Help Book.
 
 # (other)
 # You can specify additional .plist and .strings keys here, too. Have a look
@@ -94,9 +94,9 @@ config[:targets] = {
                 :HPDBookIconPath  => nil,
                 :CFBundleName     => 'New Project',
                 :ProductName      => 'New Project',
-                :ProductVersion   => version_app || '3.1.0',
+                :ProductVersion   => version_app || '3.1.1',
                 :ProductURI       => 'http://www.sample.com',
-                :ProductCopyright => '© 2018 Jim Derry. All rights reserved.',
+                :ProductCopyright => '© 2021 Jim Derry. All rights reserved.',
                 :features =>
                     {
                         :feature_advertise_pro        => true,
@@ -112,9 +112,9 @@ config[:targets] = {
                 :HPDBookIconPath  => nil,
                 :CFBundleName     => 'New Project',
                 :ProductName      => 'New Project Pro',
-                :ProductVersion   => version_app || '3.1.0',
+                :ProductVersion   => version_app || '3.1.1',
                 :ProductURI       => 'http://www.sample.com',
-                :ProductCopyright => '© 2018 Jim Derry. All rights reserved.',
+                :ProductCopyright => '© 2021 Jim Derry. All rights reserved.',
                 :features =>
                     {
                         :feature_advertise_pro        => false,
@@ -127,7 +127,7 @@ config[:targets] = {
     } # targets
 
 # By enabling :target_magic_images, target specific images will be used instead
-# of the image you specify if it's prefixed with :target_magic_word. For
+# of the image you specify if it'ss prefixed with :target_magic_word. For
 # example, you might request "all-my_image.png", and "pro-my_image.png" (if it
 # exists) will be used in your :pro target instead.
 #
@@ -205,8 +205,6 @@ end #activate
 
 #===============================================================
 # Setup directories to mirror Help Book directory layout.
-# All shared assets are subdirectories of :assets_dir, and
-# localized assets are subdirectories of `lang.lproj/assets/`.
 #===============================================================
 set :source,         'Contents'
 set :data_dir,       'Contents/Resources/SharedGlobalAssets/_data'

data/lib/middlemac.rb

@@ -5,6 +5,6 @@ Middleman::Extensions.register :Middlemac, :before_configuration do
   require_relative 'middlemac/sitemap'
   require_relative 'middlemac/helpers'
   require_relative 'middlemac/private'
-  require_relative 'middlemac/trie'
+  require_relative 'middlemac/trie-extension'
   Middlemac
 end

data/lib/middlemac/extension.rb

@@ -4,7 +4,7 @@ require 'pathname'
 require 'json'
 require 'nokogiri'
 require 'words_counted'
-require 'trie'
+require 'trie/trie'
 
 ################################################################################
 # **Middlemac** is a tool to build macOS application help book files from 
@@ -150,6 +150,10 @@ class Middlemac < ::Middleman::Extension
   #############################################################
   def after_configuration
 
+	puts "****************************************************"
+	puts "after_configuration"
+	puts "****************************************************"
+
     # Set the correct :build_dir based on the options.
     dir = options[:help_output_location] || File.expand_path('./')
     cf_bundle_name = app.config[:targets][app.config[:target]][:CFBundleName]

data/lib/middlemac/version.rb

@@ -1,5 +1,5 @@
 module Middleman
     module Middlemac
-        VERSION = '3.1.0'
+        VERSION = '3.1.1'
     end
 end

data/middlemac.gemspec

@@ -2,9 +2,26 @@
 $:.push File.expand_path('../lib', __FILE__)
 require 'middlemac/version'
 
-mm_needed = ['~> 4.2.0', '>= 4.2.0']
+# We should work with any 4.3.x version of Middleman, but due to #2319,
+# automatic image alt attributes have been removed from Middleman, so
+# I'm adjusting the minimum requirement to the first release incorporating
+# that change.
+
+mm_needed = ['~> 4.3.0', '>= 4.3.7']
+
+# We should work with any 2.0 version of Ruby, but I'm no longer testing them
+# for regressions. Version 2.6.0 goes back to December 2018, and is a suitable
+# minimum version.
+#
+# Currently no released version of Middleman works with Ruby 3, so until that is
+# resolved, We will only support 2.6 up to and not including Ruby 3.0.
+
+rb_needed = ['~> 2.0', '>= 2.6']
+
 
 Gem::Specification.new do |s|
+
+  s.required_ruby_version = rb_needed
   s.name        = 'middlemac'
   s.version     = Middleman::Middlemac::VERSION
   s.platform    = Gem::Platform::RUBY
@@ -18,6 +35,7 @@ Gem::Specification.new do |s|
   s.files         = `git ls-files`.split("\n")
   s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
   s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.extensions   << "ext/trie/extconf.rb"
   s.require_paths = ['lib']
   
   # The version of middleman-core your extension depends on
@@ -28,7 +46,7 @@ Gem::Specification.new do |s|
   s.add_runtime_dependency('middleman-targets', ['~> 1.0', '>= 1.0.12'])
   s.add_runtime_dependency 'nokogiri'
   s.add_runtime_dependency 'words_counted'
-  s.add_runtime_dependency 'fast_trie'
+  s.add_runtime_dependency 'rake-compiler'
   
   # Development dependencies
   s.add_development_dependency 'middleman', mm_needed

metadata

@@ -1,55 +1,55 @@
 --- !ruby/object:Gem::Specification
 name: middlemac
 version: !ruby/object:Gem::Version
-  version: 3.1.0
+  version: 3.1.1
 platform: ruby
 authors:
 - Jim Derry
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2019-10-11 00:00:00.000000000 Z
+date: 2021-04-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: middleman-core
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 4.2.0
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 4.2.0
+        version: 4.3.0
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.3.7
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 4.2.0
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 4.2.0
+        version: 4.3.0
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.3.7
 - !ruby/object:Gem::Dependency
   name: middleman-cli
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 4.2.0
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 4.2.0
+        version: 4.3.0
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.3.7
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 4.2.0
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 4.2.0
+        version: 4.3.0
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.3.7
 - !ruby/object:Gem::Dependency
   name: middleman-targets
   requirement: !ruby/object:Gem::Requirement
@@ -99,7 +99,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: fast_trie
+  name: rake-compiler
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -116,22 +116,22 @@ dependencies:
   name: middleman
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 4.2.0
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 4.2.0
+        version: 4.3.0
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.3.7
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 4.2.0
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 4.2.0
+        version: 4.3.0
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.3.7
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -193,7 +193,8 @@ email:
 - balthisar@gmail.com
 executables:
 - middlemac
-extensions: []
+extensions:
+- ext/trie/extconf.rb
 extra_rdoc_files: []
 files:
 - ".gitattributes"
@@ -425,6 +426,19 @@ files:
 - documentation_project/config.rb
 - documentation_project/makefile
 - documentation_project/middlemac.webloc
+- ext/trie/darray.c
+- ext/trie/darray.h
+- ext/trie/extconf.rb
+- ext/trie/fileutils.c
+- ext/trie/fileutils.h
+- ext/trie/tail.c
+- ext/trie/tail.h
+- ext/trie/trie-private.c
+- ext/trie/trie-private.h
+- ext/trie/trie.c
+- ext/trie/trie.h
+- ext/trie/triedefs.h
+- ext/trie/typedefs.h
 - features/helpers_features.feature
 - features/main_features.feature
 - features/support/env.rb
@@ -560,7 +574,7 @@ files:
 - lib/middlemac/helpers.rb
 - lib/middlemac/private.rb
 - lib/middlemac/sitemap.rb
-- lib/middlemac/trie.rb
+- lib/middlemac/trie-extension.rb
 - lib/middlemac/version.rb
 - middlemac.gemspec
 - resources/stopwords/ar.plist
@@ -610,23 +624,26 @@ homepage: https://github.com/middlemac/middlemac
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
+  - - "~>"
+    - !ruby/object:Gem::Version
+      version: '2.0'
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '2.6'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.6
-signing_key: 
+rubygems_version: 3.1.4
+signing_key:
 specification_version: 4
 summary: Build complete macOS application help books using Middleman.
 test_files: