Предполагая, что вы успешно установили Grav, мы можем продолжить и немного поиграться с Grav, чтобы вы почувствовали себя более комфортно.
Так как для Grav не требуется база данных, с ней очень легко работать, не заботясь о возможных проблемах между вашей установленной Grav и другим большим источником данных. Если что-то пойдёт не так, вы всегда можете восстановиться.
Основы контента
Сначала давайте разберёмся, где Grav хранит контент. Далее в документации мы разберём структуру папок, но на данный момент вы должны знать, что весь наш пользовательский контент храниться в папке user/pages/.
Сейчас у вас только одна папка в папке страницы, и она называется 01.home. Нумерация 01 папок является необязательной, но предоставляет несколько вещей, которые могут быть очень полезны.
Во-первых, она позволяет вам явно определять порядок ваших страниц. Например, 01 будет идти перед 02, а 00 перед 01.
Во-вторых, нумерация папки явно указывает Grav на то, что эта страница должны быть видна в меню. Здесь важно отметить, что эта часть с нумерацией вплоть до . и включая её, будет удалена из URL.
Конфигурация домашней страницы
В файле user/config/system.yaml есть опция, которая устанавливает расположение вашей домашней страницы, другими словами, куда указывает Grav, когда вы заходите в корень сайта http://yoursite.com.
Если вы изучите файл конфигурации вашей установки, то вы увидите, что он уже указывает на алиас /home. Мы пока что оставим это как есть.
Редактирование страницы
Страницы в Grav создаются, используя синтаксис Markdown. Markdown – это синтаксис форматирования, который пишется на чистом тексте, а потом автоматически конвертируется в HTML. Он использует очень простые текстовые символы для обозначения ключевых HTML тегов, что позволяет писать тексты без знания HTML. Существуют и другие преимущества использования Markdown, такие как: меньше ошибок, валидная разметка, очень читабельный, легко изучить, переносимый и т.д.
Откройте домашнюю страницу в вашем текстовом редакторе. Файл, который контролирует домашнюю страницу, расположен в папке user/pages/01.home/ и называется default.md. Весь контент, который вы создаёте, будет создан в папке user/pages/ вашей Grav.
Когда вы будете редактировать страницу в вашем текстовом редакторе, контент будет выглядеть приблизительно так:
---
title: Home
---
# Grav is Running!
## You have installed **Grav** successfully
Congratulations! You have installed the **Base Grav Package** that provides a **simple page** and the default **antimatter** theme to get you started.
>>>>> If you want a more **full-featured** base install, you should check out [**Skeleton** packages available in the downloads](http://getgrav.org/downloads).
### Find out all about Grav
* Learn about **Grav** by checking out our dedicated [Learn Grav](http://learn.getgrav.org) site.
* Download **plugins**, **themes**, as well as other Grav **skeleton** packages from the [Grav Downloads](http://getgrav.org/downloads) page.
* Check out our [Grav Development Blog](http://getgrav.org/blog) to find out the latest goings on in the Grav-verse.
## Create a new page
>>>> TODO: Walk through the process of creating a new page with title + content with simple markdown
Давайте немного разберёмся, и вы увидите, как легко писать на Markdown. Всё, что находится между символами и --- является заголовками страницы, которые написаны в очень простом YAML формате. Этот конфигурационный блок, который находится в .md файле, называется вступительная часть YAML (YAML Front Matter).
title: Home
Этот блок устанавливает HTML тег title страницы (текст, который вы видите во вкладке бразуера). Вы также можете получить к нему доступ в ваших темах через атрибут page.title. Существует несколько разных стандартных заголовков, которые позволяют вам конфигурировать страницу. Другим примером является menu: Something, который позволяет вам переопределять текст, которые используется для отображения названия страницы в меню. По умолчанию Grav будет использовать title для значения меню.
# Grav is Running!
## You have installed **Grav** successfully
Синтаксис # или хеш в makrdown обозначает заголовок. Одиночный # с пробелом и текстом будет сконвертирован в заголовок <h1> в HTML. ## или двойной хеш, будет сконвертирован в тег <h2>. По аналогии мы можем дойти до <h6>, который обозначается как шесть хешей.
Congratulations! You have installed the **Base Grav Package** that provides a **simple page** and the default **antimatter** theme to get you started.
Это простой параграф, который будет обёрнут в обычный тег <p> при конвертации. Маркеры ** означают жирный текст или <b> в HTML. Наклонных текст обозначается маркерами _.
>>>>> If you want a more **full-featured** base install, you should check out [**Skeleton** packages available in the downloads](http://getgrav.org/downloads).
Это специальная возможность, которая предоставляется дефолтной темой Grav. Обычно в markdown символ > означает <blockquote> в HTML. Но мы переопределили этот символ, поэтому с тремя уровнями и выше он предоставляет предупреждения. Например, 5 стрелочек или >>>>> выведут синий блок предупреждения. Внутри синего предупреждения также выведен текст, который обёрнут в квадратные скобки или [ и ] маркеры, за которыми следует URL в круглых скобках ( и ). Это синтаксис markdown для создания ссылки в тексте.
* Learn about **Grav** by checking out our dedicated [Learn Grav](http://learn.getgrav.org) site.
* Download **plugins**, **themes**, as well as other Grav **skeleton** packages from the [Grav Downloads](http://getgrav.org/downloads) page.
* Check out our [Grav Development Blog](http://getgrav.org/blog) to find out the latest goings on in the Grav-verse.
Создания ненумерованных списков в markdown ну очень простое. Просто используйте *, -, или +, и пробел для обозначения текста, который является частью списка. Для нумерованного списка просто используйте номер и промежуток перед текстом.
Убедитесь в том, что сохраняете .md файлы в формате UTF8.
Добавление новой страницы
Создание новой страницы - это плёвое дело в Grav. Просто следуйте этим шагам:
- Перейдите в папку ваших страниц
user/pages/и создайте новую папку. В этом примере мы будем использовать явный порядок и назовём папку как02.mypage. - Запустите ваш текстовый редактор, создайте новый файл, и вставьте туда следующий код:
---
title: My New Page
---
# My New Page!
This is the body of **my new page** and I can easily use _Markdown_ syntax here.
- Сохраните этот файл в папке
user/pages/02.mypage/какdefault.md. Это укажет Grav, что страницу нужно отобразить, используя шаблонdefault. - Вот и всё! Перегрузите браузер и вы увидите вашу новую страницу в меню.
Страница автоматически покажется в меню после пункта меню "Home". Если вы желаете изменить название, которое отображается в меню, просто добавьте menu: My Page во вступительную часть YAML (между символами ---).
Поздравляем, вы успешно создали новую страницу в Grav.
Если у вас появились проблемы с доступом к новой странице, то возможно у вас отсутствует файл .htaccess (только для веб-сервера Apache) или вам нужно отредактировать директиву RewriteBase в файле .htaccess.
