Changing colours

[russel]

The colours of adoc mode when using Emacs light on dark do not really work. The basic text colour is fine as is the section heads (though the section fonts are too big relative to the text size). But listing etc. annotations being very dark grey and the small red footnote font makes these things completely unreadable.

What is the official way of changing the colours on a per user basis?

[nicorikken]

As described in previous tickets #11 #13 and #20 you can set the customize-group markup-faces.

@sensorflo 3 of my near colleagues use Emacs (or Spacemacs) for most things except for Asciidoc editing. They use the https://github.com/asciidoctor/atom-language-asciidoc project instead (which I helped make as great as it is 😄 ). All cite the font rendering as the objection to using the Asciidoc mode. A more explicit/elaborate documentation would be great (for all the Emacs noobs out there, like me), and a command like adoc-normalize-fontsize could be a relatively simple feature to make it a more welcoming experience. I'd be happy to make a separate issue of this, and maybe contribute.

[CyberShadow]

There are a few things that can be fixed in this package to improve the situation:

• Using the conditional clauses of defface, which allow defining different face attributes depending on whether the text is displayed on a light or dark background;
• Using the :distant-foreground face property to specify an alternate color for dark backgrounds;
• Making the faces descend from the ones defined in font-lock.el, thus reusing the user's existing color theme.

However, it looks like this package has been abandoned.

[dunmaksim]

@CyberShadow , package fork now is here https://github.com/bbatsov/adoc-mode