middlemac 2.0.0 → 3.1.2

data/documentation_project/HelpViewerApp/HelpViewerApp.xcodeproj/xcshareddata/xcschemes/Help (pro).xcscheme

@@ -0,0 +1,80 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   LastUpgradeVersion = "0940"
+   version = "1.3">
+   <BuildAction
+      parallelizeBuildables = "YES"
+      buildImplicitDependencies = "YES">
+      <BuildActionEntries>
+         <BuildActionEntry
+            buildForTesting = "YES"
+            buildForRunning = "YES"
+            buildForProfiling = "YES"
+            buildForArchiving = "YES"
+            buildForAnalyzing = "YES">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "D00D796220C953AB00332C9E"
+               BuildableName = "Help (pro)"
+               BlueprintName = "Help (pro)"
+               ReferencedContainer = "container:HelpViewerApp.xcodeproj">
+            </BuildableReference>
+         </BuildActionEntry>
+      </BuildActionEntries>
+   </BuildAction>
+   <TestAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      shouldUseLaunchSchemeArgsEnv = "YES">
+      <Testables>
+      </Testables>
+      <AdditionalOptions>
+      </AdditionalOptions>
+   </TestAction>
+   <LaunchAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      launchStyle = "0"
+      useCustomWorkingDirectory = "NO"
+      ignoresPersistentStateOnLaunch = "NO"
+      debugDocumentVersioning = "YES"
+      debugServiceExtension = "internal"
+      allowLocationSimulation = "YES">
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "D00D796220C953AB00332C9E"
+            BuildableName = "Help (pro)"
+            BlueprintName = "Help (pro)"
+            ReferencedContainer = "container:HelpViewerApp.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
+      <AdditionalOptions>
+      </AdditionalOptions>
+   </LaunchAction>
+   <ProfileAction
+      buildConfiguration = "Release"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      savedToolIdentifier = ""
+      useCustomWorkingDirectory = "NO"
+      debugDocumentVersioning = "YES">
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "D00D796220C953AB00332C9E"
+            BuildableName = "Help (pro)"
+            BlueprintName = "Help (pro)"
+            ReferencedContainer = "container:HelpViewerApp.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
+   </ProfileAction>
+   <AnalyzeAction
+      buildConfiguration = "Debug">
+   </AnalyzeAction>
+   <ArchiveAction
+      buildConfiguration = "Release"
+      revealArchiveInOrganizer = "YES">
+   </ArchiveAction>
+</Scheme>

data/documentation_project/HelpViewerApp/HelpViewerApp.xcodeproj/xcshareddata/xcschemes/HelpViewerApp (free).xcscheme

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
-   LastUpgradeVersion = "0730"
+   LastUpgradeVersion = "0940"
    version = "1.3">
    <BuildAction
       parallelizeBuildables = "YES"

data/documentation_project/HelpViewerApp/HelpViewerApp.xcodeproj/xcshareddata/xcschemes/HelpViewerApp (pro).xcscheme

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
-   LastUpgradeVersion = "0730"
+   LastUpgradeVersion = "0940"
    version = "1.3">
    <BuildAction
       parallelizeBuildables = "YES"

data/documentation_project/HelpViewerApp/HelpViewerApp/AppDelegate.h

@@ -12,5 +12,6 @@
 
 @property (nonatomic, assign) NSString* labelTitle;
 
+- (IBAction) getContextHelp:(id) sender;
 @end
 

data/documentation_project/HelpViewerApp/HelpViewerApp/AppDelegate.m

@@ -42,4 +42,10 @@
     return result;
 }
 
+/* Show context-sensitive help */
+- (IBAction) getContextHelp:(id) sender
+{
+    NSString *locBookName = [[NSBundle mainBundle] objectForInfoDictionaryKey: @"CFBundleHelpBookName"];
+    [[NSHelpManager sharedHelpManager] openHelpAnchor:@"apple_help_setup"  inBook:locBookName];}
+
 @end

data/documentation_project/HelpViewerApp/HelpViewerApp/Base.lproj/MainMenu.xib

@@ -1,8 +1,9 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<document type="com.apple.InterfaceBuilder3.Cocoa.XIB" version="3.0" toolsVersion="10117" systemVersion="15E65" targetRuntime="MacOSX.Cocoa" propertyAccessControl="none" useAutolayout="YES" customObjectInstantitationMethod="direct">
+<?xml version="1.0" encoding="UTF-8"?>
+<document type="com.apple.InterfaceBuilder3.Cocoa.XIB" version="3.0" toolsVersion="14109" targetRuntime="MacOSX.Cocoa" propertyAccessControl="none" useAutolayout="YES" customObjectInstantitationMethod="direct">
     <dependencies>
         <deployment identifier="macosx"/>
-        <plugIn identifier="com.apple.InterfaceBuilder.CocoaPlugin" version="10117"/>
+        <plugIn identifier="com.apple.InterfaceBuilder.CocoaPlugin" version="14109"/>
+        <capability name="documents saved in the Xcode 8 format" minToolsVersion="8.0"/>
     </dependencies>
     <objects>
         <customObject id="-2" userLabel="File's Owner" customClass="NSApplication">
@@ -70,17 +71,18 @@
                     </menu>
                 </menuItem>
             </items>
+            <point key="canvasLocation" x="328" y="139"/>
         </menu>
         <window title="HelpViewerApp" allowsToolTipsWhenApplicationIsInactive="NO" autorecalculatesKeyViewLoop="NO" restorable="NO" releasedWhenClosed="NO" showsToolbarButton="NO" animationBehavior="default" id="QvC-M9-y7g">
             <windowStyleMask key="styleMask" titled="YES"/>
-            <rect key="contentRect" x="100" y="100" width="480" height="94"/>
-            <rect key="screenRect" x="0.0" y="0.0" width="2560" height="1417"/>
+            <rect key="contentRect" x="100" y="100" width="480" height="149"/>
+            <rect key="screenRect" x="0.0" y="0.0" width="2560" height="1418"/>
             <view key="contentView" wantsLayer="YES" id="EiT-Mj-1SZ">
-                <rect key="frame" x="0.0" y="0.0" width="480" height="94"/>
+                <rect key="frame" x="0.0" y="0.0" width="480" height="149"/>
                 <autoresizingMask key="autoresizingMask"/>
                 <subviews>
                     <textField verticalHuggingPriority="750" horizontalCompressionResistancePriority="250" translatesAutoresizingMaskIntoConstraints="NO" id="PEG-1y-oDG">
-                        <rect key="frame" x="18" y="20" width="444" height="17"/>
+                        <rect key="frame" x="18" y="75" width="444" height="17"/>
                         <textFieldCell key="cell" sendsActionOnEndEditing="YES" title="View the help content for this target from this application’s Help menu." id="LjB-rr-ycH">
                             <font key="font" metaFont="system"/>
                             <color key="textColor" name="labelColor" catalog="System" colorSpace="catalog"/>
@@ -88,7 +90,7 @@
                         </textFieldCell>
                     </textField>
                     <textField horizontalHuggingPriority="251" verticalHuggingPriority="750" translatesAutoresizingMaskIntoConstraints="NO" id="X1z-g4-M4P">
-                        <rect key="frame" x="18" y="45" width="444" height="29"/>
+                        <rect key="frame" x="18" y="100" width="444" height="29"/>
                         <textFieldCell key="cell" scrollable="YES" lineBreakMode="clipping" sendsActionOnEndEditing="YES" alignment="center" title="Label" id="b2u-QX-V1M">
                             <font key="font" metaFont="system" size="24"/>
                             <color key="textColor" name="labelColor" catalog="System" colorSpace="catalog"/>
@@ -98,18 +100,45 @@
                             <binding destination="Voe-Tx-rLC" name="value" keyPath="self.labelTitle" id="wln-bY-abo"/>
                         </connections>
                     </textField>
+                    <button translatesAutoresizingMaskIntoConstraints="NO" id="tVe-CU-hCi">
+                        <rect key="frame" x="20" y="20" width="48" height="47"/>
+                        <constraints>
+                            <constraint firstAttribute="width" constant="48" id="o6f-AC-dcN"/>
+                        </constraints>
+                        <buttonCell key="cell" type="square" bezelStyle="shadowlessSquare" image="NSInfo" imagePosition="only" alignment="center" imageScaling="proportionallyUpOrDown" inset="2" id="q0x-TE-qyD">
+                            <behavior key="behavior" pushIn="YES" lightByBackground="YES" lightByGray="YES"/>
+                            <font key="font" metaFont="system"/>
+                        </buttonCell>
+                        <connections>
+                            <action selector="getContextHelp:" target="-1" id="S7m-Fc-i7b"/>
+                        </connections>
+                    </button>
+                    <textField horizontalHuggingPriority="251" verticalHuggingPriority="750" fixedFrame="YES" translatesAutoresizingMaskIntoConstraints="NO" id="ruV-Zb-fok">
+                        <rect key="frame" x="76" y="35" width="302" height="17"/>
+                        <autoresizingMask key="autoresizingMask" flexibleMaxX="YES" flexibleMinY="YES"/>
+                        <textFieldCell key="cell" scrollable="YES" lineBreakMode="clipping" sendsActionOnEndEditing="YES" title="Or activate this button for context-sensitive help." id="V9y-Et-nhi">
+                            <font key="font" metaFont="system"/>
+                            <color key="textColor" name="labelColor" catalog="System" colorSpace="catalog"/>
+                            <color key="backgroundColor" name="controlColor" catalog="System" colorSpace="catalog"/>
+                        </textFieldCell>
+                    </textField>
                 </subviews>
                 <constraints>
+                    <constraint firstAttribute="bottom" secondItem="tVe-CU-hCi" secondAttribute="bottom" constant="20" symbolic="YES" id="2fi-cr-Vht"/>
                     <constraint firstItem="PEG-1y-oDG" firstAttribute="top" secondItem="X1z-g4-M4P" secondAttribute="bottom" constant="8" id="3Rb-WZ-isR"/>
-                    <constraint firstAttribute="bottom" secondItem="PEG-1y-oDG" secondAttribute="bottom" constant="20" symbolic="YES" id="5wR-n5-9Rf"/>
                     <constraint firstItem="PEG-1y-oDG" firstAttribute="leading" secondItem="X1z-g4-M4P" secondAttribute="leading" id="CGo-6Z-ewC"/>
                     <constraint firstItem="X1z-g4-M4P" firstAttribute="top" secondItem="EiT-Mj-1SZ" secondAttribute="top" constant="20" id="D6c-hx-zoG"/>
                     <constraint firstItem="X1z-g4-M4P" firstAttribute="leading" secondItem="EiT-Mj-1SZ" secondAttribute="leading" constant="20" id="QoS-j7-h0k"/>
                     <constraint firstItem="PEG-1y-oDG" firstAttribute="trailing" secondItem="X1z-g4-M4P" secondAttribute="trailing" id="Zi3-Yn-LK2"/>
+                    <constraint firstItem="tVe-CU-hCi" firstAttribute="top" secondItem="PEG-1y-oDG" secondAttribute="bottom" constant="8" symbolic="YES" id="a5Z-mH-Lp7"/>
                     <constraint firstAttribute="trailing" secondItem="X1z-g4-M4P" secondAttribute="trailing" constant="20" id="dHP-3Z-Fmf"/>
+                    <constraint firstItem="tVe-CU-hCi" firstAttribute="leading" secondItem="PEG-1y-oDG" secondAttribute="leading" id="hFa-Z6-Xh2"/>
                 </constraints>
             </view>
-            <point key="canvasLocation" x="336" y="259.5"/>
+            <point key="canvasLocation" x="425" y="479.5"/>
         </window>
     </objects>
+    <resources>
+        <image name="NSInfo" width="32" height="32"/>
+    </resources>
 </document>

data/documentation_project/HelpViewerApp/HelpViewerApp/Info-free.plist

@@ -3,7 +3,7 @@
 <plist version="1.0">
 <dict>
 	<key>CFBundleHelpBookFolder</key>
-	<string>Middlemac (free).help</string>
+	<string>Middlemac_(free).help</string>
 	<key>CFBundleDevelopmentRegion</key>
 	<string>en</string>
 	<key>CFBundleExecutable</key>
@@ -19,15 +19,15 @@
 	<key>CFBundlePackageType</key>
 	<string>APPL</string>
 	<key>CFBundleShortVersionString</key>
-	<string>1.0</string>
+	<string>$(MIDDLEMAC_CFBundleShortVersionString)</string>
 	<key>CFBundleSignature</key>
 	<string>????</string>
 	<key>CFBundleVersion</key>
-	<string>1</string>
+	<string>$(MIDDLEMAC_CFBundleVersion)</string>
 	<key>LSMinimumSystemVersion</key>
 	<string>$(MACOSX_DEPLOYMENT_TARGET)</string>
 	<key>NSHumanReadableCopyright</key>
-	<string>Copyright © 2016 Jim Derry. All rights reserved.</string>
+	<string>$(MIDDLEMAC_NSHumanReadableCopyright)</string>
 	<key>NSMainNibFile</key>
 	<string>MainMenu</string>
 	<key>CFBundleHelpBookName</key>

data/documentation_project/HelpViewerApp/HelpViewerApp/Info-pro.plist

@@ -3,7 +3,7 @@
 <plist version="1.0">
 <dict>
 	<key>CFBundleHelpBookFolder</key>
-	<string>Middlemac (pro).help</string>
+	<string>Middlemac_(pro).help</string>
 	<key>CFBundleDevelopmentRegion</key>
 	<string>en</string>
 	<key>CFBundleExecutable</key>
@@ -19,15 +19,15 @@
 	<key>CFBundlePackageType</key>
 	<string>APPL</string>
 	<key>CFBundleShortVersionString</key>
-	<string>1.0</string>
+	<string>$(MIDDLEMAC_CFBundleShortVersionString)</string>
 	<key>CFBundleSignature</key>
 	<string>????</string>
 	<key>CFBundleVersion</key>
-	<string>1</string>
+	<string>$(MIDDLEMAC_CFBundleVersion)</string>
 	<key>LSMinimumSystemVersion</key>
 	<string>$(MACOSX_DEPLOYMENT_TARGET)</string>
 	<key>NSHumanReadableCopyright</key>
-	<string>Copyright © 2016 Jim Derry. All rights reserved.</string>
+	<string>$(MIDDLEMAC_NSHumanReadableCopyright)</string>
 	<key>NSMainNibFile</key>
 	<string>MainMenu</string>
 	<key>CFBundleHelpBookName</key>

data/documentation_project/HelpViewerApp/HelpViewerApp/versions.xcconfig

@@ -0,0 +1,8 @@
+// Contains project-wide defaults that are exposed to the environment during
+// builds, including to Info.plist files. All dependencies should refer to
+// these variables to avoid having to change them in every one of your
+// plists.
+
+MIDDLEMAC_CFBundleShortVersionString = 3.0.0
+MIDDLEMAC_CFBundleVersion = 3.0.0
+MIDDLEMAC_NSHumanReadableCopyright = Copyright ©2018 Jim Derry. All Rights Reserved.

data/documentation_project/HelpViewerApp/README.md

@@ -2,42 +2,22 @@ HelpViewApp README
 ==================
 
 This simple app can display the sample `documentation_project` in Apple’s Help
-Viewer application, and demonstrates how you might integrate **Middlemac** with
+Viewer application, and demonstrates how you might integrate _Middlemac_ with
 your Xcode project.
 
-It consists of the following four targets:
-
-`Help (free)` 
-
-  : This is an external build system target that uses **Middlemac** to generate
-    the help files for the `HelpViewerApp (free)` target.
-  
-`Help (pro)`
-
-  : This is an external build system target that uses **Middlemac** to generate
-    the help files for the `HelpViewerApp (pro)` target.
+It consists of the following targets:
 
 `HelpViewerApp (free)`
 
   : The “free” version of this application will display the `:free` target in
-    the Help Viewer. It uses the target `Help (free)` as a build dependency.
+    the Help Viewer.
 
 `HelpViewerApp (pro)`
 
   : The “pro” version of this application will display the `:pro` target in the
-    Help Viewer.  It uses the target `Help (pro)` as a build dependency.
-
-
-## The Help file “build system”
+    Help Viewer.
 
-The build system is a bash script that executes the default version of
-**Middleman** on your system. In order to prevent re-building the help file
-every time you run the HelpViewerApp it tries to remember that it was already
-built using a marker file in the Xcode build directory.
 
-It's a simple script and doesn’t try at all to know whether or not you’ve made
-changes to the source. If you want to rebuild the help files using the build
-command in Xcode, then perform **Clean**, which will remove this marker file.
+## Build your files
 
-Xcode’s **Clean** will _not_ remove the built help book using this script; you
-are free to make the script do so if you want, however.
+Make sure you build the help files in your terminal, first!

data/documentation_project/config.rb

@@ -1,9 +1,19 @@
 ################################################################################
 #  config.rb
-#    Configure Middleman to generate Apple HelpBook containers for multiple
+#    Configure Middleman to generate Apple Help Book containers for multiple
 #    targets.
 ################################################################################
 
+##########################################################################
+# Build System Integration
+#  If built from Xcode (or another build system you create), then setup
+#  some of our variables automatically from the environment variables
+#  that the build system sets for us. You’ll have to set up Xcode to
+#  set this environment variable, of course.
+##########################################################################
+version_app = ENV.has_key?('MIDDLEMAC_CFBundleShortVersionString') ? ENV['MIDDLEMAC_CFBundleShortVersionString'] : nil
+
+
 ##########################################################################
 # Targets Configuration
 #  Middlemac is capable of building multiple targets for variants of your
@@ -40,12 +50,13 @@ config[:target] = :pro
 # If specified a target-specific icon will be used as the help book icon by
 # Apple’s help viewer. This path must be relative to the location of the
 # `Resources` directory per Apple’s specification. If `nil` (or not present) 
-# then the default `shared/icon_32x32@2x.png` will be used.
+# then the default `SharedGlobalAssets/convention/icon_32x32@2x.png` will be
+# used.
 
 # :CFBundleName
 # This value will be used for correct .plists and .strings setup, and will
 # determine final .help directory name. All targets should use the same
-# :CFBundleName. Built targets will be named `CFBundleName (target).help`.
+# :CFBundleName. Built targets will be named `CFBundleName_(target).help`.
 # This is *not* intended to be a product name, which is defined below.
 
 # :ProductName
@@ -61,6 +72,10 @@ config[:target] = :pro
 # You can specify different product URIs for each build target. The URI
 # 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.
+# This typically appears when you print a Help Book.
+
 # (other)
 # You can specify additional .plist and .strings keys here, too. Have a look
 # at `Info.plist.erb` and `InfoPlist.strings.erb`; simply use the exact key
@@ -76,11 +91,12 @@ config[:targets] = {
         :free =>
             {
                 :CFBundleID       => 'com.balthisar.middlemac.free.help',
-                :HPDBookIconPath  => 'shared/free-icon_32x32@2x.png',
+                :HPDBookIconPath  => 'SharedGlobalArt/free-icon_32x32@2x.png',
                 :CFBundleName     => 'Middlemac',
                 :ProductName      => 'Middlemac',
-                :ProductVersion   => '2.0.0',
+                :ProductVersion   => version_app || '3.1.1',
                 :ProductURI       => 'http://www.balthisar.com/developer',
+                :ProductCopyright => '© 2021 Jim Derry. All rights reserved.',
                 :features =>
                     {
                         :feature_advertise_pro        => true,
@@ -93,11 +109,12 @@ config[:targets] = {
         :pro =>
             {
                 :CFBundleID       => 'com.balthisar.middlemac.pro.help',
-                :HPDBookIconPath  => 'shared/pro-icon_32x32@2x.png',
+                :HPDBookIconPath  => 'SharedGlobalArt/pro-icon_32x32@2x.png',
                 :CFBundleName     => 'Middlemac',
                 :ProductName      => 'Middlemac Pro',
-                :ProductVersion   => '2.0.0',
+                :ProductVersion   => version_app || '3.1.1',
                 :ProductURI       => 'http://www.balthisar.com/developer',
+                :ProductCopyright => '© 2021 Jim Derry. All rights reserved.',
                 :features =>
                     {
                         :feature_advertise_pro        => false,
@@ -121,64 +138,6 @@ config[:target_magic_images] = true
 config[:target_magic_word] = 'all'
 
 
-################################################################
-# Page Groups Configuration
-#  Middlemac uses the `middleman-pagegroups` gem in order to
-#  automate nearly all of the navigation in your help book
-#  project.
-################################################################
-activate :MiddlemanPageGroups do |config|
-
-  # Indicate whether or not numeric file name prefixes used for sorting
-  # pages should be eliminated during output. This results in cleaner
-  # URI's. Helpers such as `page_name` and Middleman helpers such as
-  # `page_class` will reflect the pretty name.
-  config.strip_file_prefixes = true
-
-  # Indicates whether or not Middleman's built-in `page_class` helper is
-  # extended to include the page_group and page_name.
-  config.extend_page_class = true
-
-  # the following options provide defaults for the built-in helpers and
-  # sample partials. They'll also work in your own partials and helpers.
-
-  config.nav_breadcrumbs_class = 'breadcrumbs'
-  config.nav_breadcrumbs_alt_class = 'breadcrumbs'
-  config.nav_breadcrumbs_alt_label = 'Current page'
-  config.nav_brethren_class = 'table_contents'
-  config.nav_brethren_index_class = 'related-topics'
-  config.nav_legitimate_children_class = 'table_contents'
-  config.nav_prev_next_class = 'navigate_prev_next'
-  config.nav_prev_next_label_prev = 'Previous'
-  config.nav_prev_next_label_next = 'Next'
-  config.nav_toc_index_class = 'help_map'
-
-end
-
-
-################################################################
-# Extras Configuration
-#  Middlemac uses the `middlemac-extras` gem in order to
-#  provide other useful tools. They can be configured here.
-################################################################
-activate :MiddlemacExtras do |config|
-
-  # If set to true, then the enhanced image_tag helper will be used
-  # to include @2x srcset automatically, if the image asset exists.
-  config.retina_srcset = true
-
-  # If set to true then the `image_tag` helper will work for images even
-  # if you don't specify an extension, but only if a file exists on disk
-  # that has one of the extensions in :img_auto_extensions_order.
-  config.img_auto_extensions = true
-
-  # Set this to an array of extensions in the order of precedence for
-  # using `image_tag` without file extensions.
-  config.img_auto_extensions_order = %w(.svg .png .jpg .jpeg .gif .tiff .tif)
-
-end
-
-
 ################################################################
 # Configuration
 #  Change the option values to suit your needs.
@@ -191,16 +150,49 @@ activate :Middlemac do |options|
   # named in the form `#{CFBundleName} (target).help`. You might want to target
   # the `Resources` directory of your XCode project so that your XCode project
   # is always up to date.
-  options.Help_Output_Location = nil
+  options.help_output_location = nil
+
+  # Indicates whether or not spaces should be avoided in the name of the help
+  # bundle. The default value for backwards compatibility is `true` because
+  # some tools, such a make, don't like spaces.
+  options.help_output_avoid_spaces = true
+
+  # Indicates whether or not the `help_output_location` includes the `(target)`
+  # prefix in the help book bundle name. The default, `true`, will result in
+  # `#{CFBundleName} (target).help`, which is the historical behavior. Setting
+  # this to `false` will result in a help book named `#{CFBundleName}.help`,
+  # instead. This can be useful if you are building help books from scripts via
+  # XCode, and you set `help_output_location` to `ENV['BUILT_PRODUCTS_DIR']`.
+  # @return [Boolean] `true` or `false` to enable or disable this behavior.
+  options.help_output_use_target = true
 
-  # Indicates the name of the breadcrumbs helper to use for breadcrumbs.
-  # Built-in breadcrumbs are "nav_breadcrumbs" and "nav_breadcrumbs_alt".
-  # Change to `nil` to disable breadcrumbs completely.
-  options.Breadcrumbs = 'nav_breadcrumbs'
+  # If set to true, then the enhanced image_tag helper will be used
+  # to include @2x, @3x, and @4x srcset automatically, if the image assets
+  # exist.
+  options.retina_srcset = true
+
+  # If set to an array of possible image extension values, then the `image_tag`
+  # helper will work for images even if you don't specify an extension, but only
+  # if a file exists in the sitemap that has one of these extensions. Set this to
+  # an array of extensions in the order of precedence.
+  options.img_auto_extensions = %w(.svg .png .jpg .jpeg .gif .tiff .tif)
+
+  # If set to true, some of the templates will show additional information
+  # when pages are generated, such as contents of md_links and md_images.
+  # Also, JavaScript redirects will be omitted from naked pages, and the
+  # meta refresh will be set to 100 seconds for such pages.
+  options.show_debug = false
+
+  # If set to true, Apple will provide next page and previous page navigation
+  # gadgets automatically at the bottom of each content page. Apple itself
+  # does not use this feature currently.
+  options.show_previous_next = false
 
-  # This was removed in Middleman version 4.0. We are reintroducing it
-  # as a Middlemac feature.
-  options.partials_dir = 'Resources/Base.lproj/assets/partials'
+  # Indicate whether or not numeric file name prefixes used for sorting
+  # pages should be eliminated during output. This results in cleaner
+  # URI's. Helpers such as `page_name` and Middleman helpers such as
+  # `page_class` will reflect the pretty name.
+  config.strip_file_prefixes = true
 
 end #activate
 
@@ -214,42 +206,33 @@ end #activate
 #===============================================================
 # Setup directories to mirror Help Book directory layout.
 #===============================================================
-set :source,       'Contents'
-set :build_dir,    'Contents (build)'
-
-set :fonts_dir,    'Resources/Base.lproj/assets/fonts'
-set :images_dir,   'Resources/Base.lproj/assets/images'
-set :js_dir,       'Resources/Base.lproj/assets/javascripts'
-set :css_dir,      'Resources/Base.lproj/assets/stylesheets'
-
-set :layouts_dir,  'Resources/Base.lproj/assets/_layouts'
-set :data_dir,     'Contents/Resources/Base.lproj/assets/_data'
-
-
-#===============================================================
-# Ignore items we don't want copied to the destination
-#===============================================================
-#ignore 'data/*'
+set :source,         'Contents'
+set :data_dir,       'Contents/Resources/SharedGlobalAssets/_data'
+set :assets_dir,     'Resources/SharedGlobalAssets'
+set :partials_dir,   '_partials'
+set :layouts_dir,    '_layouts'
+set :convention_dir, 'convention'
+set :css_dir,        'css'
+set :fonts_dir,      'fonts'
+set :images_dir,     'images'
+set :js_dir,         'js'
 
 
 #===============================================================
-# All of our links and assets must be relative to the file
-# location, and never absolute. However we will *use* absolute
-# paths with root being the source directory; they will be
-# converted to relative paths at build.
+# Other required setup. Note: don't use relative assets or
+# links here, as Apple require very specific hrefs.
 #===============================================================
 set :strip_index_file, false
-set :relative_links, true
-activate :relative_assets do |options|
-  options.rewrite_ignore = [/image_sizes\.css/]
-end
 
 
 #===============================================================
-# Default to Apple-recommended HTML 4.01 layout.
+# Default to HTML5 Layout.
+# Specify layouts from most specific to least specific.
 #===============================================================
-set :haml, :format => :html4
-page 'Resources/Base.lproj/*.html', :layout => :'layout-html4'
+Haml::TempleEngine.disable_option_validator!
+set :haml, :format => :html5
+page 'Resources/*.lproj/asides/*.html', :layout => :'layout-apple-modern-aside'
+page 'Resources/*.lproj/*.html', :layout => :'layout-apple-modern'
 
 
 #===============================================================