Generating content for LiveContent S1000D Mobile

The Mobile Publish Manager service uses LiveContent S1000D Publish and CollectionPub to create a CD image containing an instance of an IETM for viewing on a LiveContent S1000D Mobile tablet device (or the LiveContent S1000D desktop application).

Before you begin

  • LiveContent S1000D must contain the collection including a publication to be published.
  • The mobile-publish-manager.jar file must reside in the same folder as the LiveContent S1000D Publish utility.

About this task

Use Mobile Publish Manager LiveContent S1000D Publish to generate a CD image containing an IETM in XML format.
The Mobile Publish Manager checks whether the CreateUpdateXML and UpdateDirectory configuration items are present in the configuration file, adds them if they are not, and sets them to the following values.
  • CreateUpdateXML is set to 1

  • UpdateDirectory is set to the publication output folder. For example, if the publication output folder is C:\XyEnterprise\LiveContentData\publications\bike, it is set to C:\XyEnterprise\LiveContentData\publications\bike\mobile\xml.

LiveContent S1000D Mobile uses dedicated XSL style files to transform content for display on a mobile device. These files are delivered to the ...\templates\FullSupport\etc\styles\mobile folder on the Publishing Server during installation, and transferred to the mobile device with the CD image. Any customizations to XML styles must be applied to these files as well as those in the ...\templates\FullSupport\etc\styles folder to maintain synchronization between mobile and desktop IETMs.
The published CD image zip file includes a JSON file named packageName.library.json, which contains an inventory of metadata describing the properties of each book in the published IETM. These properties help mobile client users identify content to load on their mobile devices. The metadata also includes a relative path to the actual XML data cdimage ZIP archive. The following is an example of a book defined in the packageName.library.json file:
{ "lastUpdated" : "2021-03-29T05:44:33Z", 
  "collections" : [ 
  { 
    "id" : "default", 
    "title" : "Default Collection", 
    "books" : [ 
    { 
      "id" : "s1000d_bike_41", 
      "title" : "BIKE41 publication", 
      "path" : "BIKE41.zip", 
      "publishedOn" : "2020-01-11T00:00:00Z", 
      "lastUpdated" : "2021-03-29T05:44:33Z" 
    } 
   ] 
  } 
 ] 
}

Procedure

  1. Navigate to the folder containing the LiveContent S1000D Publish utility and mobile-publish-manager.jar file.
  2. From the command line, invoke the Mobile Publish Manager as follows, specifying the locations of the publication configuration file and collections folder, and optionally, the name of the published output package ZIP file, and any arguments to be sent to the LiveContent S1000D Publish utility.
    java -jar mobile-publish-manager.jar -pub pubConfigLocation -coll collectionFolderLocation [-name packageName] [-pubArgs arguments]
    The following table describes each parameter for the mobile-publish-manager.jar file.
    ParameterDescription
    -pubRequired. File path to the publish configuration file.
    -collRequired. File path to the collection folder.
    -nameOptional. Name of the output package ZIP file. If not specified, the collection name is used.
    -pubargsOptional. One or more arguments to be passed to the LiveContent S1000D Publish utility. For more information about these arguments, refer to the LiveContent S1000D Publish user documentation.

Results

A ZIP archive of the CD image containing mobile and desktop versions of the IETM

file is

created in a new mobilepackages folder in publication data folder on the Publishing Server such as ..\LiveContentData\mobilepackages.