Usando los mismos updates que habia hecho encontre algunos bug, entre ellos 👀 mal procesamiento de las direcciones de salidas 👀 (mia culpa por no hacer todas las pruebas necesarias) y no los pude arreglar de inmediato , el pull #7 cubre esos errores más unos pequeños cambios cosméticos :) .

Set the or similar badge to mark projects that use illiterate.

Hola, primero quiciera dar gracias por la herramienta, es muy útil. También quiciera proponer una pequeña característica (si estan aceptando este tipo de retroalimentación claro).
Sería que el comando illiterate corra siguiendo una archivo de configuración si es que este existe.

Ahora explico a que se debe.

Hace unos meses empecé a hacer un proyecto pequeño pero que tenía varias partes privadas y alguna que otra documentación extra que no estaba embebida en el código y cada vez que tenía que correr el comando era realmente un incordio navegar por 60 archivos de documentación cuando realmente quería exponer la documentación de alrededor de 20 archivos (que al final se lograba configurando la navegación de mkdocs). Además de que tenía que añadir 6 archivos extra con el comando copy . Para este tipo de proyecto sería mas útil (a mi entender) un archivito de configuración donde pongan todo eso de una vez y ya.

PD:

Estaba revisando el proyecto de autogoal los otros días (pura curiosidad) y vi que esta característica también les seria útil a ustedes a la hora de documentar ese proyecto (es grande y tiene varios modulos privados que seguro comentan pero no exponen la documentación). Salu2s y disculpen la molestia.

Disculpen por el título tan malo del issue 😐

The following is an example of a reference to another code element (class or module):

However, it has to be specified thinking in the Markdown that will be generated. Could it be possible to make the reference using the code element, something like ref::illiterate.code.Parser?
This might require some mapping between the Python code and the Markdown documents to know the section where each class has been explained and will definitively make the parser more complex. But it might be a nice little touch :)

El comando illiterate preset build falla parcialmente. Estoy en ello.