On 5 November 2017 at 10:54, Dan Allen <[email protected]> wrote:
> discrete means it's hidden from the structure. A discrete heading.

Ahh, ok, "discrete" as in individual, separate from the rest (ie the
structure).  Maybe it should have been "discreet" as in quiet, not
advertised, hidden from the TOC. :)

As we just demonstrated neither leaps to mind, but they are both
documented, so thats fine :)

>
> DocBook calls them bridge headings, but I think that's misleading as well.
>
> On Nov 4, 2017 18:01, "Lex Trotman" <[email protected]> wrote:
>>
>> On 5 November 2017 at 09:00, Dan Allen <[email protected]> wrote:
>> > discrete is only implemented in Asciidoctor. I added it as an
>> > alternative
>> > since float makes no sense to me.
>>
>> Yes, certainly this use of "float" is inconsistent with the
>> traditional use with tables and figures that means they can move
>> relative to the text, "floating section titles" don't move relative to
>> the text.  But where does "discrete" come from?
>>
>> Cheers
>> Lex
>>
>> >
>> > On Nov 4, 2017 13:07, "Shep" <[email protected]> wrote:
>> >>
>> >> Perfect!
>> >>
>> >> And using [float] works consistently across PDF, ePub and xhtml.
>> >>
>> >> ...
>> >>
>> >>
>> >>
>> >> [float]
>> >> Some sub-heading
>> >> ~~~~~~~~~~~~~~
>> >>
>> >>
>> >> ...
>> >>
>> >>
>> >> The sub-heading renders as the appropriate type (level) of sub-heading
>> >> in
>> >> terms of styling (font, color, size, etc.), but is not numbered as a
>> >> sub-section (no "3.1" or any numbered prefix, just the heading title)
>> >> and
>> >> doesn't appear in the TOC.
>> >>
>> >> As I say, perfect for what I want to do.
>> >>
>> >> On Saturday, November 4, 2017 at 2:39:55 AM UTC-5, Shep wrote:
>> >>>
>> >>> Hi,
>> >>>
>> >>> I'm trying to create a sub-heading that doesn't appear in the ToC and
>> >>> isn't numbered, but is still rendered as a sub-heading. I believe this
>> >>> is
>> >>> also referred to as a "floating" heading.
>> >>>
>> >>> Basic asciidoc:
>> >>>
>> >>> :toc:
>> >>> = Section example
>> >>>
>> >>> == Introduction
>> >>>
>> >>> Simple introduction section.
>> >>>
>> >>> == More
>> >>>
>> >>> There is more information in this document.
>> >>>
>> >>>
>> >>> That renders as you would expect.
>> >>>
>> >>> Now, add discrete:
>> >>>
>> >>> :toc:
>> >>> = Section example
>> >>>
>> >>> [discrete]
>> >>> == Introduction
>> >>>
>> >>> Simple introduction section.
>> >>>
>> >>> == More
>> >>>
>> >>> There is more information in this document.
>> >>>
>> >>>
>> >>> This now generates an error:
>> >>>
>> >>> Shep:Asciidoc sandbox AJTSheppard$ a2x -fpdf -dbook
>> >>> discrete-example.txt
>> >>> -v
>> >>>
>> >>> a2x: args: ['-fpdf', '-dbook', 'discrete-example.txt', '-v']
>> >>>
>> >>> a2x: resource files: []
>> >>>
>> >>> a2x: resource directories: ['/opt/local/etc/asciidoc/images',
>> >>> '/opt/local/etc/asciidoc/stylesheets']
>> >>>
>> >>> a2x: executing: "/opt/local/bin/asciidoc" --backend docbook -a
>> >>> "a2x-format=pdf"  --doctype book --verbose  --out-file
>> >>> "/Users/AJTSheppard/Documents/Writing/Asciidoc
>> >>> sandbox/discrete-example.xml"
>> >>> "/Users/AJTSheppard/Documents/Writing/Asciidoc
>> >>> sandbox/discrete-example.txt"
>> >>>
>> >>>
>> >>> asciidoc: reading: /opt/local/etc/asciidoc/asciidoc.conf
>> >>>
>> >>> asciidoc: reading: /Users/AJTSheppard/Documents/Writing/Asciidoc
>> >>> sandbox/discrete-example.txt
>> >>>
>> >>> asciidoc: reading: /opt/local/etc/asciidoc/docbook45.conf
>> >>>
>> >>> asciidoc: reading:
>> >>> /opt/local/etc/asciidoc/filters/code/code-filter.conf
>> >>>
>> >>> asciidoc: reading:
>> >>> /opt/local/etc/asciidoc/filters/graphviz/graphviz-filter.conf
>> >>>
>> >>> asciidoc: reading:
>> >>> /opt/local/etc/asciidoc/filters/latex/latex-filter.conf
>> >>>
>> >>> asciidoc: reading:
>> >>> /opt/local/etc/asciidoc/filters/music/music-filter.conf
>> >>>
>> >>> asciidoc: reading:
>> >>> /opt/local/etc/asciidoc/filters/source/source-highlight-filter.conf
>> >>>
>> >>> asciidoc: reading: /opt/local/etc/asciidoc/lang-en.conf
>> >>>
>> >>> asciidoc: writing: /Users/AJTSheppard/Documents/Writing/Asciidoc
>> >>> sandbox/discrete-example.xml
>> >>>
>> >>> asciidoc: WARNING: discrete-example.txt: line 5: missing section:
>> >>> [discrete]
>> >>>
>> >>>
>> >>> a2x: executing: "xmllint" --nonet --noout --valid
>> >>> "/Users/AJTSheppard/Documents/Writing/Asciidoc
>> >>> sandbox/discrete-example.xml"
>> >>>
>> >>>
>> >>> /Users/AJTSheppard/Documents/Writing/Asciidoc
>> >>> sandbox/discrete-example.xml:15: element book: validity error :
>> >>> Element book
>> >>> content does not follow the DTD, expecting ((title , subtitle? ,
>> >>> titleabbrev?)? , bookinfo? , (dedication | toc | lot | glossary |
>> >>> bibliography | preface | chapter | reference | part | article |
>> >>> appendix |
>> >>> index | setindex | colophon)*), got (bookinfo simpara chapter )
>> >>>
>> >>> </book>
>> >>>
>> >>>        ^
>> >>>
>> >>>
>> >>> a2x: ERROR: "xmllint" --nonet --noout --valid
>> >>> "/Users/AJTSheppard/Documents/Writing/Asciidoc
>> >>> sandbox/discrete-example.xml"
>> >>> returned non-zero exit status 4
>> >>>
>> >>>
>> >>> Same for ePub and xhtml as targets.
>> >>
>> >> --
>> >> You received this message because you are subscribed to the Google
>> >> Groups
>> >> "asciidoc" group.
>> >> To unsubscribe from this group and stop receiving emails from it, send
>> >> an
>> >> email to [email protected].
>> >> To post to this group, send email to [email protected].
>> >> Visit this group at https://groups.google.com/group/asciidoc.
>> >> For more options, visit https://groups.google.com/d/optout.
>> >
>> > --
>> > You received this message because you are subscribed to the Google
>> > Groups
>> > "asciidoc" group.
>> > To unsubscribe from this group and stop receiving emails from it, send
>> > an
>> > email to [email protected].
>> > To post to this group, send email to [email protected].
>> > Visit this group at https://groups.google.com/group/asciidoc.
>> > For more options, visit https://groups.google.com/d/optout.
>>
>> --
>> You received this message because you are subscribed to the Google Groups
>> "asciidoc" group.
>> To unsubscribe from this group and stop receiving emails from it, send an
>> email to [email protected].
>> To post to this group, send email to [email protected].
>> Visit this group at https://groups.google.com/group/asciidoc.
>> For more options, visit https://groups.google.com/d/optout.
>
> --
> You received this message because you are subscribed to the Google Groups
> "asciidoc" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to [email protected].
> To post to this group, send email to [email protected].
> Visit this group at https://groups.google.com/group/asciidoc.
> For more options, visit https://groups.google.com/d/optout.

-- 
You received this message because you are subscribed to the Google Groups 
"asciidoc" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at https://groups.google.com/group/asciidoc.
For more options, visit https://groups.google.com/d/optout.

Reply via email to