DocBook based CSS conversion

We are in the process of migrating the Hibernate ORM documentation from DocBook to Asciidoc(tor).  One hang up is the styling/branding.  We have spent a lot of time developing the CSS used to style the DocBook output over the years and would like to apply at least some of those stylizations to the Asciidoctor rendered output as well.  We know asciidoc->docbook->html is an option, though obviously less than ideal.  So any pointers on converting CSS developed for DocBook to AsciiDoctor/Foundation?

---

If you reply to this email, your message will be added to the discussion below:

http://discuss.asciidoctor.org/DocBook-based-CSS-conversion-tp4002.html

To start a new topic under Asciidoctor :: Discussion, email <a href="javascript:_e(%7B%7D,&#39;cvml&#39;,&#39;ml-node%2Bs49171n1h37@n6.nabble.com&#39;);" target="_blank">ml-node+s49171n1h37@...
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

Steve,

I'm glad to hear Hibernate ORM is joining the Asciidoctor revolution. As the heart of Hibernate, I know this migration is a big deal.

As you mentioned, you could go through DocBook and reuse all the same styling you already have. But obviously, it's nice to cut out steps if possible.

There's no special requirement to create CSS for Asciidoctor HTML output. It's entirely possible just to start from scratch and hand code all the CSS.

Of course, since no one wants to do that, we start with Bootstrap, Foundation or similar. It normalizes browser styles, sets sane defaults and provides a bunch of helpers.

We chose Foundation for the default stylesheet and the stylesheet factory in Asciidoctor, but that's not a hard requirement. Some people use Bootstrap instead.

Any technical designer should have no trouble porting the existing look you have with DocBook to the Asciidoctor HTML in one day, and maybe a few more for refinements. I know because I've done it dozens of times. It's just a code rewrite.

I recommend to the designer to use the stylesheet factory as a reference, but don't feel bound to using it.

-Dan