# Описание формата разметки книг

Ниже описан синтаксис и рекомендации, применяемые при форматировании книг.

# Описание разметки

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

# Абзацы

Абзацы разделяются пустой строкой.

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

Сомнение, как следует из вышесказанного, индуцирует гедонизм. Катарсис преобразует дедуктивный метод. Любовь творит непредвиденный дуализм. Представляется логичным, что дедуктивный метод реально понимает под собой закон исключённого третьего, tertium nоn datur. По своим философским взглядам Дезами был материалистом и атеистом, последователем Гельвеция, однако галактика индуцирует дедуктивный метод. Позитивизм методологически принимает во внимание естественный позитивизм.

Ощущение мира индуктивно преобразует мир. Актуализация трансформирует данный гравитационный парадокс. Дедуктивный метод, как принято считать, неоднозначен. Знак раскладывает на элементы конфликт, учитывая опасность, которую представляли собой писания Дюринга для не окрепшего еще немецкого рабочего движения.
1
2
3
4
5

# Заголовки

Заголовки начинаются с символа решётки #. Количество символов определяет уровень заголовка.

# Заголовок первого уровня

## Заголовок второго уровня

### Заголовок третьего уровня

#### Заголовок четвертого уровня

##### Заголовок пятого уровня

###### Заголовок шестого уровня
1
2
3
4
5
6
7
8
9
10
11

Требования:

  • Заголовки книг начинаются со второго уровня. Заглавие книги формируется из поля title метаданных;
  • Заголовки должны идти без пропусков с соблюдением вложенности, за заголовком уровня n должен следовать заголовок уровня n+1;
  • После последнего символа # должен находиться один пробел;
  • Существует только 6 уровней заголовков;
  • Заголовок не должен завершаться символами :,..

# Курсив

Курсив выделяется одиночными звёздочками (*):

Этот текст *написан курсивом*.
1

Этот текст написан курсивом.

# Полужирный

Полужирный шрифт выделяется двойными звёздочками (**):

Этот текст **написан полужирным шрифтом**.
1

Этот текст написан полужирным шрифтом.

# Списки

Между символом маркировки списка и текстом всегда должен быть один пробел.

# Маркированные списки

Маркированные списки оформляются звёздочкой и пробелом в начале строки.

* Апельсины
* Лимоны
* Яблоки
1
2
3
  • Апельсины

  • Лимоны

  • Яблоки

# Нумерованные списки

Нумерованные списки оформляются цифрой, точкой и пробелом в начале строки.

1. Апельсины
1. Лимоны
1. Яблоки
1
2
3
  1. Апельсины
  2. Лимоны
  3. Яблоки

Если абзац начинается с цифры и не является элементом списка, то используйте символ экранирования (\) перед точкой:

1\. это начало абзаца, а не список
1

1. это начало абзаца, а не список

# Вложенные списки

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

* Инструменты
  * Молоток
  * Отвёртка

1. Кружок M3
  1. Усастник 1
  1. Усастник 2
1
2
3
4
5
6
7
  • Инструменты
    • Молоток
    • Отвёртка
  1. Кружок M3
    1. Участник 1
    2. Участник 2

# Цитаты

Цитаты выделяются символом больше (>) и пробелом в начале строки. Пробел всегда должен быть один.

> Люди всегда были и всегда будут глупенькими жертвами обмана и самообмана в политике, пока они не научатся за любыми нравственными, религиозными, политическими, социальными фразами, заявлениями, обещаниями разыскивать интересы тех или иных классов.
1

Люди всегда были и всегда будут глупенькими жертвами обмана и самообмана в политике, пока они не научатся за любыми нравственными, религиозными, политическими, социальными фразами, заявлениями, обещаниями разыскивать интересы тех или иных классов.

Требование pandoc (opens new window): цитата должна быть в начале документа или перед цитатой должна находится пустая строка:

Знаменитая цитата Ленина:

> Люди всегда были и всегда будут глупенькими жертвами обмана и самообмана в политике, пока они не научатся за любыми нравственными, религиозными, политическими, социальными фразами, заявлениями, обещаниями разыскивать интересы тех или иных классов.
1
2
3

Люди всегда были и всегда будут глупенькими жертвами обмана и самообмана в политике, пока они не научатся за любыми нравственными, религиозными, политическими, социальными фразами, заявлениями, обещаниями разыскивать интересы тех или иных классов.

Для деления цитат на абзацы добавляйте пустую строку с символом >:

> Первый абзац
>
> Второй абзац
1
2
3

Если цитата — это стихотворенье, то для того, чтобы строки отображались с межстрочным интервалом (а не межабзацным), используйте придельный перевод строки внутри абзаца. Для этого добавьте в конце строки пробел и слеш:

Стихотворение:

> Ешь ананасы, \
> рябчиков жуй, \
> день твой последний \
> приходит, буржуй.
1
2
3
4
5
6

# Сноски

Для оформления сносок используются квадратные скобки и крышечка (^):

И дальше: «Надо создать в России изучение и преподавание системы Тейлора, систематическое испытание и приспособление ее»[^3]. Конечно, ударение в работе по увеличению продуктивности живого человеческого труда в условиях Советского государства мы должны делать на повышении квалификации труда и улучшении его качества путем применения добытых наукой и практикой приемов работ, экономящих затрату человеческой энергии.

[^3]: В. И. Ленин. Поли. собр. соч., т. 36, с. 180, 190.
1
2
3

Размещайте текст сноски после абзаца к которому она относится.

И дальше: «Надо создать в России изучение и преподавание системы Тейлора, систематическое испытание и приспособление ее»[1]. Конечно, ударение в работе по увеличению продуктивности живого человеческого труда в условиях Советского государства мы должны делать на повышении квалификации труда и улучшении его качества путем применения добытых наукой и практикой приемов работ, экономящих затрату человеческой энергии.

# Многострочные сноски

Иногда текст сноски содержит несколько абзацев. В этом случае второй и последующие абзацы сноски начните с четырёх пробелов.

Эта книга предлагает новую интерпретацию рождения, эволюции и смерти СССР. В значительной степени мы полагаемся на имеющуюся литературу. Однако «излишковая»[^2] теория класса, которую мы находим у Маркса и используем для анализа советской истории, резко отличается от теорий, используемых как ее защитниками, так и ее критиками.

[^2]: В оригинале «the «surplus» theory of class». По всей видимости, в англоязычной литературе помимо категорий «surplus value» (прибавочная стоимость), «surplus product» (прибавочный продукт), «surplus labour» (прибавочный труд) и т. д. имеется понятие «surplus», являющееся *родовым* по отношению к вышеупомянутым понятиям. Как мы видим, в русскоязычной марксистской литературе на сегодняшний день сложилась норма перевода прилагательного «surplus» как «прибавочный (-ая)» и в этом смысле понятие «the „surplus“ theory of class» стоило перевести как «„прибавочная“ теория класса».

    Однако, как читатель увидит далее, эта теория класса, развиваемая Резником и Вольфом, получила свое название из-за того, что она, в отличие от других теорий класса, во главу угла ставит «social organization of the surplus» — общественный способ того, как в том или ином обществе организованы производство и распределение результатов труда, которые остаются за вычетом того, что требуется для простого воспроизводства этого общества. Как мы видим, в данном контексте «surplus» используется как существительное.
1
2
3
4
5

Эта книга предлагает новую интерпретацию рождения, эволюции и смерти СССР. В значительной степени мы полагаемся на имеющуюся литературу. Однако «излишковая»[2] теория класса, которую мы находим у Маркса и используем для анализа советской истории, резко отличается от теорий, используемых как ее защитниками, так и ее критиками.

# Горизонтальная линия

Для задания горизонтальной лини используйте три дефис-минуса (opens new window), отделённые пустыми строками.


---

1
2
3

Пример:


# Формулы

# Способы встраивания

Для встраивания формул используется LaTeX. Возможны два вида встраивания формулы: внутри строки и отдельным блоком.

Для встраивания внутри строки используются символы $:

Квадратное уровнение $x^2 + x + 3 = 2$ демонстрирует зависмость между...
1

Квадратное уравнение x2+x+3=2x^2 + x + 3 = 2 демонстрирует зависимость между...

Для встраивания формул отдельным блокам используйте два символа $$:

$$
\frac{K+p'K}{K_1+p'K_1} = \frac{K(1+p')}{K_1(1+p')} = \frac{K}{K_1}
$$
1
2
3
K+pKK1+pK1=K(1+p)K1(1+p)=KK1 \frac{K+p'K}{K_1+p'K_1} = \frac{K(1+p')}{K_1(1+p')} = \frac{K}{K_1}

# Пробелы

Для добавления пробелов между словами в формулах используйте \medspace:

$$
\frac{стоимость \medspace продукта \medspace А}{стоимость \medspace продукта \medspace Б} = \frac{стоимость \medspace 4 \medspace часов \medspace труда}{стоимость \medspace 2 \medspace часов \medspace труда}
$$
1
2
3
стоимостьпродуктаАстоимостьпродуктаБ=стоимость4часовтрудастоимость2часовтруда \frac{стоимость \medspace продукта \medspace А}{стоимость \medspace продукта \medspace Б} = \frac{стоимость \medspace 4 \medspace часов \medspace труда}{стоимость \medspace 2 \medspace часов \medspace труда}

# Информация по LaTeX

Более детальное описание LaTeX вы можете найти в любой книге, например в этой (opens new window).

# Блок кода

Для добавления блоков кода используйте три символа “```”.

​```
  var a = 23;
​```
1
2
3

# Изображения

Синтаксис добавления изображений:

![Заголовок_изображения](имя_файла_изображения)
1

Пример

![1. Схема товарного обращения по Кенэ](Рубин%20Исаак%20Ильич.%20История%20экономической%20мысли/kene-1.png)
1

Пробелы в названии файлов должны быть заменены на %20.

Описание способа размещения в описании структуры файлов.

# Номера страниц

Для указания номеров страниц используйте следующий синтаксис

[# page_number]
1

Например:

Первый применяется для взвешивания [# 23] особенно ценных товаров, как золото...
1

Страница может разрывать абзац или даже одно слово может начинаться на одной странице и переноситься на следующую. В случае разрыва слова, следует добавить номер страницы внутри него, без дополнительных пробелов:

Первый применяется для взвеши[# 23]вания особенно ценных товаров, как золото...
1

# Что нельзя использовать

# Фигурные скобки

В тексте книги нельзя использовать фигурные скобки

Это явялется важным {текст подчёркнут} дополнением к 
1

# Неописанные элементы разметки

Не нужно использовать элементы разметки, не описанные выше. Их может не поддерживать VuePress или Pandoc.

# Рекомендации

# Выделения

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

Правильно:

**Равенство капиталов** означает **неравенство труда**.
1

Неправильно:

**Равенство** **капиталов** означает **неравенство** **труда**.
1

# Пробелы

За исключением элементов разметки, таких, как таблицы или примечания, не используете несколько пробелов подряд.

# Переводы строк

Отделяйте абзацы, заголовки и другие элементы разметки пустыми строками. Обратите внимание на пустые строки после заголовка и между абзацами:

### О количестве и качестве товаров

Количество всех товаров узнается по весу или по мере. Причина тяжести вещей непонятна, и определение её не является целью нашей работы. Неизвестно, происходит ли она от эластичности воздуха, или от веса высшей сферы (атмосферы? — *И. П.*), или от других причин, — достаточно того, что способы определения веса тел в совершенстве открыты с помощью весов. В общем употреблении имеются два сорта весовых мер: тройский вес и торговый вес (Averdupois).

Первый применяется для взвешивания особенно ценных товаров, как золото, серебро и шёлк и т. д. Второй — для взвешивания более грубых и более объёмистых товаров, как свинец, железо и проч.
1
2
3
4
5

Не оставляйте в тексте больше одной пустой строки подряд.


  1. В. И. Ленин. Поли. собр. соч., т. 36, с. 180, 190. ↩︎

  2. В оригинале «the «surplus» theory of class». По всей видимости, в англоязычной литературе помимо категорий «surplus value» (прибавочная стоимость), «surplus product» (прибавочный продукт), «surplus labour» (прибавочный труд) и т. д. имеется понятие «surplus», являющееся родовым по отношению к вышеупомянутым понятиям. Как мы видим, в русскоязычной марксистской литературе на сегодняшний день сложилась норма перевода прилагательного «surplus» как «прибавочный (-ая)» и в этом смысле понятие «the „surplus“ theory of class» стоило перевести как «„прибавочная“ теория класса».

    Однако, как читатель увидит далее, эта теория класса, развиваемая Резником и Вольфом, получила свое название из-за того, что она, в отличие от других теорий класса, во главу угла ставит «social organization of the surplus» — общественный способ того, как в том или ином обществе организованы производство и распределение результатов труда, которые остаются за вычетом того, что требуется для простого воспроизводства этого общества. Как мы видим, в данном контексте «surplus» используется как существительное. ↩︎