Надо привести документацию к единому стандарту. Знаю, что поможет в этом DocBook. Но как все это настроить и использовать? Как именно это работает? Обо всем этом у меня размытое представление. Помогите разобраться!
LinuxForum.Fans
DocBook. Что это и как этим пользоваться?
Автор: Firebolt
9 сообщений
3803 просмотров
Надо привести документацию к единому стандарту. Знаю, что поможет в этом DocBook. Но как все это настроить и использовать? Как именно это работает? Обо всем этом у меня размытое представление. Помогите разобраться!
это очень просто - вы пишете документацию в формате XML, это обычный текст, но с тегами, как на форуме BBCode, потом компилируете, и получается HTML.
читать здесь: http://docbook.ru/
читать здесь: http://docbook.ru/ [quote=Анатолий Белайчук]"Оборотная сторона богатых возможностей DocBook— сложность в первоначальном освоении, выборе и настройке инструментария."
[/quote]
И вправду сложность в освоении и выборе инструментария.
И вправду сложность в освоении и выборе инструментария.
та ладно! я юзаю kate & vim (как настроение).
та ладно! я юзаю kate & vim (как настроение).
Мое первое представление о DocBook таково: создаешь сервер DocBook, настраиваешь. Заходишь через браузер на сервер DocBook, создаешь новый документ, в него пишешь текст, применяешь форматирование и вот он готов, все Ок. Другой кто-то так же заходит на сервер по вэбу, открывает твой документ, читает, ему хочется распечатать, он конвертирует в pdf и печатает.
Что в моем представлении и понимании неверно? - Вот что мне хотелось узнать.
drBatty дал Вам ссылку: http://docbook.ru/
Вы туда переходили? Прочитали что-нибудь? Там все написано
drBatty дал Вам ссылку: http://docbook.ru/
Вы туда переходили? Прочитали что-нибудь? Там все написано
Я пока прочел только одну документашку из раздела документации (вода водой) и прочитал все остальное на сайте. Ничего там не написано, что помогло бы мне получить ясное представление о том, как это работает.
http://docbook.ru/doc/sw/
здесь точно все расписано... если и это не поможет, тогда прям не знаю
Мое первое представление о DocBook таково: создаешь сервер DocBook, настраиваешь. Заходишь через браузер на сервер DocBook, создаешь новый документ, в него пишешь текст, применяешь форматирование и вот он готов, все Ок. Другой кто-то так же заходит на сервер по вэбу, открывает твой документ, читает, ему хочется распечатать, он конвертирует в pdf и печатает.
Что в моем представлении и понимании неверно? - Вот что мне хотелось узнать
я просто открываю vim, и там пишу. получается такая фигня (после компиляции)
Войдите или зарегистрируйтесь, чтобы ответить.
