<?xml version="1.0" encoding="UTF-8"?>


<!--
 * This file is part of the LibreOffice project.
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
 *
 * This file incorporates work covered by the following license notice:
 *
 *   Licensed to the Apache Software Foundation (ASF) under one or more
 *   contributor license agreements. See the NOTICE file distributed
 *   with this work for additional information regarding copyright
 *   ownership. The ASF licenses this file to you under the Apache
 *   License, Version 2.0 (the "License"); you may not use this file
 *   except in compliance with the License. You may obtain a copy of
 *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
 -->

<helpdocument version="1.0">
<meta>
<topic id="textsharedguidespadminxml" indexer="include" status="PUBLISH">
<title id="tit" xml-lang="en-US">Setting up Printer and Fax Under UNIX Based Platforms</title>
<filename>/text/shared/guide/spadmin.xhp</filename>
</topic>
</meta>
<body>
<section id="chapter_all">
<bookmark xml-lang="en-US" branch="index" id="bm_id3154422"><bookmark_value>spadmin</bookmark_value>
<bookmark_value>printers; adding, UNIX</bookmark_value>
<bookmark_value>default printer; UNIX</bookmark_value>
<bookmark_value>standard printer under UNIX</bookmark_value>
<bookmark_value>faxes; fax programs/fax printers under UNIX</bookmark_value>
<bookmark_value>printers; faxes under UNIX</bookmark_value>
<bookmark_value>PostScript; PDF converter, UNIX</bookmark_value>
<bookmark_value>converters; PostScript, UNIX</bookmark_value>
<bookmark_value>PDF; PostScript to PDF converter, UNIX</bookmark_value>
</bookmark><comment>mw deleted "printer programs under UNIX",  "fax programs under UNIX" and "font programs under UNIX" and changed "faxes;..."</comment>
<paragraph role="paragraph" id="par_id3154422" xml-lang="en-US" l10n="E" oldref="341" localize="false"/>
<paragraph role="heading" id="hd_id3147834" xml-lang="en-US" level="1" l10n="CHG" oldref="1"><variable id="spadmin"><link href="text/shared/guide/spadmin.xhp" name="Setting up Printer and Fax Under UNIX Based Platforms">Setting up Printer and Fax Under UNIX Based Platforms</link>
</variable></paragraph>
<section id="chapter_body">
<paragraph role="paragraph" id="par_id3159876" xml-lang="en-US" l10n="NEW">%PRODUCTNAME uses the installed fonts of your system. In a text document you can select from all printable fonts. In an HTML document or in Web layout, only fonts that are visible on screen are offered. In spreadsheets and drawings you can select from all installed fonts.</paragraph>

<paragraph role="paragraph" id="par_id3159233" xml-lang="en-US" l10n="U" oldref="2">Under UNIX based platforms, the printer administration program <emph>spadmin</emph> is provided to help you set up printers and faxes for use with the $[officename] software.</paragraph>
<paragraph role="paragraph" id="par_id3156410" xml-lang="en-US" l10n="U" oldref="117">Call the printer administration program <emph>spadmin</emph> as follows:</paragraph>
<list type="unordered">
<listitem>
<paragraph role="listitem" id="par_id3147242" xml-lang="en-US" l10n="U" oldref="11">Change to the {install_path}/program directory.</paragraph>
</listitem>
<listitem>
<paragraph role="listitem" id="par_id3147209" xml-lang="en-US" l10n="U" oldref="12">Enter: ./spadmin</paragraph>
</listitem>
</list>
<paragraph role="paragraph" id="par_id3152349" xml-lang="en-US" l10n="U" oldref="14">After it starts, the window of the printer administration program <emph>spadmin</emph> appears.</paragraph>
<paragraph role="paragraph" id="par_id3149580" xml-lang="en-US" l10n="U" oldref="10">Following a server installation, the system administrator first logs on as with root privileges, and starts the printer administration program <emph>spadmin</emph>. The administrator then creates a general printer configuration file called {install_path}/share/psprint/psprint.conf for all users. All changes are immediately available to all users.</paragraph>

<paragraph role="heading" id="hd_id3159177" xml-lang="en-US" level="2" l10n="U" oldref="121">Setting up Printers</paragraph>
<paragraph role="paragraph" id="par_id3159157" xml-lang="en-US" l10n="U" oldref="122">Under UNIX based platforms, the $[officename] software only offers direct support for printers using the PostScript technology. Other printers must be set up as described in the section <emph>Printer Drivers in the $[officename] Software</emph>. The $[officename] software automatically provides a printer with the default driver for each system queue. You can add additional printers as needed.</paragraph>
<paragraph role="heading" id="hd_id3148564" xml-lang="en-US" level="3" l10n="U" oldref="286">Adding a Printer</paragraph>
<list type="ordered">
<listitem>
<paragraph role="listitem" id="par_id3147559" xml-lang="en-US" l10n="U" oldref="353">Change to the {install_path}/program directory.</paragraph>
</listitem>
<listitem>
<paragraph role="listitem" id="par_id3152360" xml-lang="en-US" l10n="U" oldref="354">Enter: ./spadmin</paragraph>
</listitem>
<listitem>
<paragraph role="listitem" id="par_id3153360" xml-lang="en-US" l10n="U" oldref="287">Click the <emph>New Printer</emph> button.</paragraph>
</listitem>
<listitem>
<paragraph role="listitem" id="par_id3151210" xml-lang="en-US" l10n="U" oldref="288">Select the <emph>Create Printer</emph> option and click <emph>Next</emph>.</paragraph>
</listitem>
<listitem>
<paragraph role="listitem" id="par_id3153192" xml-lang="en-US" l10n="U" oldref="289">Select the appropriate driver for your printer. If you are not using a PostScript printer or your model is not listed, use the <emph>Generic Printer</emph> driver or follow the steps below. You can also add new drivers using the <emph>Import</emph> button or delete unnecessary drivers using the <emph>Delete</emph> button. Click <emph>Next</emph>.</paragraph>
</listitem>
<listitem>
<paragraph role="listitem" id="par_id3125863" xml-lang="en-US" l10n="U" oldref="290">Choose a command line that you can use to print on your printer (for example, lp -d my_queue). Click <emph>Next</emph>.</paragraph>
</listitem>
<listitem>
<paragraph role="listitem" id="par_id3150767" xml-lang="en-US" l10n="U" oldref="291">Give the printer a name and determine whether it should become the default printer. Click <emph>Finish</emph>.</paragraph>
</listitem>
<listitem>
<paragraph role="listitem" id="par_id3155429" xml-lang="en-US" l10n="U" oldref="292">To print a test page, click on <emph>Test Page</emph>. If the test page fails to print or is incorrectly printed, check all settings as described in <emph>Changing Printer Settings</emph>.</paragraph>
</listitem>
</list>
<paragraph role="heading" id="hd_id3146147" xml-lang="en-US" level="3" l10n="U" oldref="294">Printer Drivers in the $[officename] Software</paragraph>
<paragraph role="paragraph" id="par_id3147428" xml-lang="en-US" l10n="U" oldref="124">When installing a non-PostScript printer, you must set your system so that PostScript can be converted into the language of the printer. We recommend using current PostScript conversion software such as Ghostscript (http://www.cs.wisc.edu/~ghost/).</paragraph>
<paragraph role="paragraph" id="par_id3154639" xml-lang="en-US" l10n="U" oldref="125">You should set up the <emph>Generic Printer</emph> in that case. Also make sure that the page margins are set correctly.</paragraph>
<paragraph role="paragraph" id="par_id3159153" xml-lang="en-US" l10n="U" oldref="127">If you are using a printer using the PostScript technology, you should install a description file for the printer (PostScript Printer Definition - PPD) so that you can utilize the specific printer features like paper tray selection, duplex print function and all built-in fonts. You can also use the generic printer driver since it contains the most important data and is suitable for most printers. In that case, you will have to do without the paper tray selection and must correctly set the page margins.</paragraph>
<paragraph role="paragraph" id="par_id3146976" xml-lang="en-US" l10n="U" oldref="128">Some PPD files are installed as default files. If there is no matching PPD file for your printer, you will find various PPD files at http://www.adobe.com/products/printerdrivers/. You can also ask the manufacturer of your printer for PPD files. </paragraph>
<paragraph role="heading" id="hd_id3147435" xml-lang="en-US" level="4" l10n="U" oldref="346">Importing Drivers When Creating a New Printer</paragraph>
<list type="ordered">
<listitem>
<paragraph role="listitem" id="par_id3149484" xml-lang="en-US" l10n="U" oldref="129">Click <emph>Import</emph> in the driver selection dialog.</paragraph>
</listitem>
<listitem>
<paragraph role="listitem" id="par_id3149260" xml-lang="en-US" l10n="U" oldref="347">Click <emph>Browse</emph> to select the directory where you unpacked the PPD files. </paragraph>
</listitem>
<listitem>
<paragraph role="listitem" id="par_id3147443" xml-lang="en-US" l10n="U" oldref="348">In the <emph>Selection of drivers</emph> list box, select the printer driver you want to install.</paragraph>
</listitem>
<listitem>
<paragraph role="listitem" id="par_id3145364" xml-lang="en-US" l10n="U" oldref="349">Click OK.</paragraph>
</listitem>
</list>
<paragraph role="heading" id="hd_id3152885" xml-lang="en-US" level="4" l10n="U" oldref="350">Deleting Drivers When Creating a New Printer</paragraph>
<list type="unordered">
<listitem>
<paragraph role="listitem" id="par_id3154729" xml-lang="en-US" l10n="U" oldref="130">Select the printer driver.</paragraph>
</listitem>
<listitem>
<paragraph role="listitem" id="par_id3155417" xml-lang="en-US" l10n="U" oldref="351">Click <emph>Delete</emph>.</paragraph>
</listitem>
</list>
<paragraph role="paragraph" id="par_id3149909" xml-lang="en-US" l10n="U" oldref="352">Be sure that you do not delete the generic printer driver, and remember that drivers deleted from server installations are no longer available to other users who are using the same server installation.</paragraph>
<paragraph role="paragraph" id="par_id3148456" xml-lang="en-US" l10n="U" oldref="131">If the printer has more fonts built in than the usual PostScript fonts, you must also load the AFM files for these additional fonts. Copy the AFM files into the {install_path}/share/psprint/fontmetric directory or into the {install_path}/user/psprint/fontmetric directory. You can find AFM files, for example, at ftp://ftp.adobe.com/pub/adobe/type/win/all/afmfiles/.</paragraph>
<paragraph role="heading" id="hd_id3148388" xml-lang="en-US" level="3" l10n="U" oldref="296">Changing Printer Settings</paragraph>
<paragraph role="paragraph" id="par_id3156284" xml-lang="en-US" l10n="U" oldref="22">In the printer administration program <emph>spadmin</emph>, select the printer from the <emph>Installed printers</emph> list box and click <emph>Properties</emph>. The <emph>Properties</emph> dialog appears containing several tab pages. This is where you can make settings that are used according to the PPD file of the selected printer.</paragraph>
<list type="unordered">
<listitem>
<paragraph role="listitem" id="par_id3148833" xml-lang="en-US" l10n="U" oldref="297">Select the command on the <emph>Command</emph> tab page. You can remove superfluous commands using the <emph>Remove</emph> button.</paragraph>
</listitem>
<listitem>
<paragraph role="listitem" id="par_id3154270" xml-lang="en-US" l10n="U" oldref="138">On the <emph>Paper</emph> tab page, you can define the paper format and paper tray to be used as the default settings for this printer.</paragraph>
</listitem>
<listitem>
<paragraph role="listitem" id="par_id3145649" xml-lang="en-US" l10n="U" oldref="265">On the <emph>Device</emph> tab page, you can activate the special options for your printer. If your printer can only print in black and white, choose "grayscale" under <emph>Color</emph>, otherwise choose "color". If switching to grayscale leads to unfavorable results, you can also select "color" under <emph>Color</emph> and see how the printer or PostScript emulator applies it. Furthermore, on this tab page you can set the precision with which colors are described as well as the PostScript level.</paragraph>
</listitem>
<listitem>
<paragraph role="listitem" id="par_id3150752" xml-lang="en-US" l10n="U" oldref="284">The <emph>Font Replacement</emph> tab page allows you to select a printer font type available in the printer for each font type installed on your computer. This way you can reduce the data volume sent to the printer. Font replacement can be turned on or off for each printer individually.</paragraph>
</listitem>
<listitem>
<paragraph role="listitem" id="par_id3153924" xml-lang="en-US" l10n="U" oldref="266">You should also set the page margins correctly on the <emph>Additional settings</emph> tab when using the generic printer driver so that your printout is not cropped. You can also enter a description in the Comments field, which will also be displayed on the <emph>Print</emph> dialog.</paragraph>
</listitem>
</list>
<paragraph role="paragraph" id="par_id3155443" xml-lang="en-US" l10n="U" oldref="267">Some of these settings can also be set for the current printout in the <emph>Print</emph> dialog or the <emph>Printer Settings</emph> dialog in the $[officename] software with the <emph>Properties</emph> button.</paragraph>
<paragraph role="heading" id="hd_id3150042" xml-lang="en-US" level="3" l10n="U" oldref="132">Renaming or Deleting Printers</paragraph>
<list type="unordered">
<listitem>
<paragraph role="listitem" id="par_id3147338" xml-lang="en-US" l10n="U" oldref="134">Select a printer from the <emph>Installed printers</emph> list box.</paragraph>
</listitem>
</list>
<list type="unordered">
<listitem>
<paragraph role="listitem" id="par_id3149258" xml-lang="en-US" l10n="U" oldref="136">To rename the selected printer, click <emph>Rename</emph>. Enter an appropriate name in the dialog that appears and click OK. The name must be unique and should be chosen so that you can recognize the printer and the application. Printer names must be assigned the same for all users because, when documents are exchanged, the selected printer remains unchanged if the recipient has it under the same name.</paragraph>
</listitem>
</list>
<list type="unordered">
<listitem>
<paragraph role="listitem" id="par_id3153963" xml-lang="en-US" l10n="U" oldref="137">To delete the selected printer, click <emph>Remove</emph>. The default printer or a printer that has been created by the system administrator in a server installation cannot be removed using this dialog.</paragraph>
</listitem>
</list>
<paragraph role="heading" id="hd_id3147346" xml-lang="en-US" level="3" l10n="U" oldref="140"><switchinline select="sys"><caseinline select="UNIX">Selecting a Default Printer </caseinline></switchinline></paragraph>
<list type="unordered">
<listitem>
<paragraph role="listitem" id="par_id3145769" xml-lang="en-US" l10n="U" oldref="31">To make the printer selected from the <emph>Installed printers</emph> list box the default printer, double-click its name or click the <emph>Default</emph> button.</paragraph>
</listitem>
</list>
<paragraph role="paragraph" id="par_id3150644" xml-lang="en-US" l10n="E" oldref="343" localize="false"/>
<paragraph role="heading" id="hd_id3154204" xml-lang="en-US" level="2" l10n="U" oldref="141">Using Fax Functionality</paragraph>
<paragraph role="paragraph" id="par_id3148463" xml-lang="en-US" l10n="U" oldref="52">If you have installed a fax package such as Efax or HylaFax on your computer, you can send faxes with the $[officename] software.</paragraph>
<list type="ordered">
<listitem>
<paragraph role="listitem" id="par_id3154575" xml-lang="en-US" l10n="U" oldref="355">Change to the {install_path}/program directory.</paragraph>
</listitem>
<listitem>
<paragraph role="listitem" id="par_id3151277" xml-lang="en-US" l10n="U" oldref="356">Enter: ./spadmin</paragraph>
</listitem>
<listitem>
<paragraph role="listitem" id="par_id3146808" xml-lang="en-US" l10n="U" oldref="298">Click <emph>New Printer</emph>. This opens the <emph>Add Printer</emph> dialog.</paragraph>
</listitem>
<listitem>
<paragraph role="listitem" id="par_id3151070" xml-lang="en-US" l10n="U" oldref="299">Select <emph>Connect a fax device</emph>. Click <emph>Next</emph>.</paragraph>
</listitem>
<listitem>
<paragraph role="listitem" id="par_id3150787" xml-lang="en-US" l10n="U" oldref="300">Choose whether to use the default driver or another printer driver. If you are not using the default driver, select the appropriate driver. Click <emph>Next</emph>.</paragraph>
</listitem>
<listitem>
<paragraph role="listitem" id="par_id3155111" xml-lang="en-US" l10n="U" oldref="301">Enter a command line with which to communicate with the fax in the following dialog. In the command line of each fax sent "(TMP)" is replaced by a temporary file and "(PHONE)" by the telephone number of the recipient fax machine. If "(TMP)" occurs in the command line, the PostScript code is transmitted in a file, otherwise as standard input through a pipe. Click <emph>Next</emph>.</paragraph>
</listitem>
<listitem>
<paragraph role="listitem" id="par_id3146135" xml-lang="en-US" l10n="U" oldref="302">Assign a name to your new fax printer and determine whether the telephone numbers (see below) marked in the text should be removed from the printout, or not. Click <emph>Finish</emph>.</paragraph>
</listitem>
</list>
<paragraph role="paragraph" id="par_id3147506" xml-lang="en-US" l10n="U" oldref="303">You can now send faxes by printing to the printer that has just been created.</paragraph>
<paragraph role="paragraph" id="par_id3148419" xml-lang="en-US" l10n="U" oldref="83">Enter the fax number as text in the document. You can also enter a field that takes the fax number from your active database. In any case, the fax number must start with the characters @@# and end with @@. A valid entry would have the form @@#1234567@@.</paragraph>
<paragraph role="paragraph" id="par_id3150826" xml-lang="en-US" l10n="U" oldref="304">If these characters including the telephone number are not printed, activate the <emph>Fax number is removed from the printout</emph> option under <emph>Properties</emph> on the <emph>Command</emph> tab page. If no telephone number is entered in the document, a dialog prompting you for it will appear after the printout.</paragraph>
<paragraph role="paragraph" id="par_id3154196" xml-lang="en-US" l10n="CHG" oldref="305">In $[officename] you can also activate an icon for sending faxes to a default fax. To do this, choose <emph>Tools - Customize - Toolbars</emph>, click <emph>Add Commands</emph> and add from "Documents" the <emph>Send Default Fax</emph> icon. You can set which fax is used when this button is pressed under <emph><switchinline select="sys"><caseinline select="MAC">%PRODUCTNAME - Preferences</caseinline><defaultinline>Tools - Options</defaultinline></switchinline> - %PRODUCTNAME Writer - Print</emph>.</paragraph>
<paragraph role="paragraph" id="par_id3150517" xml-lang="en-US" l10n="CHG" oldref="84">Remember to create one separate print job for each fax, otherwise, the first recipient will receive all the faxes. In the <emph>Tools - Mail Merge</emph> dialog select the <emph>Printer</emph> option and then select the <emph>Single print jobs</emph> check box.</paragraph>
<paragraph role="paragraph" id="par_id3149490" xml-lang="en-US" l10n="E" oldref="344" localize="false"/>
<paragraph role="heading" id="hd_id3146929" xml-lang="en-US" level="2" l10n="U" oldref="306">Connecting a PostScript to PDF Converter</paragraph>
<paragraph role="paragraph" id="par_id3154989" xml-lang="en-US" l10n="U" oldref="307">If a PostScript to PDF converter such as Ghostscript or Adobe Acrobat Distiller is installed on your computer, you can quickly create PDF documents in the $[officename] software.</paragraph>
<list type="ordered">
<listitem>
<paragraph role="listitem" id="par_id3150524" xml-lang="en-US" l10n="U" oldref="308">In spadmin, click <emph>New Printer</emph>. This opens the <emph>Add Printer</emph> dialog.</paragraph>
</listitem>
<listitem>
<paragraph role="listitem" id="par_id3145268" xml-lang="en-US" l10n="U" oldref="309">Select <emph>Connect a PDF converter</emph>. Click <emph>Next</emph>.</paragraph>
</listitem>
</list>
<paragraph role="paragraph" id="par_id3156445" xml-lang="en-US" l10n="U" oldref="310">Choose whether to use the default driver, the Acrobat Distiller driver or another driver. The driver "Generic Printer (T42 enabled)" prefers the type 42 fonts over type 3 fonts; this driver is a good choice for output to a software PostScript interpreter. Click <emph>Next</emph>.</paragraph>
<list type="ordered" startwith="3">
<listitem>
<paragraph role="listitem" id="par_id3155128" xml-lang="en-US" l10n="U" oldref="311">In the next dialog, enter a command line for the PostScript-&gt;PDF Converter. Enter the directory where the PDF files should be saved. If you do not provide a directory, the user's home directory will be used. In the command line "(TMP)" is replaced by a temporary file and "(OUTFILE)" by the target file, the name of which is created from the document name. If "(TMP)" occurs in the command line, the Postscript code is forwarded in a file, otherwise as standard input through a pipe. If Ghostscript or Adobe Acrobat Distiller is in the search path, you can use one of the predefined command lines. Click <emph>Next</emph>.</paragraph>
</listitem>
<listitem>
<paragraph role="listitem" id="par_id3152889" xml-lang="en-US" l10n="U" oldref="312">Assign a name to your new PDF converter. Click <emph>Finish</emph>.</paragraph>
</listitem>
</list>
<paragraph role="paragraph" id="par_id3153064" xml-lang="en-US" l10n="U" oldref="313">You can now create PDF documents by printing to the converter that has just been created.</paragraph>

</section>
</section>
</body>
</helpdocument>
