Новшества в очередной версии «WriteAt»
Вышла вторая версия пакета для создания и публикации книг и документации «WriteAt» [1]. В новой версии произошли следующие изменения:
pod6 по-русски
Ключевые СЕМАНТИЧЕСКИЕ блоки можно писать по-русски! Вот как теперь выглядит шапка книги:
=begin ИЗМЕНЕНИЯ
18 июля 2012(v0.1)[i] первая версия
=end ИЗМЕНЕНИЯ
=ЗАГОЛОВОК Моя книга
=ПОДЗАГОЛОВОК Шаблон книги
=ОПИСАНИЕ Шаблон для новой книги с примерами.
=АВТОР Вася Пупкин
=ГЛАВА Приветствую
Это первая глава в моей книге.
Это пока пробный эксперимент. Коды форматирования и стандартные блоки pod6 остаются оригинальными, как описано в спецификации [2]. Возможность описывать заголовок книги по-русски может оказаться полезным.
Шаблоны книг
Для быстрого старта, подготовлены шаблоны книг:
- writeat-tmpl-firstbook
- Команда получения шаблона книги:
git clone https://github.com/zag/writeat-tmpl-firstbook.git
- writeat-tmpl-firstbook-ru
- Команда получения шаблона книги «по-русски»:
git clone https://github.com/zag/writeat-tmpl-firstbook-ru.git
После создания рабочей копии репозитория достаточно выполнить команду make
(или gmake) внутри нее. В результате будет созданы пару вариантов книги в
формате HTML и index.html
файл для публикации.
На данный момент поддерживается операционная система «Ubuntu». В других операционных системах возможны ошибки. Главным образом они могут быть связаны с отсутствием требуемых программ.
Для установки «WriteAt» в «Ubuntu» достаточно выполнить следующие команды:
sudo add-apt-repository ppa:zahatski/ppa
sudo apt-get install writeat
В результате будет установлен сам пакет «WriteAt» и все необходимые программы (если возникнут ошибки - сообщите мне по почте).
Что такое «WriteAt»?
Если вкратце: «WriteAt» - бесплатный и открытый инструмент для создания и публикации книг и документации. Более подробно данный проект описан ранее [3]. На данный момент поддерживается только HTML формат.
Исходные тексты «WriteAt» открыты [4]. Очень будут кстати патчи, исправления и замечания о встреченных при создании книг ошибках!
[1] Библиотека «WriteAt» на CPAN. http://search.cpan.org/dist/WriteAt/
[2] Спецификация на язык разметки pod6. https://raw.github.com/perl6/specs/master/S26-documentation.pod
[3]Доступные книги для читателей и писателей. http://zag.ru/a4JC1
[4] Исходные тексты «WriteAt». https://github.com/zag/writeat