내 전동 공구에 대한 매뉴얼 페이지 항목을 어떻게 추가합니까?생각이 들었습니다. 정보 페이지를 만드는 방법은 무엇입니까?
답변1
Info 문서를 생성하려면 먼저 texi 파일이 필요합니다.
.texi
-텍사스 정보 네트워크단일 소스 파일에서 온라인 및 인쇄 형식으로 문서를 생성하기 위한 조판 구문입니다(dvi, html, pdf와 같은 파일 유형 및 자체 하이퍼텍스트 형식 정보 생성). 이는 자유 소프트웨어 재단(Free Software Foundation)의 GNU 프로젝트에서 만들고 제공하는 동일한 이름의 자유 소프트웨어로 출시된 컴퓨터 프로그램에 의해 구현됩니다.
.info
- Info (세대별 makeinfo
.) 이것은 기본적으로 원본 Texinfo 구문의 일반 텍스트 버전인 특정 형식으로, 노드를 분리하고 메뉴, 상호 참조, 섹션 등에 대한 탐색 요소를 제공하기 위해 일부 제어 문자와 결합됩니다. 이 info
프로그램을 사용하여 정보 형식을 볼 수 있습니다.
makeinfo
Texinfo 파일을 Info 파일로 변환하는 유틸리티 프로그램입니다.texinfo 패키지의 일부입니다.. 동일한 기능을 가진 GNU Emacs 함수입니다 texinfo-format-region
.texinfo-format-buffer
이것은템플릿으로 사용된 택시의 예:
\input texinfo @c -*-texinfo-*-
@comment $Id@w{$}
@comment %**start of header
@setfilename sample.info
@include version.texi
@settitle GNU Sample @value{VERSION}
@syncodeindex pg cp
@comment %**end of header
@copying
This manual is for GNU Sample (version @value{VERSION}, @value{UPDATED}),
which is an example in the Texinfo documentation.
Copyright @copyright{} 2013 Free Software Foundation, Inc.
@quotation
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation; with no
Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
Texts. A copy of the license is included in the section entitled
``GNU Free Documentation License''.
@end quotation
@end copying
@dircategory Texinfo documentation system
@direntry
* sample: (sample)Invoking sample.
@end direntry
@titlepage
@title GNU Sample
@subtitle for version @value{VERSION}, @value{UPDATED}
@author A.U. Thor (@email{bug-sample@@gnu.org})
@page
@vskip 0pt plus 1filll
@insertcopying
@end titlepage
@contents
@ifnottex
@node Top
@top GNU Sample
This manual is for GNU Sample (version @value{VERSION}, @value{UPDATED}).
@end ifnottex
@menu
* Invoking sample::
* GNU Free Documentation License::
* Index::
@end menu
@node Invoking sample
@chapter Invoking sample
@pindex sample
@cindex invoking @command{sample}
This is a sample manual. There is no sample program to
invoke, but if there were, you could see its basic usage
and command line options here.
@node GNU Free Documentation License
@appendix GNU Free Documentation License
@include fdl.texi
@node Index
@unnumbered Index
@printindex cp
@bye
정보 문서로 변환그리고:
makeinfo mytool.texi
dir
시스템에 새 정보 파일을 추가하려면 디렉터리 info
( /usr/share/info/
Ubuntu의 경우)에 있는 파일 메뉴에 해당 정보 파일에 대한 메뉴 항목을 작성합니다. 또한 새 Info 파일 자체도 이 info
디렉터리로 이동합니다. 예를 들어, GDB 문서를 추가하려면 다음과 같은 새 항목을 작성해야 합니다.
* GDB: (gdb). The source-level C debugger.
메뉴 항목의 첫 번째 부분은 메뉴 항목 이름이고 그 뒤에 콜론이 옵니다. 두 번째 부분은 정보 파일의 이름으로, 괄호로 묶이고 그 뒤에 마침표가 옵니다. 세 번째 부분은 설명입니다.
관례적으로 정보 파일의 이름은 .info
확장자로 지정됩니다. 따라서 다음과 같이 파일 이름을 나열할 수 있습니다.
* GDB: (gdb.info). The source-level C debugger.
.info
그러나 Info가 메뉴에서 특정 이름의 파일을 찾지 못하면 확장명이 있는 파일을 찾습니다. 이는 첫 번째 예에 표시된 것처럼 파일을 gdb.info
로 참조할 수 있음을 의미합니다. gdb
이게 더 좋아 보이네요.