I cannot coerce AsciiDoc to generate an acknowledgements section -- perhaps
because it is only supported in DocBook 5.x.* I am wondering what others do*.
The answer
here:
https://groups.google.com/forum/#!searchin/asciidoc/acknowledgements/asciidoc/fPIi1qkHiSQ/RGUE6eFuz1sJ
did not provide me with enough information. This toolchain is mostly new to
me, so I need some hand holding.
Here are the solutions I have tried.
*Defining acknowledgements as a preface*
This is the only version that created valid DocBook output. This means I
generated two prefaces, with the first having the id _preface. The only
drawback with this that I see is that, like the dedication and existing
preface, this does not appear in the out of the box generated PDF (perhaps
I am doing something wrong there).
ifdef::backend-docbook[]
[preface]
Acknowledgements
================
First, the obligatory but oh so true statement. This work is wholly my
responsibility. Any errors contained herein are mine alone.
Few, if any projects, are ever developed in a vacuum. They depend upon the
thought and wisdom of those who have gone before, providing the seeds of
further ideas. For all that have gone before, I am deeply indebted. Some
people deserve special acclamation for the help they provided -- whether
directly or indirectly. I feel like an Oscar winner who recognizes the need
to thank everyone and will undoubtedly forget someone deserving of
attention. For those I have missed, I apologize. I wish to make clear, too,
that this work is wholly my responsibility. Any errors contained herein are
mine alone.
I'd like to thank the following individuals, without whose contributions,
this work would unintelligible: my friends.
endif::backend-docbook[]
Which generated:
<preface id="_acknowledgements">
<title>Acknowledgements</title>
<simpara>First, the obligatory but oh so true statement. This work is
wholly my responsibility. Any errors contained herein are mine
alone.</simpara>
<simpara>Few, if any projects, are ever developed in a vacuum. They depend
upon the thought and wisdom of those who have gone before, providing the
seeds of further ideas. For all that have gone before, I am deeply
indebted. Some people deserve special acclamation for the help they
provided — whether directly or indirectly. I feel like an
Oscar winner who recognizes the need to thank everyone and will undoubtedly
forget someone deserving of attention. For those I have missed, I
apologize. I wish to make clear, too, that this work is wholly my
responsibility. Any errors contained herein are mine alone.</simpara>
<simpara>I’d like to thank the following individuals, without whose
contributions, this work would unintelligible: my friends.</simpara>
</preface>
*Creating a chapter*
A chapter was created within the preface -- this trailed the [preface] not
to be confused with preface above. Chapter is not valid within a preface --
nor do I want it there. Acknowledgements feels to me like it should be at
the same level as preface and dedication.
ifdef::backend-docbook[]
== Acknowledgements
First, the obligatory but oh so true statement. This work is wholly my
responsibility. Any errors contained herein are mine alone.
Few, if any projects, are ever developed in a vacuum. They depend upon the
thought and wisdom of those who have gone before, providing the seeds of
further ideas. For all that have gone before, I am deeply indebted. Some
people deserve special acclamation for the help they provided -- whether
directly or indirectly. I feel like an Oscar winner who recognizes the need
to thank everyone and will undoubtedly forget someone deserving of
attention. For those I have missed, I apologize. I wish to make clear, too,
that this work is wholly my responsibility. Any errors contained herein are
mine alone.
I'd like to thank the following individuals, without whose contributions,
this work would unintelligible: my friends.
endif::backend-docbook[]
Which generated:
<preface>
*{my preface output}*
<chapter id="_acknowledgements">
<title>Acknowledgements</title>
<simpara>First, the obligatory but oh so true statement. This work is
wholly my responsibility. Any errors contained herein are mine
alone.</simpara>
<simpara>Few, if any projects, are ever developed in a vacuum. They depend
upon the thought and wisdom of those who have gone before, providing the
seeds of further ideas. For all that have gone before, I am deeply
indebted. Some people deserve special acclamation for the help they
provided — whether directly or indirectly. I feel like an
Oscar winner who recognizes the need to thank everyone and will undoubtedly
forget someone deserving of attention. For those I have missed, I
apologize. I wish to make clear, too, that this work is wholly my
responsibility. Any errors contained herein are mine alone.</simpara>
<simpara>I’d like to thank the following individuals, without whose
contributions, this work would unintelligible: my friends.</simpara>
</chapter>
</preface>
*Creating a section*
The code below generates a section. The generated simpara is not valid. It
is an unexpected element.
ifdef::backend-docbook[]
Acknowledgements
================
First, the obligatory but oh so true statement. This work is wholly my
responsibility. Any errors contained herein are mine alone.
Few, if any projects, are ever developed in a vacuum. They depend upon the
thought and wisdom of those who have gone before, providing the seeds of
further ideas. For all that have gone before, I am deeply indebted. Some
people deserve special acclamation for the help they provided -- whether
directly or indirectly. I feel like an Oscar winner who recognizes the need
to thank everyone and will undoubtedly forget someone deserving of
attention. For those I have missed, I apologize. I wish to make clear, too,
that this work is wholly my responsibility. Any errors contained herein are
mine alone.
I'd like to thank the following individuals, without whose contributions,
this work would unintelligible: my friends.
endif::backend-docbook[]
Which generated:
<part id="_acknowledgements">
<title>Acknowledgements</title>
<simpara>First, the obligatory but oh so true statement. This work is
wholly my responsibility. Any errors contained herein are mine
alone.</simpara>
<simpara>Few, if any projects, are ever developed in a vacuum. They depend
upon the thought and wisdom of those who have gone before, providing the
seeds of further ideas. For all that have gone before, I am deeply
indebted. Some people deserve special acclamation for the help they
provided — whether directly or indirectly. I feel like an
Oscar winner who recognizes the need to thank everyone and will undoubtedly
forget someone deserving of attention. For those I have missed, I
apologize. I wish to make clear, too, that this work is wholly my
responsibility. Any errors contained herein are mine alone.</simpara>
<simpara>I’d like to thank the following individuals, without whose
contributions, this work would unintelligible: Venkat Subramanium, Doug
DesCombaz and Manoj Sahu.</simpara>
</part>
Thanks for the advice!
--
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.
For more options, visit https://groups.google.com/groups/opt_out.
