AsciiDoc

AsciiDoc є відкритим вихідним кодом, крос-платформний і безкоштовна утиліта командного рядка здійснюється в Python, як формат текстового документа, який може бути використаний будь-ким, хто хоче писати сторінки керівництва, статті, короткі документи, і книги для їх GNU / операційні системи Linux.

файли, створені за допомогою програмного забезпечення AsciiDoc можуть бути переведені на HTML (Hypertext Markup Language), XHTML (Extensible Hypertext Markup Language) і DocBook вобще, просто за допомогою & lsquo; asciidoc & Rsquo; інструмент командного рядка (див розділ Початок роботи нижче).

Тому що програмне забезпечення не використовує позначення дивні формат або теги розмітки, користувачі зможуть писати AsciiDoc документи так само, як вони будуть писати звичайного текстового документа в текстовий редактор, наприклад,

, щоб встановити і використовувати програмне забезпечення AsciiDoc від вашого дистрибутива GNU / Linux, ви повинні будете завантажити останню версію або з проекту і Rsquo; з сайту або Softoware, зберегти архів на вашому домашньому каталозі, і розпакувати його, використовуючи ваш улюблений архів менеджер корисності.
Відкрийте термінал інструмент емулятор, перейдіть в папку, здобутих архівних файлів (наприклад, CD /home/softoware/asciidoc-8.6.9), запустіть & lsquo; ./ конфігураційний & Amp; & Amp; зробити і Rsquo; Команда налаштувати програму і побудувати виконуваний файл, а потім запустити і lsquo; Судо зробити установку і Rsquo; команду, щоб встановити його.
Після установки, запустіть і lsquo; asciidoc --help & Rsquo; Команда перегляду цієї програми & Rsquo; параметри командного рядка з підказку і доступні, так що ви можете дізнатися, як його використовувати. Для повного ведення команд розмітки, вам варто прочитати керівництво по AsciiDoc користувача.

пишеться в Python, AsciiDoc є крос-платформенний програмне забезпечення, яке працює на будь-якому дистрибутиві GNU / Linux. Слід також працювати на операційних системах X Microsoft Windows і Mac OS, і в даний час підтримується на 32 і 64-бітових комп'ютерних платформах.

Що нового У цьому випуску:

• Доповнення і зміни:
• Реалізована назву поплавка стиль. Плаваючою назва (або плацдарм) виявляється як звичайний розділ, але формально не пов'язані з текстовим тілом, і не є частиною регулярного перетину ієрархії, так що нормальні правила впорядкування не застосовуються.
• Реалізовані рядний коментар макро, так лінії коментаря в даний час можуть з'явитися всередині блочних елементів.
• Рядки коментарів відправляються на вихід, якщо showcomments атрибут визначений (коментар блоки ніколи не надсилаються до виходу).
• одиночна посиланням значення атрибутів в AttributeList елементів призводить до їх бути замінений як нормальну інлайн тексту (без одного посиланням на атрибут тільки заміна виконується).
• Переписаний обробка елемент списку (дуже crufty). Список продовження і список блоків тепер працює, як очікувалося. Оновлено та уточнити список документація в керівництві користувача.
• атрибут перегляд тепер розпізнає формат RCS $ Id $ маркера.
• RCS $ Id $ маркер відформатований лінія перегляд у заголовку не потрібно передувати автора лінії.
• Якщо RCS $ Id $ відформатований перегляд вказано і ім'я автора вже не було встановлено, то ім'я автора в $ Id $ маркера буде використовуватися.
• Оновлене Graphviz фільтр Gouichi Iisaka до версії 1.1.3.
• Додана Автошіріна варіант Таблиця атрибутів для (X) HTML виходів.
• DocBook базова тепер ставить імя_організаціі необов'язковий атрибут в DocBook заголовку.
• Застарілі без документів CompanyName атрибут на користь corpname Docbook в.
• Вилучено явне закриття зворотна коса риска від HTML4 самозакривних тегів дотримуватися WC3 рекомендації.
• виправлення:
• Виправлена ​​8.3.3 регресії при якому сусідні листи з таким же синтаксисом, але різними стилями список були неправильно розглядати як єдиний список.

Що нового у версії 8.3.3:

• виправлення:
• зламана і заплутаною нумерація і numeration2 пронумеровані списку атрибутів були зняті, використовуйте атрибут стилю замість цього.

Що нового у версії 8.3.2:

• Доповнення і зміни:
• Додана Gouichi Iisaka в Graphviz фільтр розподілу.
• елемент SidebarBlock тепер можуть відображатися з абстрактному стилі.
• Реорганізація фільтри в окрему піддиректорію для кожного фільтра.
• Оновлене Makefile.in і проявити файли, щоб відобразити нову організацію фільтри.
• Додана перелік стиль LiteralBlock елемента, так оголошень з вкладеними лістингу блоків може бути надана у вигляді лістингу блоку.
• Змінено приклад коду фільтр використовувати кращий синтаксис ListingBlock (синтаксис фільтра старий ~ разделителями більше не використовується).
• Реалізовані перелік і enumeration2 пронумерований список атрибутів для зазначення нумерації списку стиль (арабська, loweralpha, upperalpha, lowerroman і upperroman).
• AsciiDoc тепер розпізнає upperalpha, lowerroman і upperroman номера в listdef-numbered2 нумерованих списків і встановлює номер стилю, заснованого на стилі першого елемента нумерованого списку (альтернатива установці enumeration2 атрибут).
• Оновлене formatlistpat визначення в .vimrc наприклад, в керівництві користувача.
• Тепер Ви можете коса риса Escape System блок макроси.
• Додана Pychart FAQ.
• Падіння пункт текст і список текстових, індекси та етикетка матч групи з атрибутів - вони включені в текст елемента, і ми не хочемо, щоб вони обробляються вдруге як атрибути
.
• Змінено рядок коментаря блок макрос прохідне блоку макро щоб переконатися у відсутності заміни.

не «LI> subslist більше не повинен бути доданий до визначення макросу PassthroughBlock, якщо не виконуються опущені немає замін.
• Код прибирати: замінити застарілі оператору =
!.
• Вилучено використовувався LinuxDoc код.
• Код акуратні вікна: впав старих моделях посилання на модуль; замінити has_key () з переважним оператора.
• виправлення:
• Старий синтаксис джерело фільтра виділення регресії :. Спеціальні символи, де не вдалося уникнути в DocBook виходів

Що нового у версії 8.3.1:

• Доповнення і зміни:
• Замінено install.sh скрипт з оновленою сценаріїв AUTOCONF Бен Уолтона - див. [1] встановити для деталей
• Додана синтаксис узагальнений AttributeEntry, щоб довільні записи файлу конфігурації, який буде встановлено зсередини AsciiDoc документа (за пропозицією Хенрік Майер).
• У лістингу разделителями блоків в DocBook виходів тепер підтримують ідентифікатори; Ідентифікатори під назвою лістингу та літерних розділених блоків були перенесені з вкладеннями в форматі DocBook наприклад, тег (завдяки Віджай Кумар для цього патча).
• Замінено вертикалі друкарська машинка апостроф з пунктуацією апостроф (завдяки Ною Слейтер).
• виправлення:
• регресії :. Без урахування подвійні лапки з ув'язнених в лапки значень атрибутів в результаті зворотного несумісності, подвійні лапки під позабіржові значень атрибутів був відновлений
• регресії: Текст як і підсилювач; ...; іноді помилково приймають за посилання на об'єкт -. посилили особа посилання відповідність

Вимоги

• Python