<html>
<head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type">
</head>
<body text="#000000" bgcolor="#FFFFFF">
Agreed. At some point I'm thinking we need to place these pages in
'doc' or some other directory so we can build it for the portal or
where ever it will reside.. I had thought Asciidoctor, but if
Redoculous is better, that's fine.<br>
<br>
<div class="moz-cite-prefix">On 09/12/2014 11:48 AM, Lincoln Baxter,
III wrote:<br>
</div>
<blockquote
cite="mid:CAEp_U4Eq20xCUW+wnyUGM3w4MKLYZ3PFhS5+spmgPua9MZaz-Q@mail.gmail.com"
type="cite">
<div dir="ltr">
<div>GitHub uses Asciidoctor to render their asciidoc files.</div>
<div><br>
</div>
One major point of AsciiDoctor is that it allows you to
customize your rendering. If we want custom CSS, we should not
use Github Wiki directly, and instead use something like
Redoculous, which is what the Forge website uses to render its
docs and display them in its own CSS:
<div><br>
</div>
<div><a moz-do-not-send="true"
href="http://redoculous-lincolnbaxter.rhcloud.com/api/v1/preview?repo=https://github.com/windup/windup.wiki.git&path=/Rules:%20Rules%20Development%20Guide.asciidoc&ref=master">http://redoculous-lincolnbaxter.rhcloud.com/api/v1/preview?repo=https://github.com/windup/windup.wiki.git&path=/Rules:%20Rules%20Development%20Guide.asciidoc&ref=master</a></div>
<div><br>
</div>
<div>(looks like I need to fix a bug in some of the link
handling, but you should get the idea. It lets you embed docs
directly from github into a webapp: <a moz-do-not-send="true"
href="http://forge.jboss.org/document/develop-an-addon">http://forge.jboss.org/document/develop-an-addon</a>
)</div>
<div><br>
</div>
<div>~Lincoln<br>
<div><br>
</div>
<div><br>
<div><br>
</div>
<div><br>
</div>
</div>
</div>
</div>
<div class="gmail_extra"><br>
<div class="gmail_quote">On Thu, Sep 11, 2014 at 5:17 PM, Ondrej
Zizka <span dir="ltr"><<a moz-do-not-send="true"
href="mailto:ozizka@redhat.com" target="_blank">ozizka@redhat.com</a>></span>
wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0
.8ex;border-left:1px #ccc solid;padding-left:1ex">
<div bgcolor="#FFFFFF" text="#000000"> I posted it to
AsciiDoc. But they don't share my opinion that <p>
in <li> is a wrong idea.<br>
<a moz-do-not-send="true"
href="https://groups.google.com/forum/#%21topic/asciidoc/BF9HlACuNjE"
target="_blank">https://groups.google.com/forum/#!topic/asciidoc/BF9HlACuNjE</a><br>
<br>
They have an unfortunate mix of "DocBook legacy" and
forward compatibility.<br>
But it's a bit configurable. Dan wrote:<br>
<br>
<div>It's also pretty each to change by hacking the
html5.conf file:</div>
<div><br>
</div>
<div>----</div>
<div>
<div>[paragraph]</div>
<div>{title?<div
class="title">{title}</div>}<br>
</div>
<div><p class="paragraph{role?
{role}}{unbreakable-option? unbreakable}"{id?
id="{id}"}></div>
<div>|</div>
<div></p></div>
</div>
<div>----<br>
<br>
We could ask GitHub to change that for li I guess.<br>
Or, as I suggested earlier, find out if GitHub allows to
apply per-project CSS.<br>
<br>
Ondra<br>
</div>
<div>
<div class="h5"> <br>
<br>
<br>
<div>On 11.9.2014 22:23, Sande Gilda wrote:<br>
</div>
</div>
</div>
<blockquote type="cite">
<div>
<div class="h5"> This is interesting. GitHub uses
Asciidoctor to render the asciidoc files!<br>
<br>
Ondra, where did you report this issue? If you
didn't report it to Asciidoctor, I will.<br>
<div><br>
<br>
-------- Original Message --------
<table border="0" cellpadding="0" cellspacing="0">
<tbody>
<tr>
<th nowrap="nowrap" valign="BASELINE"
align="RIGHT">Subject: </th>
<td>Re: GitHub problem rendering AsciiDoc
lists</td>
</tr>
<tr>
<th nowrap="nowrap" valign="BASELINE"
align="RIGHT">Date: </th>
<td>Thu, 11 Sep 2014 10:08:00 -0700</td>
</tr>
<tr>
<th nowrap="nowrap" valign="BASELINE"
align="RIGHT">From: </th>
<td>Jess Hosman (GitHub Staff) <a
moz-do-not-send="true"
href="mailto:support@github.com"
target="_blank"><support@github.com></a></td>
</tr>
<tr>
<th nowrap="nowrap" valign="BASELINE"
align="RIGHT">To: </th>
<td>Sande Gilda <a moz-do-not-send="true"
href="mailto:sgilda@redhat.com"
target="_blank"><sgilda@redhat.com></a></td>
</tr>
</tbody>
</table>
<br>
<br>
<pre>Hi Sande,
Thanks for your patience. After some digging, it looks like we use the third party tool Asciidoctor [1] for the conversion, which is where the extra `<p>` tags are coming from. I'd recommend opening an issue in the Asciidoctor repo about this. Once changes are made there, we should be able to pull them into GitHub.
Cheers,
Jess
[1]: <a moz-do-not-send="true" href="https://github.com/asciidoctor/asciidoctor" target="_blank">https://github.com/asciidoctor/asciidoctor</a>
</pre>
<br>
</div>
<br>
<br>
<fieldset></fieldset>
<br>
</div>
</div>
<span class="">
<pre>_______________________________________________
windup-dev mailing list
<a moz-do-not-send="true" href="mailto:windup-dev@lists.jboss.org" target="_blank">windup-dev@lists.jboss.org</a>
<a moz-do-not-send="true" href="https://lists.jboss.org/mailman/listinfo/windup-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/windup-dev</a></pre>
</span></blockquote>
<br>
</div>
<br>
_______________________________________________<br>
windup-dev mailing list<br>
<a moz-do-not-send="true"
href="mailto:windup-dev@lists.jboss.org">windup-dev@lists.jboss.org</a><br>
<a moz-do-not-send="true"
href="https://lists.jboss.org/mailman/listinfo/windup-dev"
target="_blank">https://lists.jboss.org/mailman/listinfo/windup-dev</a><br>
</blockquote>
</div>
<br>
<br clear="all">
<div><br>
</div>
-- <br>
Lincoln Baxter, III<br>
<a moz-do-not-send="true" href="http://ocpsoft.org"
target="_blank">http://ocpsoft.org</a><br>
"Simpler is better."
</div>
</blockquote>
<br>
</body>
</html>