태그 보관물: documentation

documentation

매뉴얼 페이지 섹션에 연결 하시겠습니까? 있습니다. HTML 수준에서는 제목에 앵커를 추가하는

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

하위 섹션으로 직접 연결되는 Ubuntu 매뉴얼 페이지의 온라인 버전을 갖는 것이 좋습니다. 따라서 여러 가지 경우에 예를 들어 다양한 StackExchange 사이트의 답변과 같은 관련 문서를 누군가에게 지시 할 수 있습니다.

전체 솔루션이 어떻게 보일지, 어떤 방법으로 유용한 지 설명하겠습니다. 완벽한 솔루션이 어딘가에 있다고 생각하지 않으므로 질문은

오늘날 어떤 부분 솔루션이 존재합니까?

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

manpages.ubuntu.com
의 매뉴얼 페이지는 대부분의 문제를 해결하지만 제목이나 섹션에 앵커가 없습니다.

즉, man bash온라인 에서 “매개 변수 확장”섹션을 가리 키려면

[… 에서 “매개 변수 확장”을 참조 하고 브라우저를 사용하여 “매개 변수 확장”을 검색하십시오.]man bash

이렇게하면 맨 위에 bash 맨 페이지가 하나의 긴 웹 페이지로 열립니다.

껍질에서 말할 수 있습니다

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

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

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

HTML 수준에서는 제목에 앵커를 추가하는 것이 어렵지 않으므로 이러한 매뉴얼 페이지가 존재한다고 확신합니다.
그러나 온라인 어딘가에 앵커 가있는 우분투 매뉴얼 페이지 모음이 있습니까, 아니면 적어도 좋은 하위 집합입니까?

예제 코드

에서 섹션 “매개 변수 확장”의 헤더
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 Reference Manual 은 개별 솔루션으로 수동으로 조회 할 수 있습니다.

배시 참조 서 섹션 쉘 확장 파라미터
로 작성
[배시 참조 서 섹션 쉘 확장 파라미터 (http://www.gnu.org/software/bash/manual/bash.html#Shell-Parameter-Expansion)

제안 된 구현

에서이 아이디어를 구현 실제로 제안 manpages.ubuntu.com ,
: 나는 “우분투 – 맨 – 저장소”관련 프로젝트에 밀접하게 관련 버그 / 개선 요청 제출
태그 사람의 하위 섹션에 외부 링크를 허용하는 데 사용하는 HTML : 런치 패드 # 1355271를 페이지



답변

예, 있습니다 . http://man.cx/ 입니다. 모든 매뉴얼 페이지를 한 사이트에 여러 언어로 작성하는 것을 목표로합니다. 앵커는 불행히도 이름이 지정되지 않지만 번호가 매겨집니다. http://man.cx/printf#heading1이 의 첫 번째 제목에 당신을 데려 갈 것이다 printf매뉴얼 페이지를 참조하십시오. 여전히 앵커가없는 것보다 낫다고 생각합니다.)

추신. 검색 엔진에 사이트를 추가하면 man printf주소창에 간단히 입력 하면 정확한 페이지로 이동합니다.


답변

unix.stackexchange , 방법을 설명가 하이퍼 텍스트로 오프라인 맨 페이지를 사용하여 도. 가장 쉬운 방법은 패키지의 일부인 w3mman 인 것 같습니다 w3m.

sudo apt-get install w3m

맨 페이지 fe를 열면 w3mman man다음을 사용할 수 있습니다.TAB 다음 링크로 이동할 . (기타 수동 키보드 단축키는 동일하게 작동합니다 : 스크롤, 검색, 종료 🙂

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

  • 편집하다 ~/.w3m/config

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

normal man 명령 을 바꾸려면 :

  • 편집하다 ~/.bashrc

    • 더하다 alias man='w3mman'
  • source ~/.bashrc

이제 man <some command>정상적인 사람 대신 w3mman을 사용합니다. 🙂 나는 이것을 좋아합니다. 질문 주셔서 감사합니다! 🙂


답변