[hibernate-dev] Publishing documentation as rendered by asciidoc
steve at hibernate.org
Tue Oct 7 14:09:25 EDT 2014
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