Se necesitan muchas herramientas para procesar la documentación
de Python si se desea obtener todos los formatos soportados.
Esta sección enumera las herramientas utilizadas e indica cuándo hace
falta cada una de ellas. Consulta el fichero
Doc/README para ver si hay requisitos de versión para cualquiera
de ellas.
- dvips
- Este programa suele ser parte de las instalaciones de TEX.
Se usa para generar PostScript a partir de los ficheros
``independientes del dispositivo'' .dvi. Es necesario para
la conversión a PostScript.
- emacs
- Emacs es el no va más de los editores para programadores.
Viene con algo de soporte las estructuras de menú de los documentos
de Texinfo si se desea una conversión a info. Es necesario para
la conversión a info. Usar xemacs en lugar de la versión
de FSF emacs puede dar lugar a inestabilidad en la
conversión, pero eso se debe a que nadie parece mantener el
código Texinfo de Emacs de manera portable.
- latex
- Éste es un formateador de texto impreso conocido a nivel mundial,
escrito por de Donald Knuth. Se usa para la conversión a PostScript
y es necesario para la conversión a HTML (LATEX2HTML
necesita uno de los ficheros intermedios que crea).
- latex2html
- Posiblemente, el guion Perl más largo que alguien haya intentado mantener.
Convierte documentos LATEX a HTML y lo hace bastante bien.
Es necesario para las conversiones a HTML y GNU Info.
- lynx
- Un programa de navegación de la Web en modo texto que incluye
un conversión de HTML a texto plano. Se usa para convertir los
documentos
howto a texto.
- make
- Cualquier versión debería valer para los documentos estándar, pero
es necesario el make de GNU para los procesos experimentales
de Doc/tools/sgmlconv/, al menos mientras sean experimentales.
- makeindex
- Es un programa estándar para convertir datos de índice de LATEX
en un índice con formato. Debería estar incluido en todas las instalaciones
de LATEX. Es necesario para las conversiones a PDF y PostScript.
- make info
- Se usa make info de GNU para convertir documentos de
Texinfo a ficheros info de GNU. Como se usa Texinfo como formato
intermedio en la conversión a info, se necesita este programa en
dicha conversión.
- PDF latex
- PDFTEX es una variante relativamente nueva de TEX.
Se usa para generar la versión en PDF de los manuales.
Se instala típicamente como parte de la mayoría de las distribuciones
de TEX.
PDF latex es PDFTEX con el formato LATEX.
- perl
- Es necesario Perl para LATEX2HTML y uno de los guiones utilizado
para post-procesar la salida de LATEX2HTML. También se utiliza
en la conversión HTML a Texinfo. Es necesario para las conversiones
a HTML y a info de GNU.
- python
- Python se usa para muchos de los guiones del directorio
Doc/tools/. Es necesario en todas las conversiones.
¡No debería suponer un problema1 si estás interesado en escribir
documentación para Python!
Notas al pie
- ... problema1
- N. del T.: Es necesario
utilizar la versión de Python 2.0 para generar la documentación
de Python 2.0.
Ver Sobre este documento... para obtener información sobre sugerencias.
