Changes between Version 42 and Version 43 of HowTo


Ignore:
Timestamp:
Nov 6, 2012, 4:24:12 PM (11 years ago)
Author:
Alex Taylor
Comment:

Added a section on using CUPSWIZ

Legend:

Unmodified
Added
Removed
Modified

  • HowTo

    v42 v43  
    1818
    19195. [#printing Printing with CUPS]
    20   * [#cupsprint Creating & Configuring a CUPS Printer]
    21     * [#add_device Selecting the printer connection]
    22     * [#add_name Identifying the printer]
    23     * [#add_model Selecting the printer model]
    24     * [#add_options Setting the default print options]
    25     * [#cupstest Testing the CUPS printer]
    26     * [#cupslpr Printing from CUPS]
    27   * [#os2print Creating a desktop printer object to use with CUPS]
    28     * [#obj_prep Preparation]
    29     * [#object Creating the printer]
    30     * [#obj_set Configuring the printer]
     20  * [#cupswiz Using the eCups printer wizard]
     21  * [#manualsetup Manual setup]
     22    * [#cupsprint Creating & Configuring a CUPS Printer]
     23      * [#add_device Selecting the printer connection]
     24      * [#add_name Identifying the printer]
     25      * [#add_model Selecting the printer model]
     26      * [#add_options Setting the default print options]
     27      * [#cupstest Testing the CUPS printer]
     28      * [#cupslpr Printing from CUPS]
     29    * [#os2print Manual Setup: Creating a desktop printer object to use with CUPS]
     30      * [#obj_prep Preparation]
     31      * [#object Creating the printer]
     32      * [#obj_set Configuring the printer]
    3133
    3234[#about About this Document]
    … …  
    210212  1. [#cupsprint Create and configure a CUPS printer queue]. This sets things up so that CUPS itself knows about the printer and can print to it.
    211213  2. [#os2print Create and configure a desktop printer object]. This allows OS/2 applications to actually print to the CUPS printer.
    212 Unfortunately, this two-phase process makes things a bit complicated.  We'll describe how to set everything up, step by step.
    213 
    214 \\
    215 === Creating & Configuring a CUPS Printer === #cupsprint
     214Unfortunately, this two-phase process makes things a bit complicated, especially if you have to do it manually.  We'll describe how to do things using the simplified eCups GUI first, then discuss how manual setup works.
     215
     216\\
     217=== Using the eCups Printer Wizard === #cupswiz
     218A simple graphical user interface known as the eCups printer wizard (or "CUPSWIZ" for short) is now available for beta testing.  It is highly recommended to try using this tool first, especially if you are new to eCups, as it automates most of the complicated stuff for you.
     219
     220You can find it at http://users.socis.ca/~ataylo00/os2/printing/#cupswiz along with more information and some screenshots.
     221
     222Note that this program still has a few significant limitations - in particular, printers are always created with default job properties.  If you create a printer using this interface, you may wish to use the CUPS web interface afterwards, to check the defaults and adjust them as needed (and do the same in the WPS printer object as well).
     223
     224\\
     225=== Manual Setup === #manualsetup
     226In this section we'll describe how to set up CUPS-based printing manually, step by step. 
     227
     228\\
     229==== Creating & Configuring a CUPS Printer ==== #cupsprint
    216230[[Image(cupsweb02.png, right, border=1, margin-left=5, margin-bottom=10, width=35%)]]
    217231First of all, if your printer is locally-attached (e.g. via USB port), make sure that it is turned on.
    … …  
    226240
    227241\\
    228 ==== Selecting the printer connection ==== #add_device
     242===== Selecting the printer connection ===== #add_device
    229243[[Image(cupsweb03.png, right, border=1, margin-left=5, margin-bottom=10, width=35%)]]
    230244When you select ''Add Printer'', CUPS scans for available printers.  Any locally-attached printers that it finds will be shown as selectable options on the following screen.  It may also detect network printers, but this seems to be a bit hit-and-miss (it probably depends on how your network is organized, among other factors).
    … …  
    311325
    312326\\
    313 ==== Identifying the printer ==== #add_name
     327===== Identifying the printer ===== #add_name
    314328[[Image(cupsweb04.png, right, border=1, margin-left=5, margin-bottom=10, width=35%)]]
    315329On the next page, you will be asked to give your printer a name, which CUPS itself will use to identify it.  You will also need to enter a description and a location; these are for the benefit of actual human beings.
    … …  
    329343
    330344\\
    331 ==== Selecting the printer model ==== #add_model
     345===== Selecting the printer model ===== #add_model
    332346[[Image(cupsweb05.png, right, border=1, margin-left=5, margin-bottom=10, width=35%)]]
    333347This is where you select your printer's make and model.  This is obviously pretty important as it determines the driver that CUPS will use.
    … …  
    348362
    349363\\
    350 ==== Setting the default print options ==== #add_options
     364===== Setting the default print options ===== #add_options
    351365[[Image(cupsweb06.png, right, border=1, margin-left=5, margin-bottom=10, width=35%)]]
    352366After clicking ''Add Printer'' on the screen above, CUPS will load the options for the printer. This can take a little while — it is a good idea to have a look through and make sure the options look useable — especially the media size, type, and print quality settings.
    … …  
    362376
    363377\\
    364 ==== Testing the CUPS printer ==== #cupstest
     378===== Testing the CUPS printer ===== #cupstest
    365379Click on the ''Printers'' tab.  The new printer should be listed.
    366380
    … …  
    381395
    382396\\
    383 ==== Printing from CUPS ==== #cupslpr
     397===== Printing from CUPS ===== #cupslpr
    384398You should now be able to print files using CUPS's own internal tools.
    385399
    … …  
    397411
    398412\\
    399 === Creating a desktop printer object to use with CUPS === #os2print
     413==== Creating a desktop printer object to use with CUPS ==== #os2print
    400414Now to hook CUPS up to the rest of the system so that CUPS can be used for output by applications (like !OpenOffice, Firefox, Lucide, PMMail, PMView... everything, basically).
    401415
    402416\\
    403 ==== Preparation ==== #obj_prep
     417===== Preparation ===== #obj_prep
    404418If you haven't done so already, make sure you have the ECUPS or ECUPS-HP printer driver files on your disk — either by unzipping the ZIP file, or installing the WPI, into a directory of your choice.  It doesn't really matter where this directory is; just make sure you make a note of the path, because you'll need to type it into the driver dialog (below).  I suggest somewhere like `\ECS\INSTALL\PRNDRV\ECUPS` — you'll probably want to keep these files around in case you ever need to install another included printer model (or to import a PPD file).
    405419
    … …  
    408422\\
    409423
    410 ==== Creating the printer ==== #object
     424===== Creating the printer ===== #object
    411425Open the desktop Templates folder and double-click on the Printer template or drag it to the Desktop in order to start the printer creation routine.  If you have eComStation, you can also use the ''Install Printer'' object in the Printers folder and select "Standard printer" (may be called "Local printer" in some versions).
    412426
    … …  
    438452
    439453\\
    440 ==== Configuring the printer ==== #obj_set
     454===== Configuring the printer ===== #obj_set
    441455Now we need to configure the new printer object so that it prints through CUPS.
    442456