[hibernate-dev] Publishing documentation as rendered by asciidoc

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


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