Цитата |
---|
Alex_Gur пишет: Указывать в качестве Topic ID номер раздела, как мне кажется, очень неудобно. Сегодня он - 1.3.1, а завтра, может быть, станет 2.5, а номер 1.3.1 будет иметь другой раздел. Как вам удается решить эту проблему? |
Не разу не становился. 34 и 19 ГОСТ довольно неплохо задают структуру документа (вплоть до 3го уровня). К примеру, в одном из наших шаблонов обычно:
Код |
---|
1 Введение
1.1 Область применения
1.2 Краткое описание возможностей
1.3 Уровень подготовки пользователей
1.4 Перечень эксплуатационной документации
2 Назначение и условия применения
2.1 Виды деятельности, функции
2.1.1 Цели системы
2.1.2 Функции системы
.... сюда добавляем свое
2.2 Программные и аппаратные требования
2.2.1 Требования к оборудованию
2.2.2 Требования к программному обеспечению
.... сюда добавляем свое
3 Подготовка к работе
3.1 Состав дистрибутива
3.2 Установка системы
3.2.1 Установка с использованием установщика
3.2.2 Ручная установка
3.3 Запуск системы
3.4 Проверка работоспособности
4 Описание интерфейса
... здесь вставляем свои топики или подключаем внешний проект, описывающий интерфейс
5 Описание операций
... здесь вставляем свои топики или подключаем внешний проект, описывающий операции
6 Аварийные ситуации. Восстановление базы данных
7 Рекомендации по освоению
|
Согласно этого, никогда ни одна глава не будет менять свой ID (будут лишь появляться новые; стандартный шаблон подключается как репозиторий или просто файлом шаблона проекта). Даже при подключении внешнего сетевого проекта для сборки, H&M автоматически меняет ID топика. Как он называется, Topic3-1-2(2) (H&M автоматически добавляет цифру в скобках при двойном ID) или 3-2-2-2-1 - абсолютно неважно, меня это не интересует, при вставке линка я указываю его лишь раз - ID топика показывается во всплывающей подсказке при наведении на данный топик. Ссылки все равно прекрасно работают. Да, если неудобно - можно и подправить Topic ID, скорее всего, все равно придется задавать в Topic Options значение переменных счетчиков рисунков и таблиц, чтобы по всему сборному проекту было правильно (если это подключаемый проект другого пользователя, а он не удосужился это сделать, хотя можно и заставить подправить его самого - все наши проекты сетевые и в формате Uncompressed XML (а-ля DITA), поэтому можно работать толпой над одним проектами любой сложности.
P.S.: Кто не знаком с форматами проектов H&M, поясню:
- *.hmxZ - стандартный ZIP-архив, содержащий xml-проект H&M;
- *.hmxP - xml-проект H&M - подходит для многопользовательского редактирования;
- *.hmskin - дизайн-проект, содержащий html-тимплейты, переменные, baggage-файлы и прочее как шаблон проекта;
- *.hmxr - проект-содержание, содержащий топики, html-тимплейты, переменные, baggage-файлы и прочее как репозиторий;
- *.hmx, *.hm3 - проекты H&M старых версий.