txt2tags - Інтернет у хмарі

ПРОГРАМА:

ІМ'Я

txt2tags - інструмент форматування та перетворення тексту

СИНТАКСИС

теги txt2 [опції] [Фото...]

ОПИС

теги txt2 читає текстовий файл із мінімальною розміткою та перетворює його на: ASCII Art, AsciiDoc,
креольський, DocBook, DokuWiki, Google код Wiki, HTML, LaTeX, селюк, MagicPoint, Чоловік сторінка,
MoinMoin, PageMaker, одноколірний текст, PmWiki, SGML, Вікіпедія та XHTML.

Цю довідкову сторінку створив теги txt2 із простого текстового файлу. Той самий текстовий файл також є
перетворено на HTML для онлайн-версії цього посібника.

ОДНЕ джерело, КІЛЬКА цілей - http://txt2tags.org

МАРКУП

Заголовки Перші 3 рядки вихідного файлу
Заголовок = слова =
Пронумерований заголовок + слова +
Коментар % коментарів
Роздільна лінія ----------------------...
Сильна лінія ========================...
Зображення [filename.jpg]
Посилання [label url]

Жирні **слова**
Курсив //слова//
Підкресліть __слова__
Страйк --слова--
Моноширинні ``слова``
Сирі ""слова""
Позначено ''слова''

Слова абзацу
Цитата слова
Список - слова
Нумерований список + слова
Список визначень : слова
Таблиця | комірка1 | клітинка2 | клітинка3...

Дослівний рядок ``` слів
Необроблені слова """.
Рядок із тегами ''' слова

Дослівний блок ```
lines
`` `
Необроблений блок """
lines
"" "
Позначений блок '''
lines
'' '

ВАРІАНТИ

--art-chars=ПАТЕРН
Визначте ПАТЕРН як шаблон символів, які використовуються для створення ASCII Art
прикраси в такому порядку: кут, межа, сторона, смуга1, смуга2, рівень2,
рівень3, рівень4, рівень5. Типовим значенням шаблону є +-|-==-^". Тільки цей параметр
використовується ціллю ASCII Art.

-C, --файл конфігурації=Фото
Прочитайте конфігурацію із зовнішнього файлу Фото. Конфігурація повинна бути на
%!ключове слово:значення формат. Додаткову інформацію див. у розділі НАЛАШТУВАННЯ.

--css-цукор
Покращує згенерований код HTML/XHTML для використання з файлами CSS. Атрибути тегів
видаляються, теги презентації уникаються, заголовок складається з H1, H2 і H3
теги, створюються нові DIV: #заголовок, #тіло, .toc.

--css-всередині
Вставте вміст файлу CSS у заголовки HTML/XHTML. Використовуйте --style, щоб указати CSS
файл для читання.

-Дамп-конфіг
Роздрукуйте всю знайдену конфігурацію та вийдіть.

--dump-source
Надрукуйте джерело документа з розгорнутими включеннями (%!include).

--кодування=КОД
Установіть набір символів (кодування файлу), який використовується у вихідному документі КОД. Приклади
є UTF-8 та iso-8859-1.

--gui
Викликати графічний інтерфейс Tk.

-h, --допомога
Роздрукуйте довідкову інформацію та вийдіть.

-H, --без заголовків
Видалити верхній і нижній колонтитули з вихідних даних. Буде показано лише вміст (тіло).

--заголовки
Показати верхній і нижній колонтитули у вихідних даних. За замовчуванням увімкнено.

--висота=NUM
Встановіть висоту виводу на NUM рядки. Цей параметр використовується лише ASCII Art
target, якщо також використовується --slides.

-i, --infile=Фото
Установка Фото як ім'я вхідного файлу, вихідний документ. Використовуйте «-», щоб прочитати джерела
від STDIN.

--mask-email
Приховайте листи від спам-роботів. Видаляє @ і крапки. Адреса [захищено електронною поштою] звертається до
.

-n, --enum-заголовок
Увімкніть автоматичну нумерацію заголовків. Вони матимуть префікс 1, 1.1, 1.1.1, ...

--no-dump-config
Скасувати дію --dump-config.

--no-dump-source
Скасувати дію --dump-source.

--без кодування
Очистіть налаштування кодування.

--no-enum-title
Вимкніть автоматичну нумерацію заголовків.

--no-infile
Очистити всі попередні оголошення файлів.

--немає цілей
Скасувати дію --targets.

--no-mask-email
Вимкніть функцію маскування електронної пошти.

--не вихідний файл
Очистити попереднє оголошення вихідного файлу.

--ні-тихо
Показувати повідомлення, вимкнувши опцію --quiet.

--no-rc
Не читайте файл конфігурації користувача ~/.txt2tagsrc.

--без слайдів
Вимкніть функцію слайдів.

--без стилю
Очистіть усі налаштування стилю.

--no-toc
Видаліть зміст із результату.

--no-toc-only
Вимкніть дію --toc-only.

-o, --outfile=Фото
Установка Фото як ім'я вихідного файлу. Використовуйте «-», щоб надіслати результати до STDOUT.

-q, --спокійно
Тихий режим. Придушити всі виведення, крім помилок.

--rc
Прочитайте файл конфігурації користувача ~/.txt2tagsrc. За замовчуванням увімкнено.

-- слайди
Відформатуйте вихідні дані як слайди презентації. Цей параметр використовується лише ASCII Art
мета.

-- стиль=Фото
Скористайтеся кнопкою Фото як файл стилю документа. Використовується для визначення файлів CSS для HTML/XHTML
документи та пакети для LaTeX. Цей параметр можна використовувати кілька разів для включення
кілька файлів.

-t, --ціль=TYPE
Установіть формат вихідного документа TYPE. Деякі популярні типи: HTML, xhtml, tex,
людина, TXT. Використовуйте параметр --targets, щоб переглянути всі доступні формати.

--цілі
Роздрукуйте список усіх доступних цілей і вийдіть.

--toc
Додайте автоматичний зміст (TOC) до вихідних даних між заголовком і
тіло. Ви також можете вказати позицію TOC за допомогою макросу %%TOC.

--toc-level=NUM
Встановіть максимальний рівень TOC на NUM. Усі заголовки глибше ніж NUM не буде включено
у змісті.

--toc-only
Роздрукуйте зміст і вийдіть.

-v, -багатослівний
Друк інформативних повідомлень під час конвертації. Цю опцію можна використовувати кілька разів
разів, щоб збільшити кількість показаних повідомлень.

-V, -- версія
Роздрукувати версію програми та вийти.

--ширина=NUM
Встановіть ширину виводу на NUM колонки. Цей параметр використовується лише ASCII Art
мета.

ДЖЕРЕЛО ФАЙЛИ

Вихідні файли зазвичай ідентифікуються за допомогою .t2t розширення (наприклад, myfile.t2t). ви
може мати три області всередині ваших джерел:

Header (За бажанням)
Перші три рядки файлу. Залиште перший рядок порожнім, якщо вам не потрібно
заголовки. Використовується для інформації про назву документа, автора, версію та дату.

Налаштування (За бажанням)
Починається відразу після заголовка (4-й або 2-й рядок) і закінчується, коли починається область основного тексту.
Використовується для параметрів (конфігурацій) у форматі %!keyword:value.

Body Починається з першого дійсного текстового рядка (не коментаря чи налаштування) після області заголовка
і продовжується до кінця документа. Використовується для вмісту документа.

НАЛАШТУВАННЯ

Налаштування дозволяють налаштувати теги txt2, вони схожі на параметри. Їх можна використовувати при:
область налаштувань вихідного документа, ~/.txt2tagsrc файл, зовнішній файл викликається с
--config-файл.

%!ціль
Встановіть вихідний формат так само, як --target. приклад:
%!target: html

%!параметри(ціль)
Встановіть параметри за замовчуванням для кожної цілі. Ви повинні використовувати параметри командного рядка.
приклад:
%!параметри(html): --toc --toc-level 3 --css-sugar

%!includeconf
Включіть конфігурації із зовнішнього файлу в поточний, як
--config-файл. приклад:
%!includeconf: myconfig.t2t

%!стиль
Встановіть файл стилю для документа, подібно до --style. Можна використовувати кілька разів.
приклад:
%!стиль: кольори.css

%!кодування
Встановіть набір символів, який використовується в документі, так само як --encoding. приклад:
%!кодування: UTF-8

%!preproc
Фільтр пошуку/заміни введення, що використовується для зміни основної частини вихідного документа ПЕРЕД
будь-який аналіз за тегами txt2. Пошук використовує регулярні вирази Python. приклад:
%!preproc: "JJS" "Джон Дж. Сміт"

%!postproc
Фільтр пошуку/заміни вихідних даних, який використовується для зміни згенерованого документа ПІСЛЯ всього
обробка тегів txt2. Пошук використовує регулярні вирази Python. приклад:
%!postproc(html): " " " "

Якщо одне й те саме ключове слово з’являється більше одного разу, останнє знайдене буде використаним (крім:
параметри, preproc і postproc, які є сукупними). Недійсні ключові слова ігноруються. The
порядок розбору такий: ~/.txt2tagsrc, область налаштувань вихідного документа, параметр --config-file.

КОМАНДИ

Команди виконують завдання під час перетворення. Їх необхідно поставити біля джерела
тіло документа.

%!csv: файл.csv
Включає зовнішній файл CSV як таблицю.

%!включати: файл.t2t
Включає в документ файл txt2tags.

%!включати: ``файл.txt``
Включає в документ текстовий файл (дослівно).

%!включати: ''file.html''
Включає в документ вже позначений файл.

МАКРОС

Макроси — це зручні ярлики для вставлення динамічного вмісту в документ. Вони повинні бути
розміщується в тілі вихідного документа. Крім %%toc, можна налаштувати всі макроси
спеціальні директиви, такі як %Y і %f. Додаткову інформацію див. у посібнику користувача txt2tags.

%%дата Вставте поточну дату. Типовим форматом є %%date(%Y%m%d), що дає
РРРРММДД.

%%infile
Вставте шлях до вихідного файлу. Типовим форматом є %%infile(%f). Корисно для нижнього колонтитула
посилання на зразок [Див. джерело %%infile].

%%mtime
Вставте час модифікації вихідного файлу. Стандартний формат: %%date(%Y%m%d),
який дає РРРРММДД.

%% вихідний файл
Вставте вихідний шлях до файлу. Типовим форматом є %%outfile(%f). Корисно для себе
згадуючи на зразок "Це файл manpage.man".

%%toc Визначає, де буде розміщено зміст. Ви навіть можете використовувати його кілька разів
разів. Зверніть увагу, що ви також повинні використовувати параметр --toc.

ПРИКЛАДИ

txt2tags -t файл html.t2t

Перетворіть у HTML, зберігши у file.html.

txt2tags -t html -o - файл.t2t

Перетворення в HTML, надсилання результатів на STDOUT.

txt2tags -t html --toc file.t2t

Перетворення на HTML, включаючи автоматичний зміст.

txt2tags -t html --toc --toc-level 2 -n file.t2t

Перетворення на HTML із дворівневим змістом і пронумерованими заголовками.

txt2tags --toc-only file.t2t

Просто покажіть зміст, без перетворення.

txt2tags -t html --css-sugar --style base.css --style ui.css file.t2t

Перетворити в HTML, підготувавши отриманий код для використання з CSS, а також включити
виклики двох зовнішніх файлів CSS.

txt2tags -t art --slides --width 80 --height 25 -o - file.t2t | більше

Створіть слайди презентації ASCII Art, готові до показу в терміналі 80x25
екран/вікно.

(echo ; echo "**жирний**") | txt2tags -t html -H -

Зручний однорядковий файл для швидких тестів за допомогою стандарту STDIN.

txt2tags -t html -o - file.t2t | tidy > file.html

Надішліть результати до STDOUT, а потім попередньо налаштуйте код за допомогою зовнішньої програми
збереження вихідного файлу.

Використовуйте txt2tags онлайн за допомогою сервісів onworks.net