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(a)hibernate.org&gt; 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(a)lists.jboss.org > https://lists.jboss.org/mailman/listinfo/hibernate-dev > _______________________________________________ hibernate-dev mailing list hibernate-dev(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/hibernate-dev

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(a)hibernate.org&gt; 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(a)gmail.com&gt; 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(a)hibernate.org&gt; 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(a)lists.jboss.org >> > https://lists.jboss.org/mailman/listinfo/hibernate-dev >> > >> _______________________________________________ >> hibernate-dev mailing list >> hibernate-dev(a)lists.jboss.org >> https://lists.jboss.org/mailman/listinfo/hibernate-dev >> > >

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(a)gmail.com&gt; 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(a)gmail.com&gt; > 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(a)hibernate.org&gt; 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(a)gmail.com&gt; 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(a)hibernate.org&gt; 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(a)lists.jboss.org >>>> > https://lists.jboss.org/mailman/listinfo/hibernate-dev >>>> > >>>> _______________________________________________ >>>> hibernate-dev mailing list >>>> hibernate-dev(a)lists.jboss.org >>>> https://lists.jboss.org/mailman/listinfo/hibernate-dev >>> >>> >> >

hi Guillaume, great progress! In Google's Chrome it looks almost ok, not quite as the headers we have on the docs published at [1] but I guess you can easily fix that. On Firefox, it looks odd. There is something being repeated all over along the whole document.. I hope you can see the same, or let me know if I should send you a screenshot? On the speed: I'm very interested what command you use as that would be helpful when writing docs; but I see it didn't apply replacements such as {hibernateVersion} and similar. Is that a tradeoff we have to pay for quick previews, or can you trick it somehow? thanks a lot for your help, Sanne On 8 October 2014 19:09, Guillaume SCHEIBEL <guillaume.scheibel(a)gmail.com&gt; wrote: > Hi there, > > Here [1] is the first draft of the HSearch documentation. > I've just worked on the background image (the gradient at the top) and the > title / banner. > > Let me know your thoughts. > > > BTW, to generate the CSS file and build the documentation (HTML5 single > page) it takes: > > real 0m1.584s > user 0m1.073s > sys 0m0.220s > > So pretty fast ins't it. > > Cheers > Guillaume > > [1] > https://www.dropbox.com/s/tzp90mvtbpuirhg/hibernate%20search%20doc.zip?dl=0 > > On 7 October 2014 19:33, Sanne Grinovero <sanne(a)hibernate.org&gt; wrote: >> >> 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(a)gmail.com&gt; 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(a)gmail.com&gt; >> > 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(a)hibernate.org&gt; 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(a)gmail.com&gt; 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(a)hibernate.org&gt; 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(a)lists.jboss.org >> >>>> > https://lists.jboss.org/mailman/listinfo/hibernate-dev >> >>>> > >> >>>> _______________________________________________ >> >>>> hibernate-dev mailing list >> >>>> hibernate-dev(a)lists.jboss.org >> >>>> https://lists.jboss.org/mailman/listinfo/hibernate-dev >> >>> >> >>> >> >> >> > > >

On 9 Jan 2014, at 13:01, Sanne Grinovero <sanne(a)hibernate.org&gt; wrote: > hi Guillaume, great progress! > In Google's Chrome it looks almost ok, not quite as the headers we > have on the docs published at [1] but I guess you can easily fix that. > On Firefox, it looks odd. There is something being repeated all over > along the whole document.. I hope you can see the same, or let me know > if I should send you a screenshot? For what it's worth, I can confirm this repetition of the background Sanne describes. On a tangent and related to style fixes. Not sure whether other projects already use Java 8 for building, but there are yet again changes to the javadoc doclet output leading to badly rendered output. We have this problem with Validator's docs [1] and there is a related design issue [2]. I am wondering whether the design team could help to make sure that the L&F of reference and java docs are matching. That said, afaict the issue has quite low priority for them :-( --Hardy _______________________________________________ hibernate-dev mailing list hibernate-dev(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/hibernate-dev