search

dagwieers / asciidoc-odf

ODF backend for AsciiDoc
98 stars 26 forks source link

Better admonitions #12

Closed dagwieers closed 12 years ago

dagwieers commented 12 years ago

Currently admonitions are made using a frame with 2 columns and the left column shows the picture and has a column-break. Using columns was far more practical than using tables for admonitions, however if someone can do it I'd like to learn how to do it using tables !

However, one of the problems is that the default AsciiDoc icons have a lot of white pixels around it, making it harder to position properly. And it would be useful to have standard SVG icons instead as ODF supports SVG as well.

Some themes (eg. Red Hat documentation) is using boxes with a colored background.

Another item to look at is making the admonitions show text-labels when icons are not enabled, or icons were not found.

dagwieers commented 12 years ago

Current admonitions implementation works with icon and without icon support. Good enough for most cases !

dagwieers commented 12 years ago

Admonitions are now implemented using 2-column sections. This is much more simple, but as powerful as using frames. The benefit is that sections follow normal text-flow and break as one would expect. Frames are much harder as they are not part of normal text-flow and text editing might move frames around.