Renderx XEP User Guide XEP User Guide
Total Page:16
File Type:pdf, Size:1020Kb
RenderX XEP User Guide XEP User Guide © Copyright 2005-2019 RenderX, Inc. All rights reserved. This documentation contains proprietary information belonging to RenderX, and is provided under a license agreement containing restrictions on use and disclosure. It is also protected by international copyright law. Because of continued product development, the information contained in this document may change without notice.The information and intellectual property contained herein are confidential and remain the exclusive intellectual property of RenderX. If you find any problems in the documentation, please report them to us in writing. RenderX does not warrant that this document is error- free. No part of this publication may be reproduced, stored in a retrieval system, or transmitted in any form or by any means - electronic, mechanical, photocopying, recording or otherwise - without the prior written permission of RenderX. RenderX Telephone: 1 (650) 328-8000 Fax: 1 (650) 328-8008 Website: http://renderx.com Email: [email protected] Table of Contents 1. Preface ................................................................................................................... 9 1.1. What©s in this Document? .............................................................................. 9 1.2. Prerequisites ................................................................................................ 9 1.3. Acronyms ................................................................................................... 10 1.4. Technical Support ....................................................................................... 11 2. Overview ............................................................................................................... 13 2.1. Introduction ................................................................................................. 13 2.2. Basic Terms ................................................................................................ 14 3. XEP Assistant ........................................................................................................ 17 3.1. What is XEP Assistant? ............................................................................... 17 3.2. Opening XEP Assistant ............................................................................... 17 3.3. Rendering an XML File using XEP Assistant ................................................. 17 3.3.1. Opening a File .................................................................................. 17 3.3.2. Formatting a File .............................................................................. 18 4. Using the Command Line ....................................................................................... 23 4.1. Running XEP .............................................................................................. 23 4.2. XEP Options ............................................................................................... 23 4.3. XEP Switches ............................................................................................. 24 4.4. XEP Arguments .......................................................................................... 25 4.5. Examples of Running XEP from the Command Line ...................................... 26 5. Configuring XEP .................................................................................................... 29 5.1. Configuring XEP using XEP Assistant .......................................................... 29 5.1.1. Configuring Main Settings ................................................................. 29 5.1.2. Configuring Backends ....................................................................... 31 Configuring the Backend for PDF Files ................................................ 32 Configuring the Backend for PostScript Files ....................................... 34 Configuring the Backend for AFP Files ................................................ 36 Configuring the Backend for SVG Files ............................................... 39 Configuring the Backend for PPML Files ............................................. 40 Configuring the Backend for XHTML Files ........................................... 42 5.1.3. Configuring Languages ..................................................................... 43 5.1.4. Configuring Fonts ............................................................................. 44 5.2. Configuring XEP via the XEP Configuration File ............................................ 46 5.2.1. Configuration Structure ..................................................................... 46 5.2.2. Core Options .................................................................................... 47 5.2.3. Configuring Output Formats .............................................................. 51 Unicode Strings in Annotations (PDF, PostScript) ................................ 52 Initial Zoom Factor (PDF, PostScript) ................................................... 52 PDF Initial View (PDF, PostScript) ....................................................... 53 Logical Page Numbering (PDF) .......................................................... 53 Page Layout (PDF) ............................................................................ 54 PDF Viewer Preferences (PDF) .......................................................... 54 RenderX XEP 4.30.915 RenderX XEP User Guide Page 3 Contents Treatment of Unused Destinations (PDF, PostScript) ............................ 55 ICC Profile (PDF) .............................................................................. 55 PDF/X Support (PDF) ........................................................................ 55 PDF/A Support (PDF) ........................................................................ 55 Prepress Support (PDF, PostScript) .................................................... 56 PDF Version (PDF) ............................................................................ 57 Compression of PDF Streams (PDF) .................................................. 57 Linearization (PDF) ............................................................................ 58 Document Security (PDF) .................................................................. 58 PostScript Language Level (PostScript) ............................................... 59 EPS Graphics Treatment (PostScript) .................................................. 60 Page Device Control (PostScript) ........................................................ 60 Invoke Medium Map (AFP) ................................................................. 60 Page Labeling (PostScript) ................................................................. 61 Inserting Custom Comments (PostScript) ............................................ 61 Image Inline Threshold (PostScript) .................................................... 61 Images Treatment in XML Output (XEP, SVG, XHTML) ......................... 62 Break pages (SVG/XHTML) ............................................................... 62 Generate first N pages (SVG/XHTML) ................................................. 63 Generate XForms (XHTML) ............................................................... 63 5.2.4. External Document Injection (PDF) .................................................... 63 5.2.5. Configuring Fonts ............................................................................. 65 Fonts and Font Families ..................................................................... 65 Font Groups ...................................................................................... 68 Font Aliases ...................................................................................... 68 5.2.6. Configuring Languages ..................................................................... 69 Configuring Hyphenation .................................................................... 69 Language-Specific Font Aliases .......................................................... 69 5.3. Resolution of External Entities and URIs ....................................................... 69 6. XEP AFP Generator ............................................................................................... 71 6.1. Generating AFP Documents ........................................................................ 71 6.2. Fonts .......................................................................................................... 71 6.2.1. Font Mapping ................................................................................... 71 6.3. Images ....................................................................................................... 72 6.3.1. Image Support ................................................................................. 72 6.3.2. Referencing Images .......................................................................... 72 6.3.3. Image Clipping ................................................................................. 73 6.4. Highlight Color Support ............................................................................... 73 6.5. Graphics Support ........................................................................................ 74 6.6. Barcodes Support ....................................................................................... 77 6.7. FORMDEF Resource .................................................................................