[hibernate-dev] Publishing documentation as rendered by asciidoc

[Sanne Grinovero]

I think I like the "asciidoctor" theme the best, particularly the
fonts, but I guess it's quite irrelevant considering the aim for
Steve's point 2#.

On 7 October 2014 19:15, Guillaume SCHEIBEL
<guillaume.scheibel at gmail.com> wrote:
> I would go with Foundation but I'd like to have your opinion on that guys
>
> On 7 October 2014 19:14, Guillaume SCHEIBEL <guillaume.scheibel at gmail.com>
> wrote:
>>
>> I agree with you Steve #1 is the best option.
>> Which asciidoctor theme do you think is the best to use as a "model" for
>> the Hibernate Style sheet (http://themes.asciidoctor.org/preview/) ?
>>
>> On 7 October 2014 19:09, Steve Ebersole <steve at hibernate.org> wrote:
>>>
>>> IMO, the most important thing is the banners.  In terms of most
>>> everything else we generally run into disagreements (rendering back-ticked
>>> words, e.g.).  I guess I see 2 options:
>>> 1) Start from the simplest.  Just account for the top banner (the images
>>> mainly).  From there work on the individual pieces as (if) they come up.
>>> 2) Start with the assumption of making the asciidoc(tor) output look
>>> *exactly* the same as the docbook output.
>>>
>>> Personally I prefer #1 for quite a few reasons
>>>
>>>
>>> On Tue, Oct 7, 2014 at 1:01 PM, Guillaume SCHEIBEL
>>> <guillaume.scheibel at gmail.com> wrote:
>>>>
>>>> Hey,
>>>>
>>>> I've spoken with Sanne and it can be done by using the asciidoctor
>>>> stylesheet-factory.
>>>> I'll try to create a first draft. Any specific requirements other than
>>>> it
>>>> should look exactly the same ?
>>>>
>>>> Cheers,
>>>> Guillaume
>>>>
>>>> On 7 October 2014 18:26, Sanne Grinovero <sanne at hibernate.org> wrote:
>>>>
>>>> > Hi all,
>>>> > I would love to publish the documentation the way it looks like from
>>>> > the asciidoc rendering (before the transformations via docbook), as it
>>>> > looks like much more readable.
>>>> >
>>>> > But I'd like to keep our style and branding rather than the default
>>>> > docbook template; did someone already experiment with that? Or could
>>>> > anyone volunteer please as my design skills are better avoided :-)
>>>> >
>>>> > Cheers,
>>>> > Sanne
>>>> > _______________________________________________
>>>> > hibernate-dev mailing list
>>>> > hibernate-dev at lists.jboss.org
>>>> > https://lists.jboss.org/mailman/listinfo/hibernate-dev
>>>> >
>>>> _______________________________________________
>>>> hibernate-dev mailing list
>>>> hibernate-dev at lists.jboss.org
>>>> https://lists.jboss.org/mailman/listinfo/hibernate-dev
>>>
>>>
>>
>