/text/shared/guide/spadmin.xhp Sun Microsystems, Inc. converted from old format - fpe

spadmin printers; adding, UNIX default printer; UNIX standard printer under UNIX faxes; fax programs/fax printers under UNIX printers; faxes under UNIX PostScript; PDF converter, UNIX converters; PostScript, UNIX PDF; PostScript to PDF converter, UNIX fonts; adding under UNIX typefaces; adding under UNIX mw deleted "printer programs under UNIX", "fax programs under UNIX" and "font programs under UNIX" and changed "faxes;..." Setting up Printer, Fax and Fonts Under UNIX Based Platforms

Under UNIX based platforms, the printer administration program spadmin is provided to help you set up printers, faxes and fonts for use with the $[officename] software. Call the printer administration program spadmin as follows: Change to the {install_path}/program directory. Enter: ./spadmin After it starts, the window of the printer administration program spadmin appears. Following a server installation, the system administrator first logs on as with root privileges, and starts the printer administration program spadmin. 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. The system administrator can also add fonts for all users in the server installation. However, these fonts are available only after restarting the $[officename] software. Setting up Printers 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 Printer Drivers in the $[officename] Software. The $[officename] software automatically provides a printer with the default driver for each system queue. You can add additional printers as needed. Adding a Printer Change to the {install_path}/program directory. Enter: ./spadmin Click the New Printer button. Select the Create Printer option and click Next. Select the appropriate driver for your printer. If you are not using a PostScript printer or your model is not listed, use the Generic Printer driver or follow the steps below. You can also add new drivers using the Import button or delete unnecessary drivers using the Delete button. Click Next. Choose a command line that you can use to print on your printer (for example, lp -d my_queue). Click Next. Give the printer a name and determine whether it should become the default printer. Click Finish. To print a test page, click on Test Page. If the test page fails to print or is incorrectly printed, check all settings as described in Changing Printer Settings. Printer Drivers in the $[officename] Software 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/). You should set up the Generic Printer in that case. Also make sure that the page margins are set correctly. 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. 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. Importing Drivers When Creating a New Printer Click Import in the driver selection dialog. Click Browse to select the directory where you unpacked the PPD files. In the Selection of drivers list box, select the printer driver you want to install. Click OK. Deleting Drivers When Creating a New Printer Select the printer driver. Click Delete. 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. 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/. Changing Printer Settings In the printer administration program spadmin, select the printer from the Installed printers list box and click Properties. The Properties 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. Select the command on the Command tab page. You can remove superfluous commands using the Remove button. On the Paper tab page, you can define the paper format and paper tray to be used as the default settings for this printer. On the Device tab page, you can activate the special options for your printer. If your printer can only print in black and white, choose "grayscale" under Color, otherwise choose "color". If switching to grayscale leads to unfavorable results, you can also select "color" under Color 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. The Font Replacement 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. You should also set the page margins correctly on the Additional settings 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 Print dialog. Some of these settings can also be set for the current printout in the Print dialog or the Printer Settings dialog in the $[officename] software with the Properties button. Renaming or Deleting Printers Select a printer from the Installed printers list box. To rename the selected printer, click Rename. 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. To delete the selected printer, click Remove. The default printer or a printer that has been created by the system administrator in a server installation cannot be removed using this dialog. Selecting a Default Printer To make the printer selected from the Installed printers list box the default printer, double-click its name or click the Default button. Using Fax Functionality If you have installed a fax package such as Efax or HylaFax on your computer, you can send faxes with the $[officename] software. Change to the {install_path}/program directory. Enter: ./spadmin Click New Printer. This opens the Add Printer dialog. Select Connect a fax device. Click Next. Choose whether to use the default driver or another printer driver. If you are not using the default driver, select the appropriate driver. Click Next. 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 Next. 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 Finish. You can now send faxes by printing to the printer that has just been created. 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@@. If these characters including the telephone number are not printed, activate the Fax number is removed from the printout option under Properties on the Command tab page. If no telephone number is entered in the document, a dialog prompting you for it will appear after the printout. In $[officename] you can also activate an icon for sending faxes to a default fax. To do this, choose Tools - Customize - Toolbars, click Add Commands and add from "Documents" the Send Default Fax icon. You can set which fax is used when this button is pressed under Tools - Options - %PRODUCTNAME Writer - Print. Remember to create one separate print job for each fax, otherwise, the first recipient will receive all the faxes. In the Tools - Mail Merge dialog select the Printer option and then select the Single print jobs check box. Connecting a PostScript to PDF Converter 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. In spadmin, click New Printer. This opens the Add Printer dialog. Select Connect a PDF converter. Click Next. 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 Next. In the next dialog, enter a command line for the PostScript->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 Next. Assign a name to your new PDF converter. Click Finish. You can now create PDF documents by printing to the converter that has just been created. Installing Fonts When you are working with the $[officename] software you might notice that a different number of fonts is provided depending on the document type being used. This is because not all of the fonts can be used in every case. Therefore, only those fonts will be shown in the font selection box when working with a text document which can also be printed, as it is assumed that you will only want to use those fonts that you can actually have printed on paper. In an HTML document or in Web layout, only fonts that are available on screen are offered. On the other hand, when working with spreadsheets and drawings you will be able to use all of the fonts that can be either printed or shown on the screen. The $[officename] software tries to match the display on screen to the printout (WYSIWYG = what you see is what you get). Possible problems are shown in the bottom of the dialog Format - Character. Adding Fonts You can integrate additional fonts in the $[officename] software. Fonts which you integrate are available exclusively to the $[officename] software and can be used with various Xservers without your having to install them there. To make the fonts available to other programs as well, proceed as usual by adding the fonts to your Xserver. The $[officename] software can display and print out PostScript Type1 fonts as well as TrueType fonts (including TrueType Collections). To integrate additional fonts in the $[officename] software, proceed as follows: Go to the {install_path}/program directory. Enter: ./spadmin Click Fonts. The dialog lists all fonts added for the $[officename] software. You can select and remove fonts using the Remove button or add new fonts with the Add button. Click Add. The Add Fonts dialog appears. Enter the directory from which you want to add the fonts. Press the ... button and select the directory from the path selection dialog or enter the directory directly. A list of the fonts from this directory appears. Select the fonts you want to add. To add all the fonts, click Select All. With the Create soft links only check box you can determine whether the fonts are to be copied into the $[officename] directory or only symbolic links are to be created there. If the fonts to be added are on a data medium that is not always available (such as a CD-ROM), you must copy the fonts. Click OK. The fonts will now be added. In the case of a server installation, the fonts are installed in that installation if possible. If the user has no write access rights, the fonts will be installed in the corresponding user installation so that only the user who installed them can access them. Deleting Fonts To delete fonts, proceed as follows: Start spadmin. Click Fonts. All fonts added to the $[officename] software are listed in the dialog that now appears. Select the fonts you want to delete and click Delete. You can delete only the fonts that have been added for the $[officename] software. Renaming Fonts You can also rename fonts added for the $[officename] software. This is especially useful for fonts that contain several localized names. Start spadmin. Click Fonts. Select the fonts you want to rename and click Rename. Enter a new name in the dialog that appears. If the font contains several names, these names will serve as suggestions in the combo box where you enter the new name. Click OK. If you select several fonts to rename, one dialog appears for each selected font. If you have selected a TrueType Collection (TTC), one dialog appears for each of the fonts contained in it.