BullDoc 0.31 Released

[DorBer]

Вы хоть в посте укажите, что такое BullDoc. Я вот первый раз слышу, например…

[fantaseour]

Я просто совсем не давно писал в этот личный блог про версию 0.3, и думал, что глупо повторять все время справку о программе. Добавил описание, спасибо.

[dals]

В HTMLDOC (по крайней мере, при установке «из коробки», пакетом) отсутствует поддержка UTF-8. В результате — чертовщина.
Повторюсь, ставил из репозитория. Возможно, скомпилировать можно с поддержкой указанной кодировки.
Но, тем не менее, осадочек остался.
Да, система — Kubuntu 8.04.1.

[fantaseour]

спасибо.

[DYPA]

<cls:keywords data='браузер' /> — автоматически бы генерировать ключевые слова.
<cls: не мешало бы заменить на <bulldoc: для большей внятности.
как насчет интеграции вебинтерфейса с nicedit.com/ или чем нить подобным?
а плагины будут?
поддержка phpDoc?

[fantaseour]

я ответил, но промазал
fantaseour.habrahabr.ru/blog/40966/#comment_999367

[fantaseour]

Спасибо за комментарий.

1. автоматически бы генерировать ключевые слова
На основе текста? Боюсь это будет почти бессмысленно. Предметный указатель не надо мусорить, ну мне так кажется. Хотя инструмент может можно сделать — генерить ключевые слова из оглавления и наиболее частых слов в тексте. Но боюсь смысла в этом не много. Тут как раз ручная работа обычно.

2. заменить cls на bulldoc логично, спасибо.

3. насчет интеграции сделаю что-нибудь, правда я больше смотрел в сторону вот этих проектов:

Helene
code.google.com/p/helene/

CodePress
Online Real Time Syntax Highlighting Editor
codepress.org/

Edit area
www.cdolivet.net/editarea/

4. Плагины пока не понятно в чем будут заключаться и какой соответсвенно давать им API. Сейчас предусмотрен пользовательский класс для обработки текста, и можно сделать такие классы для вики разметки например, или там для маркдауна. Наверное это можно назвать плагином. Темы тоже имеют свой интерфейс и их можно изготовить некоторое количество. Пока я не придумал куда еще можно цеплять плагин. С темами я еще хочу поработать, так, что думаю интерфейс несколько изменится к следующему релизу, но не значительно.

5. Поддержка phpDoc. Я в эту сторону пока копать не думал. Потому, что эти проекты почти не имеют точек пересечения. Ну разве что написать класс, который страницы будет генерить на основании phpDoc комментариев, чтобы облегчить перенос текста из комментариев в документацию.

[DYPA]

1. просто хотелось бы иметь возможность поиска по документации
3. в хроме заработал Edit area, демо для helene не могу найти (пробовать svn версию не хватает времени)
5. можно скрестить с phpDocumentator чтобы не писать велосипед (плагин?)

[fantaseour]

1. Возможно правильно будет сделать плагин для поиска. Только он уже будет требовать чтобы был вебсервер. Очень не хочется мешать ручной тщательно подобранный указатель с автоматической кашей. Ну или опцию сделать типа «строить указатель автоматически». Спасибо. В общем принято :)

5. Видимо да — стоит сделать плагин экспорта в phpDocumentator Tutorial. Вот только кажется эти тьюториалы там не в html а в DocBook. Ну посмотрю. Есть ведь wiki.docbook.org/topic/Html2DocBook конвертор.

[fantaseour]

насчет PHPDoc.

Что еще можно сделать кроме

1. экспорт BullDoc в тюториалы PHPDoc (в формате DocBook)
2. импорт из кода с PHPDoc комментариями в BullDoc

Пока вижу только это.

[fantaseour]

С поиском можно на джаваскрипт попробовать сделать кстати, как у фотошопа 7 в хелпе. Будет поиск.