On 17 août, 23:05, Stuart Rackham <[email protected]> wrote:
> This rather long post details a BREAKING CHANGE.
>
> Currently quoted elements can be preceded by an attributes list which can
> include up to three positional attributes (color, background color and
> size) and a 'role' named attribute. Examples:
>
> [green,#b0e0e6,2]##fun with text##.
> [role="input"]*x = 25*
>
> The positional attributes are only applicable to HTML backends and
> they emit hard-coded CSS styles; the 'role' attribute emits DocBook
> 'role' attributes and HTML 'class' attributes. The number and mixed
> applicability of these style related attributes is messy and difficult
> to remember.
>
> The whole thing can be replaced by a single positional attribute which
> translates to HTML 'class' attributes:
>
> - Directly using the AsciiDoc HTML backends.
> - Indirectly using the 'docbook' backend (DocBook XSL Stylesheets
> translate DocBook 'phrase' elements with 'role' attributes to HTML
> 'span' elements with the same 'class' attributes; CSS is then used
> http://www.sagehill.net/docbookxsl/UsingCSS.html[to style the
> generated HTML]).
mmmh... What about other outputs from DocBook? I am pretty sure lots
of people use the 'role' attribute through FOP or dblatex. What
happens in such cases?
>
> Examples:
>
> [red]#obvious#
> [big red yellowback]*very obvious*
>
> The following CSS rules for 'big', 'red' and 'yellowback' class names could
> be used to style outputs generated by the previous examples:
>
> span.big { font-size: 2em; }
> span.red { color: #e3372e; }
> span.yellowback { background: #faf519; }
>
> .Pros
> - Allows CSS styling to be applied to both DocBook and HTML outputs
> from the same AsciiDoc source.
> - Role names are more obvious and easier to remember than the
> color and size positional arguments.
> - CSS affords arbitrary styling.
> - The new attribute can specify multiple class names.
>
> .Cons
> - Breaks existing quote attribute behavior.
> - You need to create CSS rules.
>
> I've committed a changeset that implements this
> enhancement:http://code.google.com/p/asciidoc/source/detail?r=99df82275a29bec4f73...
>
> To revert to the deprecated quote behavior define the 'deprecated-quotes'
> attribute in the global `asciidoc.conf` file or on the command-line.
>
> Apologies for any inconvenience that this regression may cause.
>
> Cheers, Stuart
--
You received this message because you are subscribed to the Google Groups
"asciidoc" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/asciidoc?hl=en.
