Partial fix for COMMWEB-36: Use make.clean.html and docbook.css.source for ...

Mark Craig

07.21.2012 b201fd5bcdb85c8db42618df2b8c510752be38f0

Partial fix for COMMWEB-36: Use make.clean.html and docbook.css.source for styling HTML output

Cannot get docbook.css.source to look for anything outside the stylesheet .zip downloaded by Maven

 opendj3/pom.xml

@@ -411,22 +411,22 @@
                  <replacevalue>
&lt;script src="http://code.jquery.com/jquery-latest.min.js"&gt;&lt;/script&gt;
&lt;script&gt;
// On double-click, reformat &lt;pre class="screen"&gt; for easy copying.
// On double-click, reformat &lt;div class="screen"&gt; for easy copying.
$(document).ready(function() {
  $(".screen").attr("title", "Double-click [-] to flatten lines.");
  $(".screen").prepend('&lt;img src="../images/minus.png" class="toggle"&gt;');
});
$(".screen").live("dblclick", function() {
  $(this).replaceWith(
    "&lt;pre class=\"flat\" title=\"Double-click [+] to wrap long lines.\"&gt;" +
    "&lt;div class=\"flat\" title=\"Double-click [+] to wrap long lines.\"&gt;" +
    $(this).html().replace(/minus\.png/,"plus.png").replace(/\n /g," ") + "\n&lt;!--" + $(this).html() + "--&gt;" +
    "&lt;/pre&gt;");
    "&lt;/div&gt;");
});
$(".flat").live("dblclick", function() {
  $(this).replaceWith(
    "&lt;pre class=\"screen\" title=\"Double-click [-] to flatten lines.\"&gt;" +
    "&lt;div class=\"screen\" title=\"Double-click [-] to flatten lines.\"&gt;" +
    $(this).html().replace(/(.|\n)+&lt;!\-\-/m,"").replace(/\-\-\&gt;/,"").replace(/plus\.png/,"minus.png") +
    "&lt;/pre&gt;");
    "&lt;/div&gt;");
});
&lt;/script&gt;
&lt;link rel="shortcut icon" href="http://forgerock.org/favicon.ico"&gt;
@@ -500,22 +500,22 @@
                  <replacevalue>
&lt;script src="http://code.jquery.com/jquery-latest.min.js"&gt;&lt;/script&gt;
&lt;script&gt;
// On double-click, reformat &lt;pre class="screen"&gt; for easy copying.
// On double-click, reformat &lt;div class="screen"&gt; for easy copying.
$(document).ready(function() {
  $(".screen").attr("title", "Double-click [-] to flatten lines.");
  $(".screen").prepend('&lt;img src="./images/minus.png" class="toggle"&gt;');
});
$(".screen").live("dblclick", function() {
  $(this).replaceWith(
    "&lt;pre class=\"flat\" title=\"Double-click [+] to wrap long lines.\"&gt;" +
    "&lt;div class=\"flat\" title=\"Double-click [+] to wrap long lines.\"&gt;" +
    $(this).html().replace(/minus\.png/,"plus.png").replace(/\n /g," ") + "\n&lt;!--" + $(this).html() + "--&gt;" +
    "&lt;/pre&gt;");
    "&lt;/div&gt;");
});
$(".flat").live("dblclick", function() {
  $(this).replaceWith(
    "&lt;pre class=\"screen\" title=\"Double-click [-] to flatten lines.\"&gt;" +
    "&lt;div class=\"screen\" title=\"Double-click [-] to flatten lines.\"&gt;" +
    $(this).html().replace(/(.|\n)+&lt;!\-\-/m,"").replace(/\-\-\&gt;/,"").replace(/plus\.png/,"minus.png") +
    "&lt;/pre&gt;");
    "&lt;/div&gt;");
});
&lt;/script&gt;
&lt;link rel="shortcut icon" href="http://forgerock.org/favicon.ico"&gt;

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

@@ -20,7 +20,7 @@
  !
  ! CCPL HEADER END
  !
  !      Copyright 2011 ForgeRock AS
  !      Copyright 2011-2012 ForgeRock AS
  !    
-->
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
@@ -29,13 +29,22 @@
 <xsl:import href="urn:docbkx:stylesheet" />
 <xsl:import href="urn:docbkx:stylesheet/highlight.xsl" />

 <xsl:param name="html.stylesheet">css/coredoc.css</xsl:param>
 <xsl:param name="make.clean.html" select="1" />
 <xsl:param name="docbook.css.link" select="0" />
 <xsl:param name="html.stylesheet">css/docbook.css</xsl:param>
 <xsl:param name="admon.style">
  <xsl:value-of select="string('font-style: italic;')"></xsl:value-of>
 </xsl:param>
 <xsl:param name="default.table.frame">none</xsl:param>
 <xsl:param name="default.table.rules">none</xsl:param>
 <xsl:param name="table.cell.border.thickness">0pt</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>
 <xsl:param name="generate.legalnotice.link" select="1" />
 <xsl:param name="root.filename">index</xsl:param> <!-- docbkx-tools ignores this. -->
 <xsl:param name="use.id.as.filename" select="1" />

 <xsl:param name="generate.toc">
  appendix  nop
  article/appendix  nop
@@ -59,10 +68,6 @@
 <xsl:param name="toc.max.depth" select="1" />
 <xsl:param name="generate.meta.abstract" select="1" />

 <xsl:param name="default.table.frame">none</xsl:param>
 <xsl:param name="default.table.rules">none</xsl:param>
 <xsl:param name="table.cell.border.thickness">0pt</xsl:param>

 <xsl:template match="xslthl:keyword" mode="xslthl">
   <strong class="hl-keyword">
     <xsl:apply-templates mode="xslthl"/>

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

@@ -20,7 +20,7 @@
  !
  ! CCPL HEADER END
  !
  !      Copyright 2011 ForgeRock AS
  !      Copyright 2011-2012 ForgeRock AS
  !    
-->
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
@@ -29,10 +29,20 @@
 <xsl:import href="urn:docbkx:stylesheet" />
 <xsl:import href="urn:docbkx:stylesheet/highlight.xsl" />

 <xsl:param name="html.stylesheet">css/coredoc.css</xsl:param>
 <xsl:param name="make.clean.html" select="1" />
 <xsl:param name="docbook.css.link" select="0" />
 <xsl:param name="html.stylesheet">css/docbook.css</xsl:param>
 <xsl:param name="admon.style">
  <xsl:value-of select="string('font-style: italic;')"></xsl:value-of>
 </xsl:param>
 <xsl:param name="default.table.frame">none</xsl:param>
 <xsl:param name="default.table.rules">none</xsl:param>
 <xsl:param name="table.cell.border.thickness">0pt</xsl:param>

 <xsl:param name="generate.legalnotice.link" select="1" />
 <xsl:param name="root.filename">index</xsl:param> <!-- docbkx-tools ignores this. -->
 <xsl:param name="use.id.as.filename" select="1" />

 <xsl:param name="generate.toc">
  appendix  nop
  article/appendix  nop
@@ -56,10 +66,6 @@
 <xsl:param name="toc.max.depth" select="1" />
 <xsl:param name="generate.meta.abstract" select="1" />
 
 <xsl:param name="default.table.frame">none</xsl:param>
 <xsl:param name="default.table.rules">none</xsl:param>
 <xsl:param name="table.cell.border.thickness">0pt</xsl:param>

 <xsl:template match="xslthl:keyword" mode="xslthl">
   <strong class="hl-keyword">
     <xsl:apply-templates mode="xslthl"/>

 opendj3/src/main/docbkx/shared/sec-formatting-conventions.xml

@@ -35,17 +35,9 @@
 <filename>filenames</filename>, <command>commands</command>, and
 <literal>literal values</literal>.</para>

 <screen>
$ echo Terminal sessions with very long lines are formatted with lines folded
 by default to make them easier to read on the screen and to make them fit
 on the printed page. In the HTML version, you can double-click the text to
 toggle between the folded version for easy reading and the flat, syntactically
 correct version for easy copy/pasting.
Terminal sessions with very long lines are formatted with lines folded
 by default to make them easier to read on the screen and to make them fit
 on the printed page. In the HTML version, you can double-click the text to
 toggle between the folded version for easy reading and the flat, syntactically
 correct version for easy copy/pasting.</screen>
 <screen>$ echo Terminal sessions are formatted with line folding for easier reading.
 In the HTML version, double-click to toggle between the folded version and
 the flat, copy-paste version. &gt; /dev/null</screen>

 <para>In many cases, sections pertaining to UNIX, GNU/Linux, Mac OS X, BSD,
 and so forth are marked (UNIX). Sections pertaining to Microsoft Windows

 opendj3/src/main/resources/css/coredoc.css

File was deleted

 opendj3/src/main/resources/css/docbook.css

New file
@@ -0,0 +1,248 @@
body {
  color: #333;
  font-family: DejaVu, Verdana, Helvetica, Arial, sans-serif;
  font-size: 84%; /* 100% would be medium, 16px. */
  margin-left: auto;
  margin-right: auto;
  max-width: 800px;
}

dd,
dl,
dt,
li,
ol,
p,
td,
th,
ul {
  font-size: 1em;
}

a {
  text-decoration: none;
}

a:link {
  color: #47a;
}

a:visited {
  color: #68a;
}

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

.author {
  font-size: 1em;
  font-weight: normal;
}

code,
.command>strong,
div.literallayout,
.filename {
  font-family: monospace;
  font-size: 1.1em;
  font-weight: normal;
}

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

h1 {
  color: #626D75;
  font-size: 2em;
}

h2 {
  color: #333
  font-size: 1.8em;
}

h3 {
  color: #333
  font-size: 1.6em;
}

h4 {
  color: #333
  font-size: 1.4em;
}

h5 {
  color: #333
  font-size: 1.2em;
}

h6 {
  color: #333
  font-size: 1em;
}

hr {
  display: none;
}

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

div.refentry h2 {
  font-size: 1.1em;
}

div.refentry h3 {
  font-size: 1.0em;
}

div.navfooter,
div.navheader,
div.nukefooter {
  background-color: #fafafa;
}

div.navheader {
  border-bottom: thin solid #ccc;
}

.navheader th {
  color: #fafafa;
  font-size: 0em;
}

.navheader td,
.navfooter td,
.nukefooter td {
  font-size: 0.8em;
  font-style: italic;
}

div.abstract,
div.toc {
  border: thin dotted #ccc;
  margin-bottom: 0.25em;
  margin-top: 0.25em;
  padding-bottom: 0.25em;
  padding-left: 0.5em;
  padding-right: 0.5em;
  padding-top: 0.75em;
}

div.important,
div.caution,
div.note,
div.tip,
div.warning {
  border: thin dotted #ccc;
  font-style: italic;
  margin-bottom: 0.25em;
  margin-top: 0.25em;
  padding-bottom: 0.25em;
  padding-left: 0.5em;
  padding-right: 0.5em;
  padding-top: 0.25em;
}

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

img {
  height: auto;
  max-width: 640px;
  max-height: 480px;
}

table {
  font-size: 1em;
}

.table-contents {
  border-bottom: thin solid #ccc;
  border-spacing: 0.5em;
  border-top: thin solid #ccc;
}

.table-contents thead {
  text-align: left;
}

div.table-title {
  margin-bottom: 0.5em;
}

div.abstract-title,
div.blockquote-title,
div.example-title,
div.equation-title,
div.figure-title,
div.itemizedlist-title,
div.orderedlist-title,
div.procedure-title,
div.sidebar-title,
div.table-title,
div.toc-title,
div.variablelist-title
{
  font-weight: bold;
}

div.programlisting,
div.flat,
div.screen,
div.synopsis {
  background-color: #fafafa;
  border: thin dashed #ccc;
  font-family: monospace;
  font-size: 1.1em;
  margin-bottom: 1em;
  padding: 0.5em;
  white-space: pre;
}

div.flat,
div.screen {
  text-indent: -18px;
}

.toggle {
  position: relative;
  left: -40px;
  float: left;
}

.formalpara-title {
  font-weight: bold;
}

div.msglevel,
div.msgorig,
div.msgaud,
div.msgexplan {
  margin-top: 0.5em;
  margin-bottom: 0.5em;
}

span.msgmain-title,
span.msgsub-title,
span.msgrel-title,
span.msglevel-title,
span.msgorig-title,
span.msgaud-title,
span.msgexplan-title {
  font-weight: bold;
}