Your SlideShare is downloading. ×
0
Managing Linksfor Content Reuse  Mark Baker  Analecta Communications Inc.
Links Matter The web is a hypertext medium   So are help systems A page that does not link to anything  is a dead end
Links in HTML<p>Hawkes‘ final film is a lighthearted  Western in the Rio Bravo mold, with  <a  href="http://www.johnwayne....
Hard Links A hard link identifies a resource to link to
Hard links are hard work   Author discovers a resource to    link to   Author creates link to chosen    resource   Auth...
Hard Linking Topics contain direct links to other  topics              B          C                    A              D  ...
The problem with hard linking If a topic is reused in more than one  location, what do you do about the links? First use ...
Remove all the links? Lonely topics First use           Second use                 C                C  B             A   ...
Externalize the links Move the links to a map file New map file required for each use    Heavy creation and maintenance...
Soft linking A soft link identifies the subject that  is mentioned
Soft links in XML<p><director name="Howard  Hawkes">Hawkes</director> final  film is a lighthearted Western in the  <movie...
How do links get made Topics are indexed by subject
Topic indexing in XML<topic name="john-wayne-bio">  <index>    <reference type="actor">      <key>John Wayne</key>    </re...
Links discovered via topic indexes
Soft linking != redirection No resource is identified in any way
Connection is by subject only No resource has to exist to name a  subject
Soft linking and reuse Links are created by querying the available  topics in each place a topic is used First use       ...
What if no topic found? Sometime there will be no topic in the  current set for a reference                      C       ...
Not topic, no link! No broken link, because no link to  break                       C                  A         F       ...
Mentions are not links Text must be written so that links are  omissible   No “For more information, see …”   No “Click...
No link, no problem Lack of a topic to link to not  necessarily a problem   There are simply no topics on that    subjec...
What if multiple topics found? More than one topic can cover the same subject
Different topics, same subject<topic name="john-wayne-bio">     <topic name="john-wayne-  <index>                         ...
Handling multiple link targets 1 Create a popup  with multiple links                        Topics on John               ...
Handling multiple link targets 2 Gather all the links  at the end of the  topic                         More on John Wayn...
Linking style options Mentions are not links   Therefore, linking style is not determined    at authoring time   Mentio...
Discovery is expensive
Cost of discovery: hard links Author has to find the resource to link  to each time Multiple authors linking to the same...
Cost of discovery: soft links Authors do not do resource discovery  when writing Just mark up mentions of subjects   Ma...
Forward looking How do you link to  topics that do not  yet exist? But you can always  mark up mentions  of subjects   ...
Future-proof Hard links are  fragile, volatile    Require     maintenance Marked-up  mentions of  subjects are stable  ...
Quality The best topic on a subject is chosen  by the author of that topic
Helps validate content Coverage   Reveals missing topics Duplication   Use indexes to detect duplication Terminology ...
Summary Soft linking addresses key linking  challenges   Reuse: enables transparent reuse of    topics   Discovery: aut...
Contact Mark Baker     Analecta Communications Inc.     analecta.com     +1-613-614-5881     Blog: everypageispageone...
Thank you! Questions?Contact:Mark Baker   Analecta Communications   Inc.   analecta.com   +1-613-614-5881   everypageispa...
Upcoming SlideShare
Loading in...5
×

Managing Links for Content Reuse

237

Published on

Delivered at Xtech2012

Published in: Technology
0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total Views
237
On Slideshare
0
From Embeds
0
Number of Embeds
0
Actions
Shares
0
Downloads
7
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide
  • Links are a powerful aspect of eMedia products. The capacity to link to other resources at will is one of the key things that sets true eMedia apart from plain old &quot;books on glass&quot; approaches. But the creation and management of links presents substantial challenges, especially when you are creating content that may be used in different contexts and in different media.
  • Transcript of "Managing Links for Content Reuse"

    1. 1. Managing Linksfor Content Reuse Mark Baker Analecta Communications Inc.
    2. 2. Links Matter The web is a hypertext medium  So are help systems A page that does not link to anything is a dead end
    3. 3. Links in HTML<p>Hawkes‘ final film is a lighthearted Western in the Rio Bravo mold, with <a href="http://www.johnwayne.com/"> the Duke</a> as an ex-Union colonel out to settle some old scores.</p>
    4. 4. Hard Links A hard link identifies a resource to link to
    5. 5. Hard links are hard work  Author discovers a resource to link to  Author creates link to chosen resource  Author manages and updates link over time
    6. 6. Hard Linking Topics contain direct links to other topics B C A D E
    7. 7. The problem with hard linking If a topic is reused in more than one location, what do you do about the links? First use Second use C C B A A ? F D E D
    8. 8. Remove all the links? Lonely topics First use Second use C C B A A F D E D
    9. 9. Externalize the links Move the links to a map file New map file required for each use  Heavy creation and maintenance burden  Will tend to limit amount of linking that is practical First use Second useMap file for first use Map file for second useAB ACAC ADAD AFAE
    10. 10. Soft linking A soft link identifies the subject that is mentioned
    11. 11. Soft links in XML<p><director name="Howard Hawkes">Hawkes</director> final film is a lighthearted Western in the <movie>Rio Bravo</movie> mold, with <actor name="John Wayne">the Duke</actor> as an ex-Union colonel out to settle some old scores.</p>
    12. 12. How do links get made Topics are indexed by subject
    13. 13. Topic indexing in XML<topic name="john-wayne-bio"> <index> <reference type="actor"> <key>John Wayne</key> </reference> <reference type="producer"> <key>John Wayne</key> </reference> </index>…</topic>
    14. 14. Links discovered via topic indexes
    15. 15. Soft linking != redirection No resource is identified in any way
    16. 16. Connection is by subject only No resource has to exist to name a subject
    17. 17. Soft linking and reuse Links are created by querying the available topics in each place a topic is used First use Second use C C B A A F D E D
    18. 18. What if no topic found? Sometime there will be no topic in the current set for a reference C A F D
    19. 19. Not topic, no link! No broken link, because no link to break C A F D
    20. 20. Mentions are not links Text must be written so that links are omissible  No “For more information, see …”  No “Click here.” Authors can mark up all significant mentions  If there is a topic on that subject, you get a link  If not, no harm done
    21. 21. No link, no problem Lack of a topic to link to not necessarily a problem  There are simply no topics on that subject in this collection Or, it may signal something missing from the collection
    22. 22. What if multiple topics found? More than one topic can cover the same subject
    23. 23. Different topics, same subject<topic name="john-wayne-bio"> <topic name="john-wayne- <index> filmography"> <reference type="actor"> <index> <key>John Wayne</key> <reference type="actor"> </reference> <key>John Wayne</key> <reference type="producer"> </reference> <key>John Wayne</key> </index> </reference> … </index> </topic>…</topic>
    24. 24. Handling multiple link targets 1 Create a popup with multiple links Topics on John Wayne • Filmography • Biography
    25. 25. Handling multiple link targets 2 Gather all the links at the end of the topic More on John Wayne • Filmography • Biography
    26. 26. Linking style options Mentions are not links  Therefore, linking style is not determined at authoring time  Mentions are never explicit links, so you can link inline or out of line in build  Ensures consisten style when reusing content from multiple authors Also, can use index markup to generate related topics links.
    27. 27. Discovery is expensive
    28. 28. Cost of discovery: hard links Author has to find the resource to link to each time Multiple authors linking to the same resource discover it independently Discovery breaks the author’s stream of thought Cost increases with size of collection
    29. 29. Cost of discovery: soft links Authors do not do resource discovery when writing Just mark up mentions of subjects  Mark them all up, it costs nothing No interrupting flow to find linkable resources No need to browse the collection
    30. 30. Forward looking How do you link to topics that do not yet exist? But you can always mark up mentions of subjects  Subjects are always there Topics on those subjects may appear later
    31. 31. Future-proof Hard links are fragile, volatile  Require maintenance Marked-up mentions of subjects are stable  The Duke will always be John Wayne
    32. 32. Quality The best topic on a subject is chosen by the author of that topic
    33. 33. Helps validate content Coverage  Reveals missing topics Duplication  Use indexes to detect duplication Terminology  Discover incorrect terms in text or indexes
    34. 34. Summary Soft linking addresses key linking challenges  Reuse: enables transparent reuse of topics  Discovery: authors don’t have to hunt for link targets  Maintenance: soft links don’t require much maintenance  Quality: subject experts identify the best resources on a subject
    35. 35. Contact Mark Baker  Analecta Communications Inc.  analecta.com  +1-613-614-5881  Blog: everypageispageone.com SPFE Architecture  supports soft linking  SPFE.info  Presentation at CMS/DITA 2012  http://www.cm-strategies.com/2012/abstracts.htm#Baker
    36. 36. Thank you! Questions?Contact:Mark Baker Analecta Communications Inc. analecta.com +1-613-614-5881 everypageispageone.com SPFE.info
    1. A particular slide catching your eye?

      Clipping is a handy way to collect important slides you want to go back to later.

    ×