Программа для создания текстовых документов: что это, и какие можно встретить разновидности редакторов?

В нашем обзоре мы решили рассмотреть и оценить программы для работы с текстом на компьютере, функционал которых позволяет открывать и редактировать документы разных форматов, конвертировать, переводить, комфортно читать и выполнять еще массу полезных функций.

image

Эти приложения значительно упрощают работу с текстовыми файлами, актуальны для офисных работников, фрилансеров и просто активных пользователей компьютера. Надеемся, что подборка поможет вам выбрать функциональный и оптимальный продукт.

Рейтинг программ для работы с текстом на компьютере

Программы

Русский язык

Лицензия

Поиск по тексту

Рейтинг

Печать

Lotus Symphony Да Бесплатная Да 10 Да
WPS Office Free Да Бесплатная Да 10 Да
LibreOffice Да Бесплатная Да 10 Да
PDF Commander Да Пробная Да 10 Да
Office 365 Да Бесплатная Да 10 Да
OpenOffice Да Бесплатная Да 10 Да
AbiWord Да Бесплатная Да 10 Да
Notepad++ Да Бесплатная Да 8 Да
Word Viewer Да Бесплатная Да 7 Да
Foxit Reader Да Бесплатная Да 9 Да
ABBYY PDF Transformer Да Бесплатная Да 9 Да

ТОП 10 программ для работы с текстом

image

IBM Lotus Symphony скачать бесплатно

Lotus Symphony – бесплатный пакет офисных приложений для работы с документами, презентациями и таблицами. Является кроссплатформенной разработкой и работает с любыми операционками.

Пакет состои из Symphony Presentations, Spreadsheet и Documents утилиты. Работает с популярными «офисными» форматами.

WPS Office скачать бесплатно

WPS Office Free – бесплатный комплекс офисных приложений для работы с разноформатными презентационными работами, документами и таблицами.

Поддерживает популярные форматы, имеет интегрированный преобразователь PDF-файлов и специальные режимы для защиты зрения и работы в ночной период. Интерфейс на русском языке.

LibreOffice скачать бесплатно

LibreOffice – бесплатная альтернатива офисным приложениям от Microsoft, в которой представлены редакторы таблиц, графики, текста, формул, инструмент для создания СУБД и презентационных работ. Пакет поддерживает популярные офисные форматы и имеет широкую языковую поддержку.

PDF Commander скачать бесплатно

PDF Commander – полезный инструмент для удобного чтения и корректирования пдф-файлов. Позволяет конвертировать в десятки форматов, просматривать содержимое документов, нумеровать страницы, оставлять комментарии и закладки. Меню интуитивно-понятно и имеет удобное управление.

Microsoft Office 365 скачать бесплатно

Microsoft Office 365 – это популярный программный продукт, основу которого составляют веб-сервисы для доступа к приложениям и услугам на базе одноименной платформы.

В состав пакета входят OneNote, Excel, PowerPoint, Outlook, Publisher, Word, Skype и Access, а также 1 ТБ места в OneDrive хранилище.

OpenOffice скачать бесплатно

OpenOffice – бесплатный альтернативный пакет офисных программ для работы с математическими формулами, текстами, таблицами, презентациями и СУБД.

Приложение поддерживает Flash, экспортирует файлы в формат PDF, проверяет правописание и работает с современным форматом Open XML, в котором можно сохранять документы.

AbiWord скачать бесплатно

AbiWord – бесплатное приложение для работы с текстом электронных документов. Работает со всеми стандартными форматами HTML, Word, WordPerfect, OpenOffice.org и др.

Утилита форматирует тексты, работает с таблицами и картинками, проверяет орфографию. Имеет интуитивно понятный многоязычный интерфейс.

Notepad++ скачать бесплатно

Notepad++ — бесплатный софт с функциями для редактирования тестовых файлов, воспроизведения макросов, создания закладок и установки плагинов.

Подсвечивает грамматику популярных языков программирования, единовременно работает с несколькими документами и имеет удобный поиск по тексту.

Microsoft Office Word Viewer скачать бесплатно

Microsoft Office Word Viewer – бесплатное портативное приложения для просмотра файлов, созданных в Microsoft Word.

Открывает, копирует материал и отправляет на печать документы. Поддерживает большинство форматов, имеет самые необходимые функции для работы и отличается простотой использования.

Foxit Reader скачать бесплатно

Foxit Reader – бесплатное приложение для открытия, чтения, создания документов PDF-формата с множеством настроек и полезных функций.

Позволяет постранично просматривать материал, быстро переходить на требуемую страницу, оставлять заметки к тексту и отправлять на печать. Интуитивно понятный русскоязычный интерфейс.

ABBYY PDF Transformer скачать бесплатно

ABBYY PDF Transformer – удобный и компактный софт для открытия и редактирования PDF-документов, а также конвертации файлов в Excel, Microsoft Word, TXT и HTML.

Имеет набор качественных инструментов для пакетной обработки, парольной защиты, оптической идентификации текстов и отправки материала на печать.

Альтернативные программы:

Программы для создания музыки Программы для очистки компьютера от мусора Программы для обработки фотографий Программы для монтажа видео Программы для записи видео с экрана Программы для загрузки фильмов из интернета

На Android можно бесплатно без регистрации и смс скачать текстовые редакторы, позволяющие редактировать текстовые файлы разных форматов (doc, pdf, txt и другие). Скачать нужный редактор можно в каталоге ниже.

Сортировать по: ЛучшиеПопулярныеНовыеНа русском

17.06.2021

Google Таблицы 1.21.224

Google Таблицы — установка этой программы на гаджет позволит работать с таблицами где и когда удобно. С Гугл Таблицами легко и удобно редактировать и просматривать отчетные документы. Простые инструменты, знакомая работа и приятное оформление.

Скачать APK “Google Таблицы 1.21.224”Андроид 6.0 + 17.06.2021

Google Документы 1.21.223

Google Документы – приложение, которое помогает получить доступ к офисным менеджерам удаленно. Выбрав необходимую подпрограмму можно открывать, редактировать, сохранять изменения и менять формат документов.

Скачать APK “Google Документы 1.21.223”Андроид 6.0 + 17.06.2021

Microsoft PowerPoint 16.0.143

Microsoft PowerPoint — офисная программа для редактирования и сохранения слайд-шоу. Позволяет открывать презентации и предоставлять друзьям и коллегам возможность общего просмотра. С приложением удобно работать в пути, когда нужно быстро отредактировать презентацию на ходу.

Скачать APK “Microsoft PowerPoint 16.0.143”Андроид 8.0 + 15.06.2021

Polaris Office 9.0.18

Polaris Office — совокупность офисных приложений в одном для создания и редактирования документов на мобильном устройстве. Сохранение файлов разных форматов обеспечивает наличие свободного пространства от отдельных инструментов офиса в разрозненном виде.

Скачать APK “Polaris Office 9.0.18”Андроид 4.4 + 09.06.2021

OfficeSuite 11.4.359

OfficeSuite — набор офисного инструментария для работы с документами при помощи гаджета. Посредством приложение пользователю доступно редактирование, внесение правок, просмотр и сохранение в ином формате.

Скачать APK “OfficeSuite 11.4.359”Андроид 4.4 + 11.05.2021

Microsoft Excel 16.0.141

Microsoft Excel – крутое офисное приложение, которое позволяет максимально эффективно и быстро работать с таблицами. Создавайте в течение нескольких минут таблицы с огромными массивами данных, редактируйте уже имеющиеся таблицы или работайте совместно с другими пользователями над общими проектами.

Скачать APK “Microsoft Excel 16.0.141”Андроид 8.0 + 11.05.2021

Microsoft Word 16.0.143

Microsoft Word – приложение для осуществления работы с текстовыми документами. Спокойно открывает загруженные рефераты, доклады и другую документацию, обрабатывает и сохраняет вместе с внесенными изменениями.

Скачать APK “Microsoft Word 16.0.143”Андроид 8.0 + 09.04.2021

Camscanner 5.40.0.230

Camscanner –  сканер для перевода фотоснимков с гаджета в настоящие полноформатные документы. Программа помогает быстро и качественно перевести фото с гаджета в офисный формат, полученный документ в дальнейшем может быть отредактирован или отправлен на другое устройство.

Скачать APK “Camscanner 5.40.0.230”Андроид 5.0 + 09.04.2021

WPS Office 13.7.1

WPS Office — приложение с объединением необходимых офисных инструментов по работе с текстовым форматом, презентационным и электронно — табличным вне рабочего офиса.

Скачать APK “WPS Office 13.7.1”Андроид 5.0 + 13.01.2021

Docs To Go 4.004

Docs To Go — полноценный мобильный офис с проводником, который работает не только с документами, но и с папками. Создавайте необходимые документы и таблицы, находясь вдали от персонального компьютера.

Скачать APK “Docs To Go 4.004”Андроид 4.4 + 18.12.2020

SmartOffice 3.11.6

SmartOffice – набор офисных программ, который позволяет открывать, вносить изменения и сохранять электронные документы. В смартофисе можн обрабатывать таблицы, текстовые документы, а также слайд-шоу.

Скачать APK “SmartOffice 3.11.6”Андроид 5.0 + 06.05.2020

Microsoft Office Mobile 16.0.127

Microsoft Office Mobile — передовые программы офиса для просмотра и редактирования документов такие, как Word, Excel, PowerPoint теперь в гаджете. В программе вы можете добавлять комментарии и работать совместно с другими пользователями. В электронные таблицы Excel очень легко добавлять диаграммы и формулы.

Скачать APK “Microsoft Office Mobile 16.0.127”Андроид 6.0 + 14.04.2020

Microsoft Office Lens — PDF Scanner 16.0.12

Microsoft Office Lens – компактный мобильный сканер позволяет заняться оцифровкой с высокой скоростью на Андроид телефоне. Хороший инструмент для студентов и деловых людей, когда нет под рукой более «тяжелой артиллерии»: тяжелого ноутбука, сканера или мощного фотоаппарата. Приложение за считанные секунды преобразует снимки со смартфона в цифровые документы нужного вам формата.

Скачать APK “Microsoft Office Lens — PDF Scanner 16.0.12”Андроид 5.0 + 02.04.2020

Microsoft Teams 1416.1

Microsoft Teams – это приложение, позволяющее объединить команду сотрудников в разработке проекта в Office 365. Программа представляет собой рабочее место для разговоров, собраний, обменов файлами и приложениями. Создано с целью облегчить работу над командными проектами и собрать в одном месте все инструменты.

Скачать APK “Microsoft Teams 1416.1”Андроид 4.4 + 19.02.2020

Scanbot | PDF-сканер 7.5.21.273

Scanbot | PDF-сканер – это программа, которая поможет Вам получить скан чека или документа в отличном качестве всего за пару секунд обработки. Если Вы вынуждены на ходу отправлять важные сканы Вам просто необходима утилита Scanbot. В командировках особенно выручает карманный сканер для быстрого документооборота.

Скачать APK “Scanbot | PDF-сканер 7.5.21.273”Андроид 5.0 +

Надстройка FillDocuments для MS Excel: общие сведения

Предназначение программы: заполнение множества документов данными из Excel нажатием одной кнопки.

Для работы программы требуется таблица Excel с данными для подстановки, и папка с шаблоном (шаблонами) документов. В качестве шаблонов можно использовать файлы Word и Excel.

Особенности программы

  • Количество шаблонов не ограничено. Вы легко можете сами настраивать любые шаблоны.В качестве шаблонов могут выступать файлы Excel (XLS, XLSX и др.), документы Word (DOC, DOCX и др.), а также текстовые документы (расширения TXT, DAT, XML и т.д.).
  • Гибкая настройка имён создаваемых файлов. Можно раскладывать файлы по подпапкам.
  • Подстановка таблиц и картинок (фото, печатей, подписей и т.п.) в заполняемые документы.
  • Склонение фамилий, дата и сумма прописью, — дополнительные функции обработки данных.
  • Рассылка почты (писем с вложениями) через TheBAT! или Outlook. Можно формировать красивые HTML-письма
  • Есть возможность формировать один документ по нескольким строкам исходной таблицы. (вывести список сотрудников в приказ, список товаров в накладную, и т.д.).
  • Можно выбирать шаблоны для заполнения в диалоговом окне (или даже программа будет сама брать нужные шаблоны для разных строк)
  • Подстановка данных в надписи и колонтитулы шаблонов Word.

С момента выхода программы в 2012 году, её функционал постоянно развивался (вышли десятки обновлений), поэтому сейчас в FillDocuments есть всё, что только может вам понадобиться для задачи создания документов по шаблонам.

Более подробно всё это описано в разделе

Нажатием одной кнопки, эта программа вам позволит:

  • заполнить и распечатать договор купли-продажи и акт выполненных работ всего за пару секунд
  • подготовить приказы, уведомления и доверенности по таблице с данными сотрудников
  • разослать персонифицированные коммерческие предложения или приглашения по почте
  • подготовить договоры и акты по шаблонам, и сразу вывести их на печать
  • сделать красивые грамоты по различным шаблонам, и сохранить результат в виде ПДФ файлов
  • распечатать несколько накладных или заявок на товар в формате Excel по одной исходной таблице (прайсу)
  • заполнять командировочные удостоверения, инструкции, соглашения, или любые другие однотипные документы

Версия программы обновлена 09.01.2020г.

Скачать ShablonBB

Для первого использования программы, ознакомьтесь с инструкцией ниже. Инструкция может не содержать описание новых функций.

Вам или Вашим сотрудникам необходимо часто заполнять однотипные документы. Это могут быть договора, приказы, внутренние формы документов. В таких документах в основном содержится одна и та же информация (реквизиты организации, данные о сотруднике, и т.д.). Например, для продажи товара новой организации, Вам надо заполнить три разных документа (Анкета организации, Договор купли-продажи, Акт передачи товара), все эти документы для каждого клиента одинаковые, меняется только данные самого клиента. Так же, во всех трех документах содержится одна и та же информация, но в разных местах документа, и надо копировать и вставлять кусочки нужной информации из одного места в другое. Мы столкнулись с подобной проблемой, посоветовались с партнерами, и оказалось, что для них эта проблема тоже актуальна. Решили разработать программу, которая сможет взять шаблоны документов(обычный документ в формате MS Word, где меняющиеся данные заменены полями для вставки – слово в квадратных скобках – [fio], [nomer dogovora]) и заменить эти поля сразу во всех документах на нужные данные. Так как у нас данные о клиентах повторялись, то что бы не вносить заново эти данные каждый рах, решили, что они все будут храниться в файле в формате MS Excel и для формирования документов, будет просто выбираться нужная строка из этого файла. Это позволило заполнять значительно сократить время на подготовку документов. Во-первых, не надо следить за форматированием текста, текст в вноситься любым шрифтом, любого размера или цвета (что актуально когда копируешь данные или из электронного письма или с сайта компании клиента, где данные имеют разное форматирование) Во-вторых, данные надо скопировать или ввести один раз для всех документов – даже фамилию директора, или название компании клиента, нет необходимости вносить несколько (даже если эти данные встречаются в одном договоре в нескольких местах) В-третьих, информация сохраняется, а значит можно сформировать документы заново в любой момент, или использовать эти данные для дальнейшей обработки – аналитика статистика и т.д. в программе MS Excel или загрузить в другое ПО для обработки. Так же, добавлены настройки для более удобной работы, которые позволят упростить Вашу работу с программой (подробнее в описании новых возможностей)

Установка, настройка и работа с программой

Для работы программы “ШаблонББ2”, необходимо:

FIO DataDog NomDog Tabnom Addres Tel
Иванов Сергей Васильевич 19.01.2015 2507155 1054 Сормовская 47/Б 8-988-885-85-85
Сергеев Леонид Семонович 19.12.2012 25415 568 Ленина 15 8-977-877-87-87
  1. распаковать архив, например, на диск C:
  2. в папке программы есть две папки:
    1. shablon – здесь должны храниться шаблоны документов в формате MS Word (*.doc, *.docx)
    2. docum – здесь будут сохраняться сформированные, заполненные документы. Имена файлов будут соответствовать именам шаблонов документов
  3. сформировать шаблоны Ваших документов. Это делается в программе MS Word. Пример небольшого щаблона, Вы можете посмотреть в папке Shablon. Данные, которые необходимо вставлять в шаблон ограничиваются “квадратными скобками”, например [FIO], и будем называть их “шаблонные поля”.
  4. заполнить файл замен (replace.xls). Там есть тестовые данные для тестового шаблона. Вам необходимо удалить все из этого файла и заполнить сначала первую строку. Она заполняется “шаблонными полями” из файла шаблона. Например в шаблоне есть [FIO] и оно встречается там 6 раз, в таком случае в файл замен(replace.xls) надо добавить колонку FIO (без “квадратных скобок”). После заполнения файла всеми “шаблонными полями”, вы получите файл с заполненной верхней строкой всеми “шаблонными полями”.
  5. внести данные для замены в файл замен. Если Вам могут понадобиться предыдущие данные, то данные для новых документов заполняются в следующей строке. Например мы получим такую таблицу:
  6. Теперь можно запускать программу (ShablonBB.exe)
  7. Окно программы разделено на две части: список шаблонов и данные для замены.
  8. Нажимаем кнопку “Загрузить шаблоны”. Появиться список найденных шаблонов
  9. Нажимаем кнопку “Загрузить данные”. Появляются данные для замены из файла замен.
  10. Выбираем нужные шаблоны (по-умолчанию, выбраны все шаблоны) и нажимаем левой кнопкой на нужной строке из списка данных для замены.
  11. Нажимаем кнопку “Сформировать”
  12. По окончанию работы программы, в папке Docum будут лежать готовые документы.

ВАЖНО! Не забывайте копировать готовые документы из папки docum, так как последующее формирование документов перезапишет текущие (Или используйте новую возможность программы, которая складывает документы в отдельную папку).

В новой версии появились следующие возможности и изменения:

  1. Удалены сообщения которые появлялись при формировании документов (01.09.2020)
  2. Переделан алгоритм формирования имени файла и каталога. (10.12.2019) Теперь каталог формируется всегда. Имя каталога определяется настройкой – по имени шаблона или выбранной колонке. Имя файла формируется по одному из двух алгоритмов – шаблон+выбранная колонка или выбранная колонка +шаблон. Так же дописывается в конец имени файла и каталога – порядковый номер записи
  3. Добавлена проверка на одинаковые поля (08.12.2019) – при формировании файлов проверяется – есть ли двойники в указанной колонке, если двойники есть в таблице замен, то к имени колонки(папки или файла) дописывается номер строки из таблицы замен, ВНИМАНИЕ! ДЛЯ ВСЕХ ФАЙЛОВ/ПАПОК, НЕ ТОЛЬКО С ДВОЙНИКАМИ. Например, если выбрано поле “Фамилия” и в таблице есть две или более одинаковых фамилий, то имя файла или папки сформируется так “12_Иванов..” и “489_Иванов..”
  4. Добавлен порядок формирования имени файла (08.12.2019) – теперь можно в настройках указать как формировать имя файла “ИмяФайлаШаблона-ЗначениеВыбранногоПоля” или “ЗначениеВыбранногоПоля-ИмяФайлаШаблона”
  5. Исправлена ошибка – после сохранения данных Excel файла через программу – нули в начале текста удалялись, так же длинные числа обрезались с конца(03.12.2019)
  6. Изменен внешний вид программы (31.05.2019)
  7. Замена в колонтитулах вынесена в настройку – если выключена – колонтитулы не меняются. Отключение настройки – увеличивает работу программы в несколько раз (31.05.2019)
  8. Добавлена возможность выбора файла замен replace.xls, а так же поддержка файлов .xlsx (31.05.2019)
  9. Добавлена возможность выбора каталога шаблонов на любом диске или по локальной сети (31.05.2019)
  10. Добавлен индикатор выполнения (30.05.2019)
  11. Изменен порядок формирования имени файла (30.05.2019) – теперь имя файла формируется как “ИмяФайлаШаблона-ЗначениеВыбранногоПоля”
  12. Добавлена возможность сохранять готовые документ в PDF формат(29.05.2019г) – на основном окне настройка разовая, для сохранения настройки по-умолчанию необходимо зайти в настройки программы
  13. Изменено формирование имени файла – вместо знака “_” добавляется “-“(29.05.2019г)
  14. Исправлена работа с возможность ВЗЯТЬ ПОЛЯ из колонтитулов(29.05.2019г)
  15. Исправлена работа с колонтитулами (05.12.2018г)
  16. Возможность выбрать папку с шаблонами (05.12.2018г)
  17. Добавлена возможность “взять” из файла шаблона все поля для замены(которые находятся между знаков []. ВКЛЮЧАЯ колонтитулы) (31.10.2018г)
  18. Изменен внешний вид программы (26.10.2018г)
  19. Добавлена возможность “взять” из файла шаблона все поля для замены(которые находятся между знаков []. Кроме колонтитулов – в разработке) (26.10.2018г)
  20. Добавлена возможность сразу добавить в таблицу “взятое” поле для замены (26.10.2018г)
  21. Возможность сформировать выбранные документы сразу по всем данным в таблице (26.10.2018г)
  22. Замена данных в колонтитулах!!! (20.05.2018г)
  23. Немного изменен внешний вид программы
  24. Добавлена возможность поиска данных в таблице для замен. Используется для поиска нужной строки для замены в большом массиве данных
  25. Добавлена возможность формировать имя папки для документов по выбранному столбцу
  26. Изменено отображение шаблонов (ранее отображался полный пусть к файлу шаблона, за счет чего, не всегда было видно имя самого шаблона) на отображение только имен файлов шаблонов.
  27. Возможность выбрать необходимые шаблоны для формирования документов (один или несколько, при помощи клавиш SHIFT и CTRL)
  28. Редактирование данных для замены прямо в окне программы (для этого добавлены кнопки – Добавить строки, добавить столбцы, удалить строки, удалить столбец и сохранить данные) без необходимости редактирования файла replace.xls
  29. Возможность передвигать колонки, менять их между собой местами(для удобства просмотра или заполнения)
  30. Возможность менять ширину колонок мышью (аналогично программе MS Excel)
  31. Возможность сохранять документы в отдельные папки с использованием одной из колонок как шаблон. Например, в списке замен есть колонка с номеров договора, её можно выбрать в списке для формирования папки для документов, и формировать документы по очереди на всех клиентов(поставщиков), в итоге, в папке “DOCUM” (где раньше создавались документы, и необходимо было их копировать, прежде чем сформировать новые) создается папка с номеров договора (например, 210244) и в неё уже сохраняются сформированные документы. Аналогично можно использовать колонку с ФИО (если они не повторяются), названием юр. лица, или ИНН.
  32. Возможность занесения справочных данных (личные поля) – например документы формируют несколько разных менеджеров. В договор необходимо вставлять информацию, в зависимости от менеджера, который формирует документы. В таком случае надо было в файле replace.xls для каждой строчки с клиентов вводить одни и те же данные менеджера, как например, ФИО, должность, отдел, телефон и т.д. Теперь эти данные можно внести один раз в отдельном окне, и они будут использоваться далее для всех клиентов и шаблонов документов
  33. Возможность создания справки по программе. Так как собственная справка у программы отсутствует(краткое описание только на сайте), добавлена возможность сделать собственную справку для программы. Для этого отредактируйте файл help.txt и он будет использоваться в программе

Если для Ваших задач программа не совсем подходит, то Вы можете отправить письмо на адрес site@torg-kkm.ru с Вашими пожеланиями по доработке программы. После рассмотрения, возможно, будет сделана доработка программы.

На определенном этапе развития программной системы неизбежно возникает задача разработки пользовательской документации. И тут возникает технический вопрос выбора форматов и инструментов разработки документации.

1.1. Выходные форматы

С выбором конечного формата обычно проблем не возникает, так как целевая операционная система предъявляет свои требования. Так, например, для программ для Windows — это формат скомпилированной справки CHM, для Linux и BSD систем — это man. Общим для всех систем форматом для онлайн справки является html, а для печати — pdf. Ситуация осложняется в случае, если необходимо иметь документацию в нескольких форматах — для распространения с программой (chm или man), для размещения на сайте (html) и для печати (pdf). При этом возможно, что содержание документации в различных форматах может несколько отличаться. Например, видеофрагменты имеет смысл включать в онлайн документацию, а в печатной версии их нужно заменять на статическое изображение, возможно дополненным qrcode ссылки на видеофрагмент. Кроме того, содержание документов может отличаться и для различных категорий пользователей, версий, комплектов поставки и других факторов.

1.2. Исходные форматы

Несмотря на кажущуюся очевидность необходимости использования специально созданных программ, здесь не все так однозначно. В зависимости от целевой операционной системы подходы отличаются.

1.2.1. Проприетарные исходные форматы

Так, для создания скомпилированной справки для Windows в формате chm Microsoft предлагает использовать специальный бесплатный компилятор HTML Help Workshop. При этом исходные тексты должны быть подготовлены в формате html (редактор в поставку не входит), а файлы оглавления — в специфическом формате. Никаких средств формирования печатных руководств не предоставляется. Разумеется, специализированные программы для создания справки (Robohelp, Help&Manual, HelpScribble и им подобные) предоставляют высокий уровень сервиса, обладают возможностью формирования выходных документов в различных форматах и даже в некоторой степени профилировать содержимое. Однако им присущи следующие недостатки:

  1. Во-первых, все эти системы коммерческие и лицензируются по количеству используемых рабочих мест.
  2. Во-вторых, используемый ими внутренний формат является проприетарным и не поддержимается никаким ПО, кроме продаваемого. Возможность импортировать файлы в проект вам, конечно, будет предоставлена, а вот экспортировать проект в какой либо открытый формат, пригодный для дальнейшей обработки, не удастся. Даже в случае использования в качестве внутреннего формата XML (как, например, Help&Manual) схема его остается закрытой и никак не задокументированной.
  3. В-третьих, возможности по изменению внешнего вида выходного документа являются недостаточными для формирования, например, документации в соответствиями с требованиями ГОСТ.
  4. В-четвертых, с этими программами организовать коллективную работу если и возможно, то крайне затруднительно

1.2.2. Простые форматы разметки Рациональной альтернативой представляется применение простых и, как следствие, быстро осваиваемых форматов разметок. На сегодняшний день таких форматов несколько:

  • ASCIIdoc, используемый дефакто в Linux (BSD) системах;
  • Wiki, применяемый в различного рода энциклопедиях и даже давший им общее название;
  • MarkDown — так сказать, «многоцелевой» формат документирования.

Все эти разметки используют некоторый символьный нетеговый набор правил оформления заголовок, иллюстраций и ссылок, предполагающий редактирование в простых текстовых редакторах. Подготовка же пригодного к просмотру вида осуществляется программно как правило на стороне сервера. Например, Википедия преобразует Wiki-формат в HTML «на лету». Веб-портал системы Git http://github.org также способен показывать документы в разметке Markdown в пригодном для чтения в браузере виде.

1.3. Редакторы

Несмотря на то, что для создания и редактирования исходных текстов достаточно возможностей блокнота, некоторые сервисные функции, такие как проверка правописания и подсветка разметки были бы писателю весьма кстати. В статье http://www.ixbt.com/soft/markdown-online-2.shtml приведен обзор онлайн-редакторов поддержкой markdown-синтаксиса, а в http://www.ixbt.com/soft/markdown-online-3.shtml приведен обзор пяти настольных редакторов, поддерживающих формат markdown по умолчанию, так сказать «из коробки». Одним из таких редакторов является MarkdownPad.

1.3.1. MarkdownPad

imageРисунок 1. Редактор MarkdownPad 2 Как видно из копии экрана, редактор MarkdownPad 2 поддерживает «живой» предварительный просмотр редактируемого файла с поддержкой синхронной прокрутки исходного текста и результата рендеринга. При установке на Windows 8 может возникнуть ситуация, когда предварительный просмотр недоступен.imageРисунок 2. Сообщение о крахе системы предварительного просмотра По заявлению разработчиков http://markdownpad.com/faq.html#livepreview-directx это связано с необходимостью установки специфического SDK веб-рендеринга Awesomium 1.6.6 SDK, который в свою очередь использует DirectX. Редактор поддерживает подсветку синтаксиса, проверку синтаксиса одного языка (в том числе русского), экспорт в форматы HTML, PDF (только в платной версии). Иными словами, MarkdownPad 2, как и другие специальный редакторы, является хорошим выбором для технического писателя. В тех же случаях, когда пользователю предстоит редактировать файлы различного формата, можно адаптировать свой редактор и для редактирования текстов с markdown-разметкой.

1.3.2. Notepad++

Редактором, в достаточной мере отвечающим этим требованиям, можно считать Notepad++. Проверка правописания многих языков поддерживается с помощью специального плагина. Причем поддерживается проверка текста на нескольких языках одновременно.imageРисунок 3. Редактор Notepad++ Несмотря на простоту правил разметки, автору текстов было бы удобней работать с подсветкой синтаксических элементов. Применительно к Notepad++ в этом поможет проект Markdown Syntax Highlighting for Notepad++, который, по сути, представляет собой конфигурационный файл пользовательского языка Markdown. После его установки текст в редакторе выглядит следующим образом.imageРисунок 4. Редактор Notepad++ с подсветкой элементов разметки markdown

1.4. Quota

Примечательно, что редакторы с поддержкой markdown существуют даже для мобильных платформ. На рисунке приведена копия экрана смартфона с запущенным редактором Quoda Code Editor.imageРисунок 5. Quoda Code Editor — универсальный редактор для Андроид с поддержкой разметки markdown Следует сказать, что большая часть этой статьи набрана именно в этом редакторе, а уже потом выгружена на компьютер для доработки. По результатам анализа возможностей языка разметки Markdown и специальных редакторов можно рекомендовать их применение для документирования систем средней сложности.

1.4.1. Открытые теговые форматы

Вместе с тем, для разработки программной документации больших систем следует применять в качестве исходного формата открытый, хорошо документированный формат. В качестве средства формирования — инструмент с широкими возможностями по настройке внешнего вида, профилирования и способностью формировать документы в различных форматах. Этим требованиям в полной мере отвечают такие системы как DITA и Docbook. Несмотря на некоторые различия, обе системы имеют много общего:

  • используют в качестве исходного формата документированный (схематизированный) XML, что обеспечивает возможность использования для редактирования любого XML-редактора с функцией валидации;
  • для конвертирования в один из результирующих форматов может быть использован практически любой xsl-преобразователь xslproc, xalan, saxon и др.;
  • для получения pdf-документа используется промежуточный формат xsl-fo, из которого средствами любого fo-процессора (например, Apache FOP или XEP) уже формируется pdf;
  • для настройки внешнего вида и профилирования используются многочисленные параметры преобразований, а в случае необходимости — добавлением пользовательских xsl-шаблонов.

Следует особо подчеркнуть, что данные системы используют семантическую разметку в исходных документах. Внешний вид же выходного документа определяется правилами и параметрами преобразований. Такой подход позволяет на этапе написания исходных текстов автору не задумываться над типографикой и дизайном, а сосредоточиться исключительно на смысловом содержании. Вместе с тем практический опыт использования, в частности Docbook, подтвержденный и в ряде публикаций, показал, что и при использовании столь продуманной технологии возникают некоторые сложности:

  • создание исходных текстов в формате XML определенной схемы требует от технического писателя навыков работы со специальными редакторами;
  • хорошие XML-редакторы с поддержкой Docbook — продукты коммерческие и недешевые (например, oXygen XML Editor, Altova XMLSpy XML Editor);
  • богатые возможности XML-разметки влекут за собой усложнение формата. Например, для вставки в текст иллюстрации с подписью в разметке Docbook необходимо использовать четыре вложенных тега.

Естественно, что вышеперечисленные недостатки сдерживают широкое применение XML-ориентированных технологий единого источника. В случае использования нетеговых форматов для подготовки офлайн или печатной документации необходимо использовать утилиты преобразования. Среди многих конвертеров особого внимания заслуживает программа pandoc.

1.5. Утилита преобразования pandoc

Pandoc представляет собой кроссплатформенную программу с командным интерфейсом, способную преобразовывать тексты в самых разнообразных разметках в многочисленные выходные форматы. Так, например с использованием pandoc можно конвертировать исходные документы в разметках ASCIIdoc, Wiki, Markdown в HTML. Если установить LaTex, то становится возможным получение и PDF. Так, например, преобразование исходного текста этой статьи в html формат можно выполнить следующей командой:

 pandoc -f markdown pandoc.md  -t html -o pandoc.html -H h.html 

Результатом будет готовый html-файл:imageРисунок 6. HTML-документ, сформированный из Markdown утилитой pandoc За свою универсальность программа образно названа автором «швейцарским армейским ножом». Действительно, pandoc справляется с конвертированием без каких-либо потерь информации. При конвертировании из формата MarkDown поддерживается чтение трех параметров метаданных — заголовка, автора и даты документа. Поддерживается также передача параметров командной строки для установки некоторых специфических свойств, например языка документа. Есть возможность задать свой шаблон выходного документа, до некоторой степени видоизменяя его. Так, например, в приведенном выше примере подразумевается, что в текущей папке есть файл h.html, который играет роль заголовка. Если в этом файле добавить ссылку на стилевой файл и, определив , получим следующий результат:imageРисунок 7. HTML-документ, сформированный pandoc с использованием заголовочного файла со ссылками на стили Как видно из примера, заголовки приобрели свой стиль, а внешние ссылки стали открываться в новой вкладке браузера. Вышеописанные возможности формата делают оправданным использования разметки Markdown для документирования относительно небольших программных систем, к оформлению которых не предъявляется требований ГОСТ, что и доказывается ее широким использованием в системе Git. Что же касается больших систем с обширной и сложной документацией, то для ее создания видится применение системы единого источника Docbook. Могут иметь место и переходные случаи, когда масштаб проект проявляется не сразу.

1.6. Docbook

Сложность создания исходных XML-источников можно преодолеть путем использования исходных текстов в формате Markdown с последующим их конвертированием в Docbook. Такое преобразование поддерживается утилитой pandoc. Так, команда

 pandoc -f markdown pandoc.md  -t docbook -o pandoc4.xml -H h.xml     

создаст результирующий файл. Использование заголовочного файла h.xml (можно просто пустого) необходимо для корректной обработки метатегов и формирования статьи.imageРисунок 8. Сформированная статья в XML-редакторе Следует отметить несколько дополнительных требований к разметки markdown, которая будет использована для преобразования в docbook: Во-первых, следует избегать использования в тексте символов угловых скобок (< и >), так как в XML они используются для выделения тегов, а конвертер оставляет их как есть. Если же угловые скобки нужны по смыслу, то следует использовать сущности <</code> и >. Во-вторых, при вставке рисунка обязательно вводить альтернативный текст, так как pandoc использует его для создания обязательного тега title у тега figure. Однако выходной текст формируется в устаревшем формате Docbook 4 версии, в то время как современная 5 версия предоставляет существенно более богатые возможности по семантической разметке. Для преобразования текста из 4 в 5 версию можно воспользоваться специальным преобразованием db4-upgrade.xsl, входящим в комплект поставки Docbook. xsltproc -o pandoc5.xml db4-upgrade.xsl pandoc4.xml Полученный таким образом xml файл схемы docbook 5 можно использовать при формировании единого источника.Рисунок 9. Cтатья схемы в XML-редакторе в режиме автора Описанная цепочка преобразований может показаться на первый взгляд длинной и неоправданно сложной. Однако освоив один раз необходимые инструменты и разработав для часто выполняемых задач командные файлы (скрипты) можно сэкономить значительное количество времени в дальнейшем. Следует особо подчеркнуть, что технология единого источника обладает ярко выраженным кумулятивным эффектом. Начальные временные затраты на разработку типовых неоднократно используемых фрагментов текста окупаются при их использовании в последующих проектах. Именно это качество делает особо привлекательным технологию единого источника при документировании серийных программных систем. Набор преобразований Docbook поддерживает формирование документов в HTML со стилями, PDF для печати так сказать «из коробки». xsltproc -o pandoc5.fo c:<Путь к DocbookXSL>fodocbook.xsl pandoc5.xml Внешний вид выходных документов может быть до определенной степени настроен с помощью параметров. Полученные файл формата FO-XSL pandoc5.fo является промежуточным и нужен для построения конечного PDF. Немаловажна и возможность автоматического формирования оглавления, списка иллюстраций, листингов, таблиц, индексного указателя, глоссария терминов и списка литературы. При большом количестве документов в составе пакета также возможно создание отдельного списка с возможностью автоматического формирования правильно оформленных ссылок на них. В случае же подготовки типографского макета руководства с учетом особых требований, например ГОСТ, необходимо разработать дополнительные xsl для форматов обычных страниц, титульной и финальной страницы. Это может стать темой следующей статьи.

Оцените статью
Рейтинг автора
5
Материал подготовил
Илья Коршунов
Наш эксперт
Написано статей
134
А как считаете Вы?
Напишите в комментариях, что вы думаете – согласны
ли со статьей или есть что добавить?
Добавить комментарий