Texinfo

La versión actual de la página aún no ha sido revisada por colaboradores experimentados y puede diferir significativamente de la versión revisada el 31 de octubre de 2016; las comprobaciones requieren 3 ediciones .
texinfo
Tipo de Sistema de documentación
Desarrollador Richard Stallman
Escrito en xi
Sistema operativo ÑU
Primera edición febrero de 1986
ultima versión
Formatos de archivo legibles Fuente Texinfo [d]
Licencia GPLv3
Sitio web gnu.org/software/texinfo
 Archivos multimedia en Wikimedia Commons

Texinfo ( Russian Tekinfo [2] ) es un sistema de documentación gratuito y un lenguaje de marcado que le permite crear documentos en diferentes formatos a partir de un único texto fuente. Texinfo es parte del proyecto GNU .

Descripción del sistema

Los archivos de origen de los documentos de Texinfo son texto sin formato , marcados con comandos especiales que comienzan con un signo @(por ejemplo, @contentso @titlepage). Los archivos Texinfo suelen tener .texiuna extensión .txi.

Mediante las utilidades makeinfo, texi2dvie texi2pdfincluidas en Texinfo, se genera documentación a partir de los archivos fuente en los siguientes formatos:

Texinfo usa TeX para generar formatos de archivo imprimibles convirtiendo los comandos de @Texinfo en estructuras de control de TeX.

Idioma Texinfo

El lenguaje de marcado Texinfo incluye comandos para estructuración lógica y selección de texto, creación de tablas de contenido, enlaces, índice e inserción de tablas. Dado que Texinfo le permite obtener documentación en diferentes formatos, hay comandos para incluir texto de forma condicional para cada uno de los formatos de salida.

Ejemplo de documento

Aquí hay un pequeño documento marcado con Texinfo.

\input texinfo @setfilename test.info @documentencodificación UTF-8 @settitle Compilador Foo @proceso de copiar Copyright © 2007 Hacker Publishing @fin de copia @pagina del titulo @title Compilador Foo @subtitle "Una nueva palabra en el desarrollo de compiladores" @autor J. Hacker aleatorio @vskip 0 puntos más 1 relleno @insertarcopiando @final de la página de título @encabezados fuera @contenido @ifnottex @nodeTop @top Compilador Foo @insertarcopiando @endifnottex @menú *Introducción:: *Segundo Capítulo:: menú @fin @nodo Introducción @capítulo cómo empezó todo @cindex introducción Este es un capítulo de introducción. @node Segundo Capítulo @capítulo Segundo Capítulo Este es un documento de muestra de Texinfo. Índice de conceptos de @node Índice de conceptos @unnumbered @printindex cp @adiós

Páginas man y Texinfo

Texinfo es aclamado como un sistema para crear manuales grandes y extensos (como bibliotecas de documentación), mientras que el uso tradicional de las páginas man son documentos de referencia compactos. El manual de Texinfo establece que el formato man no es comparable con las principales fuentes de Texinfo [3] en términos de legibilidad. Por lo tanto, la distribución Texinfo no incluye utilidades para generar páginas man a partir de archivos Texinfo. Se sugiere usar la utilidad help2man [4] para autogenerar páginas man .

Proyectos utilizando Texinfo

Texinfo es ampliamente utilizado para documentar programas GNU . Estos incluyen GCC y GDB , GNU libc , GNU Emacs (incluido Gnus ), Bash , GNU Octave , Autotools , Guile , GRUB .

Véase también

Enlaces

Notas

  1. ↑ Lanzamiento de Smith G. Texinfo 6.8  - 2021 .
  2. ↑ "La primera sílaba de "Texinfo" se pronuncia como "mota", no como "hexadecimal"" - del manual de Texinfo
  3. ↑ "...generar una buena página de manual requiere una fuente completamente diferente a las aplicaciones típicas de Texinfo..." - del manual de Texinfo
  4. ↑ página de inicio de help2man . Consultado el 19 de agosto de 2007. Archivado desde el original el 21 de agosto de 2007.
 Τ Ε Χ
Paquetes de macros
Motores alternativos Τ Ε Χ
distribuciones
Comunidad
  • CTAN
  • Remolcador
  • El Diario PracTeX
  • Deutschesprachige Anwendervereinigung TeX
Misceláneas