From fde2202e2d7a309c619819223caed7f60f41cbb4 Mon Sep 17 00:00:00 2001
From: David Grudl <david@grudl.com>
Date: Wed, 18 Dec 2024 15:13:19 +0100
Subject: [PATCH] x

---
 database/cs/@home.texy | 69 ++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 66 insertions(+), 3 deletions(-)

diff --git a/database/cs/@home.texy b/database/cs/@home.texy
index 20cc87170b..3fb65a8a36 100644
--- a/database/cs/@home.texy
+++ b/database/cs/@home.texy
@@ -1,7 +1,72 @@
+Nette Database
+**************
+
+.[perex]
+Nette Database je výkonná a elegantní databázová vrstva pro PHP, která vyniká svou jednoduchostí použití a chytrými funkcemi. Nevyžaduje žádnou složitou konfiguraci nebo generování entit, s Nette Database můžete začít pracovat okamžitě.
+
+
+Proč zvolit Nette Database?
+---------------------------
+
+**Dvě vrstvy v jednom**:
+  - [Database Core|core] - Nízkoúrovňová vrstva pro přímou práci s databází
+  - [Database Explorer|explorer] - Pokročilá vrstva pro intuitivní práci s daty a jejich vztahy
+
+**Automatická optimalizace výkonu:**
+  - Inteligentní načítání souvisejících dat
+  - Adaptivní načítání pouze potřebných sloupců
+  - Minimalizace počtu databázových dotazů
+
+**Bezpečnost na prvním místě:**
+  - Vestavěná ochrana proti SQL injection
+  - Parametrizované dotazy
+  - Bezpečné zpracování vstupních dat
+
+**Intuitivní práce s relacemi:**
+  - Přirozený přístup k propojeným datům
+  - Podpora všech typů vazeb (1:1, 1:N, M:N)
+  - Bez nutnosti psát JOIN dotazy
+
+**Výkonný debugovací panel v [Tracy|tracy:]** - vidíte:
+- Všechny provedené dotazy s časy
+- Vysvětlení dotazů (EXPLAIN)
+
+**Nejjednodušší parametrické dotazy** - stačí jen čárka a hodnota:
+
+```php
+$database->query('SELECT * FROM users WHERE name =', $name);
+```
+
+Žádné `?`, `:param`, `@param` nebo jiné speciální syntaxe - prostě jen otazník.
+
+
+**Chytrá detekce vazeb** - nepotřebujete konfigurovat entity ani mapování:
+
+```php
+$book = $explorer->table('book')->get(1);
+echo $book->author->name;      // automaticky nalezne vazbu přes book.author_id
+```
+
+**Adaptivní načítání dat** - automaticky načítá jen sloupce, které skutečně používáte v kódu
+```php
+foreach ($books as $book) {
+  echo $book->title;    // načte se jen sloupec title
+}
+```
+
+
+Instalace
+---------
+
+Instalace pomocí Composeru:
+
+```shell
+composer require nette/database
+```
 
 
 Podporované databáze
-====================
+--------------------
 
 Nette podporuje následující databáze:
 
@@ -15,7 +80,5 @@ Nette podporuje následující databáze:
 | ODBC                | odbc        | ANO                 | -
 
 
-
-
 {{title: Nette Database}}
 {{description: Nette Database zásadním způsobem zjednodušuje získávání dat z databáze bez nutnosti psát SQL dotazy. Pokládá efektivní dotazy a nepřenáší zbytečná data.}}