Хабр Курсы для всех
РЕКЛАМА
Практикум, Хекслет, SkyPro, авторские курсы — собрали всех и попросили скидки. Осталось выбрать!
Хабр доступен 24/7 благодаря поддержке друзей
Комментарии 20
Блин чувак, хоть никто тебе ничего и не написал, а я скажу — это круто!
Круто всегда делать что-то либо новое!
Круто всегда делать что-то либо новое!
Булдос — без улыбки не прочитаешь. Шикарное название :)
В целом понравилось :)
Только вот зашел я на сайт, просмотрел текст на обычной первой космической скорости, и не понял, что это такое, потыкал по скриншотам, появились догадки. Пришлось вдумчиво читать текст…
Было бы неплохо поместить пример готовой документации сразу на главной. Чтобы люди типа меня заходили, сразу открывали пример и делали выводы, копать глубже или нет :)
Радует, что вы не останавливаетесь и продолжаете работу :)
Только вот зашел я на сайт, просмотрел текст на обычной первой космической скорости, и не понял, что это такое, потыкал по скриншотам, появились догадки. Пришлось вдумчиво читать текст…
Было бы неплохо поместить пример готовой документации сразу на главной. Чтобы люди типа меня заходили, сразу открывали пример и делали выводы, копать глубже или нет :)
Радует, что вы не останавливаетесь и продолжаете работу :)
Сходу я могу назвать два более развитых аналога:
sphinx.pocoo.org/ — этим пользуюсь уже полгода, очень доволен, хотя chm и кирилица требуют наложения нескольких патчей.
www.methods.co.nz/asciidoc/
Форматов вывода у обоих проэктов значительно больше. Лично я чаще всего пользуюсь pdf и html. У sphinx-а есть возможность формулы отображать, синтаксис возможно покажется более сложным но он более мощный, но отсутствие тэговой разметки для меня уже в плюс по сравнению с вашим.
Хотелось бы сравнения с конкурентами в чём ваша фишка, в каких местах ваш проэкт более сильный, перед тем как отдать предпочтение кокому-либо проэкту.
sphinx.pocoo.org/ — этим пользуюсь уже полгода, очень доволен, хотя chm и кирилица требуют наложения нескольких патчей.
www.methods.co.nz/asciidoc/
Форматов вывода у обоих проэктов значительно больше. Лично я чаще всего пользуюсь pdf и html. У sphinx-а есть возможность формулы отображать, синтаксис возможно покажется более сложным но он более мощный, но отсутствие тэговой разметки для меня уже в плюс по сравнению с вашим.
Хотелось бы сравнения с конкурентами в чём ваша фишка, в каких местах ваш проэкт более сильный, перед тем как отдать предпочтение кокому-либо проэкту.
Спасибо за сфинкса, просмотрю.
А pdf кириллический хорошо получается? Текст выделяемый или втроенным фонтсетом, т.е. его через карман можно скопировать?
Насчет asciidoc, вот обсуждение разности подходов:
habrahabr.ru/blogs/i_am_advertising/41211/#comment_1005199
заодно там упомянут интересный инструмент, для правки этой документации
habrahabr.ru/blogs/pm/12903/
На всякий случай процитирую отличия проектов:
Для меня было не очень важно какой язык разметки будет использоваться. Я специально сделал API для класса форматирования, чтобы цеплять потом разные разметки. Сколько «удобных» разметок я не пробовал, лично мне роднее html. Но это лично мое предпочтение.
asciidoc и примочка крайне близко к тому, для чего писался BullDoc. Однако все же это взгляды под разными углами.
Аскидок больше нацелен на удобную разметку. И дополнительный скриптик дает возможность предпросмотра страницы без полной сборки всего документа.
На выходе в родном варианте генерится монолитный html файл (если говорить о выводе в html), а это не всегда удобно. Прочие приемы требуют еще и наличия докбучных инструментов.
Мой же проект предполагает выносить парсеры разметки в плагины. И нацелен на сборку статической книжки из многих html файлов. И на сборку CHM. Понятное дело, что и монолитный файл документации для распечатки тоже создается. Т. е. моя программа это не рендерер, а собиратель и построитель навигации, предметного указателя, и пр. Всяких парсеров я прикручу еще. Очень хочется маркдаун прикрутить в первую очередь.
А pdf кириллический хорошо получается? Текст выделяемый или втроенным фонтсетом, т.е. его через карман можно скопировать?
Насчет asciidoc, вот обсуждение разности подходов:
habrahabr.ru/blogs/i_am_advertising/41211/#comment_1005199
заодно там упомянут интересный инструмент, для правки этой документации
habrahabr.ru/blogs/pm/12903/
На всякий случай процитирую отличия проектов:
Для меня было не очень важно какой язык разметки будет использоваться. Я специально сделал API для класса форматирования, чтобы цеплять потом разные разметки. Сколько «удобных» разметок я не пробовал, лично мне роднее html. Но это лично мое предпочтение.
asciidoc и примочка крайне близко к тому, для чего писался BullDoc. Однако все же это взгляды под разными углами.
Аскидок больше нацелен на удобную разметку. И дополнительный скриптик дает возможность предпросмотра страницы без полной сборки всего документа.
На выходе в родном варианте генерится монолитный html файл (если говорить о выводе в html), а это не всегда удобно. Прочие приемы требуют еще и наличия докбучных инструментов.
Мой же проект предполагает выносить парсеры разметки в плагины. И нацелен на сборку статической книжки из многих html файлов. И на сборку CHM. Понятное дело, что и монолитный файл документации для распечатки тоже создается. Т. е. моя программа это не рендерер, а собиратель и построитель навигации, предметного указателя, и пр. Всяких парсеров я прикручу еще. Очень хочется маркдаун прикрутить в первую очередь.
Сфинкс очень близок на беглый взгляд к тому, что делал я. Посмотрю подробнее. Ну разница пока, что бросается что он на питоне, но это конечно не принципиально.
Ну и для меня ключевым было использование чистого html, а не альтернативной разметке :) т.е., то, что Вам плюс, мне как бы минус :)
Ну и сфинкс тоже бы выиграл от веб интерфейса, чтобы смотреть, то, что получается без перекомпиляции проекта. Хотя наверное есть какой-нибудь такой плагин, странно если бы его не было.
Зашел на сайт, так и не понял, что представляет из себя программа. Это набор PHP скриптов? Или какой-то бинарь, который пользует PHP? Всё это дело надо пользовать в командной строке? Или есть какой-то веб-интерфейс? Или интерфейс рисует бинарь?
В случае использования веб-интерфейса Apache обязателен? Или сойдет любой веб-сервер (в моем случае Lighttpd)?
Я не пробовал :) На мой взгляд зависимость от апача проявляется в mod_rewrite. Если другой сервер позволяет продублировать mod_rewrite c такими настройками:
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-l
RewriteRule ^(.+)$ index.php?colesoRequestPath=$1 [L,QSA]
То все должно работать.
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-l
RewriteRule ^(.+)$ index.php?colesoRequestPath=$1 [L,QSA]
То все должно работать.
Спасибо. Я не силен в настройке веб-серверов, но посмотрю ваш хинт. Хотя думается что с моим Lighttpd не запущу ваш продукт. Попробую — в случае положительного резалта отпишусь
Сорри, что сырой совет, но посмотрите сюда. Здесь решают сходную проблему для Друпала:
nordisch.org/2007/2/6/drupal-on-lighttpd-with-clean-urls#comments
nordisch.org/2007/2/6/drupal-on-lighttpd-with-clean-urls#comments
Промазал…
Возможно, что заработает и в лоб:
url.rewrite-once = ( "^(.+)$" => "/index.php?colesoRequestPath=$")
согласно вот этому:
redmine.lighttpd.net/wiki/lighttpd/Docs:ModRewrite
в последних версиях я не отдаю файлы и картинки напрямую, поэтому отсутствие !-f и !-d в ligthhttpd не должно повлиять.
однако решение для друпала, приведенное выше, должно помочь в любом случае…
Возможно, что заработает и в лоб:
url.rewrite-once = ( "^(.+)$" => "/index.php?colesoRequestPath=$")
согласно вот этому:
redmine.lighttpd.net/wiki/lighttpd/Docs:ModRewrite
в последних версиях я не отдаю файлы и картинки напрямую, поэтому отсутствие !-f и !-d в ligthhttpd не должно повлиять.
однако решение для друпала, приведенное выше, должно помочь в любом случае…
и еще одна поправка
url.rewrite-once = ( "^(.+)$" => "/index.php?colesoRequestPath=$1")
url.rewrite-once = ( "^(.+)$" => "/index.php?colesoRequestPath=$1")
Возможно, что заработает и в лоб:
url.rewrite-once = ( "^(.+)$" => "/index.php?colesoRequestPath=$")
согласно вот этому:
redmine.lighttpd.net/wiki/lighttpd/Docs:ModRewrite
в последних версиях я не отдаю файлы и картинки напрямую, поэтому отсутствие !-f и !-d в ligthhttpd не должно повлиять.
однако решение для друпала, приведенное выше, должно помочь в любом случае…
url.rewrite-once = ( "^(.+)$" => "/index.php?colesoRequestPath=$")
согласно вот этому:
redmine.lighttpd.net/wiki/lighttpd/Docs:ModRewrite
в последних версиях я не отдаю файлы и картинки напрямую, поэтому отсутствие !-f и !-d в ligthhttpd не должно повлиять.
однако решение для друпала, приведенное выше, должно помочь в любом случае…
Зарегистрируйтесь на Хабре, чтобы оставить комментарий
Bulldoc 0.4 released