[user-guide] First draft of printing chapter. Only Gnome for now.

Fri Jul 23 00:58:48 UTC 2010

commit fe419158a19e5e447f3b1f2c20bb51376c88ae55
Author: Ben Cotton <bcotton at fedoraproject.org>
Date:   Thu Jul 22 20:53:00 2010 -0400

    First draft of printing chapter. Only Gnome for now.

 en-US/Printing.xml |  166 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 166 insertions(+), 0 deletions(-)
---

diff --git a/en-US/Printing.xml b/en-US/Printing.xml
new file mode 100644
index 0000000..bbab046
--- /dev/null
+++ b/en-US/Printing.xml
@@ -0,0 +1,166 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+
+<chapter id="chap-User_Guide-Printing">
+	<title>Printing</title>
+	<para>Despite the increasing availability of electronic services, there are are 
+	still times when it is necessary or desirable to print documents.
+	Fortunately, Fedora makes printing easy. This chapter covers connecting to a 
+	single printer, and connecting to an existing print server.
+	<!-- Maybe some day we'll touch on setting up a basic print server. Or that
+	might be better left to a more advanced guide. -->
+	Like many other aspects of Fedora, printing can	be configured by a graphical
+	program or with command-line tools.  In this chapter, the focus is primarily on the 
+	graphical program, with some discussion of the basic command-line tools. 
+	</para>
+
+	<section id="sect-User_Guide-Printing-adding_a_single_printer">
+		<title>Adding a Single Printer</title>
+		<para>Most users need to connect to a single printer, often connected
+		to the computer by a USB cable, although some printer models have
+		built-in network cards for wired or wireless connection to your local
+		network.  
+
+		<section id="sect-User_Guide-adding_a_single_printer-USB">
+		<title>Adding a USB printer</title>
+		For a USB printer, Fedora makes the setup as easy as possible:
+		simply plug the USB cable into the computer.  You'll be prompted to install
+		print drivers if they aren't already installed, and Fedora will detect which
+		ones you need in most cases.</para>
+
+		<para>Click <guibutton>Install</guibutton> to begin installing the drivers.  You
+		may also need additional packages apart from the print drivers.  If you are
+		asked to confirm installation of these packages, click <guibutton>Continue</guibutton>
+		to install them.  You will then be asked to authenticate.  Type in the password
+		for the root account and click <guibutton>Authenticate</guibutton>.  When
+		this process completes, the printer is installed and ready for use.<para>
+		</section>
+
+		<section id="sect-User_Guide-adding_a_single_printer-Network">
+		<title>Adding a network printer</title>
+		<para>In some cases, the printer might not be in reach of a USB cable, or it might be
+		shared by several different computers.  One way to solve this is to print over
+		the network.  Some printer models come with built-in or optional network cards
+		for either wired or wireless connection.  This allows the printer to be anywhere 
+		with a network connection, even if it's in a different room.</para>
+
+			<section id="sect-User_Guide-singe_printer-Network-Gnome">
+			<title>Adding a network printer in Gnome</title>
+			<para>Even if the printer is on your local network, connecting is still
+			easy.  To start, open the printing configuration.  In GNOME, this is 
+			under <menuchoice><guimenu>System</guimenu>
+			<guisubmenu>Administration</guisubmenu>
+			<guisubmenu>Printing</guisubmenu></menuchoice>.  Click the 
+			<guibutton>Add</guibutton> button, and enter the root password. The system
+			will scan for printers.  If yours is detected, it will be listed on the
+			left-hand side.  If not, you'll need to know the protocol and address to use
+			to connect.  Consult your printer's owner's manual for this information.</para>
+			<para>Once the printer is selected, click <guibutton>Forward</guibutton>.
+			You may be asked to choose a driver.  The drivers for many popular printers
+			are already available.  Select the make for your printer and click
+			<guibutton>Forward</guibutton>.  You'll then have the option to select the
+			model, and if there are multiple drivers, to select the driver as well. In
+			most cases, you'll want the driver marked "(recommended)".  Click
+			<guibutton>Forward</guibutton>.  If your printer
+			model is not found, you'll need to click <guibutton>Back</guibutton> and
+			provide your own driver.  The printer manufacturer's website will often
+			have the driver (also called a "PPD file") you need.</para>
+
+			<para>In the last window, you'll be asked for some information to describe
+			the printer.  For the <guilabel>Printer Name</guilabel>, you should select a
+			short, easy-to-remember name such as "laserjet".  The 
+			<guilabel>Description</guilabel> and <guilabel>Location</guilabel> fields are
+			optional.  You can use those to provide information about the features of
+			the printer and it's location.  Once you've entered the information, click
+			<guibutton>Apply</guibutton>  You'll then be prompted for the root password.
+			Enter it in the text box and click <guibutton>Authenticate</guibutton>. As
+			the final step, you have the option to print a test page.  Click
+			<guibutton>No</guibutton> or </guibutton>Yes</guibutton> as you prefer.
+			</para>
+			</section>
+
+			<!-- The interface for KDE is different enough to warrant a separate
+			section.  I'm leaving a stub here for now until the Gnome parts are
+			complete.  Eventually, we'll probably want to add instructions for other
+			supported desktop environments.
+
+			<section id="sect-User_Guide-single_printer-Network-KDE">
+			<title>Adding a network printer in KDE</title>
+			<para> In KDE, you first have to launch the Sytem Settings program by
+			going to <menuchoice><guimenu>KMenu</guimenu>
+			<guisubmenu>Applications</guisubmenu><guisubmenu>Settings</guisubmenu>
+			<guisubmenu>System Settings</guisubmenu></menuchoice> and then clicking on
+			<guibutton>Printer Configuration</guibutton>.
+			
+			</section>
+			-->
+		</section>
+
+	<section id="sect-User_Guide-Printing-print_server">
+	<title>Connecting to a print server</title>
+	<para>If there are multiple computers on your network, one of them may be serving as
+	a print server, providing connection to one or more printers to the rest of the network.
+	Print servers can run on a wide variety of hardware and operating system combinations, but
+	Fedora makes it easy to connect to a wide variety of print servers.  
+	</para>
+	
+		<section id="sect-User_Guide-Printing-print_server-gnome">
+		<title>Connecting to a print server in Gnome</title>
+		<para>Connecting to an existing print server is similar to adding a single
+		printer.  To start, open the printing configuration.  In GNOME, this is 
+		under <menuchoice><guimenu>System</guimenu><guisubmenu>Administration</guisubmenu>
+		<guisubmenu>Printing</guisubmenu></menuchoice>.  In the <guilabel>Printing</guilabel>
+		window, select <menuchoice><guimenu>Server</guimenu><guisubmenu>Connect...</guisubmenu></menuchoice>.
+		In the <guilabel>CUPS server:</guilabel> field, enter the host name or IP address
+		of your print server (for example: print.example.com or 192.168.1.10) and check
+		<guilabel>Require encryption</guilabel> if desired.  Then click <guibutton>Connect</guibutton>.  
+		It may take a few seconds to connect to the print server, but you should see all
+		of the printers on the server in your printer list.</para>
+		</section>
+
+                <!-- Insert KDE section here -->
+	</section>	
+	
+	<section id="sect-User_Guide-Printing-printing">
+	<title>Printing</title>
+	<para>Now that you have one or more printers installed, you probably want to use them.
+	Most applications use the standard 
+	<menuchoice><guimenu>File</guimenu><guisubmenu>Print</guisubmenu></menuchoice> convention,
+	but some may have a slightly different menu structure.  However the printing menu is
+	presented to you, you'll probably have several options you can change for your print job.
+	Common options are printing in black and white versus color, or selecting the paper size
+	and layout.  Of course, your printer will need to support these options for them to work.
+	If you have multiple printers installed, you can select which printer to use.</para>
+
+	<note>
+	<title>Selecting a default printer</title>
+	<para>If you have multiple printers, there's probably one that you'll want to use the
+	most often. You can select a default printer in your Printing menu by right-clicking
+	the printer you want to be the default and select 
+	<menuchoice><guimenu>Set As Default</guimenu></menuchoice>.  Most applications will
+	honor this setting.</para>
+	</note>
+
+	<note>
+	<title>Printing from the command line</title>
+	<para>Some tasks involve using the command line to run commands.  Fortunately, there's
+	a way to print from the command line, too.  You can use the <command>lpr</command> to
+	print a file.  For example, <command>lpr myfile.txt</command> prints the file
+	<filename>myfile.txt</filename>.  You can specify the printer to use with the
+	<command>-P</command>option.  The argument to <command>-P</command> is the short name of
+	the printer.  If you installed a printer called "laserjet", you would print your file
+	with <command>lpr -P laserjet <replaceable>filename</replaceable></command>.</para>
+	<para>The default printer can also be set by setting the <command>PRINTER</command>
+	<firstterm>environment variable></firstterm>.  Environment variables are set with 
+	the <command>export</command>command:</para>
+	<screen>export PRINTER=<replaceable>printername</replaceable></screen>
+	<para>To make the change persistent, add the above line to your
+	<filename>~/.bash_profile</filename> file.</para>
+	</note>
+
+	</section>
+	
+	
+</chapter>
+ 
