|
AsciiDoc User Guide |
|
and figures. |
Verbatim element |
The word verbatim indicates that white space and line breaks in the source |
|
document are to be preserved in the output document. |
A. Migration Notes
Version 6 to version 7
The changes that affect the most users relate to renamed and deprecated backends and command-line syntax:
1.The html backend has been renamed html4.
2.The xhtml backend has been deprecated to xhtml-deprecated (use the new xhtml11 backend in preference).
3.The use of CSS specific css and css-embedded backends has been dropped in favor of using attributes (see the table below and xhtml backend attributes).
4.Deprecated features that emitted warnings in prior versions are no longer tolerated.
5.The command-line syntax for deleting (undefining) an attribute has changed from -a ^name to -a
name!.
Table A.1. Equivalent command-line syntax
Version 6 (old) |
Version 7 (new) |
Version 7 (backward |
|
|
compatible) |
|
|
|
-b html |
-b html4 |
-b html4 |
|
|
|
-b css |
-b xhtml11 -a linkcss -a |
-b xhtml-deprecated -a |
|
icons |
css -a linkcss -a icons |
|
|
|
-b css-embedded |
-b xhtml11 -a icons |
-b xhtml-deprecated -a |
|
|
css -a icons |
|
|
|
-b xhtml |
-b xhtml11 |
-b xhtml-deprecated |
|
|
|
-b docbook-sgml |
-b docbook -a sgml |
-b docbook -a sgml |
|
|
|
If you've customised version 6 distribution stylesheets then you'll need to either bring them in line with the new ./stylesheets/xhtml11*.css class and id names or stick with the backward compatible xhtml-deprecated backend.
Changes to configuration file syntax:
1.To undefine an attribute in the [attributes] section use name! instead of name (name now sets that
78