Nette Documentation Preview

syntax
Вікі-синтаксис
**************

Вікі використовує [синтаксис |https://texy.info/en/syntax] Markdown & [Texy |https://texy.info/en/syntax] з деякими покращеннями.


Посилання .[#toc-links]
=======================

Для внутрішніх посилань використовується позначення у квадратних дужках `[link]` використовується позначення у квадратних дужках. Це або у формі з вертикальною рискою `[link text |link target]`або у скороченому вигляді `[link text]` якщо ціль збігається з текстом (після перетворення на малі літери та дефіси):

- `[Page name]` -> `<a href="/en/page-name">Page name</a>`
- `[link text |Page name]` -> `<a href="/en/page-name">link text</a>`

Ми можемо посилатися на іншу мову або інший розділ. Розділ - це бібліотека Nette (наприклад, `forms`, `latte` тощо) або спеціальні розділи, такі як `best-practices`, `quickstart` тощо:

- `[cs:Page name]` -> `<a href="/en/page-name">Page name</a>` (той самий розділ, іншою мовою)
- `[tracy:Page name]` -> `<a href="//tracy.nette.org/en/page-name">Page name</a>` (інший розділ, та сама мова)
- `[tracy:cs:Page name]` -> `<a href="//tracy.nette.org/en/page-name">Page name</a>` (інший розділ, інша мова)

Також можна націлити таргетинг на певний заголовок на сторінці за допомогою `#`.

- `[#Heading]` -> `<a href="#toc-heading">Heading</a>` (заголовок на поточній сторінці)
- `[Page name#Heading]` -> `<a href="/en/page-name#toc-heading">Page name</a>`

Посилання на домашню сторінку розділу: (`@home` - спеціальний термін для позначення домашньої сторінки розділу)

- `[link text |@home]` -> `<a href="/en/">link text</a>`
- `[link text |tracy:]` -> `<a href="//tracy.nette.org/en/">link text</a>`


Посилання на документацію API .[#toc-links-to-api-documentation]
----------------------------------------------------------------

Завжди використовуйте наступні позначення:

- `[api:Nette\SmartObject]` -> [api:Nette\SmartObject]
- `[api:Nette\Forms\Form::setTranslator()]` -> [api:Nette\Forms\Form::setTranslator()]
- `[api:Nette\Forms\Form::$onSubmit]` -> [api:Nette\Forms\Form::$onSubmit]
- `[api:Nette\Forms\Form::Required]` -> [api:Nette\Forms\Form::Required]

Повні назви використовуйте лише у першій згадці. Для інших посилань використовуйте спрощену назву:

- `[Form::setTranslator() |api:Nette\Forms\Form::setTranslator()]` -> [Form::setTranslator() |api:Nette\Forms\Form::setTranslator()]


Посилання на документацію по PHP .[#toc-links-to-php-documentation]
-------------------------------------------------------------------

- `[php:substr]` -> [php:substr]


Вихідний код .[#toc-source-code]
================================

Блок коду починається з <code>&#96;&#96;&#96;lang</code> і закінчується <code>&#96;&#96;&#96;</code>. Підтримувані мови: `php`, `latte`, `neon`, `html`, `css`, `js` і `sql`. Завжди використовуйте табуляцію для відступів.

```
 ```php
	public function renderPage($id)
	{
	}
 ```
```

Ви також можете вказати ім'я файлу як <code>&#96;&#96;&#96;php .{file: ArrayTest.php}</code> і блок коду буде відображено саме так:

```php .{file: ArrayTest.php}
public function renderPage($id)
{
}
```


Заголовки .[#toc-headings]
==========================

Верхній заголовок (назва сторінки) підкреслити зірочками (`*`). For normal headings use equal signs (`=`) and then hyphens (`-`).

```
MVC Applications & Presenters
*****************************
...


Link Creation
=============
...


Links in Templates
------------------
...
```


Поля та стилі .[#toc-boxes-and-styles]
======================================

Головний абзац, позначений класом `.[perex]` .[perex]

Примітки, позначені класом `.[note]` .[note]

Порада, позначена класом `.[tip]` .[tip]

Попередження, позначене класом `.[caution]` .[caution]

Сильне попередження, позначене класом `.[warning]` .[warning]

Номер версії `.{data-version:2.4.10}` .{data-version:2.4.10}

Класи слід писати перед відповідним рядком:

```
.[note]
This is a note.
```

Зверніть увагу, що такі поля, як `.[tip]` привертають увагу і тому повинні використовуватися для підкреслення, а не для менш важливої інформації.


Зміст .[#toc-table-of-contents]
===============================

Зміст (посилання в бічній панелі) автоматично генерується, коли сторінка довша за 4 000 байт. Цю поведінку за замовчуванням можна змінити за допомогою мета-тега `{{toc}}` [мета-тегом |#meta-tags]. Текст для TOC за замовчуванням береться з заголовка, але можна використовувати інший текст за допомогою модифікатора `.{toc}` модифікатором. Це особливо корисно для довгих заголовків.

```


Long and Intelligent Heading .{toc: A Different Text for TOC}
=============================================================
```


Мета-теги .[#toc-meta-tags]
===========================

- встановлення власного заголовка сторінки (в `<title>` та хлібними крихтами) `{{title: Another name}}`
- перенаправлення `{{redirect: pla:cs}}` - див. [посилання |#links]
- примусове виконання `{{toc}}` або відключення `{{toc: no}}` зміст

{{priority: -1}}

Вікі-синтаксис

Вікі використовує синтаксис Markdown & Texy з деякими покращеннями.

Для внутрішніх посилань використовується позначення у квадратних дужках [link] використовується позначення у квадратних дужках. Це або у формі з вертикальною рискою [link text |link target]або у скороченому вигляді [link text] якщо ціль збігається з текстом (після перетворення на малі літери та дефіси):

  • [Page name]<a href="/en/page-name">Page name</a>
  • [link text |Page name]<a href="/en/page-name">link text</a>

Ми можемо посилатися на іншу мову або інший розділ. Розділ – це бібліотека Nette (наприклад, forms, latte тощо) або спеціальні розділи, такі як best-practices, quickstart тощо:

  • [cs:Page name]<a href="/en/page-name">Page name</a> (той самий розділ, іншою мовою)
  • [tracy:Page name]<a href="//tracy.nette.org/en/page-name">Page name</a> (інший розділ, та сама мова)
  • [tracy:cs:Page name]<a href="//tracy.nette.org/en/page-name">Page name</a> (інший розділ, інша мова)

Також можна націлити таргетинг на певний заголовок на сторінці за допомогою #.

  • [#Heading]<a href="#toc-heading">Heading</a> (заголовок на поточній сторінці)
  • [Page name#Heading]<a href="/en/page-name#toc-heading">Page name</a>

Посилання на домашню сторінку розділу: (@home – спеціальний термін для позначення домашньої сторінки розділу)

  • [link text |@home]<a href="/en/">link text</a>
  • [link text |tracy:]<a href="//tracy.nette.org/en/">link text</a>

Завжди використовуйте наступні позначення:

Повні назви використовуйте лише у першій згадці. Для інших посилань використовуйте спрощену назву:

Вихідний код

Блок коду починається з ```lang і закінчується ```. Підтримувані мови: php, latte, neon, html, css, js і sql. Завжди використовуйте табуляцію для відступів.

 ```php
	public function renderPage($id)
	{
	}
 ```

Ви також можете вказати ім'я файлу як ```php .{file: ArrayTest.php} і блок коду буде відображено саме так:

public function renderPage($id)
{
}

Заголовки

Верхній заголовок (назва сторінки) підкреслити зірочками (*). For normal headings use equal signs (=) and then hyphens (-).

MVC Applications & Presenters
*****************************
...


Link Creation
=============
...


Links in Templates
------------------
...

Поля та стилі

Головний абзац, позначений класом .[perex]

Примітки, позначені класом .[note]

Порада, позначена класом .[tip]

Попередження, позначене класом .[caution]

Сильне попередження, позначене класом .[warning]

Номер версії .{data-version:2.4.10}

Класи слід писати перед відповідним рядком:

.[note]
This is a note.

Зверніть увагу, що такі поля, як .[tip] привертають увагу і тому повинні використовуватися для підкреслення, а не для менш важливої інформації.

Зміст

Зміст (посилання в бічній панелі) автоматично генерується, коли сторінка довша за 4 000 байт. Цю поведінку за замовчуванням можна змінити за допомогою мета-тега {{toc}} мета-тегом. Текст для TOC за замовчуванням береться з заголовка, але можна використовувати інший текст за допомогою модифікатора .{toc} модифікатором. Це особливо корисно для довгих заголовків.



Long and Intelligent Heading .{toc: A Different Text for TOC}
=============================================================

Мета-теги

  • встановлення власного заголовка сторінки (в <title> та хлібними крихтами) {{title: Another name}}
  • перенаправлення {{redirect: pla:cs}} – див. посилання
  • примусове виконання {{toc}} або відключення {{toc: no}} зміст