wiki:docs_file_inclusion

file inclusion [rev 610+]

  • a json field value can be taken from the contents of a file
  • this is useful when you have a large document to use as a value
  • the file types .txt, .html, .doc and .docx are currently supported
    • for doc and docx:
      • abiword must be installed and available in the path for genapp processing
      • the doc is converted to html and then included
  • the files should be in a subdirectory named "files" or a language specific LANGUAGE/files subdirectory
  • the value is given as "_ _< filename"
    • e.g. myfile.txt would appear as follows:
      ...
          "tag" : "__< myfile.txt"
      ...
      

doc docx notes

  • you can include images, the *should* be handled ok, some of this is experimental, so let us know if you find a problem
  • for images, the conversion sets an absolute size in mm, which can be problematic for various browser window sizes
    • by default, all images will be rescaled to 75% to avoid this issue.
    • you can specify (anywhere in your doc/docx file) this special tag
         __imagesize:X%,Y%,..__
      
      • where X, Y are numbers representing the relative size of the image to the document size in the window
      • instead of "X%" you can put the keyword "original" which will keep the original image size settings
      • if you have fewer (or one) %'s than images, the last one listed will be used repeatedly
  • if you want a horizontal line, you can add this tag
       __hr__
    
  • for links, use this format to get a nice link:
       __link{http://my.example.link/a/b/c My tag line}
    
    • this will provide a link to the URL with "My tag line" as the text

future: md

  • planned to support md
Last modified 20 months ago Last modified on Jun 22, 2016, 3:49:00 AM