Skip to main content

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

Тех.Документация

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

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
#!/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

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

1
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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
ASCII world domination is near!
 
     *\o_               _o/*
      /  *             *  \
     <\       *\o/*       />
                )
         o/*   / >    *\o
         <\            />
__o     */\          /\*     o__
* />                        <\ *
  /\*    __o_       _o__     */\
        * /  *     *  \ *
         <\           />
              *\o/*
              __)__

Из M$ Word в Asciidoc

1
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:

1
sudo yum install -y xls2csv.noarch

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

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

Подробнее:

  • -s — задание входной кодировки
  • -d — задание выходной кодировки
  • -с — символ-разделитель значений в выходном файле
  • -q — число, выбирающее режим по кавычкам:
    • 0 — никогда не экранировать кавычками
    • 1 — экранировать кавычками строки, содержащие пробелы
    • 2 — экранировать все строки (по умолчанию)
    • 3 — экранировать все ячейки, независимо от типа
  • -f — выходной формат ячеек, которые содержат дату/время

 

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

Записи по теме: