☰

매뉴얼 페이지 섹션에 연결하시겠습니까?

tag-icon • tag-icon documentation html manpage
매뉴얼 페이지 섹션에 연결하시겠습니까?

섹션 앵커가 있는 HTML의 온라인 매뉴얼 페이지가 있습니까?

하위 섹션으로 직접 연결되는 Ubuntu 매뉴얼 페이지의 온라인 버전이 있으면 좋을 것입니다. 이를 통해 많은 경우 관련 문서(예: 다양한 StackExchange 사이트의 답변)를 누군가에게 알려줄 수 있습니다.

전체 솔루션이 어떻게 보이는지, 그리고 그것이 어떤 방식으로 유용할지 설명하겠습니다. 나는 어딘가에서 완전한 해결책을 찾을 수 없다고 생각하므로 질문은 다음과 같습니다.

현재 어떤 부분 솔루션이 존재합니까?

예를 들어, 링크하는 대신 매뉴얼 페이지를 검색하는 체계적인 방법이 부분적인 해결책이 될 것입니다.


매뉴얼 페이지는맨페이지.ubuntu.com대부분의 문제를 해결하지만 제목이나 섹션에 기준점이 없습니다.

즉, "매개변수 확장" 섹션을 가리키고 싶다면 man bash온라인으로 사용해야 해요

"매개변수 확장"을 참조하십시오.man bash
[...브라우저를 사용하여 "매개변수 확장"을 검색하세요.]

그러면 상단에 하나의 긴 웹 페이지로 bash 매뉴얼 페이지가 열립니다.

껍질에서는 다음과 같이 말할 수 있습니다.

보다man bash | less "+/Parameter Expansion"

시작 시 올바른 위치로 이동합니다.


링크 앵커가 가리키는 제목과 같은 이름을 갖는 것이 정말 도움이 될 것입니다. 일종의 색인 번호로 명명된 앵커는 여전히 도움이 되지만 이를 사용하려면 실제 웹 페이지에서 수동으로 조회해야 합니다.

제목에 앵커를 추가하는 것이 HTML 수준에서는 어렵지 않기 때문에 그러한 매뉴얼 페이지가 존재한다고 확신합니다.
하지만 컬렉션이 있나요?앵커가 포함된 Ubuntu 매뉴얼 페이지온라인 어딘가에 있나요? 아니면 적어도 좋은 하위 집합인가요?

예제 코드

"매개변수 확장" 섹션의 헤더
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] 과 같이 작성됩니다.

기타 참고문서 활용

대부분의 경우 매뉴얼 페이지와 별도로 대체 참조 문서를 사용할 수 있습니다. 이는 목차에서 필요한 섹션으로 연결하는 데 사용되는 좋은 링크 구조를 갖는 경우가 많습니다.
하지만 이것은일반적인 문제를 해결하지 못한다, 그러한 문서가 존재하는지/어디에 있는지 확인하고 링크 구조를 활용할 수 있는 일반적인 방법이 없기 때문입니다.

위에 사용된 bash 예제의 경우배쉬 참조 매뉴얼수동으로 조회한 개별 솔루션으로 사용할 수 있습니다.

Bash 참조 매뉴얼 섹션 Shell-Parameter-Expansion

[Bash 참조 매뉴얼 섹션 Shell-Parameter-Expansion](http://www.gnu.org/software/bash/manual/bash.html#Shell-Parameter-Expansion) 으로 작성되었습니다 .

제안된 구현

이 아이디어를 실제로 구현하도록 제안하려면맨페이지.ubuntu.com,
관련 프로젝트 "ubuntu-manpage-repository"에 밀접하게 관련된 버그/개선 요청을 제출했습니다. launchpad #1355271: HTML a 태그를 사용하여 매뉴얼 페이지의 하위 섹션에 대한 외부 링크 허용

답변1

네, 있어요, 그렇죠http://man.cx/. 모든 매뉴얼 페이지를 하나의 사이트에 여러 언어로 포함하는 것을 목표로 합니다. 불행히도 앵커의 이름은 지정되지 않았지만 번호가 매겨져 있습니다. 예를 들어http://man.cx/printf#heading1매뉴얼 페이지 의 첫 번째 제목으로 이동합니다 printf. 그래도 앵커가 없는 것보다는 낫다고 생각합니다.)

추신. 검색 엔진에 사이트를 추가한 다음 man printf주소 표시줄에 간단히 입력하면 올바른 페이지로 이동됩니다. 정말 대단합니다!

답변2

~에unix.stackexchange, 다음과 같은 방법이 설명되어 있습니다.오프라인 맨페이지를 하이퍼텍스트로 사용도. 나에게 가장 쉬운 방법은 패키지의 일부인 w3mman인 것 같습니다 w3m.

sudo apt-get install w3m

맨페이지 fe를 열면 다음 링크로 이동하는 데 w3mman man사용할 수 있습니다 . TAB(다른 일반적인 키보드 단축키도 동일하게 작동합니다: 스크롤, 검색, 종료 :-)

종료 확인을 끄려면(예: man동작):

  • 편집하다~/.w3m/config

    • 존재하지 않는 경우:cp /etc/w3m/config ~/.w3m/

  • 세트confirm_qq 0

노멀로 교체하려면남성명령:

  • 편집하다~/.bashrc

    • 추가하다alias man='w3mman'

  • source ~/.bashrc

이제 man <some command>일반 man 대신 w3mman을 사용하겠습니다. :) 저는 이 방식이 마음에 듭니다. 질문 주셔서 감사합니다! :)

답변3

8년이 지난 지금도
매뉴얼 페이지를 섹션 앵커와 연결하는 것은 여전히 ​​쉽지 않습니다.

Archlinux 맨페이지가 내가 아는 유일한 페이지인 것 같습니다.

아치리눅스 맨

앵커가 몇 개 있지만 충분하지 않습니다.

데모 링크: https://man.archlinux.org/man/bash.1.en#extglob

그누 맨

앵커가 좀 있어요

데모 링크: https://www.gnu.org/software/bash/manual/bash.html#Indexes
https://www.gnu.org/software/bash/manual/bash.html#Pattern-Matching

관련 정보