Журнал Эмбеддед-Инженера

asciidoc: полезные дополнения

Парсер ASCII-art рисунков с сохранением в SVG

Скрипт установки asciitosvg-install.sh:

#!/bin/bash
sudo yum install mercurial git gcc php

git clone https://github.com/dhobsd/asciitosvg.git
hg  clone https://bitbucket.org/wez/jlexphp
hg  clone https://bitbucket.org/wez/lemon-php

cd jlexphp
javac -Xlint JLexPHP/Main.java
jar cvf JLexPHP.jar JLexPHP/*.class
cd ..

cd lemon-php
cc -o lemon lemon.c
cd ..

cd asciitosvg
make

Использование:

a2s -i<исходник.ascii> -o<вых.картинка.svg> [-sx-scale,y-scale]

где -s масштаб сетки в пикселях. Хорошо дополняет этот конвертер онлайн-рисовалка ASCIIART’a http://asciiflow.com

Еще http://search.cpan.org/dist/App-Asciio/lib/App/Asciio.pm — This application allows you to draw ASCII diagrams in a modern (but simple) graphical interface

ASCII world domination is near!

     *\o_               _o/*
      /  *             *  \
     <\       *\o/*       />
                )
         o/*   / >    *\o
         <\            />
 __o     */\          /\*     o__
 * />                        <\ *
  /\*    __o_       _o__     */\
        * /  *     *  \ *
         <\           />
              *\o/*
              __)__

Из M$ Word в Asciidoc

pandoc --atx-headers <имя_файла>.docx -f docx -t asciidoc -s -o <имя_файла>.adoc

Поддерживается только .docx Выходным форматом будет legacy-разметка asciidoc (потенциально проблемы с asciidoctor) Полученные файлы скорее всего придётся подчищать от лишнего (оставшегося от .docx)

 

Из M$ Excel в Asciidoc

Как известно, asciidoc поддерживает как входной формат таблиц файлы CSV (Comma Separated Value), а значит, мы можем еще больше автоматизировать процесс сборки технической документации, истользуя для конвертации утилиту командной строки xls2csv. Итак, устанавливаем в CentOS:

sudo yum install -y xls2csv.noarch

Пример использования:

xls2csv -s cp1251 -d utf-8 -c ":" -q 0 -f  %d.%m.%Y <file>.xls > <file>.csv

Подробнее:

 

PS: если заметка помогла Вам, поделитесь ей с друзьями или коллегами: