If you've entered a lot of supplementary information for your terms, it's possible display that information in the Sidebar. This can help writers use the term correctly without having to open the full term help. For example, you could add a note on how to use the term correctly.
Tip
If you're on an Acrolinx Private Cloud instance and are interested in these configurations, contact us and we'll set them for you!
To configure the term help in the Sidebar, follow these steps:
-
Open your overlay of the following file:
term_guidance.vm
If you don't yet have an overlay of this file, create a new version. Depending on your installation, your location might be here:
<config directory>/data/common
Always edit your overlay copy in the configuration directory rather than the installed version of the file.
You can use the following sample code to get started.
<div class="guidance term"> ## $surface ## <br/> ## $status $domains #if(!$customFields.definition.isEmpty()) <br/> <b>Definition</b> <br/> $customFields.definition #end #if(!$customFields.note.isEmpty()) <br/> <b>Note</b> <br/> $customFields.note #end </div>
This configuration will display the status, domains, definition, and note for each term that shows up as a terminology issue.
Edit the code and add any other variables.
For example, most people want to add the contents of custom fields that they've created. You add a custom field with the following variable:
$customFields.<FIELD_NAME>
Replace <FIELD_NAME> with the name of the required field — like this: $customFields.usage_guide.
If needed, surround the variable with any extra HTML formatting like line breaks or bold tags.
For more detailed information on variables for term help, visit the "variables" section of the Term Help page. The variables that you use for the term help file are the same variables that you can use for the term help in the Sidebar.
-
Save your changes.
You'll see your changes the next time you run a check.