Краткое руководство⚓︎

Предполагая, что вы успешно установили Grav в соответствии с инструкциями, изложенными в предыдущей главе, мы можем продолжить и немного поэкспериментировать с этой CMS, чтобы вы почувствовали себя комфортней.

Поскольку Grav не требует базы данных, с CMS довольно легко работать, не беспокоясь о возникновении проблем между вашей установкой Grav и любым другим важным источником данных. Если что-то пойдет не так, вы можете очень легко восстановиться.

Основы контента⚓︎

Во-первых, давайте познакомимся с тем, где Grav хранит контент. Подробнее об этом мы узнаем в следующей главе, но на данный момент вы должны знать, что весь наш пользовательский контент хранится в папке user/pages/ вашей установки Grav.

По умолчанию сразу после установки в директории user/pages/ есть две папки: первая называется 01.home, а вторая — 02.typography. Числа в названиях папок являются необязательными, но предоставляют несколько полезных вещей.

Во-первых, это позволяет вам четко определить порядок ваших страниц. Например, 01 будет предшествовать 02, но 00 будет предшествовать 01.

Другая вещь, которую делает числовая часть имени папки, это явно сообщает Grav, что эта страница должна быть видна в меню. Важно отметить, что числовая часть вплоть до . будет удалена из URL.

Настройка домашней страницы⚓︎

В файле user/config/system.yaml есть опция, которая задает расположение домашней страницы, на которую указывает Grav, когда вы ссылаетесь на корень вашего сайта: https://yoursite.com.

Если вы изучите этот файл конфигурации, вы увидите, что он уже указывает на псевдоним /home. Мы можем оставить это так в этом примере.

Редактирование страниц⚓︎

Страницы Grav составляются с помощью разметки Markdown. Markdown — синтаксис форматирования простого текста, который компьютер может легко проанализировать и преобразовать в HTML. Он использует основные текстовые символы для обозначения представления (например: жирный, курсив, заголовки, списки и т. д.), облегчая написание без необходимости изучать всю структуру HTML. Преимущества Markdown включают в себя более низкий уровень ошибок, удобочитаемость, простоту изучения и использования и т. д.

На досуге вы можете прочитать подробное описание доступного синтаксиса с примерами, ну а пока следуйте дальше.

Откройте домашнюю страницу в текстовом редакторе. Файл, управляющий домашней страницей, находится в папке user/pages/01.home/ и по умолчанию называется default.md. Всё содержимое, которое вы создадите, будет сохранено в папке user/pages/.

При редактировании страницы в текстовом редакторе содержимое будет выглядеть примерно так:

---
title: Home
body_classes: title-center title-h1h2
---
# Say Hello to Grav!
## installation successful...

Congratulations! You have installed the **Base Grav Package** that provides a **simple page** and the default **Quark** theme to get you started.

> If you see a **404 Error** when you click `Typography` in the menu, please refer to the [troubleshooting guide](/troubleshooting/page-not-found).

Давайте убедимся в том, как легко писать на Markdown. Всё, что в заголовках страницы находится между символами ---, называется YAML. Этот блок конфигурации, который находится в файле .md, обычно известен как YAML-заголовок (секция заголовка страницы).

title: Home
body_classes: title-center title-h1h2

Этот блок задает HTML-тег заголовка страницы (текст, который вы видите на вкладке браузера). Вы также можете получить доступ к этому из ваших тем через атрибут page.title. Есть несколько стандартных заголовков, позволяющих настраивать различные параметры страницы. Другой пример: menu: Название пункта, это позволяет переопределить текст, используемый для отображения имени страницы в меню. По умолчанию Grav будет использовать заголовок в качестве значения пункта меню.

# Say Hello to Grav!
## installation successful...

Символ # или хэш в Markdown обозначает заголовок в тексте страницы. Одиночный символ # с последующим пробелом и текстом преобразуется в элемент <h1> в HTML. ## или двойной хэш будет конвертирован в тег <h2>. Так продолжается вплоть до HTML-тега <h6>, который, конечно же, будет состоять из шести хэшей: ###### Заголовок H6.

Congratulations! You have installed the **Base Grav Package** that provides a **simple page** and the default **Quark** theme to get you started.

Это простой абзац, который был бы завернут в обычные теги <p> при преобразовании в HTML. Маркеры ** обозначают жирный текст или <strong>, ранее <b>, в HTML. Курсивный текст обозначается маркерами _.

> If you see a **404 Error** when you click `Typography` in the menu, please refer to the [troubleshooting guide](/troubleshooting/page-not-found).

Этот обзор должен научить вас основам использования Markdown, но не стесняйтесь заглядывать и в более подробное объяснение при необходимости.

Добавление новой страницы⚓︎

Создать новую страницу в Grav очень просто. Просто следуйте этим простым шагам:

1. Перейдите к папке с вашими страницами: user/pages/ и создайте новую папку. В этом примере мы будем использовать явный порядок по умолчанию и назовем папку 03.mypage.

2. Запустите текстовый редактор, создайте новый файл и вставьте следующий пример кода:

   ---
   title: Моя новая страница
   ---
   

   # Моя новая страница!
   
   Это тело **моей новой страницы**, и я легко могу использовать здесь синтаксис _Markdown_.
   

3. Сохраните этот файл в папке user/pages/03.mypage/ как default.md. Это заставит Grav визуализировать страницу с использованием шаблона default (файл user/themes/quark/templates/default.html.twig в текущем шаблоне).

4. Обновите страницу в браузере, чтобы увидеть новый пункт в верхнем меню.

Страница автоматически отобразится в меню после пункта меню Типография. Если вы хотите изменить имя, которое отображается в меню, добавьте: menu: Моя страница между черточками в заголовке.

Поздравляем, вы успешно создали новую страницу в Grav. С Grav вы можете сделать гораздо больше, поэтому, пожалуйста, продолжайте читать, чтобы узнать о более продвинутых возможностях и всесторонних функциях.