Основы Grav

Базовое руководство Grav

Grav
Базовое руководство Grav

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

  1. Перейдите в папку ваших страниц user/pages/ и создайте новую папку. В этом примере мы будем использовать явный порядок и назовём папку как 02.mypage.
  2. Запустите ваш текстовый редактор, создайте новый файл, и вставьте туда следующий код:

---
title: My New Page
---
# My New Page!

This is the body of **my new page** and I can easily use _Markdown_ syntax here.
  1. Сохраните этот файл в папке user/pages/02.mypage/ как default.md. Это укажет Grav, что страницу нужно отобразить, используя шаблон default.
  2. Вот и всё! Перегрузите браузер и вы увидите вашу новую страницу в меню.

Страница автоматически покажется в меню после пункта меню "Home". Если вы желаете изменить название, которое отображается в меню, просто добавьте menu: My Page во вступительную часть YAML (между символами ---).

Поздравляем, вы успешно создали новую страницу в Grav.

Если у вас появились проблемы с доступом к новой странице, то возможно у вас отсутствует файл .htaccess (только для веб-сервера Apache) или вам нужно отредактировать директиву RewriteBase в файле .htaccess.