Apache Forrest > HøLUG
 
Font size:      

Static content - including raw un-processed files and documents

Linking to static content

You can place some types of raw content into the xdocs directory. For example, you can place a PDF file in src/documentation/content/xdocs and link to it normally, <a href="../hello.pdf">hello.pdf</a> However, note that if the file is one that Forrest is able to process, for example an HTML file, these files will be processed accordingly.

It is also worth noting that files in the xdocs directory will only be copied into your final site if there is a link to them somewhere in the site. See the next section for details of how to include content that is not linked.

For more information see the Linking demonstration.

Including Static Content that is Not Linked

You can include raw HTML, PDFs, plain-text, and other files. In your final site by placing them in the src/documentation/content directory. Files in this directory will be copied over automatically but will not be processed in any way by Forrest, that is they will be linked to as raw files.

You can also have sub-directories such as src/documentation/content/samples/ooo11/ which reflects your main xdocs/ tree. The raw files will then end up beside your documents.