Attempt to render EPUB less ugly

Mark Craig

19.38.2011 0bdc9f6ae604758a6cf2ed0e635a99b6cca81ebc

Attempt to render EPUB less ugly

 opendj3/pom.xml

@@ -227,7 +227,6 @@
           </font>
          </fonts>

          <htmlStylesheet>css/coredoc.css</htmlStylesheet>
          <sectionAutolabel>true</sectionAutolabel>
          <sectionLabelIncludesComponentLabel>true</sectionLabelIncludesComponentLabel>
        </configuration>
@@ -240,23 +239,39 @@
            </goals>
            <configuration>
              <epubCustomization>${dbstyle-dir}/epub/coredoc.xsl</epubCustomization>
              
              <!-- docbkx-tools does not seem to support multiple embedded
                   fonts for epub format, missing exslt. -->
              <epubEmbeddedFonts>DejaVuSans</epubEmbeddedFonts>
              <!-- Resources required but not copied by DocBook.xsl. -->
              <preProcess>
                <copy todir='${docbkx-out}/epub/admin-guide/OpenDJ-Admin-Guide/images'>
                  <fileset dir='${docbkx-src}/admin-guide/images' />
                </copy>
                <copy todir='${docbkx-out}/epub/admin-guide/OpenDJ-Admin-Guide'>
                  <fileset dir='${basedir}/src/main/resources' />
                </copy>
                <copy todir='${docbkx-out}/epub/dev-guide/OpenDJ-Dev-Guide/images'>
                  <fileset dir='${docbkx-src}/dev-guide/images' />
                </copy>
                <copy todir='${docbkx-out}/epub/dev-guide/OpenDJ-Dev-Guide'>
                  <fileset dir='${basedir}/src/main/resources' />
                </copy>
                <copy
                  todir='${docbkx-out}/epub/install-guide/OpenDJ-Install-Guide/images'>
                  <fileset dir='${docbkx-src}/install-guide/images' />
                </copy>
                <copy
                  todir='${docbkx-out}/epub/install-guide/OpenDJ-Install-Guide'>
                  <fileset dir='${basedir}/src/main/resources' />
                </copy>
                <copy
                  todir='${docbkx-out}/epub/release-notes/OpenDJ-Release-Notes/images'>
                  <fileset dir='${docbkx-src}/release-notes/images' />
                </copy>
                <copy
                  todir='${docbkx-out}/epub/release-notes/OpenDJ-Release-Notes'>
                  <fileset dir='${basedir}/src/main/resources' />
                </copy>
              </preProcess>
            </configuration>
          </execution>

 opendj3/src/main/docbkx-stylesheets/epub/coredoc.xsl

@@ -27,5 +27,29 @@
 version="1.0">
 <xsl:import href="urn:docbkx:stylesheet" />

<!--  <xsl:param name="epub.embedded.fonts">TODO... DejaVuSerif.otf,DejaVuSerif-Italic.otf, etc.</xsl:param> -->
 <xsl:param name="html.longdesc" select="0" />
 <xsl:param name="html.stylesheet">css/epub.css</xsl:param>
 
 <xsl:param name="variablelist.term.separator"></xsl:param>
 <xsl:param name="variablelist.term.break.after">1</xsl:param>
 <xsl:param name="generate.toc">
  appendix  nop
  article/appendix  nop
  article   nop
  book      toc,title
  chapter   nop
  part      toc,title
  preface   nop
  qandadiv  nop
  qandaset  nop
  reference toc,title
  sect1     nop
  sect2     nop
  sect3     nop
  sect4     nop
  sect5     nop
  section   nop
  set       toc,title
 </xsl:param>
 <xsl:param name="toc.section.depth" select="0" />
</xsl:stylesheet>

 opendj3/src/main/docbkx-stylesheets/html/chunked.xsl

@@ -27,6 +27,7 @@
 version="1.0">
 <xsl:import href="urn:docbkx:stylesheet" />

 <xsl:param name="html.stylesheet">css/coredoc.css</xsl:param>
 <xsl:param name="chunk.section.depth" select="0" />
 <xsl:param name="chunker.output.encoding">UTF-8</xsl:param>
 <xsl:param name="chunker.output.indent">yes</xsl:param>

 opendj3/src/main/docbkx-stylesheets/html/coredoc.xsl

@@ -26,6 +26,8 @@
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
 version="1.0">
 <xsl:import href="urn:docbkx:stylesheet" />

 <xsl:param name="html.stylesheet">css/coredoc.css</xsl:param>
 <xsl:param name="generate.legalnotice.link" select="1" />
 <xsl:param name="root.filename">index</xsl:param>
 <xsl:param name="use.id.as.filename" select="1" />

 opendj3/src/main/resources/css/epub.css

New file
@@ -0,0 +1,152 @@
/*
 * CCPL HEADER START
 *
 * This work is licensed under the Creative Commons
 * Attribution-NonCommercial-NoDerivs 3.0 Unported License.
 * To view a copy of this license, visit
 * http://creativecommons.org/licenses/by-nc-nd/3.0/
 * or send a letter to Creative Commons, 444 Castro Street,
 * Suite 900, Mountain View, California, 94041, USA.
 * 
 * You can also obtain a copy of the license at
 * trunk/opendj3/legal-notices/CC-BY-NC-ND.txt.
 * See the License for the specific language governing permissions
 * and limitations under the License.
 *
 * If applicable, add the following below this CCPL HEADER, with the fields
 * enclosed by brackets "[]" replaced with your own identifying information:
 *     Portions Copyright [yyyy] [name of copyright owner]
 *
 * CCPL HEADER END
 *
 *     Copyright 2011 ForgeRock AS
 *    
 */

/*
 * ForgeRock core documentation styles to be used with EPUB
 * generated from DocBook 5 XML source.
 */
 
/*
 * Basic content and text styles
 */
body
{
  font-family: DejaVuSans;
  font-size: small;
  margin-left: auto;
  margin-right: auto;
  color: #333;
}

a
{
  text-decoration: none; /* Do not underline links. */
}

a:link {
  color:#47a;
}

a:visited {
  color:#68a;
}

a:active, a:hover {
  color:#990000;
}

code,.command>strong,div.literallayout,.filename
{
  font-family: monospace;
}

code,.command,.copyright,div.index,div.literallayout>p,.filename,h3.author,.term,.step
{
  font-weight: normal;
}

h1
{
  color: #626D75; /* ForgeRock gray */
  font-size: x-large;
}

h2,h3,h4,h5,h6
{
  color: #333;
}

h2
{
  font-size: large;
}

h3
{
  font-size: medium;
}

h4
{
  font-size: medium;
}

h5
{
  font-size: medium;
}

ul
{
  list-style-image: url("../images/bulletpoint.png");
}

/*
 * Block elements
 */
pre.programlisting,pre.screen
{
  font-size: xx-small;
  white-space: pre;
  background-color: #fafafa;
  border: thin dashed #ccc;
  padding: 3px;
}

div.abstract,div.important,div.caution,div.note,div.tip,div.warning,div.example,div.toc
{
  border: thin dotted #ccc;
  padding: 3px;
}

div.chapter,div.preface
{
  border-bottom: thin solid #ccc; 
}

.important,.caution,.note,.tip,.warning
{
  font-style: italic;
}

.abstract,.example,.toc
{
  margin: 3px;
}

img
{
  max-width: 100%;
  height: auto;
  max-height: 100%;
}

/*
 * Man pages
 */
.refnamediv>h2,.refsect1>h2,.refsynopsisdiv>h2
{
  font-size: medium;
}