Новшества в очередной версии «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]. Очень будут кстати патчи, исправления и замечания о встреченных при создании книг ошибках!

NOTES

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

All Articles