FxFactory lets you organize product documentation into sections that can be referenced or inlined by other Markdown content.
A section is a snippet of self-contained Markdown content. When FxFactory generates documentation for your product, it creates a separate page for each section you have created. This is similar to how FxFactory creates separate pages for each category and each plug-in in the product.
More often than not, you will create sections so that you can define pages for common topics, and link to these pages from other Markdown content.
You can create and edit help sections under the Help panel:
Each section has a unique Section ID. You can reference this section from other Markdown content by using its unique ID. The Section ID is never displayed to users.
The section’s Title is:
section:URL scheme rather than the familiar
The following Markdown statement will create a link in your content to the section whose Section ID is
[This links to a section](section:quick_tips)
The link appears as any regular link in a Markdown document, but instead of sending users to a different website, it links directly to the web page FxFactory created.
Sections can also act as reusable snippets of Markdown content. You can ask FxFactory to paste the content of a section within existing Markdown by declaring the link text as
When using the inline modifier, whatever content is present in the section will be inserted at that spot, when the product’s documentation is generated.
This feature lets you minimize copy-and-paste across your product’s documentation. Write the information once, and insert it everywhere it’s needed.