Было бы хорошо иметь интерактивную версию страниц справочника 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 теги для разрешения внешних ссылок подразделам страниц справочника
Да, существует, это http://man.cx/ . Это имеет целью иметь все страницы справочника в одном сайте также на нескольких языках. Привязки, к сожалению, не называют, но нумеруют: например http://man.cx/printf#heading1 возьмет Вас к первому заголовку printf
страница справочника. Тем не менее я думаю, что это лучше, чем без привязок;)
пз. Добавьте сайт к своим поисковым системам, тогда Вы можете просто тип man printf
в своей строке поиска, и это возьмет Вас к корректной странице, супер потрясающей!
На 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 вместо нормального человека :) Мне нравится он этот путь.Спасибо за вопрос!:)