summaryrefslogtreecommitdiff
path: root/docs/index.docbook
diff options
context:
space:
mode:
authorJonathan Raphael Joachim Kolberg <bulldog98@freenet.de>2010-05-12 20:23:04 +0200
committerJonathan Raphael Joachim Kolberg <bulldog98@freenet.de>2010-05-12 20:23:04 +0200
commit1ba2377e3d11939367d1e8ff2c0b1432ef7e41b2 (patch)
tree766a1d0fde5d3d514b5761440a4764d42faadb5b /docs/index.docbook
parentFixed a minor bug in documentation (diff)
downloadrekonq-1ba2377e3d11939367d1e8ff2c0b1432ef7e41b2.tar.xz
Updated the rekonq doc
Diffstat (limited to 'docs/index.docbook')
-rw-r--r--docs/index.docbook208
1 files changed, 182 insertions, 26 deletions
diff --git a/docs/index.docbook b/docs/index.docbook
index 2b210f6c..c98c0def 100644
--- a/docs/index.docbook
+++ b/docs/index.docbook
@@ -46,16 +46,21 @@
<copyright>
<year>2008</year>
-<year>2009-2010</year>
-<year>2010</year>
<holder>&Andrea.Diamantini;</holder>
+</copyright>
+<copyright>
+<year>2009</year>
+<year>2010</year>
<holder>&Rohan.Garg;</holder>
+</copyright>
+<copyright>
+<year>2010</year>
<holder>&Jonathan.Kolberg;</holder>
</copyright>
<legalnotice>&FDLNotice;</legalnotice>
-<date>2010-05-01</date>
+<date>2010-05-07</date>
<releaseinfo>0.5.0</releaseinfo>
<abstract>
@@ -157,7 +162,7 @@ Its implementation is going to embrace &kde; technologies, in order to have a fu
</menuchoice>
</para></listitem>
<listitem><para><keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo> will open a
- <guimenuitem>Run Command</guimenuitem> dialog box,type &rekonq; (lower case) and press &Enter; or
+ <guimenuitem>Run Command</guimenuitem> dialog box,type <userinput><command>rekonq</command></userinput> (lower case) and press &Enter; or
the <guibutton>Run</guibutton> to start &rekonq;</para></listitem>
</itemizedlist>
</para>
@@ -200,17 +205,36 @@ To open the general settings go to
</para>
<para>
-Here a List of configurable point and explanation for it:
+Here a List of configurable points and explanation for it:
+
+<variablelist>
+ <varlistentry>
+ <term><guilabel>When starting rekonq:</guilabel></term>
+ <listitem> <para>You can configure what &rekonq; should do on startup.</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Home page URL:</guilabel></term>
+ <listitem><para>You can either set your home page directly trought tipping the &URL; in.</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guibutton>Set to Current Page</guibutton></term>
+ <listitem><para>Sets your home page to the one you are visiting at the moment.</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Default search engine:</guilabel></term>
+ <listitem><para> Here you can choose the search engine you like to be searched with as default.</para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Use KGet for downloading files</guilabel></term>
+ <listitem><para>This activates the <application>&kget;</application> download integration. If this is active &rekonq; will download everything trough &kget;</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>List links with KGet</guilabel></term>
+ <listitem><para>?????</para></listitem>
+ </varlistentry>
-<itemizedlist>
- <listitem> <para> <guimenuitem> When starting rekonq:</guimenuitem> You can configure what &rekonq; should do on startup. </para> </listitem>
- <listitem> <para> <guimenuitem> Home page URL:</guimenuitem> You can either set your home page directly trought tipping the &URL; in. </para> </listitem>
- <listitem> <para> <guimenuitem> Set to Current Page</guimenuitem> Sets your home page to the one you are visiting at the moment. </para> </listitem>
- <listitem> <para> <guimenuitem> Default search engine:</guimenuitem> Here you can choose the search engine you like to be searched with as default. </para> </listitem>
- <listitem> <para> <guimenuitem> Use KGet for downloading files</guimenuitem> This activates wether you want to download with <application>&kget;</application>. </para> </listitem>
- <listitem> <para> <guimenuitem> List links with KGet</guimenuitem> ????? </para> </listitem>
<!-- What does this? -->
-</itemizedlist>
+</variablelist>
</para>
@@ -220,9 +244,19 @@ Here a List of configurable point and explanation for it:
<title>Configure the Tabs settings</title>
+<para>Here you learn how to change the settings for tabs.</para>
+
+<para>To come to the dialog open
+<menuchoice>
+<guimenuitem>Toolbutton</guimenuitem>
+<guisubmenu>Configure rekonq</guisubmenu>
+<guimenuitem>Tabs</guimenuitem>
+</menuchoice>
+</para>
+
<para>
<screenshot>
-<screeninfo>Now you should see this</screeninfo>
+<screeninfo>Now this dialog should appear</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="tabs.png" format="PNG"/>
@@ -235,6 +269,38 @@ Here a List of configurable point and explanation for it:
</screenshot>
</para>
+<para>
+Here a List of configurable points and explanation for it:
+
+<variablelist>
+ <varlistentry>
+ <term><guilabel>Open links in new tab instead of in new window</guilabel></term>
+ <listitem><para>This enables thedefault opening of links in new tabs.</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Always show tab bar</guilabel></term>
+ <listitem> <para>This forces &rekonq; to show the tab bar evan if there is only one tab.</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Open new tabs in the background</guilabel></term>
+ <listitem> <para>This makes &rekonq; not swiching to new tabs.</para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Open new tabs after currently active one</guilabel></term>
+ <listitem> <para>This makes it to default that tabs are opened next to the currently active one.</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Show preview when hovering tab</guilabel></term>
+ <listitem> <para>This shows you an preview of the contend of a tab if you hover it. This can be useful if you have many tabs opened. </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Activate previously used tab when closing the current one</guilabel></term>
+ <listitem> <para>This makes &rekonq; storing you last opend tab and if you close you current one it will reopen the old one. This also can be useful if you use many tabs </para> </listitem>
+ </varlistentry>
+</variablelist>
+
+</para>
+
</sect1>
<sect1 id="Fonts">
@@ -256,6 +322,30 @@ Here a List of configurable point and explanation for it:
</screenshot>
</para>
+<para>
+
+Following will explain the configurable things and what they do
+<variablelist>
+ <varlistentry>
+ <term><guilabel>Standard font</guilabel></term>
+ <listitem><para>Here you can set your default font. The first part is the name of the font followed by the size of the font.</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Fixed font</guilabel></term>
+ <listitem><para>Here you can set your font for &rekonq; labels. The same synopsis like Standard font.</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Font size</guilabel></term>
+ <listitem><para>To configure your prefered size of font.</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Minimal font size:</guilabel></term>
+ <listitem><para>You can configure the minimal size of fonts in &rekonq;. Every smaller font will grow to that size.</para></listitem>
+ </varlistentry>
+</variablelist>
+
+</para>
+
</sect1>
<sect1 id="Webkit">
@@ -360,7 +450,7 @@ As you can see the Cookies can be configured in many ways.
<screeninfo>Now you should see this</screeninfo>
<mediaobject>
<imageobject>
- <imagedata fileref="automatic_fiters.png" format="PNG"/>
+ <imagedata fileref="automatic_filters.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Screenshot</phrase>
@@ -442,7 +532,7 @@ As you can see the Cookies can be configured in many ways.
</para>
<para>
-Program copyright:
+Program copyright: &underGPL;
</para>
<itemizedlist>
@@ -466,31 +556,97 @@ Documentation copyright 2010 &Jonathan.Kolberg; &Jonathan.Kolberg.mail;
<!--TRANS:CREDIT_FOR_TRANSLATORS-->
&underFDL; <!-- FDL: do not remove -->
&underBSDLicense; <!-- BSD License -->
+<!-- Still needed? -->
</chapter>
-<appendix id="Installation">
+<appendix id="installation">
<title>Installation</title>
-<sect1 id="Getting-rekonq">
+<sect1 id="getting-rekonq">
<title>How to obtain &rekonq;</title>
<para>Stable Packages of &rekonq; can be downloaded via standard repositories of your distribution</para>
+
+<para>You also can compile &rekonq; yourself see <link linkend="compilation">Compilation and Installation</link> for that.</para>
</sect1>
-<sect1 id="Requirements">
+<sect1 id="requirements">
<title>Requirements</title>
-<para>
-In order to successfully use &rekonq;, you need at least &Qt; 4.6.x and &kde; 4.4.x.
-</para>
-
+<para>In order to successfully use &rekonq;, you need at least &Qt; 4.6.x and &kde; 4.4.x.</para>
</sect1>
<sect1 id="compilation">
<title>Compilation and Installation</title>
-<para>If you wish to compile &rekonq;, go to
-<ulink url="http://techbase.kde.org/Projects/rekonq/Compiling_rekonq">The how to compile &rekonq; page</ulink>.
-<!-- TODO: add the instructions from the webpage above, to this docbook -->
+<para>If you wish to compile &rekonq;, you have to install the headers of kdelibs and you need git and the build essentials installed.</para>
+
+<para>Under Debian/Ubuntu you get those throught running</para>
+
+<para>
+ <userinput><command>sudo</command> <command>apt-get</command>
+ <option>install</option> <parameter>build-essential kdelibs5-dev git-core</parameter>
+ </userinput>
+</para>
+
+<para>Under OpenSuse you get those throught running</para>
+<para>
+ <userinput><command>sudo</command> <command>zypper</command>
+ <option>in</option> <parameter>libkde4-devel git-core gcc gcc-c++ make cmake</parameter>
+ </userinput>
+</para>
+
+<para>
+We will be using git, as the most recent code is available on the git repository. The gitorious page for rekonq can be found <ulink url="http://gitorious.org/rekonq">here</ulink>. Stable releases, can also be downloaded <ulink url="http://sourceforge.net/projects/rekonq/files/">here</ulink> in form of tarballs.
+</para>
+
+<para>
+Now we need to checkout the latest code. To do so, in a terminal run:
+</para>
+
+<para>
+ <userinput>
+ <command>git</command> <option>clone</option> <parameter>git://gitorious.org/rekonq/mainline.git</parameter>
+ </userinput>
+</para>
+
+<para>
+To compile the code tip in the following
+</para>
+
+<para>
+ <userinput>
+ <command>cd</command> <parameter>directory_where_rekonq_source_code_is</parameter>
+ </userinput>
+</para>
+
+<para>
+ <userinput>
+ <command>mkdir</command> <parameter>build</parameter>
+ </userinput>
+</para>
+
+<para>
+ <userinput>
+ <command>cd</command> <parameter>build</parameter>
+ </userinput>
+</para>
+
+<para>
+ <userinput>
+ <command>cmake</command> <option>-DCMAKE_INSTALL_PREFIX=`<command>kde4-config</command> <option>--prefix</option>`</option> <parameter>..</parameter>
+ </userinput>
+</para>
+
+<para>
+ <userinput>
+ <command>make</command>
+ </userinput>
+</para>
+
+<para>
+ <userinput>
+ <command>sudo</command> <command>make</command> <parameter>install</parameter>
+ </userinput>
</para>
</sect1>