Configuring a new XPP installation to publish PDFs
This task includes instructions for those installing XPP for the first time. It describes how to configure your environment as required to publish PDFs from Contenta S1000D.
About this task
You can create PDFs from Contenta S1000D using XPP. For more information about PDF creation in XPP, see XML Professional Publisher: PDF Support in XPP.
Procedure
- Install XPP server.
You can install XPP on a completely different server (recommended), your Contenta Web server, or your Contenta application server. See XML Professional Publisher Installation and Upgrade Guide.
- On the XPP server, install XPP RESTful Web Services.
See XPP RESTful Web Services Installation and Release Notes Chapter 1: Installing XPPRESTful Web Services.
- On the XPP server, do the following.
- In XyAdmin, click File > Graphics Configuration.
- Add a rule.
- In the Library Name field, type a name for your graphics library. This name must match the
xppImageLibrarysetting in PublishConfiguration.xml, located in the web/cw_common/custom/S1000D_Publish/ subdirectory of the Contenta_home directory on the Contenta Web server, which is set to graphics by default. - In the Library Path field, type ../graphics (or other name as needed to match your
xppImageLibrarysetting value)Note: When publishing to XPP from Contenta S1000D, the XPP graphics library must be at the XPP job level because this library is dynamically created each time XPP Publish is run. Setting the Library Path to ../<XPP_graphics_library_name> specifies a job-level graphics library. - Optionally, in the Comment field, type Job-level graphics library for S1000D XPP Publish.
- Store and exit the spec.
- On the XPP server, do the following.
- In XyAdmin, click File > Document Paths.
- In the Handle text box, type the name of the handle where you want S1000D jobs and divisions to go.
- In the Path text box, type the path to the directory where the handle, jobs, and division files will be stored.
- Click OK.
Windows XPP servers have a default handle called first and Linux XPP servers have a default handle called host-name1 (for example, neptune1). You may choose to use the default handle to store your S1000D jobs. The handle name is case sensitive and must match the value specified forxppHandlein the PublishConfiguration_Unix.xml file, which is located in the web/cw_common/custom/S1000D_Publish/PublishConfiguration_Unix.xml subdirectory of the Contenta_home directory on the Contenta Web server.Note: If you create a new document root handle, you must stop and restart XPP RESTful Web Services to see the change when you publish. - Navigate to the S1000D_samples/xpp/ subdirectory of the Contenta_home directory on the Contenta Web server.
In the following steps, you will copy zip files from this directory to various locations in the XPP_home directory on your XPP server and extract their contents.Important: If your XPP server runs on Linux, ensure that the files you extract in the following steps have read and write permissions.
- Copy s1kdXppCssStyles.zip from the Contenta/S1000D_samples/xpp/ directory on the Contenta Web server to the sd_liz/ subdirectory of the XPP_home directory on the XPP server, and extract its contents to a directory named Ls1kd_css.
If you have custom XPP styles, contact RWS Customer Support for assistance on merging old and new styles in this release of Contenta S1000D.
- Copy s1kdXppCssJob.zip from the Contenta/S1000D_samples/xpp/ directory on the Contenta Web server to the std_jobz/alljobz/ subdirectory of the XPP_home directory on the XPP server, and then extract its contents to a directory named CLS_SAMPLEBIKECSS.
This extracts the following sample XPP jobs: CLS_SAMPLEBIKECSS/GRP_XYENT/JOB_00030-01, JOB_00040-01, and JOB_00041-01.
- Copy the appropriate file for your XPP server from the Contenta/S1000D_samples/xpp directory on the Contenta Web server to the XPP_home directory on the XPP server, and then extract its contents.
- For a Windows XPP server, copy and extract s1000dXppXz.zip.
- For a Linux XPP server, copy and extract s1000dXppXz_Unix.zip.
This extracts the xz/procs/citi/pgcnt.pl and xz/xpprest/user/modifytoc.pl files to existing directories, which already contain other files. - Linux only: Set permissions on the extracted pgcnt.pl and modifytoc.pl files to make them executable as well as read and write.
- On the Contenta Web server, do the following.
- Navigate to the web/cw_common/custom/S1000D_Publish/ subdirectory of the Contenta_home directory.
- Open PublishConfiguration.xml for editing.
- Change the
xppHostandxppPortsettings to point to the XPP RESTful Web Services host and port (typically2995by default). - Edit the following line:
<property name="xppHandle" value="name of handle"/>where name of handle is the name of the XPP handle where S1000D jobs and divisions will go. By default, the value is
first. If XPP is installed on Windows, you will have a handle namedfirstand do not need to modify this line if you want to use this handle. However, if XPP is installed on Linux, you must changefirstto another value. - Edit the following line:
<property name="xppServerOS" value="XPP server operating system"/>where XPP server operating system is
WINDOWSorUNIX. If your XPP server is the same OS as your Contenta Web server, you do not need to edit this line.
- If you are publishing multiple languages to XPP, do the following.
- Obtain all fonts you will be using in various languages.
- Use XPP Font Copy and Build FAST utilities to add these fonts to XPP.
- Add the new FASTs to XPP Font Variant spec that is used when publishing from Contenta S1000D, fv_sys, located in the Ls1kd_css XPP style library if using CSS styles.
Note: The delivered styles use the Helvetica font family, which is Font Family 1 in fv_sys. If possible, add your new FASTs to Font Family 1, which can reference up to three FASTS: primary, secondary, and default. See the XPP documentation for more information.
- Resolving entities when publishing to XPP
If you do not have Internet access and use ISOEntities declarations, you will need to configure XPP to resolve character entities when publishing to XPP to create PDFs.