Re: Adding Words to Title Causes Errors
Posted by
mojavelinux on
Dec 05, 2018; 7:48pm
URL: https://discuss.asciidoctor.org/Adding-Words-to-Title-Causes-Errors-tp6627p6635.html
Abel correctly pointed out that the title text and the underline must be the same length.
Usually, I would advocate for changing it to an ATX (single-line) section heading as Abel suggested. But I think there is a good reason why this book uses the underline style. That's an implicit way to enable compatibility mode. If that's the case, then you don't want to change anyway it as it could break other syntax.
Just make sure the two lines are the same length and you'll be all good!
Cheers,
-Dan
On Wed, Dec 5, 2018 at 7:45 AM Jon Forrest [via Asciidoctor :: Discussion] <
[hidden email]> wrote:
On 12/5/2018 12:16 AM, abelsromero [via Asciidoctor :: Discussion] wrote:
> The issue comes from title underline that uses Markdown syntax.
> It should be the same length as the title text.
That was the cause of the problem!! Thanks for pointing this
out.
> Most of the book already uses normal Asciidoctor syntax for titles (=
> prefix), I'd recommend replacing it to avoid this kind of issues.
I'm taking the existing book and making changes to the text. I'm
not planning on making any changes to the Asciidoc constructs since
I don't really know what I'm doing.
> Btw, I run the book with v 1.5.6.1 and 1.5.8 successfully, I also
> recommend to update to the last version, just change the Gemfile.
That's probably a good idea but I want to track the original book
as closely as possible so I'm not going to do that. If I were
starting from scratch though, I'd definitely do that.
Thanks again for solving my problem.
Jon Forrest
--