diff options
author | Stuart Rackham <srackham@methods.co.nz> | 2011-11-13 18:25:46 +1300 |
---|---|---|
committer | Stuart Rackham <srackham@methods.co.nz> | 2011-11-13 18:25:46 +1300 |
commit | e0df8b83336461b12f7e9a41ad054c0b894698b5 (patch) | |
tree | 0e9ec2f1bfd95a35d6501cfb82fb252e0eb7d027 /doc | |
parent | 65f2db84696927a2b60a8c274dd7614fa16320d9 (diff) | |
download | asciidoc-e0df8b83336461b12f7e9a41ad054c0b894698b5.tar.gz |
The {blockname} is the block style (lists and delimited blocks) so
that custom styles (e.g. 'source' for source highlighter filter) are
emitted; eliminates reundant bullet list blocknames.
Diffstat (limited to 'doc')
-rw-r--r-- | doc/asciidoc.txt | 32 |
1 files changed, 17 insertions, 15 deletions
diff --git a/doc/asciidoc.txt b/doc/asciidoc.txt index 3c8c73b..2522b12 100644 --- a/doc/asciidoc.txt +++ b/doc/asciidoc.txt @@ -804,11 +804,13 @@ The IDs are generated by the following algorithm: `idprefix` attribute is not defined. - A numbered suffix (`_2`, `_3` ...) is added if a same named auto-generated section ID exists. -- If the `ascii-ids` attribute is defined then non-ASCII characters are - stripped from auto-generated IDs. +- If the `ascii-ids` attribute is defined then non-ASCII characters + are stripped from auto-generated IDs. This attribute may be + deprecated in future releases and *should be avoided*, it's sole + purpose is to accomodate deficient downstream applications that + cannot process non-ASCII ID attributes. -For example the title 'Jim's House' would generate the ID -`_jim_s_house`. +Example: the title 'Jim's House' would generate the ID `_jim_s_house`. Section ID synthesis can be disabled by undefining the `sectids` attribute. @@ -4635,20 +4637,20 @@ predefined intrinsic attributes: 7. See http://en.wikipedia.org/wiki/Non-English_usage_of_quotation_marks[non-English usage of quotation marks]. -8. The `{blockname}` attribute identifies the current block. It - applies to delimited block, lists and tables. Here is a list of - `{blockname}` values: +8. The `{blockname}` attribute identifies the style of the current + block. It applies to delimited blocks, lists and tables. Here is a + list of `{blockname}` values (does not include filters or custom + block and style names): - delimited blocks:: 'comment', 'sidebar', 'open', 'pass', 'literal', - 'verse', 'listing', 'quote', 'example', 'note', 'tip', 'important', - 'caution', 'warning', 'abstract, 'partintro' + delimited blocks:: comment, sidebar, open, pass, literal, verse, + listing, quote, example, note, tip, important, caution, warning, + abstract, partintro - lists:: 'bulleted', 'bulleted1 ... bulleted5', 'numbered1 ... - numbered5', 'labeled', 'labeled2 .. labeled4', 'arabic', - 'loweralpha', 'upperalpha', 'lowerroman', 'upperroman', 'qanda', - 'horizonatal', 'callout', 'bibliography', 'glossary' + lists:: arabic, loweralpha, upperalpha, lowerroman, upperroman, + labeled, labeled3, labeled4, qanda, horizonatal, bibliography, + glossary - tables:: 'table' + tables:: table ====== |