[hibernate-dev] Publishing documentation as rendered by asciidoc
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>
> 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:
>>> I've spoken with Sanne and it can be done by using the asciidoctor
>>> I'll try to create a first draft. Any specific requirements other than it
>>> should look exactly the same ?
>>> 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
More information about the hibernate-dev