DocPad

Установка

npm install -g docpad@6.79

Создание проекта

mkdir my-new-website
cd my-new-website
docpad init
docpad run

Структура проекта

• mywebsite
  • out/
  • src/
    • render/ (also documents/, for backwards compatability)
    • static/ (also files/, for backwards compatability)
    • layouts/
  • docpad.coffee
  • package.json

Конфигурация

Плагины

Конфигурация плагинов пишется сюда:

  plugins:
    <название плагина>:
      <настройки...>
      html: true

Конвертация Markdown в HTML

Исходный файл должен иметь разрешение .html.md. Пример: /documents/undex.html.md

Установка плагина markit

docpad install markit

Настройка плагина - поддержка HTML в исходном Markdown-файле

В корневом конфиге в разделе plugins пишем:

  markit:
    html: true

Шаблонизатор Eco

Установка

docpad install eco

Использование

Для конвертации шаблона в html, конвертируемый файл должен иметь разрешение .html.eco.

Пример файла src/layouts/default.html.eco:

<html>
<head>
    <title><%= @document.title %> | My Website</title>
</head>
<body>
    <h1><%= @document.title %></h1>
    <%- @content %>
</body>
</html>