Adicionei um arquivo BUGS pra saber o que ainda pode ser melhorado ou consertado.

Author: Patola

BUGS.md

@@ -0,0 +1,5 @@
+* As figuras inline não aparecem no epub se o asciidoctor-epub3 for usado. Isto é bug do próprio software.DO mesmo jeito, as fórmulas matemáticas, que são convertidas para figuras inline, não vão pro documento final em epub e mobi.
+* As fórmulas matemáticas são simples figuras. Eu tentei de outros modos, e por exemplo asciimath funciona para algumas mídias (viria MathML no backend xhtml5) mas não funciona pra outras (não aparece no PDF). O modo mais universal para elas é as escrever em latex mesmo no documento e usar a tag latexmath, junto com o require asciidoctor-mathematical.
+* O realce de sintaxe funciona de forma inconsistente. Eu fiz meu próprio léxico para gcode através da ferramenta rouge e configurei nas tags para isso. No entanto, ele coloriza alguns segmentos de código e outros não. Funciona mais ou menos em todos os formatos de renderização, no entanto.
+* Tabelas perdem os contornos e parte da formatação quando passadas para os formatos de ebook (epub, mobi e azw3).
+* Não consegui achar ainda maneira de fazer referências cruzada das figuras com a menção delas pelo número. Todos os números como por exemplo "Figura 15" que aparecem fora da legenda foram "marretados" no texto.