Asciidoctor :: Discussion

Wrapping each line of verse in a ? [Rime of the Ancient Mariner]

_‹ Previous Topic Next Topic _›

Classic

List

Threaded

3 messages Options

sethwoodworth

Sep 19, 2014; 7:59pm

Wrapping each line of verse in a ? [Rime of the Ancient Mariner]

I have a fork of the Project Gutenberg copy of Rime of the Ancient Mariner.
The format is a simple text file of the poem.
I've been looking around at markup formats, and I really like asciidoc.
So I'm porting *Rime* to asciidoc.

With a couple of hours of doc reading, I was able to make a really great looking rendered html copy of the poem.
The source is on github automatically rendered into also pretty nice looking html.

I'm looking for some advice about how to correctly tag for verse in asciidoc.
The book is broken into 7 sections with `== PART THE NTH`.
Then I wrap the internal text with:

[verse]
____
... text
____

Does this sound like the right semantic markup?

Separate question, how should I extend verse block rendering to:
- wrap each line with a span.line
- wrap each paragraph break with p.stanza

My understanding is I should probably make a new backend (template?) like this erb html verse parser from asciidoctor-backends?

--Seth

jxxcarlson

Sep 20, 2014; 4:25am

Re: Wrapping each line of verse in a ? [Rime of the Ancient Mariner]

I prefer this solution:

[verse]
--
<TEXT OF POEM>
--

Of course if there is a complicated format, this won't work.
But the idea is to define [verse] so that "inside" it you do
not have to do anything. See, for example,

http://www.noteshare.io/notebook/90/?note=592

mojavelinux

Sep 20, 2014; 11:40pm

Re: Wrapping each line of verse in a ? [Rime of the Ancient Mariner]

Administrator

Any of these are equally correct:

[source,asciidoc]

----

[verse]
____
<TEXT OF POEM>
____

----

[source,asciidoc]

----

[verse]

----

[source,asciidoc]

----

[verse]

----

As you suggested, the most convenient way to custom the output is to supply a custom template. I much prefer haml or slim over erb because it's more human readable.

Here's an example of how you would accomplish your two goals.

First, create the file verse.html.slim:

.verse.html.slim

[source,slim]

----

.verseblock id=@id class=role

- if title?

.title=title

pre.content

=content.gsub(/^.+$/, '\0').gsub(/(.+?)(?:\n\n|\Z)/m, %(\n\\1))

- attribution = (attr? :attribution) ? (attr :attribution) : nil

- citetitle = (attr? :citetitle) ? (attr :citetitle) : nil

- if attribution || citetitle

.attribution

- if citetitle

cite=citetitle

- if attribution

- if citetitle

| — #{attribution}

----

The key line is the one containing the gsub calls. The first gsub wraps a around any non-blank line. The second gsub wraps a around contiguous lines (i.e., lines in a single stanza).

Put the file verse.html.slim in a folder named templates (or whatever you want to call it), then invoke Asciidoctor as:

$ asciidoctor -T templates rime.adoc

Make sure you the slim, tilt and, optionally, thread_safe gems:

$ gem install slim tilt thread_safe

Good luck!

-Dan

On Fri, Sep 19, 2014 at 10:25 PM, jxxcarlson [via Asciidoctor :: Discussion] <[hidden email]> wrote:

I prefer this solution:

[verse]
--
<TEXT OF POEM>
--

Of course if there is a complicated format, this won't work.
But the idea is to define [verse] so that "inside" it you do
not have to do anything. See, for example,

http://www.noteshare.io/notebook/90/?note=592

If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Wrapping-each-line-of-verse-in-a-span-Rime-of-the-Ancient-Mariner-tp2253p2254.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

... [show rest of quote]

Dan Allen | http://google.com/profiles/dan.j.allen

Wrapping each line of verse in a <span>? [Rime of the Ancient Mariner]

Wrapping each line of verse in a <span>? [Rime of the Ancient Mariner]

Re: Wrapping each line of verse in a <span>? [Rime of the Ancient Mariner]

Re: Wrapping each line of verse in a <span>? [Rime of the Ancient Mariner]