Asciidoc: различия между версиями

Материал из ALT Linux Wiki
(→‎PDF: cyrillic troubleshooting)
Строка 23: Строка 23:
Вариант решения этой проблемы ниже.
Вариант решения этой проблемы ниже.
*Установить fonts-ttf-ms
*Установить fonts-ttf-ms
*Подготовить свой файл настроек fop.xconf
*Подготовить свой файл настроек fop.xconf и прописать autodetect
*Прописать в Makefile в опциях a2x <code>--xsltproc-opts=</code> правильное наименование шрифта (например Arial)
*Прописать в Makefile в опциях a2x <code>--xsltproc-opts=</code> правильное наименование шрифта (например Arial)


Строка 30: Строка 30:
Работающие шрифты:  Arial, Times New Roman, Tahoma, Verdana, Trebuchet MS, Comic Sans MS, Courier New, Arial Black, Georgia, Andale Mono, Impact <br>
Работающие шрифты:  Arial, Times New Roman, Tahoma, Verdana, Trebuchet MS, Comic Sans MS, Courier New, Arial Black, Georgia, Andale Mono, Impact <br>
Прописывать в Makefile именно так, т.е. не Times, а именно Times New Roman.
Прописывать в Makefile именно так, т.е. не Times, а именно Times New Roman.
 
:'''NB''' В современных версиях fop генерировать свои метрики шрифтов (arial.xml) не нужно.
:'''NB''' В тексте Введения по Симпли вместо "й" отображается квадрат: - видимо это ошибка в самом тексте (через mcedit её видно, через  Vim - нет).
[[Категория:HOWTO]]
[[Категория:HOWTO]]

Версия от 11:29, 29 октября 2012

QuickStart

В качестве примера можно взять документацию docs-simply-linux:

git clone git://git.altlinux.org/gears/d/docs-simply-linux.git

Для подсветки синтаксиса в Vim можно установить плагин:

apt-get install vim-plugin-asciidoc-syntax

PDF

apt-get install asciidoc-a2x

Чтобы компилировать в pdf (make pdf) нужны дополнительные пакеты xmlgraphics, я сделал так:

apt-get install xmlgraphics*

Для большей информативности процесса можно в Makefile docs-simply-linux добавить опцию verbose

$(A2X) --verbose --fop --fop-opts='-c fop.xconf' -d book -f pdf -a lang=ru \

Комментируем секцию install: all (иначе при make pdf пытается установиться)

Компилируем и собираем лог в makepdf.log

$ make -d pdf 2>&1 | tee makepdf.log

Кириллица

Известны проблемы fop с кириллицей, когда вместо русских букв в pdf отображается текст вида #### ### ###
Связано это с тем, что встроенные в fop шрифты кириллические символы не поддерживают. Решается встраиванием своих шрифтов. Вариант решения этой проблемы ниже.

  • Установить fonts-ttf-ms
  • Подготовить свой файл настроек fop.xconf и прописать autodetect
  • Прописать в Makefile в опциях a2x --xsltproc-opts= правильное наименование шрифта (например Arial)

Посмотреть использованные в сгенерированном pdf фонты в Okular:

Файл - Свойства - Шрифты

Работающие шрифты: Arial, Times New Roman, Tahoma, Verdana, Trebuchet MS, Comic Sans MS, Courier New, Arial Black, Georgia, Andale Mono, Impact
Прописывать в Makefile именно так, т.е. не Times, а именно Times New Roman.

NB В современных версиях fop генерировать свои метрики шрифтов (arial.xml) не нужно.
NB В тексте Введения по Симпли вместо "й" отображается квадрат: - видимо это ошибка в самом тексте (через mcedit её видно, через Vim - нет).