LINUX.ORG.RU

Оглавление для манов.

 , troff


0

1

Здравствуйте, господа. Не находит ли кто из вас, что длинным манам остро не хватает гипертекстовых оглавлений?

man --html их умеет. Однако у него есть малооб’яснимая склонность рендирить элементарнейшие таблицы как картинки. К примеру, вот этот кусочек из man(1) при генерации HTML станет PNG’шкой:

    1   Executable programs or shell commands
    2   System calls (functions provided by the kernel)
    3   Library calls (functions within program libraries)
    4   Special files (usually found in /dev)
    5   File formats and conventions eg /etc/passwd
    6   Games
    7   Miscellaneous (including macro packages and conventions), e.g. man(7), groff(7)
    8   System administration commands (usually only for root)
    9   Kernel routines [Non standard]

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

Подскажите, не предлагал ли кто уже решения для этой незадачи?

★★★★★

Всё просто — не использовать для углублённого изучения документации привет из прошлого века. А пару ключей посмотреть хватает и так.

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

pandoc тут поможет.

Тот самый pandoc, который требует ruby и чертову прорву биндингов для него? Нафиг такое счастье.

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

Да. Я ошибся, groff он только пишет. В принципе можно скормить ему выхлоп man.

zinfandel ★★
()

Забавно еще, что судя по этому документу десять лет тому назад Groff умел генерировать нормальные HTML-таблицы вместо картинок.

-T      forbids grohtml from generating images when processing output from
        tbl. This is useful when simple textual tables are being produced.

А потом разучился:

$ zcat /usr/share/man/man1/man.1.gz | soelim | pre-grohtml -T troff -mandoc -Thtml | post-grohtml
pre-grohtml: invalid option -- T

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

makeinfo --html

Вероятно. Но опять же формат манов он читать не умеет.

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