added best-practices/microsites

best-practices/bg/@home.texy

@@ -36,6 +36,7 @@
 Обща
 ----
 - [Как да заредим конфигурационен файл |bootstrap:]
+- [Как да пишем микросайтове |microsites]
 - [Защо Nette използва константна нотация PascalCase? |https://blog.nette.org/bg/za-po-malko-kresene-v-koda]
 - [Защо Nette не използва суфикса Interface? |https://blog.nette.org/bg/prefiksite-i-sufiksite-ne-prinadlezat-na-imenata-na-interfejsite]
 - [Съвети за използване на Composer |composer]

best-practices/bg/microsites.texy

@@ -0,0 +1,63 @@
+Как да пишем микросайтове
+*************************
+
+Представете си, че трябва бързо да създадете малък уебсайт за предстоящо събитие на вашата компания. Той трябва да бъде прост, бърз и без излишни усложнения. Може би си мислите, че такъв малък проект не изисква стабилна рамка. Но какво ще кажете, ако използването на рамката Nette може значително да опрости и ускори този процес?
+
+Дори когато създавате прости уебсайтове, не искате да се отказвате от комфорта. Не искате да изобретявате колелото наново. Чувствайте се свободни да бъдете мързеливи и да се поглезите. Рамката Nette може да се използва отлично и като микрорамка.
+
+Как може да изглежда един такъв микросайт? Например, целият код на уебсайта може да бъде поставен в един файл `index.php` в публичната папка:
+
+```php
+<?php
+
+require __DIR__ . '/../vendor/autoload.php';
+
+$configurator = new Nette\Bootstrap\Configurator;
+$configurator->enableTracy(__DIR__ . '/../log');
+$configurator->setTempDirectory(__DIR__ . '/../temp');
+
+// създаване на контейнер DI въз основа на конфигурацията в config.neon
+$configurator->addConfig(__DIR__ . '/../app/config.neon');
+$container = $configurator->createContainer();
+
+// настройка на маршрутизацията
+$router = new Nette\Application\Routers\RouteList;
+$container->addService('router', $router);
+
+// маршрут за URL https://example.com/
+$router->addRoute('', function ($presenter, Nette\Http\Request $httpRequest) {
+	// разпознаване на езика на браузъра и пренасочване към URL /en или /de и т.н.
+	$supportedLangs = ['en', 'de', 'cs'];
+	$lang = $httpRequest->detectLanguage($supportedLangs) ?: reset($supportedLangs);
+	$presenter->redirectUrl("/$lang");
+});
+
+// маршрут за URL https://example.com/cs или https://example.com/en
+$router->addRoute('<lang cs|en>', function ($presenter, string $lang) {
+	// покажете съответния шаблон, например ../templates/en.latte
+	$template = $presenter->createTemplate()
+		->setFile(__DIR__ . '/../templates/' . $lang . '.latte');
+	return $template;
+});
+
+// стартирайте приложението!
+$container->getByType(Nette\Application\Application::class)->run();
+```
+
+Всичко останало ще бъде шаблони, съхранявани в родителската папка `/templates`.
+
+PHP кодът в `index.php` първо настройва [средата |bootstrap:], след това дефинира [маршрути |application:routing#dynamic-routing-with-callbacks] и накрая стартира приложението. Предимството е, че вторият параметър на функцията `addRoute()` може да бъде извикващо се име, което се изпълнява при отваряне на съответната страница.
+
+
+Защо да използвате Nette за микросайтове? .[#toc-why-use-nette-for-microsites]
+------------------------------------------------------------------------------
+
+- Разработчиците, които някога са опитвали [Трейси |tracy:], днес не могат да си представят кодирането без него.
+- Но преди всичко ще използвате системата за шаблониране [Latte |latte:], защото само от 2 страници ще искате да разделите [оформлението и съдържанието |latte:template-inheritance].
+- И със сигурност искате да разчитате на [автоматичното ескапиране, |latte:safety-first] за да предотвратите XSS уязвимости.
+- Nette също така гарантира, че в случай на грешка никога няма да бъдат показвани съобщения за грешка на PHP, а вместо това ще бъде показана удобна за потребителя страница.
+- Ако искате да получавате обратна връзка от потребителите, например под формата на форма за контакт, можете да добавите и [форми |forms:] и [база данни |database:].
+- Можете също така лесно да [изпратите |mail:] попълнените формуляри [по имейл |mail:].
+- Понякога може да ви е полезно [кеширането |caching:], например при изтегляне и показване на емисии.
+
+В днешната епоха, в която скоростта и ефективността са от ключово значение, е важно да разполагате с инструменти, които ви позволяват да постигате резултати без излишни забавяния. Рамката Nette предлага точно това - бърза разработка, сигурност и широк набор от инструменти като Tracy и Latte, които опростяват процеса. Достатъчно е да инсталирате няколко пакета на Nette и изграждането на такъв микросайт се превръща в лесна задача. И знаете, че няма скрити недостатъци в сигурността.

best-practices/cs/@home.texy

@@ -36,6 +36,7 @@ Formuláře
 Obecné
 ------
 - [Jak načíst konfigurační soubor |bootstrap:]
+- [Jak psát mikro-weby |microsites]
 - [Proč Nette používá PascalCase notaci konstant? |https://blog.nette.org/cs/za-mene-kriku-v-kodu]
 - [Proč Nette nepoužívá příponu Interface? |https://blog.nette.org/cs/predpony-a-pripony-do-nazvu-rozhrani-nepatri]
 - [Composer: tipy pro použití |composer]

best-practices/cs/microsites.texy

@@ -0,0 +1,63 @@
+Jak psát mikro-weby
+*******************
+
+Představte si, že potřebujete rychle vytvořit malý web pro nadcházející akci vaší firmy. Má to být jednoduché, rychlé a bez zbytečných komplikací. Možná si myslíte, že pro tak malý projekt nepotřebujete robustní framework. Ale co když použití Nette frameworku může tento proces zásadně zjednodušit a zrychlit?
+
+Přece i při tvorbě jednoduchých webů se nechcete vzdát pohodlí. Nechcete vymýšlet to, co už bylo jednou vyřešené. Buďte klidně líný a nechte se rozmazlovat. Nette Framework lze skvěle využít i jako micro framework.
+
+Jak takový microsite může vypadat? Například tak, že celý kód webu umístíme do jediného souboru `index.php` ve veřejné složce:
+
+```php
+<?php
+
+require __DIR__ . '/../vendor/autoload.php';
+
+$configurator = new Nette\Bootstrap\Configurator;
+$configurator->enableTracy(__DIR__ . '/../log');
+$configurator->setTempDirectory(__DIR__ . '/../temp');
+
+// vytvoř DI kontejner na základě konfigurace v config.neon
+$configurator->addConfig(__DIR__ . '/../app/config.neon');
+$container = $configurator->createContainer();
+
+// nastavíme routing
+$router = new Nette\Application\Routers\RouteList;
+$container->addService('router', $router);
+
+// routa pro URL https://example.com/
+$router->addRoute('', function ($presenter, Nette\Http\Request $httpRequest) {
+	// detekujeme jazyk prohlížeče a přesměrujeme na URL /en nebo /de atd.
+	$supportedLangs = ['en', 'de', 'cs'];
+	$lang = $httpRequest->detectLanguage($supportedLangs) ?: reset($supportedLangs);
+	$presenter->redirectUrl("/$lang");
+});
+
+// routa pro URL https://example.com/cs nebo https://example.com/en
+$router->addRoute('<lang cs|en>', function ($presenter, string $lang) {
+	// zobrazíme příslušnou šablonu, například ../templates/en.latte
+	$template = $presenter->createTemplate()
+		->setFile(__DIR__ . '/../templates/' . $lang . '.latte');
+	return $template;
+});
+
+// spusť aplikaci!
+$container->getByType(Nette\Application\Application::class)->run();
+```
+
+Vše ostatní budou šablony uložené v nadřazené složce `/templates`.
+
+PHP kód v `index.php` nejprve [připraví prostředí |bootstrap:], poté definuje [routy|application:routing#dynamicke-routovani-s-callbacky] a nakonec spustí aplikaci. Výhodou je, že druhý parametr funkce `addRoute()` může být callable, který se po otevření odpovídající stránky vykoná.
+
+
+Proč používat Nette pro microsite?
+----------------------------------
+
+- Programátoři, kteří někdy vyzkoušeli [Tracy|tracy:], si dnes neumí představit, že by něco programovali bez ní.
+- Především ale využijete šablonovací systém [Latte|latte:], protože už od 2 stránek budete chtít mít oddělený [layout a obsah|latte:template-inheritance].
+- A rozhodně se chcete spolehout na [automatické escapování |latte:safety-first], aby nevznikla zranitelnost XSS
+- Nette taky zajistí, že se při chybě nikdy neobrazí programátorské chybové hlášky PHP, ale uživateli srozumitelná stránka.
+- Pokud chcete získávat zpětnou vazbu od uživatelů, například v podobě kontaktního formuláře, tak ještě přidáte [formuláře|forms:] a [databázi|database:].
+- Vyplněné formuláře si taktéž můžete nechat snadno [odesílat emailem|mail:].
+- Někdy se vám může hodit [kešování|caching:], například pokud stahujete a zobrazujete feedy.
+
+V dnešní době, kdy je rychlost a efektivita klíčová, je důležité mít nástroje, které vám umožní dosáhnout výsledků bez zbytečného zdržování. Nette framework vám nabízí právě to - rychlý vývoj, bezpečnost a širokou škálu nástrojů, jako je Tracy a Latte, které zjednodušují proces. Stačí nainstalovat pár Nette balíčků a vybudovat takovou microsite je najednou úplná hračka. A víte, že se nikde neskrývá žádná bezpečnostní díra.

best-practices/de/@home.texy

@@ -36,6 +36,7 @@ Formulare
 Allgemein
 ---------
 - [Wie man eine Konfigurationsdatei lädt |bootstrap:]
+- [Wie man Microsites schreibt |microsites]
 - [Warum verwendet Nette die Konstantenschreibweise PascalCase? |https://blog.nette.org/de/fuer-weniger-geschrei-im-code]
 - [Warum verwendet Nette nicht das Suffix Interface? |https://blog.nette.org/de/praefixe-und-suffixe-gehoeren-nicht-in-schnittstellennamen]
 - [Tipps zur Verwendung des Composers |composer]

best-practices/de/microsites.texy

@@ -0,0 +1,63 @@
+Wie man Microsites schreibt
+***************************
+
+Stellen Sie sich vor, Sie müssen schnell eine kleine Website für eine bevorstehende Veranstaltung Ihres Unternehmens erstellen. Sie soll einfach, schnell und ohne unnötige Komplikationen sein. Sie denken vielleicht, dass ein solch kleines Projekt kein robustes Framework benötigt. Aber was wäre, wenn die Verwendung des Nette-Frameworks diesen Prozess erheblich vereinfachen und beschleunigen könnte?
+
+Auch bei der Erstellung einfacher Websites wollen Sie nicht auf Komfort verzichten. Sie wollen das Rad nicht neu erfinden. Seien Sie ruhig faul und gönnen Sie sich etwas. Das Nette Framework lässt sich auch hervorragend als Micro-Framework einsetzen.
+
+Wie könnte eine solche Microsite aussehen? Zum Beispiel kann der gesamte Code der Website in einer einzigen `index.php` Datei im öffentlichen Ordner untergebracht werden:
+
+```php
+<?php
+
+require __DIR__ . '/../vendor/autoload.php';
+
+$configurator = new Nette\Bootstrap\Configurator;
+$configurator->enableTracy(__DIR__ . '/../log');
+$configurator->setTempDirectory(__DIR__ . '/../temp');
+
+// einen DI-Container auf der Grundlage der Konfiguration in config.neon erstellen
+$configurator->addConfig(__DIR__ . '/../app/config.neon');
+$container = $configurator->createContainer();
+
+// Routing einrichten
+$router = new Nette\Application\Routers\RouteList;
+$container->addService('router', $router);
+
+// Route für URL https://example.com/
+$router->addRoute('', function ($presenter, Nette\Http\Request $httpRequest) {
+	// Erkennung der Browsersprache und Umleitung auf URL /en oder /de usw.
+	$supportedLangs = ['en', 'de', 'cs'];
+	$lang = $httpRequest->detectLanguage($supportedLangs) ?: reset($supportedLangs);
+	$presenter->redirectUrl("/$lang");
+});
+
+// Route für URL https://example.com/cs nebo https://example.com/en
+$router->addRoute('<lang cs|en>', function ($presenter, string $lang) {
+	// Anzeige der entsprechenden Vorlage, zum Beispiel ../templates/de.latte
+	$template = $presenter->createTemplate()
+		->setFile(__DIR__ . '/../templates/' . $lang . '.latte');
+	return $template;
+});
+
+// Starten Sie die Anwendung!
+$container->getByType(Nette\Application\Application::class)->run();
+```
+
+Alles andere sind Vorlagen, die im übergeordneten Ordner `/templates` gespeichert werden.
+
+Der PHP-Code in `index.php` richtet zunächst [die Umgebung |bootstrap:] ein, definiert dann die [Routen |application:routing#dynamic-routing-with-callbacks] und führt schließlich die Anwendung aus. Der Vorteil ist, dass der zweite Parameter der Funktion `addRoute()` eine Callable sein kann, die ausgeführt wird, wenn die entsprechende Seite geöffnet wird.
+
+
+Warum Nette für Microsites verwenden? .[#toc-why-use-nette-for-microsites]
+--------------------------------------------------------------------------
+
+- Entwickler, die [Tracy |tracy:] einmal ausprobiert haben, können sich heute nicht mehr vorstellen, ohne es zu programmieren.
+- Aber vor allem werden Sie das Templating-System [Latte |latte:] nutzen, denn schon ab 2 Seiten werden Sie [Layout und Inhalt |latte:template-inheritance] trennen wollen.
+- Und Sie wollen sich auf jeden Fall auf das [automatische Escaping |latte:safety-first] verlassen, um XSS-Schwachstellen zu vermeiden.
+- Nette sorgt auch dafür, dass im Falle eines Fehlers niemals PHP-Fehlermeldungen angezeigt werden, sondern eine benutzerfreundliche Seite.
+- Wenn Sie Feedback von den Nutzern erhalten möchten, zum Beispiel in Form eines Kontaktformulars, können Sie auch [Formulare |forms:] und eine [Datenbank |database:] hinzufügen.
+- Sie können ausgefüllte Formulare auch einfach [per E-Mail versch |mail:]icken lassen.
+- In manchen Fällen ist die [Zwischenspeicherung |caching:] nützlich, z. B. beim Herunterladen und Anzeigen von Feeds.
+
+In der heutigen Zeit, in der Geschwindigkeit und Effizienz entscheidend sind, ist es wichtig, über Werkzeuge zu verfügen, die es Ihnen ermöglichen, Ergebnisse ohne unnötige Verzögerungen zu erzielen. Das Nette-Framework bietet genau das - schnelle Entwicklung, Sicherheit und eine breite Palette von Tools wie Tracy und Latte, die den Prozess vereinfachen. Installieren Sie einfach ein paar Nette-Pakete, und die Erstellung einer solchen Microsite wird zum Kinderspiel. Und Sie wissen, dass es keine versteckten Sicherheitslücken gibt.

best-practices/el/@home.texy

@@ -36,6 +36,7 @@
 Κοινό
 -----
 - [Πώς να φορτώσετε το αρχείο ρυθμίσεων |bootstrap:]
+- [Πώς να γράφετε microsites |microsites]
 - [Γιατί η Nette χρησιμοποιεί τη σημειογραφία σταθερών PascalCase; |https://blog.nette.org/el/gia-ligoteres-krauges-ston-kodika]
 - [Γιατί η Nette δεν χρησιμοποιεί την κατάληξη Interface; |https://blog.nette.org/el/ta-prothemata-kai-ta-epithemata-den-anekoun-sta-onomata-diasyndeses]
 - [Συμβουλές χρήσης του Composer |composer]