<?xml version="1.0" ?> <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY kappname "&kghostview;"> <!ENTITY package "kdegraphics"> <!ENTITY % addindex "IGNORE"> <!ENTITY % English "INCLUDE"><!-- change language only here --> ]> <book lang="&language;"> <bookinfo> <title>The &kghostview; Handbook</title> <authorgroup> <author> <firstname>Pamela</firstname> <surname>Roberts</surname> <affiliation> <address><email>pamroberts@blueyonder.co.uk</email></address> </affiliation> </author> <!-- TRANS:ROLES_OF_TRANSLATORS --> </authorgroup> <copyright> <year>2001</year> <year>2002</year> <holder>Pamela Roberts</holder> </copyright> <legalnotice>&FDLNotice;</legalnotice> <date>2002-09-28</date> <releaseinfo>0.13.02</releaseinfo> <abstract> <para>&kghostview; displays and prints &PostScript; (<literal role="extension">.ps</literal>, <literal role="extension">.eps</literal>) and Portable Document Format (<literal role="extension">.pdf</literal>) files.</para> <para>This document describes &kghostview; version 0.13.2</para> </abstract> <keywordset> <keyword>KDE</keyword> <keyword>linux</keyword> <keyword>postscript</keyword> <keyword>ghostview</keyword> </keywordset> </bookinfo> <chapter id="introduction"> <title>Introduction</title> <para> &kghostview; displays and prints &PostScript; (<literal role="extension">.ps</literal>, <literal role="extension">.eps</literal>) and Portable Document Format (<literal role="extension">.pdf</literal>) files. It a port to &kde; of Tim Theisen's <application>Ghostview</application> program which uses Alladin <application>Ghostscript</application> to view documents prepared in <trademark class="registered">Adobe</trademark>'s &PostScript; page description language. &PostScript; is the major page description language for printing on &UNIX; systems and this application can be used to preview material intended for printing or for reading documents online. </para> <para> You can use &kghostview; with all recent versions of <application>Ghostscript</application>. Newer versions offer much improved performance which you can take advantage of with &kghostview;. </para> <para> If a document does not conform to the <trademark class="registered">Adobe</trademark> document structuring convention the functionality of the viewer is limited. For example, if there is no table of contents, skipping around the document and marking pages is not possible. </para> </chapter> <chapter id="fundamentals"> <title>Fundamentals</title> <para> This section describes what you see in the main &kghostview; window, the actions of the Toolbar buttons and how to use the Page List. </para> <para> You can open multiple instances of &kghostview; to view multiple documents. The title bar at the top of a window shows you the name of the document in that window. </para> <para> The main area displays a page of the current document. If the page is too large to fit inside the window, scroll bars are automatically added to the sides of the display, although these can be disabled with the <guimenu>Settings</guimenu> menu. </para> <para> Note that the Toolbar and the Page List can be hidden with the <link linkend="settings">Settings</link> menu options to give more space on the screen for the content area. </para> <para> You can scroll up and down in a page with the <keysym>Up Arrow</keysym> and <keysym>Down Arrow</keysym> keys, or use the <menuchoice><guimenu>View</guimenu><guimenuitem>Read Up Document </guimenuitem></menuchoice> (<keycombo action="simul">&Shift;<keycap>Space </keycap></keycombo>) and <menuchoice><guimenu>View</guimenu> <guimenuitem>Read Down Document</guimenuitem></menuchoice> (<keycombo action="simul">&Ctrl;<keycap>Space</keycap></keycombo>) options to scroll through the entire document. </para> <para>The <guibutton>Next Page</guibutton> and <guibutton>Previous Page</guibutton> Toolbar buttons do what they say, or you can go immediately to any page with a &LMB; click on the appropriate entry in the Page List. </para> <para> If selected in the <guimenu>Settings</guimenu> menu a Page List will be displayed at the left side of the window. This list has two columns: the first may contain a flag indicating that the page has been marked, the second contains the page numbers. You can use this page list to navigate through the document or to mark pages for printing. </para> <para> You can toggle the <quote>page marked</quote> flag for the currently displayed page with <keycombo action="simul"><keycap>Ctrl</keycap><keycap>M</keycap></keycombo> or for any page by &MMB; clicking on it in the Page List. You can also clear or change your page marks using the drop-down menu that is activated by &RMB; clicking anywhere in the Page List area or by selecting the <link linkend="pagemarks">PageMarks</link> menu. </para> </chapter> <chapter id="primary-menu-items"> <title>The Menubar</title> <sect1 id="menufile"> <title>The <guimenu>File</guimenu> Menu</title> <variablelist> <varlistentry> <term><menuchoice> <shortcut><keycombo action="simul">&Ctrl; <keycap>O</keycap></keycombo></shortcut> <guimenu>File</guimenu> <guimenuitem>Open...</guimenuitem> </menuchoice></term> <listitem><para><action>Open</action> a file. If a file is currently being displayed it will be closed.</para> </listitem> </varlistentry> <varlistentry> <term><menuchoice> <guimenu>File</guimenu> <guimenuitem>Open Recent</guimenuitem> </menuchoice></term> <listitem><para><action>Open</action> a file selected from a drop-down list of recently opened files. If a file is currently being displayed it will be closed.</para></listitem> </varlistentry> <varlistentry> <term><menuchoice> <guimenu>File</guimenu> <guimenuitem>Save As...</guimenuitem> </menuchoice></term> <listitem><para><action>Save</action> the currently open file.</para> </listitem> </varlistentry> <varlistentry> <term><menuchoice> <shortcut><keycombo action="simul">&Ctrl; <keycap>P</keycap></keycombo></shortcut> <guimenu>File</guimenu> <guimenuitem>Print...</guimenuitem> </menuchoice></term> <listitem><para><action>Print</action> the currently displayed document. The Print dialog box will let you choose to print all or selected (marked) pages.</para> </listitem> </varlistentry> <varlistentry> <term><menuchoice> <guimenu>File</guimenu> <guimenuitem>Document Info...</guimenuitem> </menuchoice></term> <listitem><para><action>Display</action> some basic information about the document.</para> </listitem> </varlistentry> <varlistentry> <term><menuchoice> <shortcut><keycombo action="simul">&Ctrl; <keycap>Q</keycap></keycombo></shortcut> <guimenu>File</guimenu> <guimenuitem>Quit</guimenuitem> </menuchoice></term> <listitem><para><action>Close</action> down &kghostview;.</para> </listitem> </varlistentry> </variablelist> </sect1> <sect1 id="view"> <title>The <guimenu>View</guimenu> Menu</title> <variablelist> <varlistentry> <term><menuchoice> <guimenu>View</guimenu> <guimenuitem>Redisplay</guimenuitem> </menuchoice></term> <listitem><para><action>Re-render</action> the current document page.</para> </listitem> </varlistentry> <varlistentry> <term><menuchoice> <guimenu>View</guimenu> <guimenuitem>Fit To Page Width</guimenuitem> </menuchoice></term> <listitem><para><action>Scale</action> the display so a page width fits exactly across the main display area.</para> </listitem> </varlistentry> <varlistentry> <term><menuchoice> <guimenu>View</guimenu> <guimenuitem>Orientation</guimenuitem> </menuchoice></term> <listitem><para><action>Change the orientation</action> of the displayed page. You can choose between <guimenuitem>Auto</guimenuitem>, <guimenuitem>Portrait</guimenuitem>, <guimenuitem>Landscape</guimenuitem>, <guimenuitem>Upside Down</guimenuitem> and <guimenuitem>Seascape</guimenuitem> which is like <guimenuitem>Landscape</guimenuitem> but the other way up.</para> </listitem> </varlistentry> <varlistentry> <term><menuchoice> <guimenu>View</guimenu> <guimenuitem>Paper Size</guimenuitem> </menuchoice></term> <listitem><para>Lets you view the document as if it were printed on different <action>paper sizes</action> without changing the scale. You should normally choose <guimenuitem>Auto</guimenuitem>.</para> </listitem> </varlistentry> <varlistentry> <term><menuchoice> <shortcut><keycombo action="simul">&Ctrl;<keycap>+</keycap></keycombo> </shortcut> <guimenu>View</guimenu> <guimenuitem>Zoom In</guimenuitem> </menuchoice></term> <listitem><para><action>Increase the magnification</action> of the document view.</para> </listitem> </varlistentry> <varlistentry> <term><menuchoice> <shortcut><keycombo action="simul">&Ctrl; <keycap>-</keycap></keycombo></shortcut> <guimenu>View</guimenu> <guimenuitem>Zoom Out</guimenuitem> </menuchoice></term> <listitem><para><action>Decrease the magnification</action> of the document view.</para> </listitem> </varlistentry> <varlistentry> <term><menuchoice> <shortcut><keycap>Page Up</keycap> </shortcut> <guimenu>View</guimenu> <guimenuitem>Previous Page</guimenuitem> </menuchoice></term> <listitem><para>View the <action>previous page</action> of the document.</para> </listitem> </varlistentry> <varlistentry> <term><menuchoice> <shortcut><keycap>Page Down</keycap> </shortcut> <guimenu>View</guimenu> <guimenuitem>Next Page</guimenuitem> </menuchoice></term> <listitem><para>View the <action>next page</action> of the document.</para> </listitem> </varlistentry> <varlistentry> <term><menuchoice> <shortcut><keycombo action="simul">&Ctrl; <keycap>Home</keycap></keycombo></shortcut> <guimenu>View</guimenu> <guimenuitem>First Page</guimenuitem> </menuchoice></term> <listitem><para><action>Go to the first page</action> of the document.</para> </listitem> </varlistentry> <varlistentry> <term><menuchoice> <shortcut><keycombo action="simul">&Ctrl; <keycap>End</keycap></keycombo></shortcut> <guimenu>View</guimenu> <guimenuitem>Last Page</guimenuitem> </menuchoice></term> <listitem><para><action>Go to the last page</action> of the document.</para> </listitem> </varlistentry> <varlistentry> <term><menuchoice> <guimenu>View</guimenu> <guimenuitem>Go to Page...</guimenuitem> </menuchoice></term> <listitem><para><action>Go to a selected page</action> of the document.</para> </listitem> </varlistentry> <varlistentry> <term><menuchoice> <shortcut><keycombo action="simul">&Shift; <keycap>Space</keycap></keycombo></shortcut> <guimenu>View</guimenu> <guimenuitem>Read up Document</guimenuitem> </menuchoice></term> <listitem><para><action>Scroll backwards</action> through the document.</para> </listitem> </varlistentry> <varlistentry> <term><menuchoice> <guimenu>View</guimenu> <guimenuitem>Read down Document</guimenuitem> </menuchoice></term> <listitem><para><action>Scroll forwards</action> through the document.</para> </listitem> </varlistentry> </variablelist> </sect1> <sect1 id="pagemarks"> <title>The <guimenu>PageMarks</guimenu> Menu</title> <note> <para> You can also get this menu by &RMB; clicking anywhere in the Page List area. </para> </note> <variablelist> <varlistentry> <term><menuchoice> <shortcut><keycombo action="simul">&Ctrl; <keycap>M</keycap></keycombo></shortcut> <guimenu>PageMarks</guimenu> <guimenuitem>Mark Current Page</guimenuitem> </menuchoice></term> <listitem><para><action>Toggle the page marked flag</action> for the current page.</para> </listitem> </varlistentry> <varlistentry> <term><menuchoice> <guimenu>PageMarks</guimenu> <guimenuitem>Mark All Pages</guimenuitem> </menuchoice></term> <listitem><para><action>Set the page marked flag</action> for all pages of the document.</para> </listitem> </varlistentry> <varlistentry> <term><menuchoice> <guimenu>PageMarks</guimenu> <guimenuitem>Mark Even Pages</guimenuitem> </menuchoice></term> <listitem><para><action>Set the page marked flag</action> for all even numbered pages in the document. Used in conjunction with <guimenuitem>Mark Odd Pages</guimenuitem> or <guimenuitem>Toggle Page Marks</guimenuitem> this provides a convenient way of double-sided printing a document on a single sided printer</para> </listitem> </varlistentry> <varlistentry> <term><menuchoice> <guimenu>PageMarks</guimenu> <guimenuitem>Mark Odd Pages</guimenuitem> </menuchoice></term> <listitem><para><action>Set the page marked flag</action> for all odd numbered pages in the document.</para> </listitem> </varlistentry> <varlistentry> <term><menuchoice> <guimenu>PageMarks</guimenu> <guimenuitem>Toggle Page Marks</guimenuitem> </menuchoice></term> <listitem><para><action>Toggle the page marked flags</action> for all pages in the document.</para> </listitem> </varlistentry> <varlistentry> <term><menuchoice> <guimenu>PageMarks</guimenu> <guimenuitem>Remove Page Marks</guimenuitem> </menuchoice></term> <listitem><para><action>Clear the page marked flags</action> for all pages in the document.</para></listitem> </varlistentry> </variablelist> </sect1> <sect1 id="settings"> <title>The <guimenu>Settings</guimenu> Menu</title> <variablelist> <varlistentry> <term><menuchoice> <guimenu>Settings</guimenu> <guimenuitem>Show Toolbar</guimenuitem> </menuchoice></term> <listitem><para><action>Toggle the Toolbar display</action> on and off.</para></listitem> </varlistentry> <varlistentry> <term><menuchoice> <guimenu>Settings</guimenu> <guimenuitem>Show Statusbar</guimenuitem> </menuchoice></term> <listitem><para><action>Toggle the Statusbar display</action> on and off.</para></listitem> </varlistentry> <varlistentry> <term><menuchoice> <guimenu>Settings</guimenu> <guimenuitem>Show Scrollbars</guimenuitem> </menuchoice></term> <listitem><para><action>Toggle the horizontal and vertical scrollbars</action> on and off.</para></listitem> </varlistentry> <varlistentry> <term><menuchoice> <guimenu>Settings</guimenu> <guimenuitem>Watch File</guimenuitem> </menuchoice></term> <listitem><para>If this is selected the display will <action>automatically update</action> if the document file changes.</para></listitem> </varlistentry> <varlistentry> <term><menuchoice> <guimenu>Settings</guimenu> <guimenuitem>Show Page List</guimenuitem> </menuchoice></term> <listitem><para><action>Toggle the Page List</action> on and off.</para></listitem> </varlistentry> <varlistentry> <term><menuchoice> <guimenu>Settings</guimenu> <guimenuitem>Show Page Labels</guimenuitem> </menuchoice></term> <listitem><para>If this is selected the <action>name (if any) of the current page is displayed in the Status Bar</action>.</para></listitem> </varlistentry> <varlistentry> <term><menuchoice> <guimenu>Settings</guimenu> <guimenuitem>Configure &kghostview;...</guimenuitem> </menuchoice></term> <listitem><para>Brings up the &kghostview; <link linkend="config-dialog"><action>configuration dialog</action> box</link>.</para></listitem> </varlistentry> </variablelist> </sect1> <sect1 id="help"> <title>The <guimenu>Help</guimenu> Menu</title> &help.menu.documentation; </sect1> </chapter> <chapter id="config-dialog"> <title>Configuration</title> <para> The configuration dialog box is accessed with the <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &kghostview;...</guimenuitem></menuchoice> option. It has two pages; <guilabel>General settings</guilabel> and <guilabel>Ghostscript configuration</guilabel> </para> <sect1 id="general-settings"> <title>General settings</title> <para> You can select <guilabel>Enable anti-aliasing of fonts and images</guilabel> to get smoothly rendered text, but note that antialiasing is memory intensive and slower than straightforward rendering of fonts. Early versions of <application>Ghostscript</application> could not perform antialiasing. </para> <para> Select <guilabel>Use Platform fonts</guilabel> if you wish to use your native system fonts rather than those that come with <application>Ghostscript</application>. </para> <para> Turn <guilabel>Show Ghostscript Messages in a seperate box</guilabel> on if you want to be informed of any output or error messages generated by the <application>Ghostscript</application> interpreter. </para> <para> You can choose whether &kghostview; uses a <guilabel>Monochrome</guilabel>, <guilabel>Grayscale</guilabel> or <guilabel>Color</guilabel> <guilabel>Palette</guilabel> for the display. </para> </sect1> <sect1 id="ghostscript-config"> <title><application>Ghostscript</application> configuration</title> <para> In this dialog box page you can set the name of the <application>Ghostscript</application> <guilabel>Interpreter</guilabel> executable and the <guilabel>Non-antialiasing arguments:</guilabel> and the <guilabel>Antialiasing arguments</guilabel> passed to it. The default settings should be suitable for most systems. </para> </sect1> </chapter> <chapter id="credits"> <title>Credits and License</title> <para> &kghostview; </para> <itemizedlist> <title>Program Copyright:</title> <listitem><para>Mark Donohoe <email>donohoe@kde.org</email> (original author) 1998 </para></listitem> <listitem><para>David Sweet <email>dsweet@kde.org</email> Maintainer 1999-2000 </para></listitem> <listitem><para>Wilco Greven <email>greven@kde.org</email> Current maintainer </para></listitem> <listitem><para>David Faure <email>faure@kde.org</email> (basis for shell)</para> </listitem> <listitem><para>Daniel Duley <email>mosfet@kde.org</email> (port to Kparts)</para> </listitem> <listitem><para>Espen Sand <email>epsen@kde.org</email> (dialog boxes)</para> </listitem> </itemizedlist> <para> Documentation copyright 2001, 2002 Pamela Roberts <email>pamroberts@blueyonder.co.uk</email> </para> <!-- TRANS:CREDIT_FOR_TRANSLATORS --> &underFDL; <!-- FDL: do not remove --> &underGPL; <!-- GPL License --> </chapter> <appendix id="installation"> <title>Installation</title> <para> &kghostview; is part of the &kde; 3 project, details of which can be found at <ulink url="http://www.kde.org">http://www.kde.org</ulink>. </para> <para> To use &kghostview;, you must have the <application>Ghostscript</application> program as well as &kde; 3 installed on your machine. The <application>Ghostscript</application> home page is at <ulink url="http://www.cs.wisc.edu/~ghost/">http://www.cs.wisc.edu/~ghost/</ulink> </para> <para> Most distributions will include &kghostview;, but if you want to roll your own the source code can be found in the &package; package on &kde-ftp;, the main ftp site of the &kde; project.</para> <para> To see if a later version of &kghostview; has been released, you can take a look in <ulink url="http://apps.kde.com">http://apps.kde.com</ulink>. </para> &install.compile.documentation; </appendix> &documentation.index; </book> <!-- Local Variables: mode: sgml sgml-omittag: nil sgml-shorttag: t End: -->