--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/m-toolbox/html_help/help/mkhelpfiles.py	Wed Nov 23 19:22:13 2011 +0100
@@ -0,0 +1,203 @@
+#!/usr/bin/python
+# Filename: mkhelpfiles.py
+
+
+"""
+  mkhelpfiles.py
+  
+  Build MATLAB help files based on XML TOC. 
+  
+  Usage: mkhelpfiles.py -i helptoc.xml
+  
+  M Hewitson 01-03-07
+  
+  $Id: mkhelpfiles.py,v 1.3 2007/11/14 11:20:11 hewitson Exp $
+
+"""
+
+
+import glob
+import os
+import sys
+from   string import *
+import getopt
+import platform
+import time
+import datetime
+
+
+def extract(text, sub1, sub2):
+    """extract a substring between two substrings sub1 and sub2 in text"""
+    print(text.split(sub1))
+    return text.split(sub1)[-1].split(sub2)[0]
+
+#######################################################################
+#
+# mkdir
+#
+def _mkdir(newdir):
+  """works the way a good mkdir should :)
+      - already exists, silently complete
+      - regular file in the way, raise an exception
+      - parent directory(ies) does not exist, make them as well
+  """
+  if os.path.isdir(newdir):
+    pass
+  elif os.path.isfile(newdir):
+    raise OSError("a file with the same name as the desired " \
+              "dir, '%s', already exists." % newdir)
+  else:
+    head, tail = os.path.split(newdir)
+    if head and not os.path.isdir(head):
+      _mkdir(head)
+    #print "_mkdir %s" % repr(newdir)
+    if tail:
+      os.mkdir(newdir)
+  return None;    
+
+  
+
+######################################################################
+#  Main
+#
+def main():
+
+  try:
+    opts, args = getopt.getopt(sys.argv[1:], "i:", ["input="])
+  except getopt.GetoptError:
+    print(__doc__)
+    sys.exit(2)
+
+  # Default settings for database
+  tocfile   = ''
+
+  # process args
+  for o, a in opts:
+    if o in ("-i", "--input"):
+      tocfile = a
+      
+  # check for required fields
+  if tocfile=="":
+    print("\n### Incorrect inputs.")
+    print(__doc__)
+    sys.exit(2)
+
+  # Load XML file
+  try:
+    fin = open(tocfile);
+    allLines = fin.readlines();
+    fin.close()
+  except IOError:
+    print("# error opening file.")
+    sys.exit(-1)  
+  
+  # Load Template file
+  try:
+    fin = open('template.html');
+    templateFile = fin.read();
+    fin.close()
+  except IOError:
+    print("# error opening file.")
+    sys.exit(-1)  
+  
+  # Go through each line and look for 'target='  
+  entries = [];
+  
+  for l in allLines:
+    line = strip(l)    
+    if line.find("target=") > 0:
+      tmp      = split(line, "<")[1].split(">");
+      title    = strip(tmp[1])      
+      htmlfile = strip(tmp[0].split('"')[1])
+          
+      # If this is an html file we can continue
+      if htmlfile.endswith('.html'):
+        print "%s - %s" % (htmlfile, title)
+        
+        entry = {}
+        entry["html"]  = htmlfile
+        entry["title"] = title
+        entries.append(entry)
+        
+        
+  for j in range(0,len(entries)):
+    entry = entries[j]
+    print("--- Processing %s ------------------------" % entry)
+    htmlfile = entry["html"]
+    title    = entry["title"]
+      
+    if len(split(htmlfile, '/')) == 2:
+      outdir  = split(htmlfile, '/')[0]
+      outfile = split(htmlfile, '/')[1]
+      _mkdir(outdir)
+    else:
+      outdir = ''
+      outfile = split(htmlfile, '/')[0]
+      
+    # insert title
+    html = templateFile;
+    html = html.replace(">TITLE", ">%s"%title)
+            
+    # insert pre_title
+    if j>=1:
+      lastentry = entries[j-1]      
+    else:
+      lastentry = entries[-1]      
+      
+    last = split(lastentry["html"], '/')[-1]
+    print("PRE: inserting %s" % last)
+    html = html.replace("PRE_TITLE", lastentry["title"])
+    
+    # insert prehtml
+    html = html.replace("prehtml.html", last)
+            
+    # insert post_title
+    if j<len(entries)-1:
+      nextentry = entries[j+1]      
+    else:
+      nextentry = entries[0]      
+
+    # print "POST: inserting %s" % split(nextentry["html"], '/')[-1]
+    next = split(nextentry["html"], '/')[-1]
+    print("POST: inserting %s" % next)
+    html = html.replace("POST_TITLE", nextentry["title"])
+
+    # insert posthtml
+    html = html.replace("posthtml.html", next)
+            
+    # insert content link
+    contentFilePath = split(htmlfile, '.html')[0]+'_content.html'
+    if len(split(contentFilePath, '/'))>1:
+      conoutdir = split(contentFilePath, '/')[0]
+      conout    = split(contentFilePath, '/')[1]
+    else:
+      conoutdir = ''
+      conout    = split(contentFilePath, '/')[0]
+      
+      
+    
+    # make contents version of htmlfile
+    # - only if file doesn't exist
+    if os.path.exists(contentFilePath):
+      try:
+        fin = open(contentFilePath);
+        line1 = fin.readline();
+        if line1.startswith("<!-- $Id:"):
+					line1 = ""
+        content = line1+fin.read();
+        fin.close()
+      except IOError:
+        print("# error opening file.")
+        sys.exit(-1)        
+    else:
+      content = "<p>Content needs written...</p>"
+
+    html = html.replace("CONTENT", content)        
+    # write out
+    fout = open(htmlfile, "w+");
+    fout.write(html)
+    fout.close();
+      
+# call main
+if __name__ == "__main__":
+    main()