'Documentation update of kcmebrowse.docbook + german translation'

[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kde-i18n-de
Subject:    Documentation update of kcmebrowse.docbook + german translation
From:       Andreas Hochsteger <e9625392 () student ! tuwien ! ac ! at>
Date:       2002-03-10 23:15:56
[Download RAW message or body]

Hi!

I did an update of the documentation of kcmebrowse.docbook, where the syntax 
of the advanced web shortcuts was completely missing. Additionally to the 
update of the english file I also updated the german translation. Both 
patches are attached to this mail.

As this is the first time I wrote some documentation for KDE I want to post 
my changes to the list prior to commit them to CVS. 

Please tell me if you find some problems. Otherwise I'll commit my changes.

Bye,
	Andreas

["kcmebrowse.docbook.en.diff" (text/x-diff)]

Index: kcmebrowse.docbook
===================================================================
RCS file: /home/kde/kdebase/doc/kcontrol/kcmebrowse.docbook,v
retrieving revision 1.15
diff -u -r1.15 kcmebrowse.docbook
--- kcmebrowse.docbook	2002/02/12 21:32:00	1.15
+++ kcmebrowse.docbook	2002/03/10 23:02:28
@@ -13,10 +13,15 @@
 <surname>Arrouye</surname>
 <affiliation><address><email>yves@realnames.com</email></address></affiliation>
 </author>
+<author>
+<firstname>Andreas</firstname>
+<surname>Hochsteger</surname>
+<affiliation><address><email>e9625392@student.tuwien.ac.at</email></address></affiliation>
 +</author>
 <!-- TRANS:ROLES_OF_TRANSLATORS -->
 </authorgroup>
 
-<date>2002-02-12</date>
+<date>2002-03-10</date>
 <releaseinfo>3.00.00</releaseinfo>
 
 <keywordset>
@@ -149,7 +154,7 @@
 
 <para>If you examine the contents of the <guilabel>Search
 URI</guilabel> text box, you will find that most, if not all of the
-entries have a <option>\{@}</option> in them. This sequence of two
+entries have a <option>\{@}</option> in them. This sequence of
 characters acts as a parameter, which is to say that they are replaced
 by whatever you happen to type after the colon character that is
 between a shortcut and its parameter. Let's consider some examples to
@@ -186,9 +191,62 @@
 search engines but also to anything else that can be pointed to by a
 <acronym>URI</acronym>. Web shortcuts are a very powerful feature of
 navigation in &kde;.</para>
+</sect3>
+
+<sect3 id="ebrowse-aws-syntax">
 
+<title>Syntax of the Advanced Web Shortcuts</title>
+
+<para>
+In general every web shortcut uses the form <userinput>\{...}</userinput>.
+The most commonly used specifier is <userinput>\{@}</userinput> which suites well \
for most of the query URIs on the web. +If you want to substitute different values on \
different positions of an <acronym>URI</acronym>, you are required to use the \
advanced features described below. +</para>
+
+<para>
+List of expressions:
+<itemizedlist>
+<listitem><para><userinput>\{1}</userinput> .. \
<userinput>\{<replaceable>n</replaceable>}</userinput> is substituted by the \
<replaceable>n</replaceable>-th string of the user query (the words after the \
character ':' typed by the user).</para></listitem> \
+<listitem><para><userinput>\{<replaceable>name</replaceable>}</userinput> is \
substituted by the value of the user query string of the form \
'<replaceable>name</replaceable>=<replaceable>value</replaceable>'.</para></listitem> \
+<listitem><para><userinput>\{"<replaceable>value</replaceable>"}</userinput> is \
substituted by 'value'.</para></listitem> \
+<listitem><para><userinput>\{0}</userinput> is substituted by the whole (unmodified) \
user query</para></listitem> +<listitem><para><userinput>\{@}</userinput> is \
substituted by all words of the user query, which were not used for an other \
substitution</para></listitem> +</itemizedlist>
+You can use any of the simple expressions from above to form a more complex \
expressions by separating them with a comma: +<itemizedlist>
+<listitem><para><userinput>\{<replaceable>expr1</replaceable>,<replaceable>expr2</replaceable>,...}</userinput> \
is substituted by the first non-empty expression beginning with the leftmost \
expression.</para></listitem> +</itemizedlist>
+</para>
 </sect3>
 
+<sect3>
+<title>Examples</title>
+<para>
+The <emphasis>Advanced Google Search</emphasis> uses the web shortcut \
<userinput>ggx</userinput> with the URI definition \
<userinput>http://www.google.com/search?as_q=\{all,@}&amp;num=\{num,"10"}&amp;btnG=Goo \
gle+Search&amp;as_epq=\{exact}&amp;as_oq=\{any}&amp;as_eq=\{without}&amp;lr=\{lang}&am \
p;as_ft=\{ft,"i"}&amp;as_filetype=\{filetype,""}&amp;as_qdr=\{date,"all"}&amp;as_occt= \
\{occ,"any"}&amp;as_dt=\{siteop,"i"}&amp;as_sitesearch=\{site}&amp;safe=\{safe,"active"}</userinput>.
 +Here is the explanation of the used expressons:
+<itemizedlist>
+<listitem><para><userinput>as_q=\{all,@}</userinput> returns results with words you \
want to search for. You can specify them either as the expression all=... or simply \
by typing words separated with space. Example: <userinput>ggx:my search \
words</userinput> or <userinput>ggx:all=word</userinput></para></listitem> \
+<listitem><para><userinput>num=\{num,"10"}</userinput> returns pages with the given \
number of results per page. Default: "10", Example: \
<userinput>num=20</userinput></para></listitem> \
+<listitem><para><userinput>as_epq=\{exact,""}</userinput> returns results containing \
the exact phrase. Example: <userinput>exact=...</userinput></para></listitem> \
+<listitem><para><userinput>as_oq=\{any,""}</userinput> returns results with at least \
one of the given words. Example: <userinput>any=...</userinput></para></listitem> \
+<listitem><para><userinput>as_eq=\{without,""}</userinput> returns results not \
containing the given words. Example \
<userinput>without=...</userinput></para></listitem> \
+<listitem><para><userinput>lr=\{lang,""}</userinput> returns only pages written in \
the specified language (lang_en,lang_de,lang_fr,..). Example: \
<userinput>lang=lang_de</userinput></para></listitem> \
+<listitem><para><userinput>as_ft=\{ft,"i"}</userinput> returns only results \
including (i) or excluding (e) the specified filetype. Default: "i", Example: \
<userinput>ft=e</userinput></para></listitem> \
+<listitem><para><userinput>as_filetype=\{filetype,""}</userinput> searches for pages \
with/without the specified filetype (pdf, ps, rtf, xls, doc, ppt). Example: \
<userinput>filetype=pdf</userinput></para></listitem> \
+<listitem><para><userinput>as_qdr=\{date,"all"}</userinput> returns pages updated \
the last 3 months (m3), the last 6 moths (m6) or the last year (y). Default: "all", \
Example: <userinput>date=m6</userinput></para></listitem> \
+<listitem><para><userinput>as_occt=\{occurence,"any"}</userinput> returns results \
where the term occours anywhere (any), in the title (title), in the text (body), in \
the URL (url) or in the links (link) of the page. Default: "any", Example: \
<userinput>occurence=title</userinput></para></listitem> \
+<listitem><para><userinput>as_dt=\{siteop,"i"}</userinput> returns results including \
(i) or excluding (e) the specified domain. Default: "i", Example: \
<userinput>siteop=i</userinput></para></listitem> \
+<listitem><para><userinput>as_sitesearch=\{site,""}</userinput> returns results \
including or excluding the specified domain. Example: \
<userinput>site=kde.org</userinput></para></listitem> \
+<listitem><para><userinput>safe=\{safe,"active"}</userinput> activates (active) or \
deactivate (off) SafeSearch content filtering. Default: "active", Example: \
<userinput>safe=off</userinput></para></listitem> +</itemizedlist>
+</para>
+
+<para>
+An example use of the Advanced Google Search shortcut could be: \
<userinput>ggx:num=20 site=kde.org date=m3 kde konqueror</userinput>. +The resulting \
URI after substitution of the web shortcut values is then \
<userinput>http://www.google.com/search?as_q=kde+konqueror&amp;num=20&amp;btnG=Google+ \
Search&amp;as_epq=&amp;as_oq=&amp;as_eq=&amp;lr=&amp;as_ft="i"&amp;as_filetype=&amp;as \
_qdr=m3&amp;as_occt=any&amp;as_dt=i&amp;as_sitesearch=kde.org&amp;safe=active</userinput>.
 +</para>
+</sect3>
+
 </sect2>
 
 <sect2 id="ebrowse-author">
@@ -199,7 +257,12 @@
 Krishna Tateneni
 <email>tateneni@pluto.njcc.com</email>
 and Yves Arrouye
-<email>yves@realnames.com</email>
+<email>yves@realnames.com</email>.
+</para>
+<para>
+The documentation for the syntax of the <emphasis>Advanced Web Shortcuts</emphasis> \
has been written by +Andreas Hochsteger
+<email>e9625392@student.tuwien.ac.at</email>.
 </para>
 
 <!-- TRANS:CREDIT_FOR_TRANSLATORS -->
@@ -207,4 +270,3 @@
 </sect2>
 
 </sect1>
-


["kcmebrowse.docbook.de.diff" (text/x-diff)]

Index: kcmebrowse.docbook
===================================================================
RCS file: /home/kde/kde-i18n/de/docs/kdebase/kcontrol/kcmebrowse.docbook,v
retrieving revision 1.13
diff -u -r1.13 kcmebrowse.docbook
--- kcmebrowse.docbook	2002/03/10 17:23:53	1.13
+++ kcmebrowse.docbook	2002/03/10 23:02:16
@@ -27,6 +27,11 @@
 ></address
 ></affiliation
 > </author>
+<author>
+<firstname>Andreas</firstname>
+<surname>Hochsteger</surname>
+<affiliation><address><email>e9625392@student.tuwien.ac.at</email></address></affiliation>
 +</author>
 <othercredit role="translator"
 ><firstname
 >Stefan</firstname
@@ -41,6 +46,12 @@
 ><contrib
 >Deutsche Übersetzung</contrib
 ></othercredit>
+<othercredit role="translator">
+<firstname>Andreas</firstname>
+<surname>Hochsteger</surname>
+<affiliation><address><email>e9625392@student.tuwien.ac.at</email></address></affiliation>
 +<contrib>Deutsche Übersetzung der Syntax zu den erweiterten \
Web-Kurzbefehlen</contrib> +</othercredit>
 </authorgroup>
 
 <date
@@ -265,6 +276,60 @@
 
 </sect3>
 
+<sect3 id="ebrowse-aws-syntax">
+
+<title>Syntax der erweiterten Web-Kurzbefehle</title>
+
+<para>
+Allgemein verwenden Web-Kurzbefehle die Form <userinput>\{...}</userinput>.
+Der am häufigsten verwendete Ausdruck ist <userinput>\{@}</userinput>, da er für \
die meisten einfachen Such-URIs im Internet geeignet ist. +Wenn man unterschiedliche \
Werte an verschiedenen Positionen einer <acronym>URI</acronym> einsetzen möchte, \
muss man die erweiterten Möglichkeiten nutzen, die im Folgenden beschrieben werden. \
+</para> +
+<para>
+Liste der Ausdrücke:
+<itemizedlist>
+<listitem><para><userinput>\{1}</userinput> .. \
<userinput>\{<replaceable>n</replaceable>}</userinput> wird durch das \
<replaceable>n</replaceable>-te Wort der vom User eingegebenen Suchliste ersetzt, \
beginnend mit dem ersten Wort nach ':'.</para></listitem> \
+<listitem><para><userinput>\{<replaceable>name</replaceable>}</userinput> wird durch \
den Wert der Zeichenkette der Form \
'<replaceable>name</replaceable>=<replaceable>wert</replaceable>' \
ersetzt.</para></listitem> \
+<listitem><para><userinput>\{"<replaceable>wert</replaceable>"}</userinput> wird \
durch 'value' ersetzt.</para></listitem> +<listitem><para><userinput>\{0}</userinput> \
wird durch die ganze (unveränderte) Liste der vom Benutzer eingegebenen \
Suchwortliste ersetzt.</para></listitem> +<listitem><para><userinput>\{@}</userinput> \
wird durch die Liste der Wörter ersetzt, die nicht für eine andere Ersetzung \
verwendet wurden.</para></listitem> +</itemizedlist>
+Man kann jeden beliebigen einfachen Ausdruck auch in einem komplexeren Ausdruck \
verwenden, indem man sie durch Beistriche trennt: +<itemizedlist>
+<listitem><para><userinput>\{<replaceable>ausdruck1</replaceable>,<replaceable>ausdruck2</replaceable>,...}</userinput> \
wird durch den ersten nicht-leeren Ausdruck beginnend von links \
ersetzt.</para></listitem> +</itemizedlist>
+</para>
+</sect3>
+
+<sect3>
+<title>Beispiele</title>
+<para>
+Die <emphasis>Erweiterte Google Suche</emphasis> verwendet den Web-Kurzbefehl \
<userinput>ggx</userinput> mit der URI Definition \
<userinput>http://www.google.com/search?as_q=\{all,@}&amp;num=\{num,"10"}&amp;btnG=Goo \
gle+Search&amp;as_epq=\{exact}&amp;as_oq=\{any}&amp;as_eq=\{without}&amp;lr=\{lang}&am \
p;as_ft=\{ft,"i"}&amp;as_filetype=\{filetype,""}&amp;as_qdr=\{date,"all"}&amp;as_occt= \
\{occ,"any"}&amp;as_dt=\{siteop,"i"}&amp;as_sitesearch=\{site}&amp;safe=\{safe,"active"}</userinput>.
 +Hier folgt eine Erklärung der verwendeten Ausdrücke:
+<itemizedlist>
+<listitem><para><userinput>as_q=\{all,@}</userinput> liefert Ergebnisse mit den zu \
suchenden Wörtern. Man kann sie entweder als Ausdruck all=... oder einfach durch mit \
Leerzeichen getrennte Wörter angeben. Beispeiel: <userinput>ggx:my search \
words</userinput> or <userinput>ggx:all=word</userinput></para></listitem> \
+<listitem><para><userinput>num=\{num,"10"}</userinput> liefert die angegebene Anzahl \
von Suchergebnissen pro Seite. Standard: "10", Beispiel: \
<userinput>num=20</userinput></para></listitem> \
+<listitem><para><userinput>as_epq=\{exact,""}</userinput> liefert Ergebnisse welche \
nur die exakte Wortphrase beinhalten. Beispiel: \
<userinput>exact=...</userinput></para></listitem> \
+<listitem><para><userinput>as_oq=\{any,""}</userinput> liefert Ergebnisse, die \
zumindest eines der angegebenen Wörter beinhaltet. Beispiel: \
<userinput>any=...</userinput></para></listitem> \
+<listitem><para><userinput>as_eq=\{without,""}</userinput> liefert Ergebnisse, die \
die angegebenen Wörter nicht beinhalten. Beispiel: \
<userinput>without=...</userinput></para></listitem> \
+<listitem><para><userinput>lr=\{lang,""}</userinput> liefert nur Ergebnisse, die in \
der angegebenen Sprache (lang_en,lang_de,lang_fr,..) geschrieben sind. Beispiel: \
<userinput>lang=lang_de</userinput></para></listitem> \
+<listitem><para><userinput>as_ft=\{ft,"i"}</userinput> liefert nur Ergebnisse, die \
im angegebenen Dateityp vorliegen (i) oder nicht im angegebenen Dateityp vorliegen \
(e). Standard: "i", Beispiel: <userinput>ft=e</userinput></para></listitem> \
+<listitem><para><userinput>as_filetype=\{filetype,""}</userinput> liefert nur \
Ergebnisse, (nicht) im angegebenen Dateiformat (pdf, ps, rtf, xls, doc, ppt). \
Beispiel: <userinput>filetype=pdf</userinput></para></listitem> \
+<listitem><para><userinput>as_qdr=\{date,"all"}</userinput> liefert Ergebnisse, die \
in den letzten 3 Monaten (m3), den letzten 6 Monaten (m6) oder im letzen Jahr \
verändert wurden. Standard: "all", Beispiel: \
<userinput>date=m6</userinput></para></listitem> \
+<listitem><para><userinput>as_occt=\{occurence,"any"}</userinput> liefert \
Ergebnisse, wo die Suchwörter im irgendwo (any), im Titel (title), im Text (body), \
in der URL (url) oder in den Links (link) der Seite vorkommen. Standard: "any", \
Beispiel: <userinput>occurence=title</userinput></para></listitem> \
+<listitem><para><userinput>as_dt=\{siteop,"i"}</userinput> liefert Ergebnisse aus \
dem angegebenen Sitenamen (i) or nicht aus dem angegebenen Sitenamen (e). Standard: \
"i", Beispiel: <userinput>siteop=i</userinput></para></listitem> \
+<listitem><para><userinput>as_sitesearch=\{site,""}</userinput> liefert Ergebnisse \
(nicht) aus dem angegebenen Sitenamen. Beispiel: \
<userinput>site=kde.org</userinput></para></listitem> \
+<listitem><para><userinput>safe=\{safe,"active"}</userinput> aktiviert (active) or \
deaktiviert (off) das Filtern der Ergebnisse mit SafeSearch. Standard: "active", \
Beispiel: <userinput>safe=off</userinput></para></listitem> +</itemizedlist>
+</para>
+
+<para>
+Eine Beispiel-Anwendung der Erweiterten Google Suche könnte \
z.B.<userinput>ggx:num=20 site=kde.org date=m3 kde konqueror</userinput> sein. +Die \
daraus resultierende URI nach der Ersetzung der Ausdruckswerte ist dann \
<userinput>http://www.google.com/search?as_q=kde+konqueror&amp;num=20&amp;btnG=Google+ \
Search&amp;as_epq=&amp;as_oq=&amp;as_eq=&amp;lr=&amp;as_ft="i"&amp;as_filetype=&amp;as \
_qdr=m3&amp;as_occt=any&amp;as_dt=i&amp;as_sitesearch=kde.org&amp;safe=active</userinput>.
 +</para>
+</sect3>
+
 </sect2>
 
 <sect2 id="ebrowse-author">
@@ -273,19 +338,22 @@
 >Abschnittsautor</title>
 
 <para
->This section written by Krishna Tateneni <email
+>Dieser Abschnitt wurde von Krishna Tateneni <email
 >tateneni@pluto.njcc.com</email
-> and Yves Arrouye <email
+> und Yves Arrouye <email
 >yves@realnames.com</email
-> </para>
+> geschrieben.</para>
 
 <para
 >Die deutsche Übersetzung stammt von Stefan Winter <email
 >kickdown@online.de</email
 >.</para>
 
+<para>
+Die Dokumentation zur Syntax der <emphasis>Erweiterten Web-Kurzbefehle</emphasis> \
wurde geschrieben von +Andreas Hochsteger
+<email>e9625392@student.tuwien.ac.at</email>.
+</para>
 </sect2>
 
 </sect1>
-
-



[prev in list] [next in list] [prev in thread] [next in thread]
Configure | About | News | Add a list | Sponsored by KoreLogic