Предполагая, что вы успешно установили 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
.