[windup-dev] Asciidoc - lists

Tue Sep 9 18:26:45 EDT 2014

That's because there are two \n's. AsciiDoc does that even with

* foo
* bar

Ondra

On 9.9.2014 17:32, Sande Gilda wrote:
> Ondra, it looks like Markdown has the same problem rendering lists.
>
> See:
> https://github.com/jboss-developer/jboss-eap-quickstarts/blob/6.4.x-develop/README.md#introduction
>
> On 09/09/2014 10:18 AM, Pete Muir wrote:
>> I took a look at this, and it looks like a problem with the github css for the output. I think you could file a bug with them about it.
>>
>> I guess a good question here is whether the wiki is just for editing, OR if it’s actually how we will present this stuff?
>>
>> On 9 Sep 2014, at 12:45, Sande Gilda <sgilda at redhat.com> wrote:
>>
>>> One of Ondra's complaints is the way lists seem to display an extra paragraph between the items.  Take a look at the home page here: https://github.com/windup/windup/wiki
>>>
>>> Note that the list items are spaced far apart. I search for a solution, and the only thing I could find was mention of using [options="compact"], but it didn't seem to work.
>>>
>>> Ondra, what other issues did you have.
>>>
>>>
>>> On 09/09/2014 06:39 AM, Pete Muir wrote:
>>>> The big advantages of asciidoc are:
>>>>
>>>> * more comprehensive markup (e.g. tables, definition lists are supported as standard)
>>>> * generation of pdf and epub is part of the standard toolchain
>>>>
>>>> Markdown is great for short docs, but I quickly ran in to the limitations when building more complex documents.
>>>>
>>>> GitHub’s support for asciidoc wasn’t great to start with, but I think the fixed it more recently. Before you abandon it, point me at the problems, I can take a quick look.
>>>>
>>>> I prefer asciidoc links as you just do link:
>>>> http://redhat.com
>>>> [Red Hat’s website]. I find this much easier to remember than the weird []() syntax in markdown.
>>>>
>>>> On 9 Sep 2014, at 01:23, Sande Gilda
>>>> <sgilda at redhat.com>
>>>>    wrote:
>>>>
>>>>
>>>>> I'll change everything back to Markdown later this week. Ondra, in the
>>>>> meantime, you can work in Markdown.
>>>>>
>>>>> On 09/08/2014 08:12 PM, Brad Davis wrote:
>>>>>
>>>>>> I personally leveraged Markdown because it worked.  Asciidoc a while ago did not.  I noticed when things moved to Asciidoc, the images in the docs broke.
>>>>>>
>>>>>> Brad Davis
>>>>>> Red Hat Consulting
>>>>>> Email:
>>>>>> bdavis at redhat.com | c: 980.226.7865 | http://www.redhat.com
>>>>>>
>>>>>>
>>>>>>
>>>>>> ----- Original Message -----
>>>>>> From: "Ondrej Zizka"
>>>>>> <ozizka at redhat.com>
>>>>>>
>>>>>> To: "Sande Gilda"
>>>>>> <sgilda at redhat.com>, "Windup-dev List" <windup-dev at lists.jboss.org>
>>>>>>
>>>>>> Sent: Monday, September 8, 2014 7:58:20 PM
>>>>>> Subject: Re: [windup-dev] Asciidoc - lists
>>>>>>
>>>>>> For the record: I don't strongly prefer either, only that I only touched
>>>>>> few things in AsciiDoc, and:
>>>>>>     1) certain constructs are quite less readable -> editable in the
>>>>>> source text (e.g. links)
>>>>>>     2) the render results are not satisfactory - things like a bold text
>>>>>> in a lists are not properly implemented on whatever GitHub uses.
>>>>>>
>>>>>> Ondra
>>>>>>
>>>>>>
>>>>>> On 9.9.2014 01:17, Sande Gilda wrote:
>>>>>>
>>>>>>> Hi all,
>>>>>>>
>>>>>>> Ondra asked me about the advantages of AsciiDoc over Markdown. I
>>>>>>> really don't know, but I do remember Pete saying AsciiDoc would be
>>>>>>> better for the quickstart README files long ago. And I believe Drupal,
>>>>>>> the new host for documentation, supports AsciiDoc.
>>>>>>>
>>>>>>> TBH, I don't feel strongly about sticking with AsciiDoc. If no one can
>>>>>>> come up with a good reason for sticking with it, I'm fine with going
>>>>>>> back to Markdown if it's easier for everyone.
>>>>>>>
>>>>>>> So, AsciiDoc advocates, please speak up now.
>>>>>>>
>>>>>>> Thanks,
>>>>>>> Sande
>>>>>>>
>>>>>>> On 09/08/2014 06:29 PM, Sande Gilda wrote:
>>>>>>>
>>>>>>>> Hi Ondra,
>>>>>>>>
>>>>>>>> You're asking me? ;-)
>>>>>>>>
>>>>>>>> I'm totally new to asciidoc. I'll research it and see what I can find
>>>>>>>> out.
>>>>>>>>
>>>>>>>> Thanks,
>>>>>>>> Sande
>>>>>>>>
>>>>>>>> On 09/08/2014 06:13 PM, Ondrej Zizka wrote:
>>>>>>>>
>>>>>>>>> Hi Sande,
>>>>>>>>>
>>>>>>>>> is there any way to prevent asciidoc put <p> to each <li>? Makes the
>>>>>>>>> list tall and breaks the whole page layout.
>>>>>>>>>
>>>>>>>>> Thanks,
>>>>>>>>> Ondra
>>>>>>>>>
>>>>>> _______________________________________________
>>>>>> windup-dev mailing list
>>>>>>
>>>>>> windup-dev at lists.jboss.org
>>>>>> https://lists.jboss.org/mailman/listinfo/windup-dev
>>>>> _______________________________________________
>>>>> windup-dev mailing list
>>>>>
>>>>> windup-dev at lists.jboss.org
>>>>> https://lists.jboss.org/mailman/listinfo/windup-dev
>>>> _______________________________________________
>>>> windup-dev mailing list
>>>>
>>>> windup-dev at lists.jboss.org
>>>> https://lists.jboss.org/mailman/listinfo/windup-dev
>>> _______________________________________________
>>> windup-dev mailing list
>>> windup-dev at lists.jboss.org
>>> https://lists.jboss.org/mailman/listinfo/windup-dev
>> _______________________________________________
>> windup-dev mailing list
>> windup-dev at lists.jboss.org
>> https://lists.jboss.org/mailman/listinfo/windup-dev
> _______________________________________________
> windup-dev mailing list
> windup-dev at lists.jboss.org
> https://lists.jboss.org/mailman/listinfo/windup-dev