PubAssist

Overview

PubAssist is the latest iteration of the InfoDev publishing tool. It is designed to allow you a quick and easy method of accessing your documentation's source files and publishing content to the InfoDev servers.

Selecting the PubAssist button in the left navigation displays the PubAssist tool.
Note: If you have not run PubAssist before or have not created any profiles, PubAssist will not have profiles to display.
The following sections explain the details of each area of the PubAssist screen.
Note: Refer to Publish Single File or Restoring an Archive for details when selecting each respective button.

Profiles List

The Profiles list provides a way to create and maintain profiles, as well as selecting profiles for publishing.
Figure 1. Profile list as a scrollable list

Queue buttons

To publish your documents, you need to place them in the Publishing Queue. This is done for publishing singleprofiles or queueing up multiple profiles for automatic consecutive publishing. The following buttons are available:
  • Add to Queue: Allows you to place the selected profile in queue to the desired server. Selecting Add to Queue displays the Add to Queue menu from which you can select the desired server.
    Selecting a server from the context menu places the profile in queue and increases the queue number on the Open Queue button.
    Note: From within Settings, you can select to not show the Expere, Testing and Production options.
  • Open Queue: This button displays the number of items currently in the queue, and provides the method for accessing the Publishing Queue. For more information, refer to Publishing Queue.

View in Browser

This grouping of tools allows you to display the selected profile in your browser.
You can select which server to view your document on using the context menu for the View on button.
Note: The icon for the Localhost selection displays the status of the USBWebserver. The above example shows the USBWebserver is currently running. If the USBWebserver is not recognized as running, the icon appears like this:

Using browser variables

If you use dynamic profiling within your published content, you can also make use of the variables feature in IDT. Simply select Use variables in the View in browser group and enter the desired values (or leave blank) for the Audience, Revision and Product values.
Note:
  • The Use variables, Aud, Rev, and Prod values are automatically saved to the IDT settings and are retained between IDT sessions.
  • The variables displayed in each list can be edited within the Editor once you have an item in the list.
When values are used, selecting a server from the View on context menu results in the variables being appened to the URL when displayed in the browser.

Last Modified Dates

The Last Modified Dates feature presents published information for the selected profile.

Last Modified Dates (LMD) and Last Published Dates (LPD) are provided for each server environment. The Last Modified Dates display the latest date that the item on the server was modified (transformed in Oxygen). The Last Published Dates display the last time the content was published by IDT to the server.

This information is helpful in determining if your content has been published to a specific server since you last transformed it. For example, you would not need to publish to Staging if your Source and Staging dates are the same. IF Source is a later date than Staging, you need to publish to Staging.

If you select Auto check, the Last Modified Dates are refreshed automatically when you select a profile from the Profiles List. You can manually refresh the information at any time by selecting Refresh Dates.
Note: From within Settings, you can select to not show the Expere, Testing and Production columns.

Profile Details

The Profile elments section is where you view, edit and create the details for each individual profile.
Note: When a profile is selected, the number of files within the Source location is displayed on the right side of the Profile Details titlebar.
Feature Description
Profile Name The name of the profile.
  • This is typically the name of the document artifact (OPPSA User Guide, etc.)
  • This is the name that is displayed in the Profiles List.
Source Folder The location of the files that are transformed by Oxygen (the location of the Oxygen output folder).
Note: For the purpose of PubAssist, it may be easier for you to crate multiple transformation scenarios in Oxygen - one for each document you transform. Having Oxygen transform to individual locations in the C:\DITA\Server framework allows for a local representation of the content that is more identical with the servers.
Server Folder Allows you to select a location on the development server to which the content of the profile will publish. the location selected will be the same across all servers.
Oxygen Project* Allows you to select the associated Oxygen project file. This is helpful if you have mapped the DITA Repository to a network drive. Clicking the Oxygen button opens the project file within Oxygen.
DITAMap* Allows you to select the associated Oxygen DITAMap file. This is helpful if you have mapped the DITA Repository to a network drive. Clicking the Oxygen button opens the ditamap file within Oxygen.
Add Profile Creates a new profile that includes the information in the Profile elements text boxes.
Update Profile Updates the currently selected profile.
*Optional