Ah, I think I understand what's going on now.
As Lex mentioned, when you omit the title, it's still making an example
block, it's just not getting labeled as an example block (so it might
appear like it's just a regular paragraph). If you look at the source code
generated, you'll see it does use an example element variant in both cases.
What this really seems to be about is having an example *caption* without
an example *title*. AsciiDoc (and the DocBook toolchain) only adds a
caption (e.g., Example 1) when the example block has a title (the same goes
for other types of blocks).
There are a few approaches to getting the caption without a title.
Approach #1: Trick AsciiDoc/DocBook into thinking there is a title using a
space character
.{zwsp}
====
example block content
====
This should appear as:
*Example 1.*
example block content
Approach #2: Use the title to output the caption
.{example-caption} {counter:example-number}.
====
example block content
====
This should also appear as:
*Example 1.*
example block content
These workarounds are necessary because you are working around the
convention that a caption (e.g., Example 1) should only be used when there
is also a title.
The final option is to customize the template in the backend so that it
always uses the caption even in the absence of a title. See the html5.conf
or docbook45.conf files for the template you need to customize.
-Dan
On Thu, May 23, 2013 at 5:13 PM, Eduardo Santana <[email protected]>wrote:
> Hi Dan,
>
> I know the title is optional, but when I don't use it, it doesn't turn
> into an example block.
>
>
> ====
> Qui in magna commodo, est labitur dolorum an. Est ne magna primis
> adolescens.
> ====
>
> .This box turns into an example because it has a title.
> ====
> Qui in magna commodo, est labitur dolorum an. Est ne magna primis
> adolescens.
> ====
>
>
> My question is, how can I create an example box without using the title...
>
> It should be only Example 1...
>
> Em quinta-feira, 23 de maio de 2013 19h03min30s UTC-3, Dan Allen escreveu:
>>
>> Yep, that's allowed. The block title is optional on all delimited blocks.
>>
>> -Dan
>>
>>
>> On Thu, May 23, 2013 at 2:19 PM, Eduardo Santana <[email protected]>wrote:
>>
>>> At
>>> http://www.methods.co.nz/**asciidoc/userguide.html#X48<http://www.methods.co.nz/asciidoc/userguide.html#X48>we
>>> can see how to create example blocks.
>>>
>>> But how can we create it without having to put a title?
>>>
>>> .An example
>>> ==============================**==============================**=========
>>> Qui in magna commodo, est labitur dolorum an. Est ne magna primis
>>> adolescens.
>>> ==============================**==============================**=========
>>>
>>> Not an example:
>>>
>>> ==============================**==============================**=========
>>> Qui in magna commodo, est labitur dolorum an. Est ne magna primis
>>> adolescens.
>>> ==============================**==============================**=========
>>>
>>>
>>> --
>>> 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 asciidoc+u...@**googlegroups.com.
>>> To post to this group, send email to [email protected].
>>>
>>> Visit this group at
>>> http://groups.google.com/**group/asciidoc?hl=en<http://groups.google.com/group/asciidoc?hl=en>
>>> .
>>> For more options, visit
>>> https://groups.google.com/**groups/opt_out<https://groups.google.com/groups/opt_out>
>>> .
>>>
>>>
>>>
>>
>>
>>
>> --
>> Dan Allen |
>> http://google.com/profiles/**dan.j.allen<http://google.com/profiles/dan.j.allen>
>>
> --
> 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 http://groups.google.com/group/asciidoc?hl=en.
> For more options, visit https://groups.google.com/groups/opt_out.
>
>
>
--
Dan Allen | http://google.com/profiles/dan.j.allen
--
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 http://groups.google.com/group/asciidoc?hl=en.
For more options, visit https://groups.google.com/groups/opt_out.
