Inserting external documents

Principle

Sometimes combining documents using the book template is not enough. You may want to add a message or an image in a specific part of your generated documentation.

Modelio Document Publisher has a solution for this use case:

Inserting a document

Document Publisher relies on the document’s target format to handle the inserted file type. For example, you can insert a “.txt” file  in both HTML and OpenXML formats, but “.docx” files can be inserted only in OpenXML generation mode. According to your system configuration, you may have to actualize your document content (using F9 for Word and usually F5 for your web browser) before seeing the inserted files.

The image below shows how to insert an image in the documentation generated for a Use-Case.

2

Inserting an image

When generating the document, the image is inserted at the same location as the current “description” note:

3

The inserted image in the generated document

Inserting a link

An << External Document >> note can also be generated as a link, rather than a direct insertion.

Just check the “Is a link” property in the “Annotations” view, and add a label if you do not want the hyperlink to be explicit, as shown below:

4

Switching to link insertion

When generating the document, the hyperlink is inserted instead of the image, and the label is displayed:

5

The inserted link in the generated document