[hibernate-dev] Publishing documentation as rendered by asciidoc

Guillaume SCHEIBEL guillaume.scheibel at gmail.com
Tue Oct 7 14:15:27 EDT 2014


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
>>>
>>
>>
>


More information about the hibernate-dev mailing list