В этом документы мы создадим простой статический сайт с двумя страницами.
Ожидаемое время завершения: 10 минут.
**Содержание**
* [01. Вдохновление](#inspiration)
* [02. Изучите файл `pskov.cfg`](#cfg)
* [03. Изучите файл `item.template`](#item)
* [04. Изучите файлы `about.md` и `cv.md`](#md)
* [05. Запустите ЛФСД](#lfsa)
* [06. Сгенерируйте сайт](#gen)
* [07. Проверьте сайт](#observe)
* [08. Итог](#summary)
## 01. Вдохновление
Представьте, что вы являетесь выдающимся русским живописцем Валентином Серовым. Каждый раз, когда кто-либо хочет узнать о вас, он идёт на [Википедию][serov]. Сегодня утром вы просыпаетесь раньше обычного с отчётливым желанием создать свой собственный веб-сайт.
Вы приступаете к созданию следующих страницы:
* About me
* Curriculum vitae (CV)
Несколько позже в [директории вашего сайта][01-files] у вас оказываются следующие файлы:
* pskov.cfg
* item.template
* about.md
* cv.md
Давайте взглянем на их содержимое.
## 02. Изучите файл `pskov.cfg`
Файл `pskov.cfg` содержит следующее:
```
input = .
item = item.template
```
`pskov.cfg` является [файлом настроек][ini-file] со следующими ключами:
| Ключ | Описание |
|---|---|
| `input` | Указывает на директорию с файлом, на который ссылается ключ `item` |
| `item` | Указывает на файл с шаблоном HTML, который используется для генерации файлов HTML из Markdown |
В нашем случае файл `item.template` расположен рядом с `pskov.cfg`, поэтому мы используем `.` для обозначения текущей директории.
## 03. Изучите файл `item.template`
Файл `item.template` содержит следующее:
```
Serov
```
**Внимание**: стиль схлопнут для краткости.
Как видите, `item.template` представляет из себя обычный файл HTML с двумя константами **ПСКОВА**:
| Константа ПСКОВА | Описание |
|---|---|
| `PSKOV_ITEM_TITLE` | Значение ключа `Title` из файла Markdown страницы |
| `PSKOV_ITEM_CONTENTS` | Предоставляет содержимое HTML, сгенерированное из Markdown |
**Замечания**:
* другие константы **ПСКОВА** описаны позже
* файл Markdown страницы описан ниже
## 04. Изучите файлы `about.md` и `cv.md`
Файл `about.md` содержит следующее:
```
Title: About me
Slug: about
Hi, my name is Valentin Serov. Here's my self-portrait:
![Valentin Serov self-portrait][serov-portrait]
- - - - Схлопнуто для краткости - - - -
Have a look at my [CV][cv] now.
[serov]: https://en.wikipedia.org/wiki/Valentin_Serov
[revolution]: https://en.wikipedia.org/wiki/Russian_Revolution
[serov-portrait]: myself.jpg
[serov-work]: mywork.jpg
[girl-with-peaches]: https://en.wikipedia.org/wiki/Girl_with_Peaches
[pskov]: http://opengamestudio.org/pskov
[cv]: cv.html
```
`about.md` начинается с так называемого заголовка:
| Ключ заголовка | Описание |
|---|---|
| `Title` | Предоставляет значение для константы `PSKOV_ITEM_TITLE` во время генерации HTML из Markdown |
| `Slug` | Сообщает **ПСКОВУ** о том, что этот файл должен быть сохранён как `.html` |
В остальном содержимое `about.md` ничем не отличается от любых других файлов Markdown.
**Внимание**: ссылка на страницу `cv` указана как `cv.html`, не `cv.md`
Файл `cv.md` содержит следующее:
```
Title: Curriculum vitae
Slug: cv
Here's my CV in case my paintings still interest you. I took a bit of a modern IT approach to structure my CV as key-value pairs of a dictionary (map), enjoy!
| Key | Value |
|---|---|
| Name | Valentin Serov |
| Age | 46 |
| Marital status | Married |
| Country | Russian Empire |
| Alma mater | Imperial Academy of Arts |
| Education | * Member Academy of Arts (1898) * Full Member Academy of Arts (1903) |
```
Как видите, в `cv.md` нет ничего нового за исключением таблицы Markdown.
## 05. Запустите ЛФСД
Запустите [ЛФСД][lfsa] с указанием директории, содержащей только что рассмотренные файлы:
```
$ /путь/до/lfsa_1.0.0.py /путь/до/директории/01.TwoPages
```
Вы должны увидеть примерно такой вывод:
```
DIR: '/Users/kornerr/p/site-pskov-sample/01.TwoPages'
PORT: '8000'
```
## 06. Сгенерируйте сайт
Перейдите на страницу [Инструмент][tool] и нажмите кнопку `Генерировать` для генерации файлов HTML рядом с файлами Markdown.
## 07. Проверьте сайт
Проверьте сгенерированный веб-сайт локально: откройте файл `about.html` и совершите переход между страницами.
## 08. Итог
Вы успешно сгенерировали веб-сайт с двумя страницами. [Проверьте результат][01-sample].
Представлены константы **ПСКОВА**:
| Константа ПСКОВА | Описание |
|---|---|
| `PSKOV_ITEM_TITLE` | Значение ключа `Title` из файла Markdown страницы |
| `PSKOV_ITEM_CONTENTS` | Предоставляет содержимое HTML, сгенерированное из Markdown |
Представлены ключи настроек:
| Ключ | Описание |
|---|---|
| `input` | Указывает на директорию с файлом, на который ссылается ключ `item` |
| `item` | Указывает на файл с шаблоном HTML, который используется для генерации файлов HTML из Markdown |
Представлены ключи заголовка:
| Ключ заголовка | Описание |
|---|---|
| `Title` | Предоставляет значение для константы `PSKOV_ITEM_TITLE` во время генерации HTML из Markdown |
| `Slug` | Сообщает **ПСКОВУ** о том, что этот файл должен быть сохранён как `.html` |