Соединение с разделами страницы справочника?

Страницы справочника онлайн в HTML с привязками к разделу?

Было бы хорошо иметь интерактивную версию страниц справочника Ubuntu с прямыми ссылками в подразделы. Это позволило бы указывать на кого-то на соответствующую документацию во многих случаях - например, в ответах различных сайтов StackExchange.

Я опишу, как могло бы посмотреть полное решение, и в который пути, которые будут полезны. Я не думаю, что полное решение доступно где-нибудь, таким образом, вопрос

Какие частичные решения существуют сегодня?

Например, так или иначе систематическими способами искать в страницы справочника, вместо соединения, было бы частичное решение.


Страницы справочника по manpages.ubuntu.com решают большую часть проблемы, но у них нет привязок на заголовках или разделах.

Это означает, если я хочу указать на раздел "Parameter Expansion" в man bash онлайн, я должен использовать

См. "расширение параметра" в man bash
[... и использование Ваш браузер для поиска "Расширения Параметра"]

Это открывает страницу справочника удара наверху как одна длинная веб-страница.

В оболочке я могу сказать

Посмотрите man bash | less "+/Parameter Expansion"

который переходит к правильному месту при запуске.


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

Поскольку не трудно на уровне HTML добавить привязки к заголовкам, я уверен, что такие страницы справочника существуют;
Но есть ли набор страниц справочника Ubuntu с привязками онлайн где-нибудь или по крайней мере хорошее подмножество?

Пример кода

Заголовок раздела "Parameter Expansion" от
http://manpages.ubuntu.com/bash
который отчасти-перенаправляет к
http://manpages.ubuntu.com/manpages/trusty/en/man1/bash.1.html

       [ ... ]
       tildes in assignments to <b>PATH</b>, <b>MAILPATH</b>,  and  <b>CDPATH</b>,  and  the  shell
       assigns the expanded value.

   <b>Parameter</b> <b>Expansion</b>
       The `<b>$</b>' character introduces parameter expansion, command substitution,
       or arithmetic expansion.  The parameter name or symbol to  be  expanded
       [ ... ]

Чтобы смочь связаться непосредственно с этим разделом, нам нужно что-то как:

       [ ... ]
       tildes in assignments to <b>PATH</b>, <b>MAILPATH</b>,  and  <b>CDPATH</b>,  and  the  shell
       assigns the expanded value.

   <a href="#ParameterExpansion"><b>Parameter</b> <b>Expansion</b></a>
       The `<b>$</b>' character introduces parameter expansion, command substitution,
       or arithmetic expansion.  The parameter name or symbol to  be  expanded
       [ ... ]


Это добавляет один тег к HTML-коду и один атрибут, имя раздела без пробелов:

<b>Parameter</b> <b>Expansion</b>
<a href="#ParameterExpansion"><b>Parameter</b> <b>Expansion</b></a>

Теперь, мы можем связаться с разделом как

http://manpages.ubuntu.com/bash#ParameterExpansion
или даже
manpages.ubuntu.com/bash#ParameterExpansion

то, которое использует примечание ноги и является, записано как
[manpages.ubuntu.com/bash#ParameterExpansion] [6]


Использование других справочных документов

Во многих случаях существуют альтернативные доступные справочные документы, независимо от страницы справочника. Они часто имеют хорошую структуру ссылки, которая используется для соединения от оглавления до разделов, в чем мы нуждаемся.
Но это не решает общую проблему, поскольку нет никакого распространенного способа найти ли/где такой документ existst и использовать структуру ссылки.

Для примера удара, используемого выше, Справочник Bash мог использоваться в качестве отдельного решения, искавшего вручную:

Расширение параметра Shell раздела Bash Reference Manual
записанный как
[Расширение параметра Shell раздела Bash Reference Manual] (http://www.gnu.org/software/bash/manual/bash.html#Shell-Parameter-Expansion)

Предложенное внедрение

Предложить на самом деле реализовать эту идею по manpages.ubuntu.com,
Я зарегистрировал тесно связанный запрос ошибки/улучшения на связанном "репозитории страницы справочника человечности" проекта: панель запуска № 1355271: Используйте HTML теги для разрешения внешних ссылок подразделам страниц справочника

13
задан 11 September 2014 в 12:27

2 ответа

Да, существует, это http://man.cx/ . Это имеет целью иметь все страницы справочника в одном сайте также на нескольких языках. Привязки, к сожалению, не называют, но нумеруют: например http://man.cx/printf#heading1 возьмет Вас к первому заголовку printf страница справочника. Тем не менее я думаю, что это лучше, чем без привязок;)

пз. Добавьте сайт к своим поисковым системам, тогда Вы можете просто тип man printf в своей строке поиска, и это возьмет Вас к корректной странице, супер потрясающей!

7
ответ дан 23 November 2019 в 03:24

На unix.stackexchange существуют пути, описанные для использования офлайновых страниц справочника в качестве гипертекста также. Самый легкий путь ко мне кажется w3mman, который является частью пакета w3m, так:

sudo apt-get install w3m

Когда Вы открыли страницу справочника, f.e. w3mman man, можно использовать ВКЛАДКУ для навигации к следующей ссылке. (Другие типичные для человека сочетания клавиш работают то же: прокрутка, поиск, выход :-)

Выключить подтверждение выхода (как man ведет себя):

  • править ~/.w3m/config

    • если не существующий: cp /etc/w3m/config ~/.w3m/
  • набор confirm_qq 0

Заменять нормальную команду человека:

  • править ~/.bashrc

    • добавить alias man='w3mman'
  • source ~/.bashrc

Теперь man <some command> будет использовать w3mman вместо нормального человека :) Мне нравится он этот путь.Спасибо за вопрос!:)

2
ответ дан 23 November 2019 в 03:24

Другие вопросы по тегам:

Похожие вопросы: