Chris Jones | 3 Feb 00:57
Picon

Is there such as thing as numbered labeled lists?

I am writing an FAQ and found that some of the answers are a little on
the long side and would best be split into 2-3 paragraphs.

The presentation I had in mind looks somewhat like this:

|
| 1. Question one
| 
|    abcdefgh abcdefgh abcdefgh abcdefgh
|    abcdefgh abcdefgh abcdefgh abcdefgh
| 
|    abcdefgh abcdefgh abcdefgh abcdefgh
|    abcdefgh abcdefgh abcdefgh abcdefgh
|    abcdefgh abcdefgh abcdefgh abcdefgh
| 
| 2. Question two
| 
|    abcdefgh abcdefgh abcdefgh abcdefgh
|    abcdefgh abcdefgh abcdefgh abcdefgh
|
| 3. Question three
| 
|    abcdefgh abcdefgh abcdefgh abcdefgh
| 
|    abcdefgh abcdefgh abcdefgh abcdefgh
|    abcdefgh abcdefgh abcdefgh abcdefgh
|
| etc.

I thought I'd use the labeled list form (::), but I haven't been able to
(Continue reading)

Lex Trotman | 3 Feb 01:34
Picon

Re: Is there such as thing as numbered labeled lists?

On Fri, Feb 3, 2012 at 10:57 AM, Chris Jones <cjns1989@...> wrote:
> I am writing an FAQ and found that some of the answers are a little on
> the long side and would best be split into 2-3 paragraphs.
>
> The presentation I had in mind looks somewhat like this:
>
> |
> | 1. Question one
> |
> |    abcdefgh abcdefgh abcdefgh abcdefgh
> |    abcdefgh abcdefgh abcdefgh abcdefgh
> |
> |    abcdefgh abcdefgh abcdefgh abcdefgh
> |    abcdefgh abcdefgh abcdefgh abcdefgh
> |    abcdefgh abcdefgh abcdefgh abcdefgh
> |
> | 2. Question two
> |
> |    abcdefgh abcdefgh abcdefgh abcdefgh
> |    abcdefgh abcdefgh abcdefgh abcdefgh
> |
> | 3. Question three
> |
> |    abcdefgh abcdefgh abcdefgh abcdefgh
> |
> |    abcdefgh abcdefgh abcdefgh abcdefgh
> |    abcdefgh abcdefgh abcdefgh abcdefgh
> |
> | etc.
>
(Continue reading)

Chris Jones | 3 Feb 03:24
Picon

Re: Is there such as thing as numbered labeled lists?

On Thu, Feb 02, 2012 at 07:34:23PM EST, Lex Trotman wrote:
> On Fri, Feb 3, 2012 at 10:57 AM, Chris Jones <cjns1989@...> wrote:

> > I am writing an FAQ and found that some of the answers are a little
> > on the long side and would best be split into 2-3 paragraphs.

[..]

> You can't combine two list types in the same paragraph.
> 
> To achieve your result use multi paragraph numbered lists.  You have
> to manually attach the extra paragraphs to the list item:
> 
> . Question one
> +
> blah de blah blahblah de blah blahblah de blah blahblah de blah
> blahblah de blah blah
> +
> blab de blab blabblab de blab blabblab de blab blabblab de blab
> blabblab de blab blab
> 
> . Question 2
> +
> foo de foo foo
> foo de foo foo
> foo de foo foo
> foo de foo foo
> foo de foo foo
> +
> lorem ipsum etc etc lorem ipsum etc etc lorem ipsum etc etc lorem
(Continue reading)

Lex Trotman | 3 Feb 03:41
Picon

Re: Is there such as thing as numbered labeled lists?

[...]
>
> I was unable to find a description of this technique in the User Guide..

See http://www.methods.co.nz/asciidoc/userguide.html#X15

[...]
>> PS just a hint, as became apparent with the Asciidoc FAQ, the question
>> numbers for FAQs should be fixed, so references to FAQ #55 will always
>> remain correct.
>
> Good point.. but what if the FAQ reaches a size where it needs a major
> overhaul..? I mean.. FAQ #55 becomes FAQ #3.12 - e.g...
>
> Backward compatibility also has its drawbacks..

Yep, you can't win em all.

Maybe I'm just a bit sensitive, but we had a *very* irate series of ML
posts from a user complaining that a two month old reply to a
different user quoted an irrelevant FAQ enty.  This was because new
FAQs had been added in the meantime.  Now new FAQs are posted to the
end of the list, but they are less visible.

[...]

> But all the same, I'm glad you mentioned it.. and assuming the source of
> the FAQ is written in asciidoc, I would be quite interested in taking
> a look at it.

(Continue reading)

Chris Jones | 3 Feb 15:39
Picon

Re: Is there such as thing as numbered labeled lists?

On Thu, Feb 02, 2012 at 09:41:14PM EST, Lex Trotman wrote:

[...]

> > I was unable to find a description of this technique in the User Guide..
> 
> See http://www.methods.co.nz/asciidoc/userguide.html#X15

Ouch.. :-(

Rather than refer to the manual, I rely on a collection of templates for
lists, blocks, tables, that I put together when I started with
asciidoc.. and it appears I missed this. 

Thanks,

CJ

--

-- 
You received this message because you are subscribed to the Google Groups "asciidoc" group.
To post to this group, send email to asciidoc@...
To unsubscribe from this group, send email to asciidoc+unsubscribe@...
For more options, visit this group at http://groups.google.com/group/asciidoc?hl=en.

Grant Edwards | 3 Feb 18:05
Picon

Re: Is there such as thing as numbered labeled lists?

On 2012-02-03, Chris Jones <cjns1989@...> wrote:

>> PS just a hint, as became apparent with the Asciidoc FAQ, the question
>> numbers for FAQs should be fixed, so references to FAQ #55 will always
>> remain correct.
>
> Good point.. but what if the FAQ reaches a size where it needs a major
> overhaul..? I mean.. FAQ #55 becomes FAQ #3.12 - e.g...

Then I wouldn't use numbers as references.  Make sure each FAQ has a
unique and not-too-long "title", and use that title when referring to
the FAQ.

-- 
Grant Edwards               grant.b.edwards        Yow! MERYL STREEP is my
                                  at               obstetrician!
                              gmail.com            

--

-- 
You received this message because you are subscribed to the Google Groups "asciidoc" group.
To post to this group, send email to asciidoc@...
To unsubscribe from this group, send email to asciidoc+unsubscribe@...
For more options, visit this group at http://groups.google.com/group/asciidoc?hl=en.

Qingping Hou | 6 Feb 09:05
Picon
Gravatar

Deck.js backend for AsciiDoc, an alternative to slidy

Hi all,

I write a deck.js backend for ascdoc to cut down my work when writing
deck.js slides. Currently it supports all the standard features, but
not third-party extensions.

project page:
http://houqp.github.com/asciidoc-deckjs/

a demo slide written with asciidoc:
http://houqp.github.com/asciidoc-deckjs/tutorial-slide.html

Hope you enjoy this. :-)

---
Best Regards,
Dave Hou

--

-- 
You received this message because you are subscribed to the Google Groups "asciidoc" group.
To post to this group, send email to asciidoc@...
To unsubscribe from this group, send email to asciidoc+unsubscribe@...
For more options, visit this group at http://groups.google.com/group/asciidoc?hl=en.

Dag Wieers | 6 Feb 13:30
Favicon
Gravatar

Re: Deck.js backend for AsciiDoc, an alternative to slidy

On Mon, 6 Feb 2012, Qingping Hou wrote:

> I write a deck.js backend for ascdoc to cut down my work when writing
> deck.js slides. Currently it supports all the standard features, but
> not third-party extensions.
>
> project page:
> http://houqp.github.com/asciidoc-deckjs/
>
> a demo slide written with asciidoc:
> http://houqp.github.com/asciidoc-deckjs/tutorial-slide.html
>
> Hope you enjoy this. :-)

Looks really nice ! :)

-- 
-- dag wieers, dag@..., http://dag.wieers.com/
-- dagit linux solutions, info@..., http://dagit.net/

[Any errors in spelling, tact or fact are transmission errors]

--

-- 
You received this message because you are subscribed to the Google Groups "asciidoc" group.
To post to this group, send email to asciidoc@...
To unsubscribe from this group, send email to asciidoc+unsubscribe@...
For more options, visit this group at http://groups.google.com/group/asciidoc?hl=en.

Qingping Hou | 6 Feb 14:31
Picon
Gravatar

Re: Deck.js backend for AsciiDoc, an alternative to slidy

Yes, Deck.js itself comes with many beautiful themes. :-)

Also many people wrote interesting extensions for it, which you can
find out at this page:
https://github.com/imakewebthings/deck.js/wiki

I haven't had enough time to add these extensions into the backend yet.

On Mon, Feb 6, 2012 at 8:30 PM, Dag Wieers <dag@...> wrote:
> On Mon, 6 Feb 2012, Qingping Hou wrote:
>
>> I write a deck.js backend for ascdoc to cut down my work when writing
>> deck.js slides. Currently it supports all the standard features, but
>> not third-party extensions.
>>
>> project page:
>> http://houqp.github.com/asciidoc-deckjs/
>>
>> a demo slide written with asciidoc:
>> http://houqp.github.com/asciidoc-deckjs/tutorial-slide.html
>>
>> Hope you enjoy this. :-)
>
>
> Looks really nice ! :)
>
> --
> -- dag wieers, dag@..., http://dag.wieers.com/
> -- dagit linux solutions, info@..., http://dagit.net/
>
(Continue reading)

Stuart Rackham | 6 Feb 21:51
Picon

Re: Deck.js backend for AsciiDoc, an alternative to slidy

Hi Qingping

That's really nice.

I've added it the list of 'Documents written using AsciiDoc' 
(http://www.methods.co.nz/asciidoc/#X2). If you get time to package it up into a 
downloadable plugin that would be great and I'll add it to the backend plugins 
list (http://www.methods.co.nz/asciidoc/plugins.html).

Cheers, Stuart

On 06/02/12 21:05, Qingping Hou wrote:
> Hi all,
>
> I write a deck.js backend for ascdoc to cut down my work when writing
> deck.js slides. Currently it supports all the standard features, but
> not third-party extensions.
>
> project page:
> http://houqp.github.com/asciidoc-deckjs/
>
> a demo slide written with asciidoc:
> http://houqp.github.com/asciidoc-deckjs/tutorial-slide.html
>
> Hope you enjoy this. :-)
>
> ---
> Best Regards,
> Dave Hou
>
(Continue reading)


Gmane