Create a bookmarks file

Once you have set up your update sites, you must provide your users with the list of URIs that they need to connect to.

Instead of asking your users to enter many URIs manually, you can create bookmarks files. A bookmarks file is an XML file that contains a list of update sites; users simply import this list into Eclipse.

The bookmarks file can contain the URIs of the DITA CMS plug-ins as well as public URIs (for example, for oXygen XML Editor and Author plug-in updates). IXIASOFT recommends that you create two bookmarks files: one for CMS administrators and one for regular DITA CMS users. This approach ensures that the administrator plug-ins are distributed to CMS administrators only and are not installed by regular users.

The following table lists the URIs that you should include in each bookmarks file:
Bookmarks file Update site name Used by
bookmarks.xml
  • dita-cms
  • dita-doc
This file may also contain the following public URIs:
  • Eclipse BIRT plug-in: Required if you want to add business intelligence and reporting tools (BIRT) to your Eclipse environment
  • oXygen XML Editor/Author update plug-ins
  • Regular users
  • CMS administrators
bookmarks_admin.xml
  • dita-cms-admin
  • textml-admin
  • CMS administrators only
Note: You could also create a bookmarks file for the test update sites, if appropriate.

Bookmarks file structure

The bookmarks file is an XML file with the following structure:

<?xml version="1.0" encoding="UTF-8"?>
<bookmarks>
   <site url="site_url" selected="true" name="site_name"/>
</bookmarks>
Each URI is stored in a <site> element, where:
  • site_url is the URI of the update site; for example: http://update.acme.com/dita-cms-admin/site.xml
  • site_name is the name of the update site as it will appear in Eclipse; for example: DITA CMS Administration

To create the bookmarks files:

  1. Create a bookmarks file to configure the update sites for a regular DITA CMS user.
    Specify the URIs for your update site; for example, for the update.acme.com update site, the bookmarks.xml file would look as follows:
    <?xml version="1.0" encoding="UTF-8"?>
    <bookmarks>
       <site 
          url="http://update.acme.com/dita-doc/site.xml" 
          selected="true" 
          name="DITA 1.2 Specification"/>
       <site 
          url="http://update.acme.com/dita-cms/site.xml" 
          selected="true" 
          name="IXIASOFT DITA-CMS 4.2"/>
    </bookmarks>
  2. Create a bookmarks file to configure the update sites that are specific to the DITA CMS administrator.
    Specify the URIs for your update site; for example, for the update.acme.com update site, the bookmarks_admin.xml file would look as follows:
    <?xml version="1.0" encoding="UTF-8"?>
    <bookmarks>
       <site 
          url="http://update.acme.com/dita-cms-admin/site.xml" 
          selected="true" 
          name="DITA CMS Administration"/>
       <site 
          url="http://update.acme.com/textml-admin" 
          selected="true" 
          name="TEXTML Server Administration"/>
    </bookmarks>
  3. Add the URLs for the BIRT and oXygen XML update sites to the bookmarks.xml file, as follows:
    Note: Only add the URLs that are necessary for your deployment.
    For example:
    <?xml version="1.0" encoding="UTF-8"?>
    <bookmarks>
       ...   
       <site 
         url="http://oxygenxml.com/InstData/Editor/Eclipse/site.xml" 
         selected="true" 
         name="oXygen XML Editor"/>
       <site 
         url="http://download.eclipse.org/birt/update-site/2.5" 
         selected="true" 
         name="Eclipse BIRT"/>
       ...
    </bookmarks>

Using the IXIASOFT update site

You can also use the IXIASOFT update site directly to deploy plug-ins to your users. In this case, you simply provide these URLs to your users so that they can update their DITA CMS themselves.

The following table lists the URLs for the IXIASOFT update sites:
Update site URL
DITA CMS Administration http://cms.ixiasoft.com/update-site-4.2/dita-cms-admin/site.xml
TEXTML Administration http://cms.ixiasoft.com/update-site-4.2/textml-admin
DITA CMS (includes the following plug-ins):
  • DITA Content Management System
  • Collaborative Reviewer
  • oXygen XML Extension (Editor)
  • oXygen XML Extension (Author)
  • XMetaL XMAX Extension
  • HyperSTE
  • Dynamic Release Management
http://cms.ixiasoft.com/update-site-4.2/dita-cms/site.xml
DITA 1.2 Specification http://cms.ixiasoft.com/update-site-4.2/dita-doc/site.xml