Using extendedPDF with NeoOffice

From NeoWiki

(Difference between revisions)
Jump to: navigation, search
Revision as of 09:18, 2 January 2005 (edit)
Waldo ( | contribs)
(from old wiki)
← Previous diff
Revision as of 08:04, 21 January 2005 (edit) (undo)
Sardisson (Talk | contribs)
(move updated version from old wiki)
Next diff →
Line 3: Line 3:
''There is a [[X11ExtendedPDF|separate version]] of this tutorial addressing [[OpenOffice.orgX11|OpenOffice.org/X11]], which behaves differently in a number of key places.'' ''There is a [[X11ExtendedPDF|separate version]] of this tutorial addressing [[OpenOffice.orgX11|OpenOffice.org/X11]], which behaves differently in a number of key places.''
-The extendedPDF macro is used to create structured PDFs (those with bookmarks, sections, etc.) in [[OpenOffice.org|OpenOffice.org]]. Marc Liyanage has a tutorial on configuring this macro for use with OpenOffice.org Mac OS X (X11), but there are some additional details and steps needed to use this macro with NeoOffice/J.+The extendedPDF macro is used to create structured PDFs (those with bookmarks, sections, etc.) in [[OpenOffice.org|OpenOffice.org]]. Marc Liyanage has a tutorial on configuring this macro for use with [[OpenOffice.orgX11|OpenOffice.org Mac OS X (X11)]], but there are some additional details and steps needed to use this macro with NeoOffice/J.
-(This is a stub topic to remind [[User:Sardisson|sardisson]] or someone else to edit and post the info. In the meantime, the details can be found in this thread at trinity: http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&p=5220#5220)+=== Initial setup ===
 + 
 +# Download the extendedPDF macro from the [http://www.jdisoftware.co.uk/pages/epdf-home.php JDiSoftware site] and install as instructed.
 +# If you do not have a printer connected to your Mac, you will need to set up a "dummy" PostScript printer. ('''Acrobat’s "Adobe PDF" dummy printer will not work.''')
 +## Open Print Setup Utility (<tt>/Applications/Printer Setup Utility</tt>) and click "Add" to set up a new printer.
 +### Choose "IP Printing" from the drop-down list.
 +### Choose "Internet Printing Protocol" as the Printer Type.
 +### Enter <tt>localhost</tt> as the Printer Address; leave the Queue Name blank.
 +### For Printer Model, select a recent HP LaserJet, like the LaserJet 4050 Series.
 + 
 +=== Configuring extendedPDF ===
 + 
 +You can set up extendedPDF according to [http://www.entropy.ch/software/macosx/docs/openoffice-mac/ Marc Liyanage’s instructions], with the following changes:
 + 
 +# Configuration pane:
 +## In NeoOffice/J, the printer name setting does not matter and can remain "Generic Printer".
 +## For the path to GhostScript, enter the path to your copy of Marc Liyanage’s Acrobat Distiller helper script (e.g., <tt>/Users/macuser/bin/NeoOfficeJ_pdf_helper.pl</tt>) if you use Distiller; if you will be using GhostScript, leave the setting as <tt>gs</tt>.
 +### ''(If you use Acrobat Distiller, be sure the name in Marc's script matches the name of the Distiller app on your Mac—without the .app extension, e.g., Acrobat Distiller 6.0.3.)''
 +# File Settings pane:
 +## Choose a location for the temporary files; '''you will need to remember this location''' for step 1.2.1 in the ''Invoking the extendedPDF macro on a document'' section below.
 +## As in Marc's tutorial, you might wish to check "Delete temporary files" once you have extendedPDF working properly.
 +## If you want the final PDFs to be created in a location other than that where the source .sxw document is located, enter this location in the "Output folder" field (e.g., <tt>/Users/macuser/Documents/extendedPDFs/</tt>).
 + 
 +=== Invoking the extendedPDF macro on a document ===
 + 
 +Once you have set up the other extendedPDF options to suit your needs and have created a properly styled document, you are ready to invoke the macro. There are a couple of additional steps required to avoid errors or problems in generating the final PDF.
 + 
 +# When the extendedPDF macro does its magic, it calls the native Print dialogue box for your default printer.
 +## Select the "Output Options" pane from the third drop-down menu (the one that defaults to "Copies & Pages"); check the "Save as File" box and "PostScript" as the Format.
 +### ''(If you will be using extendedPDF often, you may wish to now select "Save as Preset" from the "Presets" drop-down menu. In the future, you will be able to simply select the preset for this step.)''
 +## Click the "Save…" button to save the temporary file. '''The location and filename required are very specific!'''
 +### Be sure to save the file to the location you selected in step 2.1 of the ''Configuring extendedPDF'' section of this tutorial.
 +### The name of the file you save needs to be <tt>filename.ps</tt> (e.g., if your document’s name is <tt>My Extended PDF.sxw</tt>, the filename you specify in the Save box should be <tt>My Extended PDF.ps</tt>).
 +# extendedPDF and Distiller or GhostScript now do their magic and the PDF is saved in the location you specified, if any, in the "Output folder" field of extendedPDF’s File Settings pane.
 + 
 +=== Known Issues ===
 + 
 +* NeoOffice/J currently does not print (or pass to PDFs) embedded EPS files.
 +* Extended PDFs produced by NeoOffice/J using GhostScript currently render the text as "garbage" in Preview and as blank space in Acrobat.
 +* There are reports that link boxes are poorly-rendered and mis-aligned.
 + 
 +=== Further Reference ===
* ExtendedPDF can be found at the JDiSoftware site: http://www.jdisoftware.co.uk/pages/epdf-home.php * ExtendedPDF can be found at the JDiSoftware site: http://www.jdisoftware.co.uk/pages/epdf-home.php
* Marc's Liyanage has a tutorial posted at: http://www.entropy.ch/software/macosx/docs/openoffice-mac/ * Marc's Liyanage has a tutorial posted at: http://www.entropy.ch/software/macosx/docs/openoffice-mac/
 +* Discussion of using extendedPDF with OpenOffice.org/X11 and NeoOffice/J on [http://trinity.neooffice.org trinity]:
 +** http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&t=901
 +** http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&t=976

Revision as of 08:04, 21 January 2005

Contents

Using the extendedPDF macro with NeoOffice/J

There is a separate version of this tutorial addressing OpenOffice.org/X11, which behaves differently in a number of key places.

The extendedPDF macro is used to create structured PDFs (those with bookmarks, sections, etc.) in OpenOffice.org. Marc Liyanage has a tutorial on configuring this macro for use with OpenOffice.org Mac OS X (X11), but there are some additional details and steps needed to use this macro with NeoOffice/J.

Initial setup

  1. Download the extendedPDF macro from the JDiSoftware site and install as instructed.
  2. If you do not have a printer connected to your Mac, you will need to set up a "dummy" PostScript printer. (Acrobat’s "Adobe PDF" dummy printer will not work.)
    1. Open Print Setup Utility (/Applications/Printer Setup Utility) and click "Add" to set up a new printer.
      1. Choose "IP Printing" from the drop-down list.
      2. Choose "Internet Printing Protocol" as the Printer Type.
      3. Enter localhost as the Printer Address; leave the Queue Name blank.
      4. For Printer Model, select a recent HP LaserJet, like the LaserJet 4050 Series.

Configuring extendedPDF

You can set up extendedPDF according to Marc Liyanage’s instructions, with the following changes:

  1. Configuration pane:
    1. In NeoOffice/J, the printer name setting does not matter and can remain "Generic Printer".
    2. For the path to GhostScript, enter the path to your copy of Marc Liyanage’s Acrobat Distiller helper script (e.g., /Users/macuser/bin/NeoOfficeJ_pdf_helper.pl) if you use Distiller; if you will be using GhostScript, leave the setting as gs.
      1. (If you use Acrobat Distiller, be sure the name in Marc's script matches the name of the Distiller app on your Mac—without the .app extension, e.g., Acrobat Distiller 6.0.3.)
  2. File Settings pane:
    1. Choose a location for the temporary files; you will need to remember this location for step 1.2.1 in the Invoking the extendedPDF macro on a document section below.
    2. As in Marc's tutorial, you might wish to check "Delete temporary files" once you have extendedPDF working properly.
    3. If you want the final PDFs to be created in a location other than that where the source .sxw document is located, enter this location in the "Output folder" field (e.g., /Users/macuser/Documents/extendedPDFs/).

Invoking the extendedPDF macro on a document

Once you have set up the other extendedPDF options to suit your needs and have created a properly styled document, you are ready to invoke the macro. There are a couple of additional steps required to avoid errors or problems in generating the final PDF.

  1. When the extendedPDF macro does its magic, it calls the native Print dialogue box for your default printer.
    1. Select the "Output Options" pane from the third drop-down menu (the one that defaults to "Copies & Pages"); check the "Save as File" box and "PostScript" as the Format.
      1. (If you will be using extendedPDF often, you may wish to now select "Save as Preset" from the "Presets" drop-down menu. In the future, you will be able to simply select the preset for this step.)
    2. Click the "Save…" button to save the temporary file. The location and filename required are very specific!
      1. Be sure to save the file to the location you selected in step 2.1 of the Configuring extendedPDF section of this tutorial.
      2. The name of the file you save needs to be filename.ps (e.g., if your document’s name is My Extended PDF.sxw, the filename you specify in the Save box should be My Extended PDF.ps).
  2. extendedPDF and Distiller or GhostScript now do their magic and the PDF is saved in the location you specified, if any, in the "Output folder" field of extendedPDF’s File Settings pane.

Known Issues

  • NeoOffice/J currently does not print (or pass to PDFs) embedded EPS files.
  • Extended PDFs produced by NeoOffice/J using GhostScript currently render the text as "garbage" in Preview and as blank space in Acrobat.
  • There are reports that link boxes are poorly-rendered and mis-aligned.

Further Reference

Personal tools