Add German translation of fcsql.html.ep
Change-Id: I6d121fb6f842ac12cdf21774e7ad9048edd2774c
diff --git a/Changes b/Changes
index b943c7c..8a82597 100644
--- a/Changes
+++ b/Changes
@@ -4,6 +4,7 @@
- Fix layerInfo retrieval for relation view. (diewald)
- Change look of addon logo. (diewald)
- Support VCs via URL without queries (diewald)
+ - Added translations for regexp and FCSQL (r-wilm)
0.55 2024-07-03
- Removed deprecated doc_link_to helper. (diewald)
diff --git a/README.md b/README.md
index 318e214..20d112a 100644
--- a/README.md
+++ b/README.md
@@ -326,7 +326,8 @@
Copyright (C) 2015-2024, [IDS Mannheim](https://www.ids-mannheim.de/)<br>
Author: [Nils Diewald](https://www.nils-diewald.de/), Helge Stallkamp<br>
-Contributor: Eliza Margaretha (Documentation), Susanne Feix (Translation),
+Contributor: Eliza Margaretha (Documentation), Susanne Feix and Rebecca
+Wilm (Translation),
Leo Repp
Kalamar is developed as part of the [KorAP](https://korap.ids-mannheim.de/)
diff --git a/kalamar.dict b/kalamar.dict
index eb648c4..c5c9bfc 100644
--- a/kalamar.dict
+++ b/kalamar.dict
@@ -85,7 +85,8 @@
'.' => 'de/doc/ql',
'poliqarp-plus' => 'de/doc/ql/poliqarp-plus',
'cosmas-2' => 'de/doc/ql/cosmas-2',
- 'regexp' => 'de/doc/ql/regexp'
+ 'regexp' => 'de/doc/ql/regexp',
+ 'fcsql' => 'de/doc/ql/fcsql'
},
api => {
'koralquery' => 'de/doc/api/koralquery'
@@ -220,7 +221,8 @@
'.' => 'doc/ql',
'poliqarp-plus' => 'doc/ql/poliqarp-plus',
'cosmas-2' => 'doc/ql/cosmas-2',
- 'regexp' => 'doc/ql/regexp'
+ 'regexp' => 'doc/ql/regexp',
+ 'fcsql' => 'doc/ql/fcsql'
},
api => {
'koralquery' => 'doc/api/koralquery'
diff --git a/templates/de/doc/ql/fcsql.html.ep b/templates/de/doc/ql/fcsql.html.ep
new file mode 100644
index 0000000..a58a4f6
--- /dev/null
+++ b/templates/de/doc/ql/fcsql.html.ep
@@ -0,0 +1,88 @@
+% layout 'main', title => 'KorAP: FCS-QL';
+
+%= page_title
+
+<p>FCS-QL ist eine Anfragesprache, die speziell für die erweiterte Suche in der <%= ext_link_to 'CLARIN Federated Content Search (FCS)', "https://www.clarin.eu/content/federated-content-search-clarin-fcs" %> entwickelt wurde und eine Suche über annotierte Daten ermöglicht. FCS-QL ist also vor allem dann als Anfragesprache zu empfehlen, wenn es um Anfragen geht, die Annotationsebenen wie Part-of-Speech oder Lemma einbeziehen. Da FCS-QL zu großen Teilen auf Poliqarp/CQP basiert, sind sich <%= embedded_link_to 'doc', 'Poliqarp', 'ql', 'poliqarp-plus' %> und FCS-QL syntaktisch gesehen recht ähnlich.</p>
+
+<p>Foundries werden in FCS-QL Qualifikatoren genannt. Um eine bestimmte Annotationsebene einer Foundry anzusprechen, werden Foundry und Annotationsebene mithilfe eines Doppelpunkts verbunden. Zum Beispiel wird die Lemma-Ebene der TreeTagger-Foundry wie folgt repräsentiert: <code>tt:lemma</code>. In Bezug auf FCS-QL unterstützt KorAP die folgenden Annotationsebenen:</p>
+
+<dl>
+ <dt>text</dt>
+ <dd>Oberflächenform</dd>
+ <dt>lemma</dt>
+ <dd>Lemma</dd>
+ <dt>pos</dt>
+ <dd>Part-of-Speech</dd>
+</dl>
+
+<section id="simple-queries">
+
+ <h3>Einfache Anfragen</h3>
+
+ <p>Suche nach einzelnen Begriffen</p>
+ %= doc_query fcsql => '"Semmel"', cutoff => 1
+
+ <p>Einbindung von regulären Ausdrücken</p>
+ %= doc_query fcsql => '"gie(ss|ß)en"', cutoff => 1
+
+ <p>Suche ohne Beachtung der Groß- und Kleinschreibung</p>
+ %= doc_query fcsql => '"essen"/c', cutoff => 1
+</section>
+
+<section id="complex-queries">
+
+ <h3>Komplexe Anfragen</h3>
+
+ <h4>Einbeziehung von Annotationsebenen</h4>
+
+ <p>Suche nach einzelnen Begriffen auf Basis der Annotationsebene für Oberflächenformen</p>
+ %= doc_query fcsql => '[text = "Semmel"]', cutoff => 1
+ %= doc_query fcsql => '[text = "essen"/c]', cutoff => 1
+
+ <p>Suche nach Adverbien laut <%= embedded_link_to 'doc', 'Standard-Foundry', 'data', 'annotation' %>.</p>
+ %= doc_query fcsql => '[pos="ADV"]', cutoff => 1
+
+ <h4>Einbeziehung von Qualifikatoren (Foundries)</h4>
+
+ <p>Suche nach mithilfe von OpenNLP annotierten Adverbien</p>
+ %= doc_query fcsql => '[opennlp:pos="ADV"]', cutoff => 1
+
+ <p>Suche nach Tokens mit einem bestimmten TreeTagger-Lemma</p>
+ %= doc_query fcsql => '[tt:lemma = "leben"]', cutoff => 1
+
+ <h4>Suche mithilfe von booleschen Operatoren</h4>
+
+ <p>Alle Tokens mit dem Lemma <code>"leben"</code>, die auch finite Vollverben sind</p>
+ %= doc_query fcsql => '[tt:lemma ="leben" & pos="VVFIN"]', cutoff => 1
+
+ <p>Alle Tokens mit dem Lemma <code>"leben"</code>, die auch finite Vollverben oder Vollverben im Partizip Perfekt sind</p>
+ %= doc_query fcsql => '[tt:lemma ="leben" & (pos="VVFIN" | pos="VVPP")]', cutoff => 1
+
+ <h4>Sequenzanfragen</h4>
+
+ <p>Kombination von zwei Begriffen in einer Sequenzanfrage</p>
+ %= doc_query fcsql => '[opennlp:pos="ADJA"] "leben"', cutoff => 1
+
+ <h4>Leeres Token</h4>
+
+ <p>Wie es auch in <%= embedded_link_to 'doc', 'Poliqarp', 'ql', 'poliqarp-plus' %> der Fall ist, stellt <code>[]</code> in FCS-QL ein leeres Token dar, welches für jedes beliebige Token stehen kann. Um eine zu hohe Anzahl von Suchresultaten zu vermeiden, darf das leere Token in Anfragen nicht ganz alleine, sondern nur in Kombination mit anderen Tokens verwendet werden. Es spielt also vor allem bei Sequenzanfragen eine Rolle.</p>
+ %= doc_query fcsql => '[] "Wolke"', cutoff => 1
+
+ <h4>Negation</h4>
+
+ <p>Wie das leere Token darf eine Negation in einer Suchanfrage nicht ganz alleine stehen, da dies zu einer unverhältnismäßig hohen Anzahl von Resultaten führen würde. In Sequenzanfragen hingegen ist der Einsatz von Negationen möglich.</p>
+ %= doc_query fcsql => '[pos != "ADJA"] "Buch"', cutoff => 1
+
+ <h4>Einsatz von Quantifizierern</h4>
+
+ <p>Quantifizierer machen es möglich, nach Wiederholungen eines Begriffes zu suchen. Sie können zum Beispiel verwendet werden, um nach genau zwei aufeinanderfolgenden Vorkommen von <code>"die"</code> zu suchen.</p>
+ %= doc_query fcsql => '"die" {2}', cutoff => 1
+
+ <p>Des Weiteren sind Quantifizierer nützlich, um nach Vorkommen von beliebigen Tokens in der Nähe von anderen ganz spezifischen Tokens zu suchen. Die folgende Anfrage zum Beispiel lässt genau zwei oder drei beliebige Tokens zwischen <code>"wir"</code> und <code>"leben"</code> zu.</p>
+ %= doc_query fcsql => '"wir" []{2,3} "leben"', cutoff => 1
+
+ <h4>Suche nach einem Begriff innerhalb eines Satzes</h4>
+
+ %= doc_query fcsql => '"Boot" within s', cutoff => 1
+
+</section>
diff --git a/templates/doc/ql/fcsql.html.ep b/templates/doc/ql/fcsql.html.ep
index 735ce8b..f7e50c1 100644
--- a/templates/doc/ql/fcsql.html.ep
+++ b/templates/doc/ql/fcsql.html.ep
@@ -1,16 +1,16 @@
-% layout 'main', title => 'KorAP: FCSQL';
+% layout 'main', title => 'KorAP: FCS-QL';
%= page_title
<p>FCS-QL is a query language specifically developed to accomodate advanced search in
- <%= ext_link_to 'Clarin Federated Content Search (FCS)', "https://www.clarin.eu/content/federated-content-search-clarin-fcs" %>,
+ <%= ext_link_to 'CLARIN Federated Content Search (FCS)', "https://www.clarin.eu/content/federated-content-search-clarin-fcs" %>
that allows searching through annotated data.
Accordingly, FCS-QL is primarily intended to represent queries involving annotation layers
such as part-of-speech and lemma. FCS-QL grammar is fairly similar to <%= embedded_link_to 'doc', 'Poliqarp', 'ql', 'poliqarp-plus' %> since it was
built heavily based on Poliqarp/CQP.</p>
<p>In FCS-QL, foundries are called qualifiers. A combination of a foundry and a layer is
-separated with a colon, for example the lemma layer of Tree Tagger is represented as
+separated with a colon, for example the lemma layer of TreeTagger is represented as
<code>tt:lemma</code>. KorAP supports the following annotation layers for FCS-QL:</p>
<dl>
@@ -49,10 +49,10 @@
<h4>Querying using qualifiers (foundries)</h4>
- <p>Querying adverbs annotated by Opennlp</p>
+ <p>Querying adverbs annotated by OpenNLP</p>
%= doc_query fcsql => '[opennlp:pos="ADV"]', cutoff => 1
- <p>Querying tokens with a lemma from Tree tagger</p>
+ <p>Querying tokens with a lemma from TreeTagger</p>
%= doc_query fcsql => '[tt:lemma = "leben"]', cutoff => 1
@@ -72,15 +72,15 @@
<h4>Empty token</h4>
- <p>Like in <%= embedded_link_to 'doc', 'Poliqarp', 'ql', 'poliqarp-plus' %>, an empty token is signified by <code>[]</code>
+ <p>Like in <%= embedded_link_to 'doc', 'Poliqarp', 'ql', 'poliqarp-plus' %>, an empty token is signified by <code>[]</code>,
which means any token. Due to the
- excessive number of results, empty token is not allowed to be used independently, but in
+ excessive number of results, the empty token is not allowed to be used independently but only in
combination with other tokens, for instance in a sequence query.</p>
%= doc_query fcsql => '[] "Wolke"', cutoff => 1
<h4>Negation</h4>
- <p>Similar to empty token, negation is not allowed to be used independently due to the
+ <p>Similar to the empty token, negation is not allowed to be used independently due to the
excessive number of results. However, it can be used in a sequence query.</p>
%= doc_query fcsql => '[pos != "ADJA"] "Buch"', cutoff => 1