Introduction

LexWiki Publisher helps to transform and later publish entities in user terminology/Ontology to a target platform. Currently LexWiki Publisher provides a default output which is suitable for Semantic Media Wiki enabled with LexWiki extension. This utility is conceptualized to make it easier for user to publish their content to wiki faster and with ease. Once the entities are published to Wiki they can benefit from other Semantic Media Wiki features. Each wiki page renders one term or entity in user's terminology. LexWiki Publisher is one of the arrays of tools that work and based on LexEVS model and framework implementation.

What is LexWiki?

LexWiki Publisher publishes pages that are published to a LexWiki Wiki Pages. Before we discuss LexWiki Publisher, here is a brief introduction to LexWiki. LexWiki is a Semantic Media Wiki extension and it is based on LexEVS model. LexWiki is a set of PHP program libraries, Semantic Media Wiki templates, forms, properties and enabled wiki services. LexWiki was conceived, designed and developed at Mayo Clinic to help publish ontology/terminology terms as wiki pages. From now on in this document the word "LexWiki" will refer to a Semantic Media Wiki which has LexWiki extension enabled and configured according to user's specification. LexWiki utilizes relationship properties among wiki pages to simulate relationship among terminology terms and concepts.
LexWiki is available as a package at Vocabulary Knowledge Center at https://cabig-kc.nci.nih.gov/Vocab/KC/index.php/LexWiki. User can download it and configure it accordingly to the supplied instructions. Please note that LexWiki framework also employs features from other Semantic Media Wiki extensions to provide additional functions. These third party extensions may or may not be upgraded along with newer versions of Semantic Media Wiki. When it comes to publishing content using LexWiki Publisher, it is assumed that LexWiki framework's basic extensions (latest available) are installed.

What is LexWiki Publisher?

LexWiki Publisher 2.0 is a Java library which allows user to publish their ontology/terminology from a LexEVS 6.0 (or later) repository to a format which could be published to a LexWiki. LexWiki Publisher can be used as a stand-alone Java Library or can be augmented into a user's application. It is assumed that the source ontology is first loaded into a LexEVS 6.0 repository successfully without any issues. Once the contents are in LexEVS 6.0 repository then user can either run LexWiki Publisher either from command line or integrate it in an application and run it using its application interfaces.

Why do we need LexWiki Publisher?

LexWiki Publisher is a faster and easier way to get your contents transformed and published to LexWiki. Without LexWiki Publisher the user has to either write customized transformation routines to make terms published as pages. Customized transformation may be tedious to write and fragile to maintain and it may not work as a universal transformation tool for any other ontology than for what it has been written for.
Another option is to 'manually' create pages for each concept and association in the terminology. It may work for if terminology is small (few nodes), but will not be a practical solution for medium and large sized ontologies.
LexWiki Publisher is created by Mayo Clinic, which conceptualized and developed and has been core part of development of both LexEVS and LexWiki model and frameworks. Mayo Clinic is going to keep LexWiki Publisher updated with latest LexEVS releases and LexWiki installers (whenever possible) so there is no confusion and data loss when contents are transformed from LexEVS for a LexWiki platform.

Architecture

At high level, LexWiki Publisher is divided into three parts:

• The first part is to communicate with LexEVS repository and make sure we resolve and retrieve all the requested terms and their relationship graphs correctly.
• The second part is the core part of LexWiki Publisher which transforms a term's content into text which makes sense in LexWiki world. LexWiki text is a set of LexWiki template calls along with Semantic Forms and Wiki properties.
  The LexWiki templates are extensions to the Semantic Media Wiki templates features and maps to (usually one-to-one) LexEVS model components. LexWiki properties are configurable according to what properties a user's ontology has. These properties are another layer on top of Semantic Media Wiki properties and help relate one concept term page to another in the LexWiki world.
• The third part is the delivery of the transformed text to LexWiki which can be done in two ways:
  *One way is to collect all text generated from transformation routine and load them as pages (one by one) using a PHP script. This PHP script is customized to load these specific text files (containing transformed text) to LexWiki by extending Wiki's maintenance load routine.
  *The other way of loading pages is to use a third party tool like MediaWiki Bot to connect LexWiki Publisher directly to the Wiki and post each page one by one. This delivery solution is relatively slower and may take reasonable amount to time to load a bigger ontology. In this solution we have to spend extra time and efforts to manage a third party tool. The third party tool may not work well with latest version of Semantic Media Wiki, even though it had been tested and works well with older versions of Semantic Media Wiki.

Publishing Your Content

LexWiki Publisher provides the first way of delivering pages to LexWiki: Converting pages into text files (one file for each concept) and a routine to load them to LexWiki. This routine is a PHP script (discussed above) and may require users to have access and execute permissions to the Wiki's maintenance directory.

To accomplish a successful transfer of your terminology from LexEVS to LexWiki:

• Follow the instructions to install LexWiki Publisher.
• Follow the instructions to create an XML configuration file, an instance of LexWiki Publisher schema, for LexWiki Publisher to work correctly and transform content in a desired way. The schema is defined at http://informatics.mayo.edu/lexwikipublisher/LexWikiPublisher_2_0.xsd.

  Launch the LexWiki Publisher program by invoking the script"runpublisher.bat"* provided in the download.

  You can also write your own batch file with "edu.mayo.lexwiki.publish.LexWikiPublisher" as the main executing Java class and pass a configuration XML file as the first command line argument.
  At the end of a successful run you should have a set of files in the target directory (as specified in configuration file).
• Open a command prompt to the maintenance directory of your LexWiki installation.
• Run the publish PHP using the directory location of the files created as the only argument:
  php publish.php /home/myhomedir/tobepublishedpages