Есть отличный официальный стандарт OASIS для написания технической документации с наименованием DocBook (http://docbook.org/). Сейчас в ходу 5 версия. Из xml DocBook с использованием xsl можно получить xhtml одной страницей, xhtml по главам, PDF (+Apache FOP), ePub, WinHelp. Все ради того, чтобы сырцы технической документации были в одном месте, подвергались номальному версионному контролю, а из них генерировали ту форму документации, которая требуется. Обычно требуется только 3 вещи: (x)html одной страницей, (x)html по главам и книжка PDF.
Наиболе адекватный визуальный toolchain для работы с DocBook, на мой взгляд, предлагает http://www.oxygenxml.com/. В коробке все что нужно для работы, включая Apache FOP.
Если вы будете создавать документы на кириллице, то с xhtml проблем не возникнет. А при генерации PDF с xsl из коробки вместо кириллицы получите решетки - символы хеша (#). Вот наименования фонтов, с которыми PDF у меня выглядел нормально:
Arial
Arial Unicode MS
Courier New
Чтобы все заработало присвойте значению body.font.family и title.font.family наименование нужного фонта.
Вообще проблемы с русским возникают из-за Apache FOP. Вот здесь хорошие советы по решению вопроса http://www.sql.ru/forum/actualthread.aspx?bid=38&tid=491835&pg=1
Еще ссылки по теме:
http://forum.vingrad.ru/forum/topic-294568.html
http://www.sagehill.net/docbookxsl/AddFont.html
http://www.oxygenxml.com/doc/ug-oxygen/tasks/add-font-to-builtin-FOP-simplified.html
Подписаться на:
Комментарии к сообщению (Atom)
Мой список блогов
-
-
Notes on LLMapгод назад
-
Строительноегод назад
-
Будем честными ...год назад
-
Highscalability is Up For Sale2 года назад
-
-
-
-
-
Go Composition vs Inheritance6 лет назад
-
Welcome, Prashanth!6 лет назад
-
Top Developer Collaboration Tools6 лет назад
-
Транспортный микс7 лет назад
-
-
Исповедь скрам тестера7 лет назад
-
-
Running JRuby on the Graal JIT7 лет назад
-
-
-
Скрепкус гигантус8 лет назад
-
Мои твиты8 лет назад
-
-
-
6990 рублей9 лет назад
-
-
Смирение и американские боеголовки9 лет назад
-
-
-
-
-
-
Measuring Activity Startup Time10 лет назад
-
-
-
-
-
Рассказ жителя Мариуполя из первых рук12 лет назад
-
-
Grails - Convention over Configuration12 лет назад
-
$ (dollar) prefix for angularJS12 лет назад
-
-
-
-
Блог закрыт!12 лет назад
-
-
Websphere portal. Create pages programmatically13 лет назад
-
-
-
Tweetbot для Mac13 лет назад
-
Scala-IO Core: Unmanaged Resources13 лет назад
-
Использование шрифтов в JasperReports13 лет назад
-
Аудит менеджмента качества13 лет назад
-
-
Windows 8 Camp14 лет назад
-
-
-
Переезд14 лет назад
-
CSP15 лет назад
-
-
Графоманам15 лет назад
-
ListView Multiple Selection 215 лет назад
-
-
-
UnitOfWork & IdentityMap17 лет назад
-
-
-
-
-
-
-
-
-
2 комментария:
Олег, поделитесь пожалуйста соим опытом, какие материалы пчитать, чтобы девелопть на докбуке.
Что-то я выпал из жизни. http://www.docbook.org/tdg5/en/html/docbook.html
А вообще там не так много "ходовых" тегов - сплошные sect1 и para.
Отправить комментарий