Documentation

This page contains Wandora documentation. Documentation is a work in progress and incomplete. Also note some documentation may be out of date as the application is developed intensely. If you need specific help, leave a note in the discussion forum and we'll answer your request as soon as possible. Additional help may be available on wandoratv.

Preparing Wandora

• System requirements
• Download Wandora (build date 2016-05-10)
• Installing Wandora
• Running Wandora

Topic maps

• About topic maps
• Topic maps in Wandora

See also Layers section below.

Basics

This section contains tutorials for topic and association creation, modification, and deletion. See also tutorial videos on wandoratv.

Quickstart Finding a topic Opening a topic Topic shortcuts Modify topic Modifying base name Modifying subject locator Modifying subject identifiers Modifying variant names Modifying topic classes Modifying associations Modifying occurrences

Create new topic Delete topic Create new association Delete association Working with topic tables Drag and drop topics Working with topic trees Creating custom topic trees Topic panels Traditional topic panel Tabbed topic panel Graph topic panel Custom topic panel

Import and Export

Wandora has been designed to enable easy aggregation of knowledge and features wide range of import and export tools. Wandora is capable to export not just different topic map formats but also RDF, HTML, and several different graph formats. Wandora's native file format is Wandora project (WPR) which is a collection of XTM topic maps and configuration file within a zip package. Managing of topic maps is easy as Wandora allows the user to copy and paste topics and associations using system clipboard. Usually import tools locate in Wandora's File > Import menu. Export tools locate in Wandora's File > Export menu. To export one layer select menu option in layer context under Export layer. To import into a specific layer select menu option in layer context under Merge to layer.

How to save and load project How to import existing topic map to Wandora How to export topic map in Wandora Transferring data with clipboard Importing RDF (see also extractors below) Importing OBO flat file ontologies Gene Ontology Annotation file import Importing XML with XSL Generic SQL database import Exporting WWW site Lucene search index export SQL Dump Export

Graph and matrix imports Adjacency list import Adjacency matrix import Incidence matrix import Graph and matrix exports Graph Modeling Language export GraphML export GraphXML export GXL graph export Export adjacency matrix Export incidence matrix

For additional information about Wandora's export capabilities see also Wandora Server and CMS bridges section below. For additional information about Wandora's import capabilities see also Extractors section below.

Extractors

Wandora is great for information mashups. With Wandora you can easily mashup information from various sources. Extractors are specific Wandora tools used to extract topics and associations out of different file formats and sources. Wandora can extract data from MP3 and JPG files for example. To see what extractors your Wandora has installed see File > Extract. To start an extractor just select the extractor name in the menu or use drag and drop extractor. If you don't find the extractor in the menu use Tool manager to add the extractor into the menu. Wandora also contains an add-on for Mozilla Firefox WWW browser. With the add-on you can perform extractions directly in browser.

• Drag and drop extractor
• Firefox plugin to extract directly from Firefox WWW browser and Thunderbird email client.

Search engine extractors Bing extractor Simple files extractors JPG binary metadata extractor PDF extractor File system extractor Convert simple text documents to topic map occurrences Media extractors MP3 ID3v1 and ID3v2 extractor IMDB extractor FreeDB extractor Convert Last.fm XML feeds to a topic map Flickr extractors Ovi shared media extractors YouTube extractors Social bookmarking extractors Digg extractors Delicious extractors Diigo bookmark extractor Twine RDF extractor Bibliographical extractors Convert BibTeX files to a topic map RIS extractor Classifications and knowledge extractors OpenCalais classifier SemanticHacker classifier OpenCyc extractor Subj3ct record extractor AlchemyAPI extractors DBpedia extractor

HTML structures extractors HTML superclass-subclass list extractor HTML instance list extractor HTML property table extractor HTML association table extractor HTML link extractor News and syndication extractors RSS 2.0 Extractor and RSS 1.0 RDF Extractor Atom extractor Microformat extractors Convert geo microformat snippets to topic maps Convert adr microformat snippets to topic maps Convert hcalendar microformat snippets to topic maps Convert hcard microformat snippets to topic maps Wiki extractors Wikipedia extractor More general MediaWiki extractor Simple RDF extractors SKOS RDF extractor Dublin Core RDF extractor FOAF RDF extractor Language Big Huge Thesaurus API extractor VerbOcean extractor Moby thesaurus extractor Other Importing SQL database Email extractor Geonames extractors Gellish ontology extractor GEDCOM extractor

Generators

Generators are special tools that generate topics and associations algorithmically. Generators help you to construct basic building blocks for your topic maps. Generators also serve as a nice test suite for Wandora and topic maps in general. Generators locate in Wandora's File > Generate menu. Available generators are

• Random graph generator
• Fully connected graph generator
• Tree graph generator
• Linear list graph generator
• Finite group graph generator
• Platonic solid graph generator
• Hypercube graph generator
• Tiling graph generator (square, triangular, and hexagonal tilings)
• Edge generator
• L-system generator

Schema

Schema is a collection of specific topics and associations that Wandora uses to construct the user interface of association editor, occurrence editor and topic name panel. Schema eases many topic map operations such as association and occurrence construction. Schema also defines the language support of Wandora application.

• Schema to ease association and text data creation and modification
• How to add another variant name language
• How to add another variant name type

Layers

Wandora supports layered topic maps. Layered topic map contains one or more topic maps stacked into an ordered array. This separation of merged topic maps allows flexible management of topic maps and enables the birth of public knowledge repositories used as a component of other Wandora based knowledge bases. Layer specific options locate in Layers menu.

Introduction to Layered Topic Maps Creating new layers Deleting layer Layer order and arranging layers Merging layers Topic's layer distribution

Different layer types Layered topic map Memory topic map Database topic map Linked topic map Query topic map Web service topic map

Analyzing Topic Maps

Generally these tools locate in Layers > Statistics menu. As an exception SOM classifier is found in association table menu.

• Topic map info
• Topic map connection statistics
• Topic map diameter
• Clustering coefficient of topic map
• SOM classifier (Self Organizing Maps classifier)

Tools and tool manager

Almost every feature in Wandora is implemented with a tool. Tool packs certain Wandora functionality into a single software component. Wandora's user may customize the available tool set and even add third party tools to Wandora.

• Tool manager
• Available tools
• Writing your own tool
• Installing your own tool
• Tool locks
• Configuring tools
• Additional tool help

Wandora Server and CMS bridges

Wandora's Embedded HTTP server allows you to publish topic maps as a dynamic HTML site, RSS feed or pretty much anything directly from Wandora application.

• Included output modules: HTML, RSS instance feed, ATOM topic, Wandora Web Service.
• We have created several Wandora Drupal extras to show you examples how Wandora can be used together with Drupal content management system.
• We have also created an extra for Joomla content management system to demonstrate how to publish Wandora content in Joomla sites.
• You can also create new output modules to Wandora easily. See chapter Setting up new services at Embedded HTTP server.

Wandora Piccolo is a framework to publish topic maps with Wandora and Apache Tomcat. Wandora Piccolo suits well for large scale server configurations that doesn't require Wandora's GUI.

• Setting up Wandora Piccolo server (including the web service interface).
• Wandora Web Service
• Piccolo XML processor.

See also Export section above.

Other

• Wandora options
• Wandora Javadocs
  • Download Wandora Javadocs