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

Материал из ALT Linux Wiki
Перейти к: навигация, поиск
(initial page)
 
Строка 3: Строка 3:
 
  git clone git://git.altlinux.org/gears/d/docs-simply-linux.git
 
  git clone git://git.altlinux.org/gears/d/docs-simply-linux.git
  
 +
Для подсветки синтаксиса в Vim можно установить плагин:
 +
apt-get install vim-plugin-asciidoc-syntax
 
==PDF==
 
==PDF==
  apt-get install asciidoc-a2x vim-plugin-asciidoc-syntax
+
  apt-get install asciidoc-a2x
 
 
  
 
Чтобы компилировать в pdf (<code>make pdf</code>) нужны дополнительные пакеты xmlgraphics, я сделал так:
 
Чтобы компилировать в pdf (<code>make pdf</code>) нужны дополнительные пакеты xmlgraphics, я сделал так:

Версия 08:11, 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