Wandora: A Beginner’s Guide to the Modular Knowledge BrowserWandora is an open-source, modular knowledge browser designed to help you collect, visualize, and explore structured information. Originally developed to support the Topic Maps standard (ISO/IEC 13250), Wandora has evolved into a flexible tool for knowledge management, information integration, and semantic data exploration. This guide introduces Wandora’s core concepts, installation, basic workflows, key features, and practical tips to help beginners become productive quickly.
What is Wandora?
Wandora is a Java-based application that functions as both a topic map editor and a general-purpose knowledge browser. At its core, it models information as topics, associations, occurrences, and facets, enabling users to represent complex relationships clearly. While it supports Topic Maps explicitly, Wandora also imports and integrates data from a variety of formats — RDF, CSV, OPML, HTML, and more — making it useful beyond strict Topic Maps use cases.
Key concepts
- Topic: The primary information unit (similar to a node in a graph).
- Association: A typed relationship between topics.
- Occurrence: Information attached to a topic (e.g., a URL, text, or file).
- Role: The part a topic plays in an association.
- Topic Map: A collection of topics, associations, and occurrences forming a graph of knowledge.
Installing Wandora
- Ensure you have Java (JRE/JDK) installed — Wandora requires Java 8 or newer.
- Download the latest Wandora release from the official project site or repository.
- Unpack the archive and run the executable JAR:
java -jar wandora.jar - On first run, configure preferences (memory settings, plugins) via the Options menu.
User interface overview
Wandora’s interface is built around several interchangeable panels:
- Project panel: manages open topic maps and projects.
- Topic panel: lists topics and their properties.
- Map panel: visualizes topic maps as interactive graphs.
- Explorer/Import panels: handle data import and integration.
- Plugin panels: provide additional tools like SPARQL querying, web scraping, or RDF export.
Panels can be rearranged and saved as workspace layouts.
Importing data
Wandora supports multiple import formats:
- Topic Maps (XTM)
- RDF/XML, Turtle, N-Triples
- CSV and TSV
- OPML (outlines)
- HTML and web pages (via scraping)
- JSON (with plugins)
To import, use File → Import or drag-and-drop supported files into the application. During import you can map fields to topic types, set identity rules, and define associations.
Building your first topic map
- Create a new topic map: File → New → Topic Map.
- Add topics: Right-click in the Topic panel → New Topic. Give it a name and type.
- Add occurrences: Select a topic → Add occurrence (e.g., attach a URL or text).
- Create associations: Select two topics → Create Association; assign roles and type.
- Visualize: Switch to Map panel and lay out the graph. Use filters to focus or expand.
Visualization and navigation
Wandora’s graph visualization supports:
- Multiple layout algorithms (force-directed, circular, hierarchical).
- Filtering by topic type, association type, and attributes.
- Expand/collapse topic neighborhoods.
- Styling topics by type, occurrences, or custom properties.
Use zoom, pan, and context menus to explore large maps. Export visualizations as images or vector graphics for presentations.
Querying and analyzing
Wandora includes tools for querying topic maps:
- Search panel for quick keyword searches.
- SPARQL (via RDF export/import) for RDF-backed datasets.
- Custom plugins/scripts for batch processing, merging, or deduplication.
You can compute statistics (topic counts, association distributions) and generate reports to understand structure and content.
Plugins and extensibility
Wandora is plugin-friendly. Common plugins include:
- RDF import/export and SPARQL endpoints.
- Web scraping and metadata extraction.
- CSV/Excel mappers and transformers.
- Scripting console (for automation in JavaScript/Groovy).
Plugins can be enabled from Options → Plugin Manager or added manually to the plugins folder.
Use cases and examples
- Research knowledge organization: Collect papers, authors, keywords, and their relationships.
- Personal knowledge base: Link notes, bookmarks, and tasks semantically.
- Data integration: Merge disparate datasets (CSV, RDF, HTML) into a unified graph.
- Teaching semantic technologies: Demonstrate Topic Maps, RDF, and semantic modeling.
Example: Import a bibliography CSV (title, author, year), map authors and papers to topics, create “authorship” associations, and visualize co-authorship networks.
Best practices
- Plan your topic types and association types before heavy importing.
- Use identity rules (subject indicators/identifiers) to avoid duplicate topics.
- Keep topics granular: prefer multiple specific topics over large monolithic topics.
- Regularly back up topic maps; they are stored as files that can grow large.
- Use scripting for repetitive transformations.
Troubleshooting common issues
- Performance: Increase Java heap size (e.g., -Xmx2G) for large maps.
- Import mapping errors: Re-run import with explicit field-to-type mappings.
- Plugin failures: Check Java version compatibility and plugin dependencies.
- Visual clutter: Apply filters or work with sub-maps to focus views.
Resources
- Official Wandora download and documentation pages.
- Topic Maps standard (ISO/IEC 13250) for conceptual background.
- Community forums and example projects for templates and plugins.
Wandora is a powerful tool for anyone wanting to work with structured knowledge graphs without committing to heavy ontology engineering. With its modular plugin architecture and support for many formats, it’s suitable for researchers, students, and knowledge managers who need a practical way to collect, connect, and visualize information.
Leave a Reply