Форум русскоязычного сообщества Ubuntu


Считаете, что Ubuntu недостаточно дружелюбна к новичкам?
Помогите создать новое Руководство для новичков!

Автор Тема: Ищу инструмент для сборки документов. Подскажите - куда копать.  (Прочитано 615 раз)

0 Пользователей и 1 Гость просматривают эту тему.

Оффлайн Sly_tom_cat

  • Автор темы
  • Don't worry, be happy!
  • Заслуженный пользователь
  • Старожил
  • *
  • Сообщений: 12130
  • Xubuntu 22.04
    • Просмотр профиля
    • Github
Вот что есть:

1. Есть Документация на систему - несколько файлов с описанием функционала системы (всего).
2. Есть набор Спецификаций, где предложена конкретная модель взаимодействия с системой и описан только тот функционал, который в рамках этой модели используется (копи-паст глав из Документации).
3. Документация на систему периодически обновляется.

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

Вроде и тривиальная задача, но чет торможу - как сделать, что бы отдать "блондинкам" эти спеки генерить...

Сделал большую рыбу, куда запихал все (все варинты спек и функционал) из него нужно вырезать ненужное... спека собирается за 10 минут, но "блондинкам" "фигурная нарезка" не по силам :(

PS первичная дока - в MSword, выходной файл можно в PDF, а можно также доком.
« Последнее редактирование: 27 Июля 2012, 11:25:03 от Sly_tom_cat »
Индикатор для Yandex-Disk: https://forum.ubuntu.ru/index.php?topic=241992
UEFI-Boot - грузимся без загрузчика: https://help.ubuntu.ru/wiki/uefiboot

Оффлайн avi9526

  • Активист
  • *
  • Сообщений: 618
  • ахтыжъёшкинкот
    • Просмотр профиля
    • Блог av9526
LaTeX. Сори, может не то что надо, я просто почти ничего не понял из коммента, надо подробнее
LaTeX народ не любит (потому что сложно). Но он замечательно подходит для сборки научных и инженерных статей. У него есть подключение файлов, типа include. Или есть еще XeLaTeX, он вроде посовременнее и TTF шрифты в нем просто подключать.
« Последнее редактирование: 28 Июля 2012, 03:17:17 от avi9526 »
Ubuntu 14.10

Оффлайн prokoudine

  • Заслуженный пользователь
  • Активист
  • *
  • Сообщений: 497
    • Просмотр профиля
    • Мультимедиа в Linux
Author-It. Да, проприетарщина. Да, Windows.

Оффлайн Sly_tom_cat

  • Автор темы
  • Don't worry, be happy!
  • Заслуженный пользователь
  • Старожил
  • *
  • Сообщений: 12130
  • Xubuntu 22.04
    • Просмотр профиля
    • Github
Спасибо за подсказки - буду посмотреть...

Пробую подробнее:

Есть пара десятков разных возможных моделей взаимодействия(с учетом использования разных сервисов). Для каждой модели есть некий набор диаграмм поясняющих последовательность взаимодействия с системой. Модели практически не меняются.

Есть большой мануал где ВСЕ сервисы описаны без акцента на модель взаимодействия - просто все в одной куче. Именно в этом документе идут все обновления.

Конечный документ - это заголовок из модели с телом в виде выжимки из мануала (только то что в рамках этой модели используется). В нем в части модели есть референсы на сервисы во второй части. Ну и ко всему этому прицеплен заглавный лист, оглавление и приложение (справочные данные).
Индикатор для Yandex-Disk: https://forum.ubuntu.ru/index.php?topic=241992
UEFI-Boot - грузимся без загрузчика: https://help.ubuntu.ru/wiki/uefiboot

 

Страница сгенерирована за 0.245 секунд. Запросов: 25.