Merge pull request #57 from CogTool-Modern/feature/help-menu-user-guide

Adding a macOS Help Book
CogTool-Modern · Aug 21, 2020 · 2fdca0f · 2fdca0f
2 parents 83a01fc + 10b5dbd
commit 2fdca0f
Show file tree

Hide file tree

Showing 276 changed files with 14,939 additions and 6 deletions.
diff --git a/build.xml b/build.xml
@@ -80,11 +80,46 @@
 		</copy>
 
 	</target>
+
+	<condition property="os.mac">
+		<os family="mac" />
+	</condition>
+
+	<target name="help-copy" description="Create a Help Bundle for Mac from the documentation (docs/)">
+		<!-- Build the Jekyll site in a special way that will work inside of Help Viewer app -->
+		<exec dir="${basedir}/docs" executable="/bin/sh">
+			<arg value="-c" />
+			<arg value="jekyll build --config _config.yml,_config_helpbundle.yml" />
+		</exec>
+		<!-- Copy the Mac Help Bundle files -->
+		<copy todir="${resdir}/CogTool.tmp/Contents/Resources/CogTool.help/Contents/Resources/en.lproj/" overwrite="true">
+			<fileset dir="docs/_site/help"/>
+		</copy>
+	</target>
+
+	<target if="os.mac" name="help-index" description="Builds the index for Help Bundles and Spotlight">
+		<!-- Create a helpindex file for macOS's Spotlight, for searching through Help topics. hituil is macOS only. -->
+		<exec dir="${resdir}/CogTool.tmp/Contents/Resources/CogTool.help/Contents/Resources/en.lproj/" executable="/bin/sh">
+			<arg value="-c" />
+			<arg value="hiutil -I corespotlight -Caf help.cshelpindex . -v -v" />
+		</exec>
+
+		<!-- Help Menu Search -->
+		<exec dir="${resdir}/CogTool.tmp/Contents/Resources/CogTool.help/Contents/Resources/en.lproj/" executable="/bin/sh">
+			<arg value="-c" />
+			<arg value="hiutil -I lsm -Caf help.helpindex . -v -v" />
+		</exec>
+
+		<!-- Clear the help cache -->
+		<exec dir="${resdir}/CogTool.tmp/Contents/Resources/CogTool.help/Contents/Resources/en.lproj/" executable="hiutil">
+			<arg value="-P" />
+		</exec>
+	</target>
 
 	<taskdef name="launch4j" classname="net.sf.launch4j.ant.Launch4jTask" classpath="${launch4j.dir}/launch4j.jar:${launch4j.dir}/lib/xstream.jar" />
 
 	<!-- Packages build output and resources into runable packages., -->
-	<target name="package" depends="clean,compile" description="Packages build output and resources into runable packages.">
+	<target name="package" depends="clean,compile, help-copy, help-index" description="Packages build output and resources into runable packages.">
 
 		<tstamp>
 			<format property="buildtime" pattern="MM/dd/yyyy-hh:mm" />

diff --git a/docs/_config.yml b/docs/_config.yml
@@ -20,16 +20,17 @@ category_dir: /
 #baseurl: /path/to/blog 
 baseurl: ''
 
+# When developing web pages for the help bundle you'll want to add this to the front of all links and css urls.
+# When building the help bundle set this to empty string. jekyll b --config _config.yml,_config_helpbundle.yml
+helpbundledevbaseurl: '/help/'
+
 # The URL of your actual domain. This will be used to make absolute links in the RSS feed.
-url: https://cogtool-modern.github.io/cogtool/
+weburl: https://cogtool-modern.github.io/cogtool/
 
 #### Under the Hood Stuff #####
 
 # Makes pretty (descriptive) permalinks. See Jekyll docs for alternatives.
 permalink: pretty
 
-# How many articles do you wish to appear on the front page:
-paginate: 6
-
 # Exclude metadata and development time dependencies (like Grunt plugins)
 exclude: [README.markdown, package.json, grunt.js, Gruntfile.js, Gruntfile.coffee, node_modules]
diff --git a/docs/_config_helpbundle.yml b/docs/_config_helpbundle.yml
@@ -0,0 +1,3 @@
+helpbundledevbaseurl: ''
+# Helps to have all pages in one directory with their resources (CSS) instead of folders. (This because abs URLs are weird within Help Viewer app)
+permalink: none
diff --git a/docs/_layouts/app_help.html b/docs/_layouts/app_help.html
@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN">
+
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+    <head>
+        <title>{{ page.title }} </title>
+        <meta name="robots" content="index, anchors" />
+        <meta name="description" content="{{ page.title }}" />
+        <meta name="keywords" content="{{ page.keywords }}" />
+        <link href="{{ site.helpbundledevbaseurl }}machelp.css" rel="stylesheet">
+        <link href="{{ site.helpbundledevbaseurl }}style.css" rel="stylesheet">        
+    </head>
+    <body>
+
+        <!--top navigation area-->
+        <div id="navbox" class="gradient">
+            <div id="navleftbox">
+                <a class="navlink_left" href="{{ site.helpbundledevbaseurl }}index.html">Home</a>
+            </div>
+            <div id="navrightbox">
+                <a class="navlink_right" href="{{ site.helpbundledevbaseurl }}index.html">Index</a>
+            </div>
+        </div><!--closes top navigation area-->
+
+        <!--page head-->
+        <div id="headerbox">
+            <div id="iconbox">
+                <img id="iconimg" src="{{ site.helpbundledevbaseurl }}appicon.png" alt="CogTool" height="32" width="32" />
+            </div>
+            <div id="pagetitle">
+                <a name="{{ page.title }}"></a>
+                <h1>{{ page.title }}</h1>
+            </div>
+        </div><!--closes page header-->
+
+        {{ content }}
+
+    </body>
+</html>
diff --git a/docs/assets/user-guide/CogToolUserGuide_1_2 2.docx b/docs/assets/user-guide/CogToolUserGuide_1_2 2.docx
diff --git a/docs/assets/user-guide/CogToolUserGuide_1_2 2.pdf b/docs/assets/user-guide/CogToolUserGuide_1_2 2.pdf
diff --git a/docs/assets/user-guide/media/image1.jpg b/docs/assets/user-guide/media/image1.jpg
diff --git a/docs/assets/user-guide/media/image10.png b/docs/assets/user-guide/media/image10.png
diff --git a/docs/assets/user-guide/media/image100.png b/docs/assets/user-guide/media/image100.png
diff --git a/docs/assets/user-guide/media/image101.png b/docs/assets/user-guide/media/image101.png
diff --git a/docs/assets/user-guide/media/image102.png b/docs/assets/user-guide/media/image102.png
diff --git a/docs/assets/user-guide/media/image103.png b/docs/assets/user-guide/media/image103.png
diff --git a/docs/assets/user-guide/media/image104.png b/docs/assets/user-guide/media/image104.png
diff --git a/docs/assets/user-guide/media/image105.png b/docs/assets/user-guide/media/image105.png
diff --git a/docs/assets/user-guide/media/image106.jpg b/docs/assets/user-guide/media/image106.jpg
diff --git a/docs/assets/user-guide/media/image107.jpg b/docs/assets/user-guide/media/image107.jpg
diff --git a/docs/assets/user-guide/media/image108.png b/docs/assets/user-guide/media/image108.png
diff --git a/docs/assets/user-guide/media/image109.jpg b/docs/assets/user-guide/media/image109.jpg
diff --git a/docs/assets/user-guide/media/image110.jpg b/docs/assets/user-guide/media/image110.jpg
diff --git a/docs/assets/user-guide/media/image111.png b/docs/assets/user-guide/media/image111.png
diff --git a/docs/assets/user-guide/media/image112.jpg b/docs/assets/user-guide/media/image112.jpg
diff --git a/docs/assets/user-guide/media/image113.jpg b/docs/assets/user-guide/media/image113.jpg
diff --git a/docs/assets/user-guide/media/image114.jpg b/docs/assets/user-guide/media/image114.jpg
diff --git a/docs/assets/user-guide/media/image115.png b/docs/assets/user-guide/media/image115.png
diff --git a/docs/assets/user-guide/media/image116.jpg b/docs/assets/user-guide/media/image116.jpg
diff --git a/docs/assets/user-guide/media/image117.jpg b/docs/assets/user-guide/media/image117.jpg
diff --git a/docs/assets/user-guide/media/image118.jpg b/docs/assets/user-guide/media/image118.jpg
diff --git a/docs/assets/user-guide/media/image119.jpg b/docs/assets/user-guide/media/image119.jpg
diff --git a/docs/assets/user-guide/media/image12.png b/docs/assets/user-guide/media/image12.png
diff --git a/docs/assets/user-guide/media/image120.jpg b/docs/assets/user-guide/media/image120.jpg
diff --git a/docs/assets/user-guide/media/image121.jpg b/docs/assets/user-guide/media/image121.jpg
diff --git a/docs/assets/user-guide/media/image122.png b/docs/assets/user-guide/media/image122.png
diff --git a/docs/assets/user-guide/media/image123.jpg b/docs/assets/user-guide/media/image123.jpg
diff --git a/docs/assets/user-guide/media/image124.jpg b/docs/assets/user-guide/media/image124.jpg
diff --git a/docs/assets/user-guide/media/image126.png b/docs/assets/user-guide/media/image126.png
diff --git a/docs/assets/user-guide/media/image127.png b/docs/assets/user-guide/media/image127.png
diff --git a/docs/assets/user-guide/media/image128.png b/docs/assets/user-guide/media/image128.png
diff --git a/docs/assets/user-guide/media/image129.png b/docs/assets/user-guide/media/image129.png
diff --git a/docs/assets/user-guide/media/image130.jpg b/docs/assets/user-guide/media/image130.jpg
diff --git a/docs/assets/user-guide/media/image131.jpg b/docs/assets/user-guide/media/image131.jpg
diff --git a/docs/assets/user-guide/media/image132.jpg b/docs/assets/user-guide/media/image132.jpg
diff --git a/docs/assets/user-guide/media/image133.jpg b/docs/assets/user-guide/media/image133.jpg
diff --git a/docs/assets/user-guide/media/image134.png b/docs/assets/user-guide/media/image134.png
diff --git a/docs/assets/user-guide/media/image135.jpg b/docs/assets/user-guide/media/image135.jpg
diff --git a/docs/assets/user-guide/media/image136.jpg b/docs/assets/user-guide/media/image136.jpg
diff --git a/docs/assets/user-guide/media/image137.jpg b/docs/assets/user-guide/media/image137.jpg
diff --git a/docs/assets/user-guide/media/image138.jpg b/docs/assets/user-guide/media/image138.jpg
diff --git a/docs/assets/user-guide/media/image139.jpg b/docs/assets/user-guide/media/image139.jpg
diff --git a/docs/assets/user-guide/media/image14.png b/docs/assets/user-guide/media/image14.png
diff --git a/docs/assets/user-guide/media/image140.jpg b/docs/assets/user-guide/media/image140.jpg
diff --git a/docs/assets/user-guide/media/image141.jpg b/docs/assets/user-guide/media/image141.jpg
diff --git a/docs/assets/user-guide/media/image142.jpg b/docs/assets/user-guide/media/image142.jpg
diff --git a/docs/assets/user-guide/media/image143.jpg b/docs/assets/user-guide/media/image143.jpg
diff --git a/docs/assets/user-guide/media/image144.jpg b/docs/assets/user-guide/media/image144.jpg
diff --git a/docs/assets/user-guide/media/image145.jpg b/docs/assets/user-guide/media/image145.jpg
diff --git a/docs/assets/user-guide/media/image146.jpg b/docs/assets/user-guide/media/image146.jpg
diff --git a/docs/assets/user-guide/media/image147.jpg b/docs/assets/user-guide/media/image147.jpg
diff --git a/docs/assets/user-guide/media/image148.jpg b/docs/assets/user-guide/media/image148.jpg
diff --git a/docs/assets/user-guide/media/image149.jpg b/docs/assets/user-guide/media/image149.jpg
diff --git a/docs/assets/user-guide/media/image150.png b/docs/assets/user-guide/media/image150.png
diff --git a/docs/assets/user-guide/media/image151.png b/docs/assets/user-guide/media/image151.png
diff --git a/docs/assets/user-guide/media/image152.png b/docs/assets/user-guide/media/image152.png
diff --git a/docs/assets/user-guide/media/image153.jpg b/docs/assets/user-guide/media/image153.jpg
diff --git a/docs/assets/user-guide/media/image154.png b/docs/assets/user-guide/media/image154.png
diff --git a/docs/assets/user-guide/media/image155.png b/docs/assets/user-guide/media/image155.png
diff --git a/docs/assets/user-guide/media/image156.png b/docs/assets/user-guide/media/image156.png
diff --git a/docs/assets/user-guide/media/image157.png b/docs/assets/user-guide/media/image157.png
diff --git a/docs/assets/user-guide/media/image158.jpg b/docs/assets/user-guide/media/image158.jpg
diff --git a/docs/assets/user-guide/media/image159.png b/docs/assets/user-guide/media/image159.png
diff --git a/docs/assets/user-guide/media/image16.jpg b/docs/assets/user-guide/media/image16.jpg
diff --git a/docs/assets/user-guide/media/image160.png b/docs/assets/user-guide/media/image160.png
diff --git a/docs/assets/user-guide/media/image161.jpg b/docs/assets/user-guide/media/image161.jpg
diff --git a/docs/assets/user-guide/media/image162.png b/docs/assets/user-guide/media/image162.png
diff --git a/docs/assets/user-guide/media/image163.png b/docs/assets/user-guide/media/image163.png
diff --git a/docs/assets/user-guide/media/image164.png b/docs/assets/user-guide/media/image164.png
diff --git a/docs/assets/user-guide/media/image165.png b/docs/assets/user-guide/media/image165.png
diff --git a/docs/assets/user-guide/media/image166.jpg b/docs/assets/user-guide/media/image166.jpg
diff --git a/docs/assets/user-guide/media/image17.jpg b/docs/assets/user-guide/media/image17.jpg
diff --git a/docs/assets/user-guide/media/image18.png b/docs/assets/user-guide/media/image18.png
diff --git a/docs/assets/user-guide/media/image182.png b/docs/assets/user-guide/media/image182.png
diff --git a/docs/assets/user-guide/media/image183.jpg b/docs/assets/user-guide/media/image183.jpg
diff --git a/docs/assets/user-guide/media/image185.png b/docs/assets/user-guide/media/image185.png
diff --git a/docs/assets/user-guide/media/image186.png b/docs/assets/user-guide/media/image186.png
diff --git a/docs/assets/user-guide/media/image187.png b/docs/assets/user-guide/media/image187.png
diff --git a/docs/assets/user-guide/media/image188.jpg b/docs/assets/user-guide/media/image188.jpg
diff --git a/docs/assets/user-guide/media/image19.png b/docs/assets/user-guide/media/image19.png
diff --git a/docs/assets/user-guide/media/image2.jpg b/docs/assets/user-guide/media/image2.jpg
diff --git a/docs/assets/user-guide/media/image20.png b/docs/assets/user-guide/media/image20.png
diff --git a/docs/assets/user-guide/media/image21.jpg b/docs/assets/user-guide/media/image21.jpg
diff --git a/docs/assets/user-guide/media/image22.jpg b/docs/assets/user-guide/media/image22.jpg
diff --git a/docs/assets/user-guide/media/image23.png b/docs/assets/user-guide/media/image23.png
diff --git a/docs/assets/user-guide/media/image237.png b/docs/assets/user-guide/media/image237.png
diff --git a/docs/assets/user-guide/media/image238.png b/docs/assets/user-guide/media/image238.png
diff --git a/docs/assets/user-guide/media/image239.jpg b/docs/assets/user-guide/media/image239.jpg
diff --git a/docs/assets/user-guide/media/image24.png b/docs/assets/user-guide/media/image24.png
diff --git a/docs/assets/user-guide/media/image240.jpg b/docs/assets/user-guide/media/image240.jpg
diff --git a/docs/assets/user-guide/media/image241.jpg b/docs/assets/user-guide/media/image241.jpg
diff --git a/docs/assets/user-guide/media/image242.png b/docs/assets/user-guide/media/image242.png
diff --git a/docs/assets/user-guide/media/image243.png b/docs/assets/user-guide/media/image243.png
diff --git a/docs/assets/user-guide/media/image244.png b/docs/assets/user-guide/media/image244.png
diff --git a/docs/assets/user-guide/media/image245.png b/docs/assets/user-guide/media/image245.png
diff --git a/docs/assets/user-guide/media/image246.png b/docs/assets/user-guide/media/image246.png
diff --git a/docs/assets/user-guide/media/image247.png b/docs/assets/user-guide/media/image247.png
diff --git a/docs/assets/user-guide/media/image25.png b/docs/assets/user-guide/media/image25.png
diff --git a/docs/assets/user-guide/media/image26.jpg b/docs/assets/user-guide/media/image26.jpg
diff --git a/docs/assets/user-guide/media/image27.png b/docs/assets/user-guide/media/image27.png
diff --git a/docs/assets/user-guide/media/image28.jpg b/docs/assets/user-guide/media/image28.jpg
diff --git a/docs/assets/user-guide/media/image29.jpg b/docs/assets/user-guide/media/image29.jpg
diff --git a/docs/assets/user-guide/media/image30.jpg b/docs/assets/user-guide/media/image30.jpg
diff --git a/docs/assets/user-guide/media/image304.jpg b/docs/assets/user-guide/media/image304.jpg
diff --git a/docs/assets/user-guide/media/image305.jpg b/docs/assets/user-guide/media/image305.jpg
diff --git a/docs/assets/user-guide/media/image306.jpg b/docs/assets/user-guide/media/image306.jpg
diff --git a/docs/assets/user-guide/media/image307.jpg b/docs/assets/user-guide/media/image307.jpg
diff --git a/docs/assets/user-guide/media/image308.jpg b/docs/assets/user-guide/media/image308.jpg
diff --git a/docs/assets/user-guide/media/image309.png b/docs/assets/user-guide/media/image309.png
diff --git a/docs/assets/user-guide/media/image31.jpg b/docs/assets/user-guide/media/image31.jpg
diff --git a/docs/assets/user-guide/media/image310.png b/docs/assets/user-guide/media/image310.png
diff --git a/docs/assets/user-guide/media/image311.jpg b/docs/assets/user-guide/media/image311.jpg
diff --git a/docs/assets/user-guide/media/image312.jpg b/docs/assets/user-guide/media/image312.jpg
diff --git a/docs/assets/user-guide/media/image313.png b/docs/assets/user-guide/media/image313.png
diff --git a/docs/assets/user-guide/media/image314.png b/docs/assets/user-guide/media/image314.png
diff --git a/docs/assets/user-guide/media/image315.jpg b/docs/assets/user-guide/media/image315.jpg
diff --git a/docs/assets/user-guide/media/image32.png b/docs/assets/user-guide/media/image32.png
diff --git a/docs/assets/user-guide/media/image323.jpg b/docs/assets/user-guide/media/image323.jpg
diff --git a/docs/assets/user-guide/media/image325.jpg b/docs/assets/user-guide/media/image325.jpg
diff --git a/docs/assets/user-guide/media/image327.png b/docs/assets/user-guide/media/image327.png
diff --git a/docs/assets/user-guide/media/image328.jpg b/docs/assets/user-guide/media/image328.jpg
diff --git a/docs/assets/user-guide/media/image329.png b/docs/assets/user-guide/media/image329.png
diff --git a/docs/assets/user-guide/media/image33.jpg b/docs/assets/user-guide/media/image33.jpg
diff --git a/docs/assets/user-guide/media/image333.jpg b/docs/assets/user-guide/media/image333.jpg
diff --git a/docs/assets/user-guide/media/image34.jpg b/docs/assets/user-guide/media/image34.jpg
diff --git a/docs/assets/user-guide/media/image343.jpg b/docs/assets/user-guide/media/image343.jpg
diff --git a/docs/assets/user-guide/media/image344.jpg b/docs/assets/user-guide/media/image344.jpg
diff --git a/docs/assets/user-guide/media/image345.jpg b/docs/assets/user-guide/media/image345.jpg
diff --git a/docs/assets/user-guide/media/image35.jpg b/docs/assets/user-guide/media/image35.jpg
diff --git a/docs/assets/user-guide/media/image352.jpg b/docs/assets/user-guide/media/image352.jpg
diff --git a/docs/assets/user-guide/media/image353.png b/docs/assets/user-guide/media/image353.png
diff --git a/docs/assets/user-guide/media/image354.jpg b/docs/assets/user-guide/media/image354.jpg
diff --git a/docs/assets/user-guide/media/image36.png b/docs/assets/user-guide/media/image36.png
diff --git a/docs/assets/user-guide/media/image365.jpg b/docs/assets/user-guide/media/image365.jpg
diff --git a/docs/assets/user-guide/media/image366.png b/docs/assets/user-guide/media/image366.png
diff --git a/docs/assets/user-guide/media/image367.png b/docs/assets/user-guide/media/image367.png
diff --git a/docs/assets/user-guide/media/image368.jpg b/docs/assets/user-guide/media/image368.jpg
diff --git a/docs/assets/user-guide/media/image37.jpg b/docs/assets/user-guide/media/image37.jpg
diff --git a/docs/assets/user-guide/media/image377.jpg b/docs/assets/user-guide/media/image377.jpg
diff --git a/docs/assets/user-guide/media/image378.jpg b/docs/assets/user-guide/media/image378.jpg
diff --git a/docs/assets/user-guide/media/image38.jpg b/docs/assets/user-guide/media/image38.jpg
diff --git a/docs/assets/user-guide/media/image39.png b/docs/assets/user-guide/media/image39.png
diff --git a/docs/assets/user-guide/media/image390.png b/docs/assets/user-guide/media/image390.png
diff --git a/docs/assets/user-guide/media/image392.jpg b/docs/assets/user-guide/media/image392.jpg
diff --git a/docs/assets/user-guide/media/image40.png b/docs/assets/user-guide/media/image40.png
diff --git a/docs/assets/user-guide/media/image409.jpg b/docs/assets/user-guide/media/image409.jpg
diff --git a/docs/assets/user-guide/media/image41.png b/docs/assets/user-guide/media/image41.png
diff --git a/docs/assets/user-guide/media/image42.png b/docs/assets/user-guide/media/image42.png
diff --git a/docs/assets/user-guide/media/image43.jpg b/docs/assets/user-guide/media/image43.jpg
diff --git a/docs/assets/user-guide/media/image437.png b/docs/assets/user-guide/media/image437.png
diff --git a/docs/assets/user-guide/media/image439.jpg b/docs/assets/user-guide/media/image439.jpg
diff --git a/docs/assets/user-guide/media/image44.jpg b/docs/assets/user-guide/media/image44.jpg
diff --git a/docs/assets/user-guide/media/image440.jpg b/docs/assets/user-guide/media/image440.jpg
diff --git a/docs/assets/user-guide/media/image441.jpg b/docs/assets/user-guide/media/image441.jpg
diff --git a/docs/assets/user-guide/media/image45.jpg b/docs/assets/user-guide/media/image45.jpg
diff --git a/docs/assets/user-guide/media/image457.png b/docs/assets/user-guide/media/image457.png
diff --git a/docs/assets/user-guide/media/image458.jpg b/docs/assets/user-guide/media/image458.jpg
diff --git a/docs/assets/user-guide/media/image459.jpg b/docs/assets/user-guide/media/image459.jpg
diff --git a/docs/assets/user-guide/media/image46.png b/docs/assets/user-guide/media/image46.png
diff --git a/docs/assets/user-guide/media/image47.png b/docs/assets/user-guide/media/image47.png
diff --git a/docs/assets/user-guide/media/image477.jpg b/docs/assets/user-guide/media/image477.jpg
diff --git a/docs/assets/user-guide/media/image48.jpg b/docs/assets/user-guide/media/image48.jpg
diff --git a/docs/assets/user-guide/media/image49.jpg b/docs/assets/user-guide/media/image49.jpg
diff --git a/docs/assets/user-guide/media/image5.png b/docs/assets/user-guide/media/image5.png
diff --git a/docs/assets/user-guide/media/image50.png b/docs/assets/user-guide/media/image50.png
diff --git a/docs/assets/user-guide/media/image51.jpg b/docs/assets/user-guide/media/image51.jpg
diff --git a/docs/assets/user-guide/media/image52.png b/docs/assets/user-guide/media/image52.png
diff --git a/docs/assets/user-guide/media/image53.png b/docs/assets/user-guide/media/image53.png
diff --git a/docs/assets/user-guide/media/image54.png b/docs/assets/user-guide/media/image54.png
diff --git a/docs/assets/user-guide/media/image55.jpg b/docs/assets/user-guide/media/image55.jpg
diff --git a/docs/assets/user-guide/media/image56.png b/docs/assets/user-guide/media/image56.png
diff --git a/docs/assets/user-guide/media/image57.png b/docs/assets/user-guide/media/image57.png
diff --git a/docs/assets/user-guide/media/image58.png b/docs/assets/user-guide/media/image58.png
diff --git a/docs/assets/user-guide/media/image59.png b/docs/assets/user-guide/media/image59.png
diff --git a/docs/assets/user-guide/media/image60.png b/docs/assets/user-guide/media/image60.png
diff --git a/docs/assets/user-guide/media/image609.jpg b/docs/assets/user-guide/media/image609.jpg
diff --git a/docs/assets/user-guide/media/image61.jpg b/docs/assets/user-guide/media/image61.jpg
diff --git a/docs/assets/user-guide/media/image610.png b/docs/assets/user-guide/media/image610.png
diff --git a/docs/assets/user-guide/media/image611.jpg b/docs/assets/user-guide/media/image611.jpg
diff --git a/docs/assets/user-guide/media/image6110.jpg b/docs/assets/user-guide/media/image6110.jpg
diff --git a/docs/assets/user-guide/media/image612.jpg b/docs/assets/user-guide/media/image612.jpg
diff --git a/docs/assets/user-guide/media/image614.jpg b/docs/assets/user-guide/media/image614.jpg
diff --git a/docs/assets/user-guide/media/image618.png b/docs/assets/user-guide/media/image618.png
diff --git a/docs/assets/user-guide/media/image619.jpg b/docs/assets/user-guide/media/image619.jpg
diff --git a/docs/assets/user-guide/media/image62.png b/docs/assets/user-guide/media/image62.png
diff --git a/docs/assets/user-guide/media/image620.png b/docs/assets/user-guide/media/image620.png
diff --git a/docs/assets/user-guide/media/image621.png b/docs/assets/user-guide/media/image621.png
diff --git a/docs/assets/user-guide/media/image622.jpg b/docs/assets/user-guide/media/image622.jpg
diff --git a/docs/assets/user-guide/media/image629.png b/docs/assets/user-guide/media/image629.png
diff --git a/docs/assets/user-guide/media/image63.jpg b/docs/assets/user-guide/media/image63.jpg
diff --git a/docs/assets/user-guide/media/image630.png b/docs/assets/user-guide/media/image630.png
diff --git a/docs/assets/user-guide/media/image631.jpg b/docs/assets/user-guide/media/image631.jpg
diff --git a/docs/assets/user-guide/media/image632.jpg b/docs/assets/user-guide/media/image632.jpg
diff --git a/docs/assets/user-guide/media/image633.jpg b/docs/assets/user-guide/media/image633.jpg
diff --git a/docs/assets/user-guide/media/image634.jpg b/docs/assets/user-guide/media/image634.jpg
diff --git a/docs/assets/user-guide/media/image635.jpg b/docs/assets/user-guide/media/image635.jpg
diff --git a/docs/assets/user-guide/media/image636.jpg b/docs/assets/user-guide/media/image636.jpg
diff --git a/docs/assets/user-guide/media/image637.jpg b/docs/assets/user-guide/media/image637.jpg
diff --git a/docs/assets/user-guide/media/image639.png b/docs/assets/user-guide/media/image639.png
diff --git a/docs/assets/user-guide/media/image64.png b/docs/assets/user-guide/media/image64.png
diff --git a/docs/assets/user-guide/media/image640.jpg b/docs/assets/user-guide/media/image640.jpg
diff --git a/docs/assets/user-guide/media/image65.png b/docs/assets/user-guide/media/image65.png
diff --git a/docs/assets/user-guide/media/image66.png b/docs/assets/user-guide/media/image66.png
diff --git a/docs/assets/user-guide/media/image67.png b/docs/assets/user-guide/media/image67.png
diff --git a/docs/assets/user-guide/media/image68.png b/docs/assets/user-guide/media/image68.png
diff --git a/docs/assets/user-guide/media/image69.png b/docs/assets/user-guide/media/image69.png
diff --git a/docs/assets/user-guide/media/image70.png b/docs/assets/user-guide/media/image70.png
diff --git a/docs/assets/user-guide/media/image71.jpg b/docs/assets/user-guide/media/image71.jpg
diff --git a/docs/assets/user-guide/media/image72.png b/docs/assets/user-guide/media/image72.png
diff --git a/docs/assets/user-guide/media/image73.jpg b/docs/assets/user-guide/media/image73.jpg
diff --git a/docs/assets/user-guide/media/image74.jpg b/docs/assets/user-guide/media/image74.jpg
diff --git a/docs/assets/user-guide/media/image75.jpg b/docs/assets/user-guide/media/image75.jpg
diff --git a/docs/assets/user-guide/media/image76.jpg b/docs/assets/user-guide/media/image76.jpg
diff --git a/docs/assets/user-guide/media/image77.jpg b/docs/assets/user-guide/media/image77.jpg
diff --git a/docs/assets/user-guide/media/image78.png b/docs/assets/user-guide/media/image78.png
diff --git a/docs/assets/user-guide/media/image79.png b/docs/assets/user-guide/media/image79.png
diff --git a/docs/assets/user-guide/media/image8.png b/docs/assets/user-guide/media/image8.png
diff --git a/docs/assets/user-guide/media/image80.jpg b/docs/assets/user-guide/media/image80.jpg
diff --git a/docs/assets/user-guide/media/image81.png b/docs/assets/user-guide/media/image81.png
diff --git a/docs/assets/user-guide/media/image82.jpg b/docs/assets/user-guide/media/image82.jpg
diff --git a/docs/assets/user-guide/media/image83.png b/docs/assets/user-guide/media/image83.png
diff --git a/docs/assets/user-guide/media/image84.png b/docs/assets/user-guide/media/image84.png
diff --git a/docs/assets/user-guide/media/image85.png b/docs/assets/user-guide/media/image85.png
diff --git a/docs/assets/user-guide/media/image86.png b/docs/assets/user-guide/media/image86.png
diff --git a/docs/assets/user-guide/media/image87.png b/docs/assets/user-guide/media/image87.png
diff --git a/docs/assets/user-guide/media/image88.jpg b/docs/assets/user-guide/media/image88.jpg
diff --git a/docs/assets/user-guide/media/image89.jpg b/docs/assets/user-guide/media/image89.jpg
diff --git a/docs/assets/user-guide/media/image9.png b/docs/assets/user-guide/media/image9.png
diff --git a/docs/assets/user-guide/media/image90.jpg b/docs/assets/user-guide/media/image90.jpg
diff --git a/docs/assets/user-guide/media/image91.jpg b/docs/assets/user-guide/media/image91.jpg
diff --git a/docs/assets/user-guide/media/image92.png b/docs/assets/user-guide/media/image92.png
diff --git a/docs/assets/user-guide/media/image93.jpg b/docs/assets/user-guide/media/image93.jpg
diff --git a/docs/assets/user-guide/media/image94.png b/docs/assets/user-guide/media/image94.png
diff --git a/docs/assets/user-guide/media/image95.png b/docs/assets/user-guide/media/image95.png
diff --git a/docs/assets/user-guide/media/image96.png b/docs/assets/user-guide/media/image96.png
diff --git a/docs/assets/user-guide/media/image97.png b/docs/assets/user-guide/media/image97.png
diff --git a/docs/assets/user-guide/media/image98.jpg b/docs/assets/user-guide/media/image98.jpg
diff --git a/docs/assets/user-guide/media/image99.png b/docs/assets/user-guide/media/image99.png
diff --git a/docs/feed.xml b/docs/feed.xml
@@ -1,5 +1,5 @@
 ---
-layout: rss-feed
+layout: null
 ---
 <?xml version="1.0" encoding="UTF-8"?>
 <rss version="2.0">

diff --git a/docs/help/00-front-matter.md b/docs/help/00-front-matter.md
@@ -0,0 +1,181 @@
+---
+title: Front matter
+date: 2012-05-23T03:04:25+00:00
+layout: app_help
+---
+# User Guide
+
+**Version 1.2**
+
+**May 23, 2012**
+
+Bonnie E. John<br>
+IBM T. J. Watson Research Center<br>
+Software Productivity<br>
+19 Skyline Drive, Hawthorne NY 10532<br>
+{{ site.weburl }}<br>
+Addendum to CogTool Version 1.2 © IBM 2012<br>
+CogTool User Guide Version 1.1 © Bonnie E. John and Carnegie Mellon University 2008, 2009
+
+### Addendum for CogTool Version 1.2 
+
+CogTool 1.2 is essentially the same as CogTool 1.1 for making
+storyboards and predicting skilled performance time. Therefore, this
+User Guide presents the new features of CogTool 1.2 here and then the
+User Guide for version 1.1 follows in its entirety.
+
+### New platforms for CogTool 1.2 
+
+CogTool 1.2 now runs in Windows 7, Mac OS 10.6 (Snow Leopard), and Mac
+OS 10.7 (Lion).
+
+### Improvements to the GUI in CogTool 1.2 
+
+**Widget Tool Tips**
+In response to user requests, we have expanded the tool tips on the
+Widget Toolbar in
+Frame Editing windows. The tooltips now contain the prose in
+**Appendix B: Types of Widgets and When to Use Them** (but continue to
+refer to that appendix if you want to see pictures of example
+widgets).
+![](/assets/user-guide/media/image2.jpg)
+**Transition Properties Pane now contains source & destination
+information** Formerly only available by rolling over a transition in
+a Design window, the source and destination of a transition are now
+displayed in the transition's property pane as well.
+![](/assets/user-guide/media/image5.png)
+
+### Changed or new functionality in CogTool 1.2 
+
+**Default starting position of the hands**
+Formerly defaulting to starting on the keyboard, our users told us
+that most of their tasks start with the user's hand on the mouse.
+CogTool 1.2 now defaults to starting with the hand on the mouse, if a
+mouse is one of the available devices.
+(This will not effect the initial starting position of the hands in
+existing models made with versions prior to 1.2.)
+**Numeric results in the Project Window can now be changed in the**
+**Preferences dialog**
+Prior to v1.2, the Project window always displayed the predictions of
+skilled task execution time in seconds with three decimal places.
+Users of CogTool found this misleading because the predictions are
+known to be within +-10% of what you would find if you could collect
+data of skilled users performing these tasks. To make communicating
+the results more plausible, we have added two adjustments in the
+Preferences dialog box.
+![](/assets/user-guide/media/image8.png)
+Setting the number of decimal places to 3 and not checking the
+"Display range" box retains the Project window as it appeared prior to
+version 1.2, as shown below.
+
+![](/assets/user-guide/media/image9.png)
+
+But you can now change this presentation of results. For example,
+setting the number of decimal places to 1 and checking the "Display
+range" box highlights the fact that GoogleNotebook is faster than the
+other two designs for this task, but Gmail and Wetpaint are not
+sufficiently different to be detected by CogTool models.
+
+![](/assets/user-guide/media/image10.png)
+
+You can reset all parameters to CogTool's default values (displaying 1
+decimal place, but no range) by clicking the new "Reset to Default
+Values" button.
+**Modeling dragging on touch screen devices.**
+You can now model dragging on touch screen devices with transitions
+called "Up Tap" and "Down Tap." Just use a Down-Tap self-transition on
+the widget where the drag starts and an Up-Tap transition on a widget
+where the drag ends. (See this explained for dragging with a mouse in
+Section 4.4.6.3 Dragging Over Text to Highlight It.)
+**Widgets can now have a remote label**
+Most widgets can now have what we call a "remote label" which will
+make using CogTool as a prototyping tool more realistic. For example,
+a group of check boxes often has some text asking a question that the
+user can answer by checking one or more of the checkboxes. This test
+is represented as a remote label of a standard checkbox widget, as
+shown below. The remote label is connected to the widget (or widget
+group) that owns it with a dashed line.
+![](/assets/user-guide/media/image12.png)
+The remote label is itself a widget of Type Text, so you can model
+interacting with it as you would any other text in an interface.
+If your interface is complex, it is possible that the remote label
+might be quite far from the widget that owns it, so when a widget is
+selected, you can find its remote label by clicking on the
+[Find] link, which will select the remote label (below).
+Likewise, when a remote label is selected, you can always find its
+owner by clicking on the link below
+"Remote Label Owner:"
+![](/assets/user-guide/media/image14.png)
+
+![](/assets/user-guide/media/image16.jpg)
+
+**CogTool User Guide**
+
+**Version 1.1**
+
+**17 September 2009**
+
+Bonnie E. John, Principle Investigator
+Human-Computer Interaction Institute
+School of Computer Science
+Carnegie Mellon University {{ site.weburl }}
+
+© 2008, 2009 Bonnie E. John and Carnegie Mellon University
+
+CogTool User Guide • 1
+
+### Acknowledgments
+
+The following people have contributed to CogTool. We would like to thank
+them for their hard work and patience with the process.
+
+Gus Prevas, Ken Koedinger, Peter Centgraf, Mike Horowitz, Alex Eiser,
+Alex Faaborg, Sandy Esch, Jason Cornwell, Lily Cho, Don Morrison,
+Samantha Konwinski, Carmen Jackson, Josh Ehlke, Ryan Myers, Diana Dill,
+Leigh Johnston, Chris Monti, Melissa Gallagher, Annie Luo, Brett Harris,
+Khaled Ziyaeen, Alonso Vera, Collin Green, Guy Pryzak, Mike Feary, Rick
+Lewis, Mason Smith, Andrew Howes, Peter Pirolli, Wai-Tat Fu, Victoria
+Bellotti, Dario Salvucci, Lance Sherry, Maricel Medina Mora, Marylin
+Hughes Blackmon, Peter Polson, Karl Fennel, and all the students in HCI
+Methods and Cognitive Crash Dummies courses at Carnegie Mellon, Stanford
+and professional conferences.
+
+This research was supported by funds from the Office of Naval Research,
+N00014-03-1-0086, NASA Ames Research Center, DSO National Laboratories,
+the Boeing Corp., NEC, and IBM. The views and conclusions contained in
+this document are those of the authors and should not be interpreted as
+representing the official policies, either expressed or implied, of the
+Office of Naval Research, NASA, DSO National Laboratories, Boeing, NEC,
+IBM or the U. S. Government.
+
+### Conventions for this User Guide
+
+CogTool runs on both Macintosh (10.3 and above) and Windows (XP and
+Vista) operating systems. Unless otherwise stated, this User Guide
+uses pictures from the Macintosh version, but it operates and looks
+almost the same on Windows platforms.
+There are several ways to accomplish most tasks in CogTool, often
+using menus from the menu bar, keyboard shortcuts, or context menus.
+In the body of this user guide, we generally present the procedures
+for these tasks using the menus from the menu bar, but we also list
+available shortcut keys in the left margin next to the appropriate
+commands as well as in **Appendix G: CogTool Shortcut Keys**. We list
+context menus in **Appendix H: CogTool Context Menus.**
+We capitalize the first letter of words that have specific meaning in
+CogTool, (e.g., Project, Frame, and Widget) and bold commands (e.g.,
+From the **File** menu, choose **New Project**). When we reference
+another section or appendix, we write the full name (with number and
+subtitle) and bold it (as in the previous paragraph).
+
+We use special graphics to denote the following items:
+<ul>
+<li class="icon fyi">Notes that explain the behavior of CogTool</li>
+<li class="icon tip">Tips for efficient or alternative ways to complete tasks</li>
+<li class="icon warning">Warnings of potential problems and ways to avoid them</li>
+<li class="icon remember">Information to remember while using CogTool</li>
+<li class="icon bug">Documented bugs in CogTool (bugs are fixed more often than the User Guide is revised, and so you may not encounter these bugs in your version of CogTool)</li>
+</ul>
+
+
+
+