정보 문서를 만드는 방법은 무엇입니까?

정보 문서를 만드는 방법은 무엇입니까?

내 전동 공구에 대한 매뉴얼 페이지 항목을 어떻게 추가합니까?생각이 들었습니다. 정보 페이지를 만드는 방법은 무엇입니까?

답변1

Info 문서를 생성하려면 먼저 texi 파일이 필요합니다.

.texi-텍사스 정보 네트워크단일 소스 파일에서 온라인 및 인쇄 형식으로 문서를 생성하기 위한 조판 구문입니다(dvi, html, pdf와 같은 파일 유형 및 자체 하이퍼텍스트 형식 정보 생성). 이는 자유 소프트웨어 재단(Free Software Foundation)의 GNU 프로젝트에서 만들고 제공하는 동일한 이름의 자유 소프트웨어로 출시된 컴퓨터 프로그램에 의해 구현됩니다.

.info- Info (세대별 makeinfo.) 이것은 기본적으로 원본 Texinfo 구문의 일반 텍스트 버전인 특정 형식으로, 노드를 분리하고 메뉴, 상호 참조, 섹션 등에 대한 탐색 요소를 제공하기 위해 일부 제어 문자와 결합됩니다. 이 info프로그램을 사용하여 정보 형식을 볼 수 있습니다.

makeinfoTexinfo 파일을 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이게 더 좋아 보이네요.

관련 정보