Archive Trac docs file inclusion

Docs File Inclusion

Legacy Trac archive page imported from docs_file_inclusion. Source: https://genapp.rocks/wiki/wiki/docs_file_inclusion. Review age, links, and examples before treating as current.

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, this 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
• N.B. make sure the link is plain text, not a link within the doc/docx.

future: md

• planned to support md