Archivo DTX

Un archivo .dtx es un archivo de fuente LaTeX documentado, el formato estándar para distribuir paquetes de LaTeX en CTAN (Comprehensive TeX Archive Network). El formato implementa un enfoque de programación literaria: un único archivo .dtx intercala el código fuente ejecutable del paquete con su documentación completa tipografiada en un solo archivo de texto plano autónomo.

El mecanismo se basa en DocStrip, una utilidad incluida en todas las distribuciones de TeX. Los comentarios de guarda en la forma % <guard> marcan qué líneas pertenecen a la implementación y cuáles son pura documentación. Al ejecutar latex package.ins (usando el archivo instalador .ins complementario) se eliminan los marcadores de documentación y se extraen los archivos de paquete .sty o .cls utilizables. Al ejecutar pdflatex package.dtx, en su lugar, se tipografía el manual completo, con el código fuente anotado y resaltado por sintaxis.

Casi todos los paquetes de CTAN se envían como un par .dtx + .ins. El archivo .ins es un pequeño script de DocStrip que indica al extractor qué archivos de salida producir y dónde colocarlos.

Los archivos .dtx son texto plano UTF-8 (o ASCII) y se abren en cualquier editor de texto, aunque los editores compatibles con TeX como TeXstudio o Texmaker proporcionan resaltado de sintaxis. La clase de documento ltxdoc, parte del núcleo de LaTeX, se utiliza para tipografiar la documentación de los .dtx y proporciona entornos para anotar definiciones de macros junto con su código fuente.