hacerdoc


MakeDoc es un lenguaje de marcado ligero creado en 2000 por Carl Sassenrath para crear documentación y páginas web utilizando notaciones de texto simples. [1] El lenguaje se usa ampliamente en la comunidad REBOL para documentación, sitios web y wikis.

MakeDoc se diseñó originalmente para permitir a los autores crear documentación formateada sin necesidad de un software de procesamiento de texto. [2] Cualquier editor de texto normal, incluidos los formularios de entrada web, se puede utilizar para la entrada, y la salida puede ser HTML , PDF o texto normal. [2]

Un objetivo adicional de MakeDoc era que el formato de entrada de texto en sí debería ser legible, despejado con las notaciones de marcado que se encuentran comúnmente en los lenguajes de marcado basados en SGML , como HTML y XML . Esto se hizo para permitir la distribución de documentación para paquetes de software, donde a menudo dichos documentos se visualizan (o incluso se crean) en shells de comandos de solo texto.

El formato de MakeDoc está diseñado para ingresar y editar desde cualquier editor de texto, incluidos los que se usan a menudo en entornos de shell, como vi y Emacs .

Las viñetas, las listas numéricas, las definiciones y otros formatos de documentos especiales se notan comenzando una línea con un carácter especial.

El lenguaje también permite la evaluación (ejecución) de secciones de código para producir los resultados, por ejemplo, o imágenes de salida. Esto hace posible generar con precisión secciones de código que contienen resultados precisos.