<sect1 id="sect-printing">
  <title>Printing to a Printer or a File.</title>

  <para>
    The <interface>Print dialog</interface> includes the most important options
    related to printing. More detailed options related to printing can be set
    in the <interface> Page Setup dialog</interface>, detailed in
    <xref linkend="sect-printing-setup" /> Press the
    <guibutton>Print</guibutton> to print out the workbook. Press the
    <guibutton>Print Preview</guibutton> button to display the
    <interface>Print Preview dialog</interface>.
  </para>

  <para>
    The <interface>Print dialog</interface> has 3 tabs that include 
    different groups of options.
  </para>

  <figure id="print-workbook-printer-fig">
    <title><interface>Print Dialog Printer Tab</interface></title>
    <mediaobject>
      <imageobject>
	<imagedata format="PNG"
		   fileref="figures/print-worksheet-printer.png" />
      </imageobject>
    </mediaobject>
  </figure>

  <para>
    Normally you  want to select <guimenuitem>Generic Postscript</guimenuitem> 
    as <interface>Printer</interface> and the appropriate printer name as 
    <interface>Location</interface>.
    Then click on <interface>Print</interface> to send the document to your
    printer. 
  </para>
  <para>
    You can also send the printed document to a
    <keycap>postscript</keycap> file by selecting 
    <guimenuitem>File</guimenuitem> as <interface>Location</interface> and
    specifying an appropriate output file.
  </para>

  <figure id="print-workbook-job-fig">
    <title><interface>Print Dialog Job Tab</interface></title>
    <mediaobject>
      <imageobject>
	<imagedata format="PNG"
		   fileref="figures/print-worksheet-job.png" />
      </imageobject>
    </mediaobject>
  </figure>

  <para>
    In the <guimenuitem>Job</guimenuitem> tab you may also select a multiple number of copies, or specify which sheets to print. Choose Selection to print just the range of cells currently selected on the active sheet. 
  </para>

  <figure id="print-workbook-paper-fig">
    <title><interface>Print Dialog Paper Tab</interface></title>
    <mediaobject>
      <imageobject>
	<imagedata format="PNG"
		   fileref="figures/print-worksheet-paper.png" />
      </imageobject>
    </mediaobject>
  </figure>

  <para>
    In the <guimenuitem>Paper</guimenuitem> tab you can select the paper size 
    used for printing, the page orientation and the layout. The layout 
    specification allows to print several logical pages on the same physical 
    sheet of paper.
    If you need to change your margins, scale the output to fit
    properly onto your page or customize the page footers or headers, 
    see the <xref linkend="sect-printing-setup" />
  </para>

</sect1>



<sect1 id="sect-printing-setup">
  <title>Page Setup.</title>
  <para>
    The <interface>Page Setup Dialog</interface> can be used to
    configure various options related to printing out a
    workbook. Click on <menuchoice> <guimenu>File Menu</guimenu>
    <guimenuitem>Page Setup</guimenuitem> </menuchoice> to activate
    the <interface>Page Setup</interface>.
  </para>

  <tip>
    <title>TIP</title>

    <para>
      Remember that at any time you can click on the <interface>Print
      preview</interface> button to see what your document looks like
      with your selected options. See the <xref
      linkend="sect-printing-preview" />
    </para>
  </tip> 

  <para>
    Normally the specified settings apply only to the current sheet. 
    Select another sheet at the bottom of the 
    <interface>Page Setup Dialog</interface> or select 
    <guilabel>Apply to all sheets of this workbook.</guilabel>
  </para>


  <sect2 id="print-setup-page">
    <title>Page Setup Dialog - Page</title>

    <figure id="print-setup-page-fig">
     <title><interface>Page Setup Dialog - Page</interface></title>
      <mediaobject>
	<imageobject>
	  <imagedata fileref="figures/printing-setup-page.png"
	  format="PNG" srccredit="Thomas Miesbauer" />
	</imageobject>
      </mediaobject>
    </figure>

    <para>
      Select the paper size and page orientation (portrait or landscape)
      to suit the best layout for your document.
    </para>

    <para>
      Specify the required margins of the page. Nothing  will be printed 
      inside these margins, not even page numbers.
    </para>
    <para>
    The margins will be measured in the same units (centimetres, millimetres,
    points or inches) as the paper size. Change the unit in the paper and 
    layout section to best fit your needs.
    </para>

    <para>
    Change the scale your image to fit it to your page size
    suitably. The scaling can both enlarge and diminish the size of
    your printed document. 
    </para>

    <para>
      Select the <interface>Fit to</interface> option to have the document 
      automatically scaled. When scaling, the aspect ratio will be preserved.
      Therefore less pages than specified might be printed.
    </para>

    <para>
      You may also specify whether the page is centered horizontally 
      and/or vertically on the printable part of the page.
    </para>
  </sect2>

  <sect2 id="print-setup-header">
    <title>Page Setup Dialog - Headers and Footers</title>

    <figure id="print-setup-header-fig">
      <title><interface>Print Dialog - Headers and Footers</interface></title>
      <mediaobject>
	<imageobject>
	  <imagedata fileref="figures/printing-setup-header.png"
	  format="PNG" srccredit="Thomas Miesbauer" />
	</imageobject>
      </mediaobject>
    </figure>

    <para>
      Select the space available for the header and footer. If you do not 
      provide sufficient space for the header and footer, they will not 
      print even if you chose a style for them.  
    </para>

    <para>
      Click on the option menu to choose from a range of different
      header and footer styles.  
    </para>
    <tip>
      <title>TIP</title>

      <para>
        You can choose the font in which the header and footer is printed by
        selecting a default header/footer font the preferences (see in <xref
        linkend="sect-configuration-preferences" />).
      </para>
    </tip> 

    <para>
      Customize the header or footer by
      choosing the last option on the menu. 
    </para>
    
    <tip>
      <title>TIP</title>

      <para>
	Double clicking on the header or footer preview will quickly
	allow you to customize that header or footer.
      </para>
    </tip> 
    
  </sect2>


  <sect2 id="print-setup-header-config">
    <title>Customizing Headers and Footers</title>

    <figure id="print-setup-header-config-fig">
      <title><interface>Print Dialog - Customize Header/Footer</interface>
      </title>

      <mediaobject>
	<imageobject>
	  <imagedata fileref="figures/printing-setup-header-config.png"
		     format="PNG" srccredit="Thomas Miesbauer" />
	</imageobject>
      </mediaobject>	
    </figure>

    <para>
      Enter what text you would like to appear in the header or
      footer. There are a number of special <keycap>opcodes</keycap>
      for common options. These are:
    </para>

    <variablelist>
      <varlistentry>
	<term>&amp;[TAB]</term>
	<listitem>
	  <para>
	    Name of the workbook.
	  </para>
	</listitem>
      </varlistentry>
      <varlistentry>
	<term>&amp;[PAGE]</term>
	<listitem>
	  <para>
	    Page number in the printing.
	  </para>
	</listitem>
      </varlistentry>
      <varlistentry>
	<term>&amp;[PAGES]</term>
	<listitem>
	  <para>
	    Total number of pages in the printout.
	  </para>
	</listitem>
      </varlistentry>
      <varlistentry>
	<term>&amp;[DATE]</term>
	<listitem>
	  <para>
	    Current date in format dd-mmm-yyyy. 
            The format can be changed by specifying the desired format in the opcode: 
            <literal>&amp;[DATE:yyyy/mm/dd]</literal>.
	  </para>
	</listitem>
      </varlistentry>
      <varlistentry>
	<term>&amp;[TIME]</term>
	<listitem>
	  <para>
	    Current time in format hh:mm.  
            The format can be changed by specifying the desired format in the opcode: 
            <literal>&amp;[TIME:hh:mm:ss]</literal>.
	  </para>
	</listitem>
      </varlistentry>
      <varlistentry>
	<term>&amp;[FILE]</term>
	<listitem>
	  <para>
	    The basename of the file. For the file <literal>/home/jdoe/file.gnumeric</literal>, 
            this opcode prints <literal>file.gnumeric</literal>.
	  </para>
	</listitem>
      </varlistentry>
      <varlistentry>
	<term>&amp;[PATH]</term>
	<listitem>
	  <para>
	    The path of the file excluding the basename. 
            For the file <literal>/home/jdoe/file.gnumeric</literal>, this opcode prints 
            <literal>/home/jdoe/</literal>.
	  </para>
	</listitem>
      </varlistentry>
    </variablelist>
  </sect2>
  
  <sect2 id="print-setup-sheet">
    <title>Page Setup Dialog - Sheet</title>

      <figure id="print-setup-sheet-fig">
	<title><interface>Page Setup Dialog - Sheet</interface></title>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="figures/printing-setup-sheet.png"
		       format="PNG" srccredit="Thomas Miesbauer" />
	  </imageobject>
	</mediaobject>
      </figure>
    <para>
      You can select rows or columns to be printed on every page of
      the output. This is commonly used for printing column or row
      names. To enable this, enter the range of cells to be
      repeated in <guilabel>Rows to repeat...</guilabel> or
      <guilabel>Columns to repeat..</guilabel> field. Instead of
      entering them manually, you can also select columns or rows to
      be repeated using the mouse. 
    </para>

    <warning>
      <title>WARNING</title>

      <para>
        Note that the rows and columns must be entered as ranges. 
        That is, if you want to have first row repeated, you
        must enter <literal>1:1</literal>, not just
        <literal>1</literal>. Similarly, to have column
        <literal>A</literal> repeated, you must enter
        <literal>A:A</literal>.
      </para>
    </warning>

    <para>
      Select <interface>Grid lines</interface> to print the cell
      grid lines with your document. Unselect the button to hide
      the grid lines from your print output.
    </para>

    <para>
      Select <interface>Black and white</interface> to convert the
      colours in your document to a greyscale range.
    </para>

    <para>
      Select <interface>Styles with no content</interface> to
      ensure cells with style changes will be printed, even if
      they are empty. For example, if you have a number of cells
      with the background color changed but no data in them, you
      can select this option to ensure they are in the printed
      output.
    </para>

  </sect2>

</sect1>



<sect1 id="sect-printing-preview">
  <title>Print Preview.</title>

  <para>
    The <interface>Print Preview Dialog</interface> is used to display
    what the printed output will look like. The Print Preview dialog
    can be used to check whether you have the desired formatting and
    layout before you print out the workbook. 
  </para>

  <figure id="print-preview-fig">
    <title><interface>Print Preview Dialog</interface></title>
    <mediaobject>
      <imageobject>
	<imagedata fileref="figures/printing-preview.png" format="PNG"
		   srccredit="Thomas Miesbauer" />
      </imageobject>
    </mediaobject>
  </figure>

  <sect2 id="menu-bar">
    <title>Menu Bar</title>
    <variablelist>
      <varlistentry>
      <term><guimenu>View</guimenu></term>
      <listitem>
	<para>
	  This menu contains:
	  <itemizedlist>
	    <listitem>
	      <para>
		<guimenuitem>First Page</guimenuitem>
		&mdash;Shows the first page in the workbook.
	      </para>
	    </listitem>
	    <listitem>
	      <para>
		<guimenuitem>Previous Page</guimenuitem>
		&mdash;Shows the previous page in the workbook.
	      </para>
	    </listitem>
	    <listitem>
	      <para>
		<guimenuitem>Next Page</guimenuitem>
		&mdash;Shows the next page in the workbook.
	      </para>
	    </listitem>
	    <listitem>
	      <para>
		<guimenuitem>Last Page</guimenuitem>
		&mdash;Shows the last page in the workbook.
	      </para>
	    </listitem>
	    <listitem>
	      <para>
		<guimenuitem>Zoom in</guimenuitem>
		&mdash;Zooms the current page in, showing more detail.
	      </para>
	    </listitem>
	    <listitem>
	      <para>
		<guimenuitem>Zoom out</guimenuitem>
		&mdash;Zooms the current page out, showing less detail.
	      </para>
	    </listitem>
	  </itemizedlist>
	</para>
      </listitem>
    </varlistentry>
  </variablelist>
</sect2>
 
 <sect2>
   <title>Toolbar</title>
   <variablelist>
      <varlistentry>
        <term>
          <guiicon>
            <inlinemediaobject>
              <imageobject>
                <imagedata fileref="figures/print-large.png" format="PNG" />
            </imageobject>
            <textobject>
              <phrase>An image of the print toolbar button.</phrase>
            </textobject>
           </inlinemediaobject>
            Print
          </guiicon>
        </term>
        <listitem>
          <para>Prints the current worksheet to a file or a printer.</para>
        </listitem>
      </varlistentry>

       <varlistentry>
        <term>
          <guiicon><inlinemediaobject>
              <imageobject>
                <imagedata fileref="figures/print-preview-first.png" />
            </imageobject>
            <textobject>
              <phrase>An image of the print preview toolbar move to
              the first page button.</phrase>
            </textobject>
           </inlinemediaobject>
          First
          </guiicon>
        </term>
        <listitem>
          <para>Show the first page in the workbook.</para>
        </listitem>
      </varlistentry>

        <varlistentry>
        <term>
          <guiicon><inlinemediaobject>
              <imageobject>
                <imagedata fileref="figures/print-preview-back.png" />
            </imageobject>
            <textobject>
              <phrase>An image of the print preview toolbar move back
              button.</phrase>
            </textobject>
           </inlinemediaobject>
          Back
          </guiicon>
        </term>
        <listitem>
          <para>Show the previous page in the workbook.</para>
        </listitem>
      </varlistentry>
 
        <varlistentry>
        <term>
          <guiicon><inlinemediaobject>
            <imageobject>
              <imagedata fileref="figures/print-preview-next.png" />
            </imageobject>
            <textobject>
              <phrase>An image of the print preview toolbar next page
              button.</phrase>
            </textobject>
           </inlinemediaobject>
          Next
          </guiicon>
        </term>
        <listitem>
          <para>Show the next page in the workbook.</para>
        </listitem>
      </varlistentry>

         <varlistentry>
        <term>
          <guiicon><inlinemediaobject>
            <imageobject>
              <imagedata fileref="figures/print-preview-last.png" />
            </imageobject>
            <textobject>
              <phrase>An image of the print preview toolbar last page
              button.</phrase>
            </textobject>
           </inlinemediaobject>
          Last
          </guiicon>
        </term>
        <listitem>
          <para>Show the last page in the workbook.</para>
        </listitem>
      </varlistentry>
  
       <varlistentry>
        <term>
          <guiicon><inlinemediaobject>
            <imageobject>
              <imagedata fileref="figures/print-preview-zoomin.png" />
            </imageobject>
            <textobject>
              <phrase>An image of the print preview toolbar zoom in
              button.</phrase>
            </textobject>
           </inlinemediaobject>
          Zoom in
          </guiicon>
        </term>
        <listitem>
          <para>Zooms the current page in, showing greater detail.</para>
        </listitem>
      </varlistentry>

       <varlistentry>
        <term>
          <guiicon><inlinemediaobject>
            <imageobject>
              <imagedata fileref="figures/print-preview-zoomout.png" />
            </imageobject>
            <textobject>
              <phrase>An image of the print preview toolbar zoom out
              button.</phrase>
            </textobject>
           </inlinemediaobject>
          Zoom out
          </guiicon>
        </term>
        <listitem>
          <para>Zooms the current page out, showing less detail.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>
          <guiicon><inlinemediaobject>
            <imageobject>
              <imagedata fileref="figures/print-preview-fitonetoone.png" />
            </imageobject>
            <textobject>
              <phrase>An image of the print preview toolbar zoom to
              fit at one to one scale button.</phrase>
            </textobject>
           </inlinemediaobject>
          Fit at one to one scale.
          </guiicon>
        </term>
        <listitem>
          <para>Fits the page at full resolution.</para>
        </listitem>
      </varlistentry>

       <varlistentry>
        <term>
          <guiicon><inlinemediaobject>
            <imageobject>
              <imagedata fileref="figures/print-preview-fit.png" />
            </imageobject>
            <textobject>
              <phrase>An image of the print preview toolbar zoom to fit
              button.</phrase>
            </textobject>
           </inlinemediaobject>
          Fit
          </guiicon>
        </term>
        <listitem>
          <para>Fits the whole page into the screen space.</para>
        </listitem>
      </varlistentry>


   </variablelist>
  </sect2>
</sect1>
