Socrates

Сократ простой статический сайт генератор направлена ​​блогах. Вы пишете свои сообщения в вашем любимом виде обычного текста в HTML языка (например, Markdown, текстиль) и сохранять их в виде текстовых файлов на вашем жестком диске. Сократ затем принимает их, и создает полный HTML-сайт для вас. Для бесплатно, вы получите домашней странице, где перечислены все сообщения, отдельные страницы сообщений, категория страниц, архивные страницы, в о странице и фид Atom.
Использование
Во-первых, вам нужно создать новый блог:
блог Сократа -i
Это создаст каталог блоге с простой структурой блоге:
блог
и NBSP; сообщения
& NBSP; 2010-your-post.md
& NBSP; макет
& NBSP; index.html
& NBSP; single.html
& NBSP; category.html
& NBSP; ...
и NBSP; СМИ
& NBSP; style.css
& NBSP; config.yaml
& NBSP; about.md
Каталог сообщений, где вы будете размещать свои сообщения файлы. Все с префиксом _ или. будут игнорироваться. макет ваша основная тема или шаблон. config.yaml файл конфигурации веб-узле. Не забудьте обновить файл с о соответствующей информации.
Вы также можете создать новый блог в текущем рабочем каталоге:
Сократ -i
Когда вы будете готовы, чтобы генерировать ваш сайт, вы запускаете:
блог Сократа -g
Или,
Сократ -g
для текущего каталога.
Это место все созданные файлы в блоге / развернуть. Вы можете взять эту директорию и загрузить его на сервер.
Установка
Во-первых, настроить виртуальную среду и установить PIP Сократа.
virtualenv ENV --no-сайт-пакеты
Источник ENV / бен / активировать
пункт установить Сократа
Или, чтобы получить последнюю версию кода, вы можете установить с Github.
пункт установить Git -e: //github.com/honza/socrates.git#egg=socrates
Следующим шагом является установка шаблонов. На данный момент, вы можете выбрать между шаблонами Django и шаблонов jinja2. Тема по умолчанию использует Django.
Темы
Сократ поддерживает шаблоны Django и шаблоны jinja2. Вы можете указать, какие шаблоны двигатель вы хотите использовать в файле config.yaml. Есть два основных тем в каталоге темами, чтобы вы начали.
Текст HTML
Сократ attemp конвертировать ваши текстовые файлы в формате HTML с помощью текстового процессора. Вы должны указать имя текстового процессора в config.yaml. Это должно быть все в нижнем регистре. В настоящее время поддерживаются процессоры:
- Уценки
- Текстиль
- ReStructuredText
- HTML (без изменений текст)
По умолчанию, Сократ устанавливает только уценки текстовые процессоры. Вы можете установить другие ПИО:
пункт установить текстиль
пункт установить Docutils
Разработка
Вы можете начать простой сервер разработки, чтобы помочь вам в развитии .:
блог Сократа -r
Или,
Сократ -r
для текущего каталога.
Документация
Документация содержится в каталоге Docs и написано в ReStructuredText использованием Sphinx. Документация легко прочитать в стандартном текстовом редакторе. Тем не менее, вы можете построить HTML версию вот так:
пункт установить сфинкса
CD / документы
сделать HTML
открыт _build / HTML / index.html
Или, вы можете просмотреть онлайн-версию последнего документации

Особенности :.

• Знакомые Django и jinja2 шаблоны
• Простая установка с помощью PIP
• уценки, ReStructuredText, текстиль поддержка
• Конфигурация YAML
• Атом корма
• страницы GitHub совместимы

Требования

• Python