X-Git-Url: https://git.mdrn.pl/wolnelektury.git/blobdiff_plain/357027375ff8867f42ca34bcbfb5a78b5b185fc3..e24e657ebf536f55c1bde66bd41563fae30a98b0:/src/api/templates/api/main.html

diff --git a/src/api/templates/api/main.html b/src/api/templates/api/main.html
old mode 100755
new mode 100644
index 04244dc91..62bb535b3
--- a/src/api/templates/api/main.html
+++ b/src/api/templates/api/main.html
@@ -1,97 +1,106 @@
-{% extends "base.html" %}
+{% extends "base_simple.html" %}
 {% load i18n %}
 {% load build_absolute_uri from fnp_common %}
 
-{% block title %}{% trans "WolneLektury.pl API" %}{% endblock %}
+{% block settings %}
+  {% load title %}
+  {% trans "API WolneLektury.pl" as title %}
+  {% title title %}
+{% endblock %}
+
+{% block title %}{% trans "API WolneLektury.pl" %}{% endblock %}
 
 {% block bodyid %}api{% endblock %}
 
 {% block body %}
+  <h1>API</h1>
 
-<h1>API</h1>
-
-<div class="normal-text white-box">
-<p>
-{% url "api" as u %}
-{% blocktrans with u=u|build_absolute_uri:request %}
-WolneLektury.pl API resides under <code>{{ u }}</code>.
-You can use it to access information about books, their fragments and
-their metadata.
-{% endblocktrans %}
-</p>
+  <div class="normal-text white-box">
+    <p>
+      {% url "api" as u %}
+      {% blocktrans trimmed with u=u|build_absolute_uri:request %}
+        API serwisu WolneLektury.pl znajduje się pod adresem <code>{{ u }}</code>.
+        Za jego pomocą można uzyskać informacje o utworach, ich fragmentach
+        i metadanych.
+      {% endblocktrans %}
+    </p>
 
-<p>
-{% blocktrans %}
-Default data serialization format is
-<a href="http://en.wikipedia.org/wiki/JSON">JSON</a>, 
-but you can also use XML by appending <code>?format=xml</code>
-query parameter to each URL.
-{% endblocktrans %}
-</p>
+    <p>
+      {% blocktrans trimmed %}
+        Dane domyślnie są serializowane w formacie JSON,
+        ale dostępny jest też format XML – wystarczy dodać parametr
+        <code>?format=xml</code> do dowolnego zapytania.
+      {% endblocktrans %}
+    </p>
 
-<p>
-{% blocktrans %}
-The URLs in WolneLektury.pl API are:
-{% endblocktrans %}
-</p>
+    <p>
+      {% blocktrans trimmed %}
+        API Wolnych Lektur zawiera następujące adresy URL:
+      {% endblocktrans %}
+    </p>
 
-<ul>
-    <li><a href='{% url "api_book_list" "" %}'>
-    	{% url "api_book_list" "" %}</a> – {% trans "All books" %}
-    <li><a href='{% url "api_audiobook_list" "" %}'>
-    	{% url "api_audiobook_list" "" %}</a> – {% trans "Audiobooks" %}
-    <li><a href='{% url "api_daisy_list" "" %}'>
-    	{% url "api_daisy_list" "" %}</a> – {% trans "DAISY" %}
+    <ul>
+      <li><a href='{% url "catalogue_api_book_list" "" %}'>
+        {% url "catalogue_api_book_list" "" %}</a> – {% trans "Wszystkie utwory" %}</li>
+      <li><a href='{% url "catalogue_api_audiobook_list" "" %}'>
+        {% url "catalogue_api_audiobook_list" "" %}</a> – {% trans "Audiobooki" %}</li>
+      <li><a href='{% url "catalogue_api_daisy_list" "" %}'>
+        {% url "catalogue_api_daisy_list" "" %}</a> – {% trans "DAISY" %}</li>
 
-    <li><a href='{% url "api_tag_list" "authors" %}'>
-    	{% url "api_tag_list" "authors" %}</a> – {% trans "List of all authors" %}</li>
-    <li><a href='{% url "api_tag_list" "epochs" %}'>
-    	{% url "api_tag_list" "epochs" %}</a> – {% trans "List of all epochs" %}</li>
-    <li><a href='{% url "api_tag_list" "genres" %}'>
-    	{% url "api_tag_list" "genres" %}</a> – {% trans "List of all genres" %}</li>
-    <li><a href='{% url "api_tag_list" "kinds" %}'>
-    	{% url "api_tag_list" "kinds" %}</a> – {% trans "List of all kinds" %}</li>
+      <li><a href='{% url "catalogue_api_tag_list" "author" %}'>
+        {% url "catalogue_api_tag_list" "author" %}</a> – {% trans "Lista autorów" %}</li>
+      <li><a href='{% url "catalogue_api_tag_list" "epoch" %}'>
+        {% url "catalogue_api_tag_list" "epoch" %}</a> – {% trans "Lista epok" %}</li>
+      <li><a href='{% url "catalogue_api_tag_list" "genre" %}'>
+        {% url "catalogue_api_tag_list" "genre" %}</a> – {% trans "Lista gatunków literackich" %}</li>
+      <li><a href='{% url "catalogue_api_tag_list" "kind" %}'>
+        {% url "catalogue_api_tag_list" "kind" %}</a> – {% trans "Lista rodzajów literackich" %}</li>
 
-    <li><a href='{% url "api_tag_list" "themes" %}'>
-    	{% url "api_tag_list" "themes" %}</a> – {% trans "List of all themes" %}</li>
-    <li><a href='{% url "api_collections" %}'>
-    	{% url "api_collections" %}</a> – {% trans "Collections" %}
-</ul>
+      <li><a href='{% url "catalogue_api_tag_list" "theme" %}'>
+        {% url "catalogue_api_tag_list" "theme" %}</a> – {% trans "Lista motywów i tematów literackich" %}</li>
+      <li><a href='{% url "catalogue_api_collections" %}'>
+        {% url "catalogue_api_collections" %}</a> – {% trans "Kolekcje" %}</li>
+    </ul>
 
-<p>
-{% url "api_book" "studnia-i-wahadlo" as e1 %}
-{% url "api_tag" "authors" "edgar-allan-poe" as e2 %}
-{% blocktrans %}
-Each element of those lists contains a link (in a "href") attibute
-which points to individual resource's details, i.e.:
-<a href="{{e1}}">{{e1}}</a> or
-<a href="{{e2}}">{{e2}}</a>.
-{% endblocktrans %}
-</p>
+    <p>
+      {% url "catalogue_api_book" "studnia-i-wahadlo" as e1 %}
+      {% url "catalogue_api_tag" "author" "edgar-allan-poe" as e2 %}
+      {% blocktrans trimmed %}
+        Każdy element na tych listach zawiera adres (w atrybucie „href”), pod którym
+        można znaleźć szczegółowe dane, np.
+      {% endblocktrans %}
+      <a href="{{e1}}">{{e1}}</a> {% trans "albo" %}
+      <a href="{{e2}}">{{e2}}</a>.
+    </p>
 
-<p>
-{% blocktrans with "/api/authors/adam-mickiewicz/kinds/liryka/books/" as e %}
-You can combine authors, epochs, genres and kinds to find only books matching
-those criteria. For instance:
-<a href="{{e}}">{{e}}</a>.
-{% endblocktrans %}
-</p>
+    <p>
+      {% blocktrans trimmed %}
+        Można łączyć autorów, epoki, gatunki i rodzaje, aby wybrać tylko utwory
+        odpowiadające zadanym kryteriom. Na przykład:
+      {% endblocktrans %}
+      <a href="/api/authors/adam-mickiewicz/kinds/liryka/books/">/api/authors/adam-mickiewicz/kinds/liryka/books/</a>.
+    </p>
 
-<p>
-{% blocktrans with "/api/authors/adam-mickiewicz/kinds/liryka/parent_books/" as e %}
-If you only want top-level books and not all the children, you can use /parent_books/, as in:
-<a href="{{e}}">{{e}}</a>.
-{% endblocktrans %}
-</p>
+    <p>
+      {% blocktrans trimmed %}
+        Aby spośród wszystkich pasujących wybrać tylko utwory najwyższego poziomu
+        (pomijając ich podutwory), można użyć zapytania /parent_books/, np.:
+      {% endblocktrans %}
+      <a href="/api/authors/adam-mickiewicz/kinds/liryka/parent_books/">/api/authors/adam-mickiewicz/kinds/liryka/parent_books/"</a>.
+    </p>
 
-<p>
-{% url "api_fragment" "sen-nocy-letniej" "1290526312912-3814598192" as f %}
-{% blocktrans with "/api/authors/william-shakespeare/themes/zabawa/fragments/" as e %}
-The same way, using also books and themes, you can search for a list of fragments:
-<a href="{{e}}">{{e}}</a>. 
-Again, each entry has a "href" attribute which links to the fragment's details, i.e.:
-<a href="{{f}}">{{f}}</a>. 
-{% endblocktrans %}
-</p>
-</div>
+    <p>
+      {% blocktrans trimmed %}
+        W ten sam sposób, filtrując dodatkowo według lektur lub motywów, można
+        wyszukiwać fragmenty:
+      {% endblocktrans %}
+      <a href="/api/authors/william-shakespeare/themes/zabawa/fragments/">/api/authors/william-shakespeare/themes/zabawa/fragments/</a>.
+      {% blocktrans trimmed %}
+        Każdy element uzyskanej listy w atrybucie „href” zawiera link do
+        szczegółowego opisu danego fragmentu, np.:
+      {% endblocktrans %}
+      {% url "catalogue_api_fragment" "sen-nocy-letniej" "1290526312912-3814598192" as f %}
+      <a href="{{f}}">{{f}}</a>.
+    </p>
+  </div>
 {% endblock %}