Last updated on August 24, 2020
Defining A Glossary Term
Augmented Glossary is a function enabled by Visual-Meta where the author:
- Adds a heading called ‘Glossary’ at the end of their document in ‘Author’.
- Adds paragraphs of text where the term to be defined needs to be in bold and the definition in non-bold. That is the only formatting the user needs to know or care about.
Alternative creation: In Author user selects the text ‘Dynamic View’ and hit cmd-g in:
This is an action to define a term but the user can also do it manually by typing the term in bold in the Glossary section and the definition in the same paragraph in non-bold.
Glossary section at the end of the document where the term and definitions are stored:
Glossary’ heading followed by terms in bold and definitions in non-bold in the rest of the paragraph
Accessing & Reading A Glossary Term
When the document is exported to PDF with Visual-Meta and opened in ‘Reader’, a reader can as normal, select any text in the body of the document and do cmd-f to change the view to only show lines with the selected text.
However, if this text is in bold in the Glossary, the paragraph it appears in (in other words the paragraph with its definition) will appear at the top of the screen in full, under a heading ‘Glossary’ with a very light grey background colour (#f4f4f4), followed by all the other Find results.
Result of selecting the text ‘Dynamic View’ in a document and doing cmd-f:
Glossary definition on top, other Find results underneath:
Note: If more than one paragraph has bold text which matches the search term, they will also be shown.
I believe this is the simplest (or at least a very simple) implementation which could be useful for a reader and very simple for an author to create. The author can easily create and copy from an old document to a new document or from a ‘Glossary’ document and edit/add to as they see fit and the reader can choose to read the Glossary in full or see items as they come across terms the would like to look up.
Additional interaction will be for the user to select text to define, do cmd-g and a dialog opens with the selected text already in the ‘Term’ field and the cursor focused in a ‘Definition’ field for the user to type in the definition. The user can add to the term, adding acronym or other spellings of the term. Once ‘Saved’ this text will simply be added to the back of the document in the Glossary section.
Why Not Visually Indicated
The user action supported is for the user to feel that Find should be the default to find more about the text and glossary should be a bonus if available and not have another visual markup to make the document more visually messy.
All kinds of tags and relationships can be added to this dialog and embedded in Visual-Meta but I think this is a usefully simple start.