Your SlideShare is downloading. ×

Terminology Management in DITA

935
views

Published on

Published in: Technology, Education

0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total Views
935
On Slideshare
0
From Embeds
0
Number of Embeds
1
Actions
Shares
0
Downloads
5
Comments
0
Likes
0
Embeds 0
No embeds

Report content
Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
No notes for slide
  • Using DITA and a Thesaurus.
  • Each glossary entry describes and documents one sense (meaning, or concept) Kara Warburton IBM. DITA 1.2 Glossary and Terminology Specialization Feature Description.** Note: Perhaps we could show the Acronym mechanism as well.
  • Each glossary entry describes and documents one sense (meaning, or concept) Kara Warburton IBM. DITA 1.2 Glossary and Terminology Specialization Feature Description.** Note: Perhaps we could show the Acronym mechanism as well.
  • Each glossary entry describes and documents one sense (meaning, or concept) Kara Warburton IBM. DITA 1.2 Glossary and Terminology Specialization Feature Description.** Note: Perhaps we could show the Acronym mechanism as well.
  • Each glossary entry describes and documents one sense (meaning, or concept) Kara Warburton IBM. DITA 1.2 Glossary and Terminology Specialization Feature Description.** Note: Perhaps we could show the Acronym mechanism as well.
  • Discuss consistency of control values vs concept links
  • Talk about browse – single facet and multi-facet.Talk about search – AND, OR, NOT, ()Mention that across departments, internal system users benefit from thesaurus-assisted search capability—in addition to content team and end-users
  • Talk about browse – single facet and multi-facet.Talk about search – AND, OR, NOT, ()Mention that across departments, internal system users benefit from thesaurus-assisted search capability—in addition to content team and end-users
  • Talk about browse – single facet and multi-facet.Talk about search – AND, OR, NOT, ()
  • Forms of ValueSimple Index entriesGlossaryFacet Search for AuthorsFacet Search for Readers
  • Transcript

    • 1. Terminology Management Using DITA to squeeze maximum value from your Terminology Jim Tivy October 2013
    • 2. Jim Tivy: • Documentation systems since the 80s • Data modeling, database system specialist • XQuery Working Group early 90s • CTO, Bluestream • Member, Oasis DITA TC
    • 3. Contents 1. 2. 3. 4. Introduction DITA Glossary/Term Mechanism Thesaurus Index Browse and Search @JimTVanc @LavaCon Oct 2013
    • 4. Introduction @JimTVanc @LavaCon Oct 2013
    • 5. Terminology Management • Identification, organization and use of terms • The promise: – accuracy – coherence – findability • Terminology – Set of preferred terms – Alternative terms – synonyms – Acronyms @JimTVanc @LavaCon Oct 2013
    • 6. Content Project Phases @JimTVanc @LavaCon Oct 2013
    • 7. DITA Glossary/Term Mechanism @JimTVanc @LavaCon Oct 2013
    • 8. DITA Glossary Mechanism • • • • • • <glossentry> <term> <glossref> Concept (sense) oriented Synonyms Acronyms @JimTVanc @LavaCon Oct 2013
    • 9. <glossentry> <glossentry> … <glossterm>voice mail</glossterm> <glossdef>Allows callers to leave voice messages.</glossdef> <glossBody> <glossAlt> <glossSynonym>answering machine</glossSynonym> <glossUsage>Older term</glossUsage> </glossAlt> </glossBody> </glossentry> @JimTVanc @LavaCon Oct 2013
    • 10. <term> <task <taskbody> <prereq> <p>Your <term>voice mail</term> must be set up with a service provider, a password, and a greeting. </p> </prereq> … </taskbody> </task> @JimTVanc @LavaCon Oct 2013
    • 11. <glossref> • <p>Your <term keyref="voice_mail"/> must be set up with a service provider, a password, and a greeting. </p> • Needs a key definition. • <map> <topicref href="/Content/Retrieve_voicemail_xi10005.xml"/> ... <topichead navtitle="Glossary> <glossref href="/Content/VoiceMail_xi10019.xml" keys="voice_mail“ linking="normal" toc="no" print="yes"/> <glossref href="/Content/SIMcard_xi10017.xml" keys="SIMcard“ linking="normal" toc="no" print="yes"/> ... </topichead> </map> • As shown in HTML… @JimTVanc @LavaCon Oct 2013
    • 12. Abbreviated Form Added to <glossentry> <glossBody … <glossSurfaceForm>phone screen (SCR)</glossSurfaceForm> <glossAlt> <glossAcronym>SCR</glossAcronym> </glossAlt> … Used instead of <term> <abbreviated-form keyref="phone_screen"/> As shown in HTML… @JimTVanc @LavaCon Oct 2013
    • 13. Thesaurus Index @JimTVanc @LavaCon Oct 2013
    • 14. Thesauri • • • • A kind of taxonomy Hierarchy of concepts – narrower, broader Concepts are controlled and organized Concepts have labels – – – – Some labels are preferred Some labels are synonyms There are links to related concepts There can be labels for each language • Getty Center example @JimTVanc @LavaCon Oct 2013
    • 15. Getty Example @JimTVanc @LavaCon Oct 2013
    • 16. Example SKOS thesaurus entry prefLabel (en-US): in calls altLabel: getting called definition: In calls are those calls you receive when someone dials your number. broader: phone narrower: voice mail @JimTVanc @LavaCon Oct 2013
    • 17. Thesaurus Index • A thesaurus with links to content Thesaurus Tree Phones Calling Parts Voice mail Files vmail.xml music.xml calls.xml @JimTVanc @LavaCon Oct 2013 Screen photos.xml screen.xml
    • 18. Harvest Time! • “As you sow, so shall you reap.” • Harvest Demo @JimTVanc @LavaCon Oct 2013
    • 19. Managing the Thesaurus Index • Managing concepts – Manual Harvest • Managing concept links – Manual Harvest (where used?) – Manual Link to images (only for authors?) • Consistency of thesaurus index and repository – Manual or fully synchronized? @JimTVanc @LavaCon Oct 2013
    • 20. Thesaurus Standards • W3C SKOS 2009: Simple Knowledge Organization System – Schema plus triples – in OWL • ISO 25964-1 2011: Thesauri for information retrieval – Entity Relationship Model – works well for RDBs @JimTVanc @LavaCon Oct 2013
    • 21. Thesaurus Index as links • RDF or OWL2 statements “File vmail.xml is aboutTerm voice mail.” File vmail.xml Term aboutTerm @JimTVanc @LavaCon Oct 2013 voice mail
    • 22. What about Subject scheme <subjectScheme> <hasNarrower> <subjectdef keys="PhoneFeatures“ navtitle="Phone Features“> <subjectdef keys="VoiceMail" navtitle="Voice Mail" href=“GE_VoiceMail.xml"/> </subjectdef> </hasNarrower> </subjectScheme> @JimTVanc @LavaCon Oct 2013
    • 23. Subject to topic link <map> <!-- ... --> <topicref href=“RetrievingVoiceMail.xml" > <topicsubject> <subjectref keyref="VoiceMail "/> </topicsubject> <!-- ... --> </topicref> <!-- ... --> </map> @JimTVanc @LavaCon Oct 2013
    • 24. Browse and Search @JimTVanc @LavaCon Oct 2013
    • 25. Browse • Authors browse by term (subject) – Single or multi facet • Readers browse by term – Needs well known hierarchy – Or full text, then facets • Dynamic generation of relationships @JimTVanc @LavaCon Oct 2013
    • 26. Search • Search the Thesaurus only – As in the Getty example • Use Thesaurus in Full Text Search – Generate Synonym Ring (SynSet) • Rank terms higher • Increases precision – Maximize relevant/returned – Less false positives @JimTVanc @LavaCon Oct 2013
    • 27. Demo Browse and Search Author Browse: XDocs demo Reader Browse: http://www.kayak.com/ @JimTVanc @LavaCon Oct 2013
    • 28. In Summary • • • • • • • Identify and organize. Use terms in DITA Harvest into an index Manage for accuracy. Authors use index for findability Readers use index for findability Iterate as necessary @JimTVanc @LavaCon Oct 2013
    • 29. Breaking the Silo – Linked Data @JimTVanc @LavaCon Oct 2013
    • 30. References Title Author Reference SKOS Reference August 18, 2009 W3C SKOS Reference Information Standards Quarterly, Winter 2012, ISO from ISO 2788 to ISO 25964. Evolution of Thesaurus Standards DITA 1.2 Glossary and Terminology Specialization Feature Description Kara Warburton https://www.oasisopen.org/committees/download.php/34831/GlossarySpecializationBestP ractice_Final.pdf DITA 1.2 Specification Oasis http://docs.oasis-open.org/dita/v1.2/spec/DITA1.2-spec.html Visual Thesaurus http://www.visualthesaurus.com Getty Thesaurus of Geographic Names® Online http://www.getty.edu/research/tools/vocabularies/tgn/ Online Thesauri and Authority Files Note: Only some of these work. http://www.asindexing.org/i4a/pages/index.cfm?pageid=3625 UNBIS Thesaurus United Nations Bibliographic Information System (UNBIS) https://lib-thesaurus.un.org/LIB/DHLUNBISThesaurus.nsf http://www.taxonomies-sig.org/about.htm American Society for Indexing http://www.taxonomies-sig.org/about.htm @JimTVanc @LavaCon Oct 2013