What is a Variable?
Variables are placeholders whose value you can set at a later time. You can use global variables and classifications in MindTouch.
A global variable is a placeholder that you can refer to in the text of your MindTouch page. You set the value of the variable, and when readers view the page, they see the value of the variable instead of the variable itself. When you change the value of the variable, all references to that variable in the text are automatically updated.
You can create your own global variables and set their values.
A classification is a container that can hold a piece of information about a MindTouch article. You set the value of the classification for each article so that content creators understand the condition of the article.
By default, these classifications are delivered with your MindTouch account:
You can set the value for each classification in the right side tray when you view the article (you may need to be logged in). You can also view and update the classifications assigned to articles in batches by using the Classifications Manager.
What are the Benefits of Variables?
When you use this feature, you gain the ability to manage information that may not be related to the subject of the article, but that supports and describes the article itself.
You use global variables when the information might change over time. For example, you might use a global variable to contain:
- A feature name that has not yet been approved. You can write content about the feature and insert the variable in place of the feature name. Once the name is approved, you can set the value of the global variable and the approved name will appear throughout the document wherever the variable was included.
- A version number. When you release a new version and keep the legacy content that is still relevant to the new version, you can update the global variable with the new number to update the version number throughout the legacy content.
- A copyright date. You can update copyright dates throughout the document set all at once by using a global variable.
You use classifications to capture information about an article. A classification makes it easy to limit the list of values the user can choose to tag a page. You might use this information:
- To create custom tabs for the tabbed navigation tool that appears on articles with the Article Type of Category. See Creating Custom Tabs.
- As part of a document workflow. For example, you might run a report of all articles where the Stage classification is set to Stub every week to create a to-do list.
- While localizing content. You can use the Classifications Manager to find all of the articles that are ready to be sent for translation, then update the classification for all of the articles once they have been sent to the translation vendor.