Re: [docbook-apps] Show off what you've done with Docbook

Hello Róbert,

    
      

        
I have a question about how your HTML docs work: 

        
For example, at http://dev.mysql.com/doc/refman/5.6/en/tutorial.html
          there is a list of multiple books and a search bar on the
          left. Is this part external to docbook, or do you use some
          webhelp tweak to do it? (I've been trying to use webhelp with
          <set> to achieve similar results, but couldn't sort out
          all the bugs so far.)

      

    
    The sidebar is part of the overall website layout which is
    maintained by our web team. For the online readable formats, we sync
    over the HTML output from DocBook to which we add a specially
    crafted PHP "header" that makes the HTML integrate smoothly we the
    site layout. The solutions works but is kind of hack-ish, so we hope
    to replace soon it with a simpler solution that requires us to sync
    over plain old XHTML.

    

    Cheers,

    

    Stefan 

    
      

        

        

        
Thanks!

        

        

        
Robert

      

      

        
On Mon, Sep 14, 2015 at 6:48 PM, Stefan
          Hinz <>
          wrote:

          Hi,

              

              
                Have any of you PDF + HTML output with Docbook? If
                anyone has such a project and will be willing to show it
                off, send some URLs!

              
              

            
            The MySQL documentation is created and maintained in DocBook
            XML. The entry point to the docs is here:

            

            http://dev.mysql.com/doc/

            

            As you can see, we build a lot of formats from DocBook,
            including Unix man pages which are created from the same
            source as the rest of the formats (most documentation teams
            maintain man pages separately).

            

            Last time we cared to do a detailed analysis of our stuff
            was in 2009; here's a summary:

            

            http://dev.mysql.com/doc/index-about.html

            

            It's only become more in every respect, more products to
            cover, more books, more pages, more complexity. We get the
            "why don't you use X instead, it's so much better" question
            every once in a while, but DocBook has been working
            remarkably well for us for more than a decade, and it
            scales, so we have no plans to move away from it anytime
            soon.

            

            Reasons to consider DocBook in the first place included
            Norm's (http://docbook.org/tdg/en/html/docbook.html)
            and Bob's (http://www.sagehill.net/docbookxsl/)
            great books, by the way. :-)

            

            Cheers,

            

            Stefan

                

                -- 

                Oracle <http://www.oracle.com>

                Stefan Hinz, MySQL Documentation Manager

                Oracle MySQL <http://dev.mysql.com/doc>

                Berlin, Germany, +49-30-82702940
            

              

                

                

---------------------------------------------------------------------

                To unsubscribe, e-mail: 

                For additional commands, e-mail: 

                

              

            

          
        

        

      

    
    

    
--
      
        
          

            

               Stefan Hinz, MySQL
                Documentation Manager

                Oracle MySQL

                Berlin, Germany, +49-30-82702940