Compartilhar via

DocWiki Topic Mapping

  • Artigo

In documentation, structure and organization are imperative. The most basic element of any organizational scheme is the parent-child relationship, which enables writers to create topic maps and readers to find answers to their questions quickly.

Most Wikis are spineless, non-hierachical collections of Web pages whose only forms of organization are quickly jotted notes, links to other pages, and the ability to create TopicIndexes dynamically. In full-featured Wikis, like FlexWiki, a TopicIndex can sometimes be filtered by one or more TopicProperties. 

Workarounds that do not diminish the freeform editorial capabilities of the classic wiki include, but are probably not limited to:

  • Enhanced TopicProperty Filtering -- Organizational information is metadata.  The statement, “TopicC is a child of TopicB and a grandchild of TopicA“, can (theoretically) be described in WikiText as:
    • WikiText in TopicC -- Parent: TopicB
    • In TopicB -- Parent: TopicA and Child: TopicC
    • In TopicA -- Child: TopicB
  • Hardcoded Topic/Site Maps -- A site map is a Table of Contents-like map that cannot be edited and which  usually occupies the left frame in a Wiki Homepage.  Excellent examples include:

PInvoke is a FlexWiki implementation.  Nice work, Adam!  Thanks to DuncanMa for the link to the PInvoke Wiki. 

PINVOKE.NET attempts to address the difficulty of calling Win32 or other unmanaged APIs in managed code (languages such as C# and VB .NET). Manually defining and using PInvoke signatures (also known as Declare statements in VB .NET) is an error-prone process that can introduce extremely subtle bugs.

Comments

  • Anonymous
    April 20, 2004
    If you are interested in the union of topicmaps and wikis you might find some of the stuff I've been playing with for a couple of years now of interest... http://www.purl.org/net/conclave/frontpage

    Version 2 will be released once I get settled in my new home in Tenerife. The current version at the above URL has been a dead codebase since last June. Version 2 will be brought up to a full and final release which version 1 never was being largely for play/experiment.
  • Anonymous
    April 21, 2004
    I hooked up Engenium's Semetric <www.engenium.com> concept searching engine to an interal wiki (1500+ pages) which greatly increased its usefulness (i.e. searchability). I didn't do it for the wiki, but Semetric also has the ability to find "conceptually related pages" types of lookups that would work like Guy's relation sidebar.
  • Anonymous
    April 21, 2004
    You might want to look at OpenWiki, it allows you to create sub-pages to create a nice heirarchy.

    ie:
    Programming/DotNet
    Programming/Win32

    You can the use its nice macro capabilities to list all the subpages for a given page.

  • Anonymous
    March 16, 2006
    The comment has been removed
  • Anonymous
    March 27, 2006
    The comment has been removed
  • Anonymous
    March 27, 2006
    online directory main
  • Anonymous
    June 16, 2009
    PingBack from http://topalternativedating.info/story.php?id=11509