LINUX.ORG.RU

Documancer-0.2.4


0

0

После долгого перерыва вышла новая версия программы для просмотра документации Documancer.
Поддерживаются man, info, html.
Присутствуют закладки и глобальный поиск.
Программа использует wxPython,wxMozilla,man2html,info2html.

ChangeLog :

* added "Update index" menu entry
* added contents panel
* books are now stored in XML files in ~/.documancer/books/ instead of in config file
* added Refresh and Stop buttons
* PyLucene is now used instead of SWISH-E for fulltext search and Unicode is fully supported
* search UI improvements
* Python 2.3+ is now required

>>> Подробности

★★

Проверено: maxcom ()

Ответ на: комментарий от anonymous

>С ума сойти! А что команды man и info так и перестали работать?

Согласись, читать доку каталогизированную с красивым форматированием, с закладками, с гипер-ссылками, с полнотекстным поиском гораздо удобнее и приятнее
чем в консоли при помощи голого man и info...
Плюс documancer можно просто как каталогизатор использовать...

Renso ★★
() автор топика
Ответ на: комментарий от Orlangoor

>А закладки оно держит?

Держит, вроде не ронял ни разу... :)))

>Если да, то вкупе с xpdf будет прекрасный наборчик.

Вооще, если прикрутить к нему поддержку других форматов через врапперы,
сделать управление внесёнными документами как в ScrapBook для firefox
,к примеру, то получится универсальная система управления любыми документами + читалка...

Renso ★★
() автор топика
Ответ на: комментарий от Renso

>Согласись, читать доку каталогизированную с красивым форматированием, с >закладками, с гипер-ссылками, с полнотекстным поиском гораздо удобнее и >приятнее >чем в консоли при помощи голого man и info...

в KDE3.1.x+:

ALT+F2 -> man://somemanpage или ALT+F2 -> info://someinfopage

Вполне себе эротично, с гиперссылками...

anonymous
()
Ответ на: комментарий от anonymous

>в KDE3.1.x+:
>ALT+F2 -> man://somemanpage или ALT+F2 -> info://someinfopage

Во первых, это в KDE ;)
Во вторых, там поиск есть ?

Renso ★★
() автор топика
Ответ на: комментарий от anonymous

>Согласись, читать доку каталогизированную с красивым

Может я не прав но:

1. Приятного в доках мало. 2. Часто кроме консоли в руках ничего нет. 3. С консоли поиск эффективней чем через любой гуй 4. Каталог годится если точно знаешь что потерял, и совершенно бесполезен в обратом случае.

anonymous
()
Ответ на: комментарий от anonymous

>1. Приятного в доках мало.

Возможно, но от них никуда не деться... :)

>2. Часто кроме консоли в руках ничего нет.

Согласен, но это не всегда так...

>3. С консоли поиск эффективней чем через любой гуй

Не согласен, а про читабельность в консоли я вообще молчу...

>4. Каталог годится если точно знаешь что потерял, и совершенно бесполезен в обратом случае.

Для этого как раз есть поиск...

В общем ,я считаю, что для графического режима documancer является
отличным ДОПОЛНЕНИЕМ к консольным командам...

Renso ★★
() автор топика

При одном упоминании чего там надо этой проге, я сказал НАХ! Лень все это тащить откуда, то ставить, и ябаться с установкой!

anonymous
()
Ответ на: комментарий от anonymous

>Лень все это тащить откуда, то ставить, и ябаться с установкой!

Для запуска достаточно wxGTK и wxPython
Для красивого форматирования прибавляем wxMozilla
Для полноценного поиска прибавляем PyLucene

По моему, не так всё и сложно... :)

Renso ★★
() автор топика
Ответ на: комментарий от Renso

> читать доку каталогизированную с красивым форматированием, с закладками, с гипер-ссылками, с полнотекстным поиском гораздо удобнее и приятнее чем в консоли при помощи голого man и info...

А что, теперь в _info_ ни гиперссылок, ни индекса, ни поиска нет?

anonymous
()
Ответ на: комментарий от Renso

Т.е. я хочу сказать,что пользоваться и man и info в графике гораздо
удобнее через documancer чем в голом виде, к стати для консоли тоже
что-то подобное есть pinfo называется...

Renso ★★
() автор топика
Ответ на: комментарий от baka-kun

1. Ссылок в голом man нет.
2. Полноценного поиска с подсветкой результатов нет.
3. Закладок нет.
4. Читабильность с консоли заведомо хуже чем в грамотно форматированном html.

Renso ★★
() автор топика

а работает ли данная система с многоязыковым поиском?

вот man, например, с правильно выставленным LANGUAGE, ищет сначала в одной языковой секции, потом в другой и только уже тогда, если ничего не находит, в секции "C"

swar0g ★★★★
()
Ответ на: комментарий от Renso

> 1. Ссылок в голом man нет. 2. Полноценного поиска с подсветкой результатов нет. 3. Закладок нет.

Странно, а мой ${PAGER} и something(_n_) воспринимает как ссылку, если есть ${MANPATH}/man_n_/something._n_.gz, и полноценный поиск с подсветкой поддерживает (да он и у less даже есть), и закладки...

> 4. Читабильность с консоли заведомо хуже чем в грамотно форматированном html.

Тоже удивительно слышать, мой roff очень неплохо форматирует... Чудны дела твои, Господи...

baka-kun ★★★★★
()
Ответ на: комментарий от baka-kun

>Странно, а мой ${PAGER} и something(_n_) воспринимает как ссылку, если есть

Ну так pinfo тоже ссылки поддерживает...

>и полноценный поиск с подсветкой поддерживает (да он и у less даже есть)

Глобальный поиск по всем страницам man с подсветкой результата в каждой
найденной странице ?

>и закладки...

Это чё за ${PAGER} такой ?

>Тоже удивительно слышать, мой roff очень неплохо форматирует...

Ну это уж ,на вкус на цвет...

Вообще-то, я уже сказал что данная программа ДОПОЛНЕНИЕ к консольным утилитам, при чём, достаточно удобное...

Renso ★★
() автор топика
Ответ на: комментарий от Renso

> Глобальный поиск по всем страницам man с подсветкой результата в каждой найденной странице ?

man apropos ; man whatis

> Это чё за ${PAGER} такой ?

Да не все ли равно, что у тебя будет `setenv PAGER`? Хоть mcview. В моем случае это маленькая самописанная curses софтинка, изначально задуманная как bookreader.

Или... Страшная мысль: ты не знаешь, что такое PAGER?

> Ну это уж ,на вкус на цвет...

При чем тут вкус и цвет? Маны _уже_ в roff. Написаны они на нем. Ну делаешь ты `groff -T html`, а потом отображаешь, на здоровье. Только не говори, что это "намного лучше", чем `groff -T ascii`, `groff -T dvi` или `groff -T ps`.

> данная программа ДОПОЛНЕНИЕ к консольным утилитам

Дополнение к консольным утилитам у меня konqueror, в котором очень удобно 'man:/something' с так любимым тобой глобальным поиском, подсветкой и ссылками.

baka-kun ★★★★★
()
Ответ на: комментарий от baka-kun

>man apropos ; man whatis

Пример поиска словосочетания "data base", по всем страницам man,
при открытии найденных страниц словосочетание подсвечивается
при этом работают ссылки...

>Да не все ли равно, что у тебя будет `setenv PAGER`? Хоть mcview.

С каких это пор у нас mcview поддерживает переход по ссылкам в man ?

>В моем случае это маленькая самописанная curses софтинка, изначально задуманная как bookreader.

Вот это уже другой разговор, я уже про pinfo сказал, значит вам тоже
удобнее что-то читать через специальное приложение а не штатными средствами...

>Или... Страшная мысль: ты не знаешь, что такое PAGER?

Знаю, это такой приборчик который пищит на поясе... :))))

>Ну делаешь ты `groff -T html`, а потом отображаешь, на здоровье.

Это я знаю, но согласитесь, что обьединить apropos whatis groff -T html man info и т.д. и дать пользователю возможность их интерактивно ,просто
и удобно использовать не такая уж и плохая задумка...

>Дополнение к консольным утилитам у меня konqueror в котором очень
>удобно 'man:/something' с так любимым тобой глобальным поиском, >подсветкой и ссылками.

Тот кто не пользуется KDE такой роскоши не достоин ?

Renso ★★
() автор топика
Ответ на: комментарий от Renso

>Ну делаешь ты `groff -T html`, а потом отображаешь, на здоровье.

И к стати groff -T html по дефолту рендерит гораздо хуже в смысле
читабельности чем man2html...

Renso ★★
() автор топика
Ответ на: комментарий от Renso

> Пример поиска словосочетания "data base", по всем страницам man, при открытии найденных страниц словосочетание подсвечивается при этом работают ссылки...

Тебе что, показать alias, который заменяет вызов apropos на `/usr/bin/apropos "$*" | ${PAGER} --search "$*"` ?

> обьединить apropos whatis groff ... и дать пользователю возможность их ... использовать не такая уж и плохая задумка

Ага. База уже есть (makewhatis), средства поиска (apropos, whatis), парсер (groff)... Осталось что? Ага, PAGER. Вот и создавайте нормальную гляделку, а не велосипед. Я её написал за пару часов. Для себя.

baka-kun ★★★★★
()
Ответ на: комментарий от Renso

> И к стати groff -T html по дефолту рендерит гораздо хуже в смысле читабельности чем man2html...

Чего? Внешний вид другой? Ну так напиши свой tmac, или поправь существующие в /usr/share/tmac. Тоже мне, бином Ньютона...

baka-kun ★★★★★
()
Ответ на: комментарий от baka-kun

>Тебе что, показать alias, который заменяет вызов apropos на `/usr/bin/apropos "$*" | ${PAGER} --search "$*"` ?

Опять упираемся в PAGER... очень уж он у тебя хороший...
и ссылки в man воспринимает и закладки в нём есть и поиск с подсветкой...

>Ага. База уже есть (makewhatis), средства поиска (apropos, whatis), >парсер (groff)... Осталось что? Ага, PAGER. Вот и создавайте нормальную >гляделку, а не велосипед. Я её написал за пару часов. Для себя.

Вот, с этим я уже могу согласиться, доля истины в этом есть...
Осталось понять почему этого разработчики documancer не сделали,
и стали использовать man2html и info2html потом индексить их вывод
и по нему уже искать, напомню что documancer позволяет любую html
доку индексировать, а не только man и info, с Python docs тоже работает.

Renso ★★
() автор топика
Ответ на: комментарий от baka-kun

>Чего? Внешний вид другой? Ну так напиши свой tmac, или поправь существующие в /usr/share/tmac.

Я ж сказал , по дефолту...

>Тоже мне, бином Ньютона...

Т.е. чтоб нормальный вид доки имели,я ещё и в форматировании должен
разбираться,я то это сделаю, а остальные не столь искушённые ?

Renso ★★
() автор топика
Ответ на: комментарий от Renso

Поставь себе в качестве pager'а vim и наслаждайся жизнью.

jackill ★★★★★
()
Ответ на: комментарий от Orlangoor

Закладки вредны, Слака рулит

anonymous
()
Ответ на: комментарий от Renso

> Я ж сказал , по дефолту...

По дефолту он делает нормальный стандартный HTML4.01. А вот если нужны извращения, то переопределяй макросы, да пиши css.

> Т.е. чтоб нормальный вид доки имели, я ещё и в форматировании должен разбираться?

Конечно. Не поступать же как тупой man2html. Ты знаешь, как он работает? Он берет вывод `groff -T ascii` и тупо вставляет <pre>. Ну и заменяет [char][bs][char] на <b>char</b>, и _жестко_зашитые_ NAME, SYNOPSIS, DESCRIPTION и т.п. на <h1>NAME</h1>,...

И ЭТО ты называешь "красивым форматированием man"? Всю мошь пре- и пост-процессоров roff свести к такому извращению?

baka-kun ★★★★★
()
Вы не можете добавлять комментарии в эту тему. Тема перемещена в архив.