Git commit 55d55c98fd4dd81515731241489fe3fb5466f647 by Yuri Chornoivan. Committed on 21/01/2013 at 20:38. Pushed by yurchor into branch 'master'.
Some cleanup in docs, fix EBN warnings M +1 -1 conf/dlggeneralbase.ui M +- -- doc/configure.png M +16 -31 doc/index.docbook http://commits.kde.org/okular/55d55c98fd4dd81515731241489fe3fb5466f647 diff --git a/conf/dlggeneralbase.ui b/conf/dlggeneralbase.ui index 001d4e5..f2c9efd 100644 --- a/conf/dlggeneralbase.ui +++ b/conf/dlggeneralbase.ui @@ -61,7 +61,7 @@ <item> <widget class="QCheckBox" name="kcfg_DisplayDocumentTitle"> <property name="text"> - <string>Display document title in title bar if available</string> + <string>Display document title in titlebar if available</string> </property> </widget> </item> diff --git a/doc/configure.png b/doc/configure.png index ff23ba7..8fcd6cf 100644 Binary files a/doc/configure.png and b/doc/configure.png differ diff --git a/doc/index.docbook b/doc/index.docbook index 7a2a46c..a0c171f 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -11,10 +11,10 @@ <!-- TODO add chapter about navigation panel Show/Hide Contens/Thumbnails/Reviews/Bookmarks bar to save screen space -Use Small Icons and deselct Show Text to minimize the navigation panel +Use Small Icons and deselect Show Text to minimize the navigation panel Describe all actions only possible in the navigation bars: Switching between documents using bookmarks -Context menu actions like Rename Bookmarks etc) +Context menu actions like Rename Bookmarks etc.) --> <book id="okular" lang="&language;"> <bookinfo> @@ -24,7 +24,7 @@ Context menu actions like Rename Bookmarks etc) <firstname>Albert</firstname> <surname>Astals Cid</surname> <affiliation> - <address><email>aacid at kde.org</email></address> + <address>&Albert.Astals.Cid.mail;</address> </affiliation> </author> <author> @@ -68,7 +68,7 @@ Context menu actions like Rename Bookmarks etc) improved presentation support and annotation support. </para> <para> - &okular; supports a lot of different formats like PDF, Postscript, Tiff, CHM, DjVU, Images (png, jpg, &etc;) + &okular; supports a lot of different formats like &PDF;, Postscript, Tiff, CHM, DjVU, Images (png, jpg, &etc;) XPS, Open Document (ODT), Fiction Books, Comic Book, Plucker, EPub and Fax. For all supported formats and their features see <ulink url="http://okular.kde.org/formats.php";> &okular; Document Format Handlers</ulink>. @@ -84,14 +84,6 @@ Context menu actions like Rename Bookmarks etc) </textobject> </mediaobject> </screenshot> -<!-- - <para> - The PDF format is widely used for publishing documents that are - mostly not meant to be edited again. &okular; is only a viewer - for these files and therefore it doesn't provide any functionality - to edit or create PDF documents. - </para> ---> </chapter> <chapter id="use"> <title>Basic Usage</title> @@ -106,7 +98,7 @@ Context menu actions like Rename Bookmarks etc) If you have already opened files in &okular; before, you can quickly access them by selecting them in the <menuchoice><guimenu>File</guimenu><guisubmenu>Open Recent</guisubmenu></menuchoice> menu. </para> - <para>&okular; is the default &kde; application for PDF and Postscript files, launched when you click with the + <para>&okular; is the default &kde; application for &PDF; and Postscript files, launched when you click with the &LMB; on such a file type in the filemanager. If you want to open any file whose format is supported by &okular; use <menuchoice><guimenu>Open with...</guimenu><guimenuitem>&okular;</guimenuitem> </menuchoice> from context menu in the filemanager. @@ -400,15 +392,15 @@ Add a 'Find Previous' entry </screenshot> <para>&okular; has two different kind of annotations:</para> <para>Text annotations like <guilabel>Yellow Highlighter</guilabel> and <guilabel>Black Underlining</guilabel> - for files with text like ⪚ PDF.</para> + for files with text like ⪚ &PDF;.</para> <para>Graphic annotations like <guilabel>Note</guilabel>, <guilabel>Inline Note</guilabel>, <guilabel>Green Freehand Line</guilabel>, <guilabel>Straight Yellow Line</guilabel>, <guilabel>Blue Polygon</guilabel>, <guilabel>Stamp</guilabel> and <guilabel>Cyan Ellipse</guilabel> for all formats supported by &okular;.</para> <para>Using the context menu either in the <guilabel>Reviews</guilabel> view of the navigation panel or in the main window you can open a <guilabel>Pop up Note</guilabel> for any kind of annotation and add or edit comments.</para> - <para>Annotations are not only limited to PDF files, they can be used for any format &okular; supports.</para> + <para>Annotations are not only limited to &PDF; files, they can be used for any format &okular; supports.</para> <para> Since &kde; 4.2, &okular; has the "document archiving" feature. This is an &okular;-specific format for carrying the document plus various metadata related to it (currently only annotations). You can save a "document archive" from the open document by choosing <menuchoice><guimenu>File</guimenu><guisubmenu>Export As</guisubmenu><guimenuitem>Document Archive</guimenuitem></menuchoice>. To open an &okular; document archive, just open it with &okular; as it would be ⪚ a &PDF; document. </para> <para> - Since &okular; 0.15 you can <emphasis>also</emphasis> save annotations directly into PDF files. This feature is only available if &okular; has been built with version 0.20 or later of <ulink url="http://poppler.freedesktop.org/";>Poppler rendering library</ulink>. You can use <menuchoice><guimenu>File</guimenu> <guimenuitem>Save As...</guimenuitem></menuchoice> to save the copy of &PDF; file with annotations. + Since &okular; 0.15 you can <emphasis>also</emphasis> save annotations directly into &PDF; files. This feature is only available if &okular; has been built with version 0.20 or later of <ulink url="http://poppler.freedesktop.org/";>Poppler rendering library</ulink>. You can use <menuchoice><guimenu>File</guimenu> <guimenuitem>Save As...</guimenuitem></menuchoice> to save the copy of &PDF; file with annotations. </para> <note> <para> @@ -1335,7 +1327,7 @@ Add a 'Find Previous' entry </menuchoice> </term> <listitem> - <para>These items allow you to speak the whole document or just the current page and stop speaking using the &kde; Text-to-Speech system <application>Jovie</application>.</para> + <para>These items allow you to speak the whole document or just the current page and stop speaking using the &kde; Text-to-Speech system &jovie;.</para> <para>The <guilabel>Speak ...</guilabel> actions are enabled only if &jovie; is available in the system.</para> </listitem> </varlistentry> @@ -1540,9 +1532,9 @@ Add a 'Find Previous' entry </listitem> </varlistentry> <varlistentry> - <term><guilabel>Display document title in title bar if available</guilabel></term> + <term><guilabel>Display document title in titlebar if available</guilabel></term> <listitem> - <para>Whether to show the current document title in the title bar of &okular; window. If no metadata for title + <para>Whether to show the current document title in the titlebar of &okular; window. If no metadata for title found in the document or this item is unchecked &okular; shows filename of the document. </para> </listitem> @@ -1579,13 +1571,6 @@ Add a 'Find Previous' entry use the backend with the highest priority.</para> </listitem> </varlistentry> - <!--varlistentry> - <term><guilabel>Center first page</guilabel></term> - <listitem> - <para>Whether the first page should be centered or aligned to the left when - displaying the pages in facing and overview mode.</para> - </listitem> - </varlistentry--> <varlistentry> <term><guilabel>Overview columns</guilabel></term> <listitem> @@ -1740,7 +1725,7 @@ Add a 'Find Previous' entry <varlistentry> <term><guilabel>Enable transitions</guilabel></term> <listitem> - <para>Use this checkbox to enable or disable transition effects between pages.</para> + <para>Use this check box to enable or disable transition effects between pages.</para> </listitem> </varlistentry> <varlistentry> @@ -1783,7 +1768,7 @@ Add a 'Find Previous' entry This is the case when the document has references to the various points (usually row and column number) of sources it was generated from. The &DVI; format supports natively the addition of the information about the sources the LaTeX document was generated from. A similar system exists for &PDF; documents, called <acronym>pdfsync</acronym>, which stores these extra information in an external file named after the &PDF; file itself (for example <filename>mydocument.pdfsync</filename> for <filename>mydocument.pdf</filename>). </para> <para> - &okular; ships with preconfigured settings for the following editors: <ulink url="http://kate-editor.org/";>&kate;</ulink>, <ulink url="http://kile.sourceforge.net/";>Kile</ulink>, <ulink url="http://www.scintilla.org/SciTE.html";>SciTE</ulink>, <ulink url="http://www.gnu.org/software/emacs/";>Emacs client</ulink>, and <ulink url="http://www.lyx.org/";>LyX client</ulink>. + &okular; ships with preconfigured settings for the following editors: <ulink url="http://kate-editor.org/";>&kate;</ulink>, <ulink url="http://kile.sourceforge.net/";>Kile</ulink>, <ulink url="http://www.scintilla.org/SciTE.html";>SciTE</ulink>, <ulink url="http://www.gnu.org/software/emacs/";>&Emacs; client</ulink>, and <ulink url="http://www.lyx.org/";>LyX client</ulink>. </para> <note> <para> @@ -1796,7 +1781,7 @@ Add a 'Find Previous' entry <term><guilabel>Command</guilabel></term> <listitem> <para>This is the command and its parameters to invoke the selected editor with the source file of the actual document.</para> - <para>This field will be filled automatically if you use one of the preconfigured editors. Otherwise, please choose <guimenuitem>Custom Text Editor</guimenuitem> in <guilabel>Editor</guilabel> drop-down list and refer to the documentation on your favorite editor to find the proper command. + <para>This field will be filled automatically if you use one of the preconfigured editors. Otherwise, please choose <guimenuitem>Custom Text Editor</guimenuitem> in <guilabel>Editor</guilabel> drop down box and refer to the documentation on your favorite editor to find the proper command. </para> <para>You can use the following placeholders:</para> <itemizedlist> @@ -1821,14 +1806,14 @@ Add a 'Find Previous' entry <itemizedlist> <title>Program Copyright:</title> - <listitem><para>Albert Astals Cid <email>aacid at kde.org</email> Current maintainer</para></listitem> + <listitem><para>&Albert.Astals.Cid; &Albert.Astals.Cid.mail; Current maintainer</para></listitem> <listitem><para>Pino Toscano <email>pino at kde.org</email></para></listitem> <listitem><para>Enrico Ros <email>eros.kde at email.it</email> &kpdf; developer</para></listitem> </itemizedlist> <itemizedlist> <title>Documentation Copyright:</title> - <listitem><para>Albert Astals Cid <email>aacid at kde.org</email> Author</para></listitem> + <listitem><para>&Albert.Astals.Cid; &Albert.Astals.Cid.mail; Author</para></listitem> <listitem><para>Titus Laska <email>titus.laska at gmx.de</email> Some updates and additions</para></listitem> <listitem><para>Pino Toscano <email>pino at kde.org</email></para></listitem> </itemizedlist>
