application: improvements (#990)(#993)(#999)(#1002)

Author: mildabre

application/bg/ajax.texy

@@ -10,9 +10,13 @@ AJAX и фрагменти
 
 </div>
 
-Заявката AJAX може да бъде открита чрез метода на услугата, който [капсулира HTTP заявката |http:request] `$httpRequest->isAjax()` (определя се въз основа на HTTP заглавието `X-Requested-With`). Съществува и съкратен метод в програмата за представяне: `$this->isAjax()`.
 
-Заявката AJAX не се различава от обикновената заявка - водещият се извиква с определено представяне и параметри. От водещия зависи и как ще реагира: той може да използва процедурите си, за да върне фрагмент от HTML код, XML документ, JSON обект или част от Javascript код.
+Заявка AJAX .[#toc-ajax-request]
+================================
+
+Заявката AJAX не се различава от класическата заявка - водещият се извиква с определен изглед и параметри. От водещия също зависи как да отговори на нея: той може да използва своя собствена процедура, която връща фрагмент от HTML код (HTML snippet), XML документ, JSON обект или JavaScript код.
+
+От страна на сървъра AJAX заявката може да бъде открита с помощта на метода на услугата, [капсулиращ HTTP заявката |http:request] `$httpRequest->isAjax()` (открива се въз основа на HTTP заглавието `X-Requested-With`). Вътре в презентатора е наличен пряк път под формата на метода `$this->isAjax()`.
 
 Съществува предварително обработен обект `payload`, предназначен за изпращане на данни към браузъра във формат JSON.
 
@@ -60,6 +64,21 @@ npm install naja
 <script src="https://unpkg.com/naja@2/dist/Naja.min.js"></script>
 ```
 
+За да създадете AJAX заявка от обикновена връзка (сигнал) или подаване на формуляр, просто маркирайте съответната връзка, формуляр или бутон с класа `ajax`:
+
+```html
+<a n:href="go!" class="ajax">Go</a>
+
+<form n:name="form" class="ajax">
+    <input n:name="submit">
+</form>
+
+or
+<form n:name="form">
+    <input n:name="submit" class="ajax">
+</form>
+```
+
 
 Извадки .[#toc-snippety]
 ========================

application/bg/bootstrap.texy

@@ -174,7 +174,7 @@ $configurator->addStaticParameters([
 ]);
 ```
 
-Конфигурационните файлове могат да използват нормалния запис `%projectId%` за достъп до параметъра с име `projectId`. По подразбиране конфигураторът попълва следните параметри: `appDir`, `wwwDir`, `tempDir`, `vendorDir`, `debugMode` и `consoleMode`.
+В конфигурационните файлове можем да запишем обичайната нотация `%projectId%`, за да получим достъп до параметъра с име `projectId`.
 
 
 Динамични параметри .[#toc-dynamic-parameters]
@@ -197,6 +197,19 @@ $configurator->addDynamicParameters([
 ```
 
 
+Параметри по подразбиране .[#toc-default-parameters]
+----------------------------------------------------
+
+Можете да използвате следните статични параметри в конфигурационните файлове:
+
+- `%appDir%` е абсолютният път до директорията на файла `Bootstrap.php`
+- `%wwwDir%` е абсолютният път до директорията, съдържаща входния файл `index.php`
+- `%tempDir%` е абсолютният път до директорията за временни файлове
+- `%vendorDir%` е абсолютният път до директорията, в която Composer инсталира библиотеки
+- `%debugMode%` показва дали приложението е в режим на отстраняване на грешки
+- `%consoleMode%` показва дали заявката е постъпила от командния ред
+
+
 Внесени услуги .[#toc-imported-services]
 ----------------------------------------
 

application/bg/presenters.texy

@@ -158,7 +158,7 @@ $url = $this->link('Product:show', [$id, 'lang' => 'en']);
 $this->forward('Product:show');
 ```
 
-Пример за временно пренасочване с HTTP код 302 или 303:
+Пример за т.нар. временно пренасочване с HTTP код 302 (или 303, ако текущият метод на заявка е POST):
 
 ```php
 $this->redirect('Product:show', $id);
@@ -170,7 +170,7 @@ $this->redirect('Product:show', $id);
 $this->redirectPermanent('Product:show', $id);
 ```
 
-Можете да пренасочите към друг URL адрес извън приложението, като използвате метода `redirectUrl()`:
+Можете да пренасочите към друг URL адрес извън приложението, като използвате метода `redirectUrl()`. Като втори параметър може да се посочи HTTP кодът, като по подразбиране той е 302 (или 303, ако текущият метод на заявка е POST):
 
 ```php
 $this->redirectUrl('https://nette.org');

application/bg/templates.texy

@@ -42,7 +42,9 @@ Nette използва системата за шаблони [Latte |latte:]. L
 - `templates/<Presenter>/<view>.latte`
 - `templates/<Presenter>.<view>.latte`
 
-Ако шаблонът не е намерен, отговорът ще бъде [грешка 404 |presenters#error-404-etc].
+Ако шаблонът не бъде намерен, ще се опита да търси в директорията `templates` едно ниво по-нагоре, т.е. на същото ниво като директорията с класа на водещия.
+
+Ако шаблонът не бъде намерен и там, отговорът ще бъде [грешка 404 |presenters#Error 404 etc.].
 
 Можете също така да промените изгледа с помощта на `$this->setView('jineView')`. Или вместо да търсите директно, посочете името на файла с шаблона, като използвате `$this->template->setFile('/path/to/template.latte')`.
 

application/cs/ajax.texy

@@ -10,10 +10,14 @@ Moderní webové aplikace dnes běží napůl na serveru, napůl v prohlížeči
 
 </div>
 
-AJAXový požadavek lze detekovat metodou služby [zapouzdřující HTTP požadavek |http:request] `$httpRequest->isAjax()` (detekuje podle HTTP hlavičky `X-Requested-With`). Uvnitř presenteru je k dispozici "zkratka" v podobě metody `$this->isAjax()`.
+
+AJAXový požadavek
+=================
 
 AJAXový požadavek se nijak neliší od klasického požadavku - je zavolán presenter s určitým view a parametry. Je také věcí presenteru, jak bude na něj reagovat: může použít vlastní rutinu, která vrátí nějaký fragment HTML kódu (HTML snippet), XML dokument, JSON objekt nebo kód v JavaScriptu.
 
+Na straně serveru lze AJAXový požadavek detekovat metodou služby [zapouzdřující HTTP požadavek |http:request] `$httpRequest->isAjax()` (detekuje podle HTTP hlavičky `X-Requested-With`). Uvnitř presenteru je k dispozici "zkratka" v podobě metody `$this->isAjax()`.
+
 Pro odesílání dat prohlížeči ve formátu JSON lze využít předpřipravený objekt `payload`:
 
 ```php
@@ -60,6 +64,21 @@ npm install naja
 <script src="https://unpkg.com/naja@2/dist/Naja.min.js"></script>
 ```
 
+Aby se z obyčejného odkazu (signálu) nebo odeslání formuláře vytvořil AJAXový požadavek, stačí označit příslušný odkaz, formulář nebo tlačítko třídou `ajax`:
+
+```html
+<a n:href="go!" class="ajax">Go</a>
+
+<form n:name="form" class="ajax">
+    <input n:name="submit">
+</form>
+
+nebo
+<form n:name="form">
+    <input n:name="submit" class="ajax">
+</form>
+```
+
 
 Snippety
 ========

application/cs/bootstrap.texy

@@ -174,7 +174,7 @@ $configurator->addStaticParameters([
 ]);
 ```
 
-Na parametr `projectId` se lze v konfiguraci odkázat obvyklým zápisem `%projectId%`. Třída Configurator automaticky přidává parametry `appDir`, `wwwDir`, `tempDir`, `vendorDir`, `debugMode` a `consoleMode`.
+Na parametr `projectId` se lze v konfiguraci odkázat obvyklým zápisem `%projectId%`.
 
 
 Dynamické parametry
@@ -197,6 +197,19 @@ $configurator->addDynamicParameters([
 ```
 
 
+Výchozí parametry
+-----------------
+
+V konfiguračních souborech můžete využít tyto statické parametry:
+
+- `%appDir%` je absolutní cesta k adresáři se souborem `Bootstrap.php`
+- `%wwwDir%` je absolutní cesta k adresáři se vstupním souborem `index.php`
+- `%tempDir%` je absolutní cesta k adresáři pro dočasné soubory
+- `%vendorDir%` je absolutní cesta k adresáři, kam Composer instaluje knihovny
+- `%debugMode%` udává, zda je aplikace v debugovacím režimu
+- `%consoleMode%` udává, zda request přišel přes příkazovou řádku
+
+
 Importované služby
 ------------------
 

application/cs/presenters.texy

@@ -158,7 +158,7 @@ Metoda `forward()` přejde na nový presenter okamžitě bez HTTP přesměrován
 $this->forward('Product:show');
 ```
 
-Příklad tzv. dočasného přesměrování s HTTP kódem 302 nebo 303:
+Příklad tzv. dočasného přesměrování s HTTP kódem 302 (nebo 303, je-li metoda aktuálního požadavku POST):
 
 ```php
 $this->redirect('Product:show', $id);
@@ -170,7 +170,7 @@ Permanentní přesměrování s HTTP kódem 301 docílíte takto:
 $this->redirectPermanent('Product:show', $id);
 ```
 
-Na jinou URL mimo aplikaci lze přesměrovat metodou `redirectUrl()`:
+Na jinou URL mimo aplikaci lze přesměrovat metodou `redirectUrl()`. Jako druhý parametr lze uvést HTTP kód, výchozí je 302 (nebo 303, je-li metoda aktuálního požadavku POST):
 
 ```php
 $this->redirectUrl('https://nette.org');

application/cs/templates.texy

@@ -42,7 +42,9 @@ Cestu k šablonám odvodí presenter podle jednoduché logiky. Zkusí, zda exist
 - `templates/<Presenter>/<view>.latte`
 - `templates/<Presenter>.<view>.latte`
 
-Pokud šablonu nenajde, je odpovědí [chyba 404|presenters#Chyba 404 a spol.].
+Pokud šablonu nenajde, zkusí hledat ještě v adresáři `templates` o úroveň výš, tj. na stejné úrovni, jako je adresář s třídou presenteru.
+
+Pokud ani tam šablonu nenajde, je odpovědí [chyba 404|presenters#Chyba 404 a spol.].
 
 Můžete také změnit view pomocí `$this->setView('jineView')`. Nebo místo dohledávání přímo určit jméno souboru se šablonou pomocí `$this->template->setFile('/path/to/template.latte')`.
 

application/de/ajax.texy

@@ -10,9 +10,13 @@ Moderne Webanwendungen laufen heute zur Hälfte auf einem Server und zur Hälfte
 
 </div>
 
-Eine AJAX-Anfrage kann mit einer Methode eines Dienstes, [der eine HTTP-Anfrage kapselt |http:request], erkannt werden `$httpRequest->isAjax()` (erkennt anhand des `X-Requested-With` HTTP-Headers). Es gibt auch eine Kurzform der Methode in Presenter: `$this->isAjax()`.
 
-Eine AJAX-Anfrage unterscheidet sich nicht von einer normalen Anfrage - ein Presenter wird mit einer bestimmten Ansicht und Parametern aufgerufen. Auch hier ist es dem Präsentator überlassen, wie er reagiert: Er kann seine Routinen nutzen, um entweder ein Fragment von HTML-Code (ein Snippet), ein XML-Dokument, ein JSON-Objekt oder ein Stück Javascript-Code zurückzugeben.
+AJAX-Anfrage .[#toc-ajax-request]
+=================================
+
+Eine AJAX-Anfrage unterscheidet sich nicht von einer klassischen Anfrage - der Presenter wird mit einer bestimmten Ansicht und Parametern aufgerufen. Es liegt auch am Präsentator, wie er darauf reagiert: Er kann seine eigene Routine verwenden, die ein HTML-Codefragment (HTML-Snippet), ein XML-Dokument, ein JSON-Objekt oder JavaScript-Code zurückgibt.
+
+Auf der Serverseite kann eine AJAX-Anfrage mit Hilfe der Servicemethode erkannt werden [, die die HTTP-Anfrage kapselt |http:request] `$httpRequest->isAjax()` (erkennt auf der Grundlage des HTTP-Headers `X-Requested-With`). Innerhalb des Presenters ist eine Abkürzung in Form der Methode `$this->isAjax()` verfügbar.
 
 Es gibt ein vorverarbeitetes Objekt namens `payload`, das für das Senden von Daten in JSON an den Browser bestimmt ist.
 
@@ -60,6 +64,21 @@ npm install naja
 <script src="https://unpkg.com/naja@2/dist/Naja.min.js"></script>
 ```
 
+Um eine AJAX-Anfrage aus einem regulären Link (Signal) oder einer Formularübermittlung zu erzeugen, markieren Sie einfach den entsprechenden Link, das Formular oder die Schaltfläche mit der Klasse `ajax`:
+
+```html
+<a n:href="go!" class="ajax">Go</a>
+
+<form n:name="form" class="ajax">
+    <input n:name="submit">
+</form>
+
+or
+<form n:name="form">
+    <input n:name="submit" class="ajax">
+</form>
+```
+
 
 Schnipsel .[#toc-snippets]
 ==========================

application/de/bootstrap.texy

@@ -174,7 +174,7 @@ $configurator->addStaticParameters([
 ]);
 ```
 
-In Konfigurationsdateien können wir die übliche Notation `%projectId%` verwenden, um auf den Parameter mit dem Namen `projectId` zuzugreifen. Standardmäßig füllt der Configurator die folgenden Parameter aus: `appDir`, `wwwDir`, `tempDir`, `vendorDir`, `debugMode` und `consoleMode`.
+In Konfigurationsdateien können wir die übliche Notation `%projectId%` verwenden, um auf den Parameter `projectId` zuzugreifen.
 
 
 Dynamische Parameter .[#toc-dynamic-parameters]
@@ -197,6 +197,19 @@ $configurator->addDynamicParameters([
 ```
 
 
+Standard-Parameter .[#toc-default-parameters]
+---------------------------------------------
+
+Sie können die folgenden statischen Parameter in den Konfigurationsdateien verwenden:
+
+- `%appDir%` ist der absolute Pfad zu dem Verzeichnis, in dem sich die Datei `Bootstrap.php` befindet
+- `%wwwDir%` ist der absolute Pfad zu dem Verzeichnis, das die `index.php` Eintragsdatei enthält
+- `%tempDir%` ist der absolute Pfad zu dem Verzeichnis für temporäre Dateien
+- `%vendorDir%` ist der absolute Pfad zu dem Verzeichnis, in dem Composer die Bibliotheken installiert
+- `%debugMode%` gibt an, ob sich die Anwendung im Debug-Modus befindet
+- `%consoleMode%` zeigt an, ob die Anfrage über die Befehlszeile kam
+
+
 Importierte Dienste .[#toc-imported-services]
 ---------------------------------------------