Doc Book

[SKART1]

Освоить написание документации с помощью наборов тегов разметки текста DocBook

. Для этого, как минимум, ознакомиться со следующими материалами:

• Общая философия
• Тоже философия, но поконкретнее
• Документация на русском. Рекомендую:
  • "Кратчайший путь к DocBook" Автор: Анатолий Белайчук
  • "Словари DocBook" Автор: Анатолий Белайчук
  • "Классификация тэгов DocBook"
  • "Cловарь HTML-DocBook"
  • "Справочники по тэгам и атрибутам DocBook с примерами"
  • "Параметры DocBook XSL"
  .

P.S. если кому-то станет особо интересна данная есть официальная книга. P.P.S. Для закрепления материала прошу пользоваться разметкой в формате DocBook повсемемстно на github.com

[SKART1]

@Lorygoth присоединяйся!!

[timofeevda]

Не надо издеваться над собой и использовать DocBook на github, не тратьте на это время. Эта разметка была создана не для этого :)

[dm-kiselev]

А LaTeX будем использовать?

[SKART1]

@dm-kiselev нет - это немного из другой оперы. Принципы похожие, но наборы тэгов другие

[dm-kiselev]

XML и DocBook - разные вещи?

[SKART1]

DocBook - набор тэгов. XML-набор правил.

[dm-kiselev]

@321SKART123 , @GimAndMed , @qqq123 , @maroki , @Lorygoth , в папке SRS лежит заготовка для спецификации требований к системе. Пока ещё этот файл не стал слишком сложным, рекомендую изучить, как пример корректного docbook документа. Также мной было описано создание html документа из xml файла. Там написано для Linux, но даже если вы работаете в Windows, вам будет полезно прочитать это, потому что в Windows это делается аналогичным образом.

[lorygoth]

Пока всё понятно. Попытаюсь перейти на днях на linux.

[SKART1]

@Lorygoth на Linux перееходить не надо. Там описан интрументарий и под Винду в т.ч. тот же Geany.

[dm-kiselev]

Ну да, переходить на Linux как бы не обязательно. Но если есть желание, то имеет смысл это сделать. Например, мне в нём удобнее работать. К тому же я только что на него перешёл и сам недавно разбирался с некоторыми распространёнными вопросами, которые при этом возникают. Так что могу объяснить.

[lorygoth]

Вот именно. На Linux всё как родное, в отличии от Windows, да и в случае чего действительно больше хелпа можно найти на просторах интернета.