[Sugester V2](https://pomoc.sugester2.pl.md) / [Syntax](https://pomoc.sugester2.pl/syntax.md)

# [Szablon Syntax - automatyczne sekcje](https://pomoc.sugester2.pl/szablon-syntax-automatyczne-sekcje-Pxafc542.md)

## Szablon Syntax

Szablon `syntax` to jeden z dostępnych szablonów Bazy Wiedzy. Wyróżnia się automatycznymi sekcjami na stronie głównej, które dynamicznie pobierają treści na podstawie nazw kategorii i tagów wpisów.

## Automatyczne sekcje na stronie głównej

### 1. Grid kategorii

Na górze strony głównej wyświetlany jest grid wszystkich kategorii głównych (root) z opisami i liczbą wpisów.

### 2. Najnowsze wpisy

Sekcja wyświetla **4 ostatnio dodane wpisy** (sortowane po `created_at`). Każdy wpis pokazuje:
- Nazwę kategorii (zielony badge)
- Tytuł wpisu
- Abstrakt lub początek treści (max 120 znaków)

### 3. Popularne wpisy

Sekcja wyświetla **4 wpisy z największą liczbą wyświetleń** (sortowane po `view_count`). Format identyczny jak najnowsze, ale z niebieskim badge kategorii.

### 4. Sekcja FAQ (automatyczna)
<img src="https://s3.eu-west-1.amazonaws.com/attachments.intum.net/public-files/31076/922837b37e00df09d8921ea22b2a66539a93d831" alt="faq" style="max-width: 100%;" />

Sekcja FAQ pojawia się **automatycznie**, jeśli istnieje kategoria spełniająca jeden z warunków:

- Nazwa kategorii zawiera słowo `faq`
- URL kategorii zawiera słowo `faq`
- Nazwa kategorii zawiera słowo `często`
- Nazwa kategorii zawiera słowo `pytania`

**Przykładowe nazwy kategorii które uruchomią sekcję FAQ:**
- `FAQ`
- `Często zadawane pytania`
- `Najczęstsze pytania`

Sekcja wyświetla **10 pierwszych wpisów** z tej kategorii w formie akordeon (rozwijane pytania). Po kliknięciu pokazuje się skrócona treść (600 znaków) i link "Czytaj więcej".

### 5. Sekcja Video (automatyczna)

<img src="https://s3.eu-west-1.amazonaws.com/attachments.intum.net/public-files/31076/c18235a457a5f2b0bb74af35ce6eed79c2fff340" alt="video sekcja" style="max-width: 100%;" />

Sekcja z poradnikami wideo pojawia się **automatycznie**, jeśli istnieją wpisy z odpowiednimi tagami.

**Tagi które uruchamiają sekcję video:**
- `video`
- `film`
- `movie`
- `wideo`
- `tutorial`
- `poradnik`

**Wymagania:**
1. Wpis musi mieć jeden z powyższych tagów
2. Wpis powinien zawierać link do YouTube w treści

Jeśli wpis zawiera link YouTube, szablon automatycznie:
- Wyciąga ID filmu z URL
- Pobiera miniaturkę z `img.youtube.com`
- Wyświetla przycisk play
- Po kliknięciu otwiera modal z odtwarzaczem YouTube

**Obsługiwane formaty URL YouTube:**
- `youtube.com/embed/VIDEO_ID`
- `youtube.com/watch?v=VIDEO_ID`
- `youtu.be/VIDEO_ID`

## Jak aktywować sekcje

<table>
<tr><th>Sekcja</th><th>Jak aktywować</th></tr>
<tr><td>Najnowsze</td><td>Automatycznie (wystarczy mieć wpisy)</td></tr>
<tr><td>Popularne</td><td>Automatycznie (wystarczy mieć wpisy z wyświetleniami)</td></tr>
<tr><td>FAQ</td><td>Utwórz kategorię z "faq" lub "pytania" w nazwie/URL</td></tr>
<tr><td>Video</td><td>Dodaj tag <code>video</code>, <code>tutorial</code> lub <code>poradnik</code> do wpisów</td></tr>
</table>
## Spis treści wpisu (On this page)

W widoku pojedynczego wpisu, jeśli treść zawiera nagłówki H2/H3, w prawym sidebarze automatycznie pojawia się spis treści "On this page" z podświetlaniem aktywnej sekcji podczas przewijania.