[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kde-doc-english
Subject:    Re: [kde-doc-english] checkXML vs meinproc4
From:       "T.C. Hollingsworth" <tchollingsworth () gmail ! com>
Date:       2014-09-16 1:11:08
Message-ID: CAJVv0O=ETKpL5qQbBAxLV9A4cLAm1CgkbRSS1Adi58rAnbqb-w () mail ! gmail ! com
[Download RAW message or body]

On Mon, Sep 15, 2014 at 3:23 PM, Jack <ostroffjh@sbcglobal.net> wrote:
> Thanks for that - I have been following.  I certainly prefer the css markup
> to the <HR>, and I like the idea of moving it from mediaimage to screenshot
> (where I actually thought it was.)  I have not yet actually tried using
> mediagimage without screenshot, but that will certainly do what I want.

If you want to try it out locally, download the two files attached to
this e-mail and copy them over the existing versions in
/usr/share/doc/HTML/en/common/.  (Back up the old versions if you want
to restore them later for any reason, or you can just use the
"reinstall" function of your distro's package manager to revert also.)

Then you can open any help:/ URL in khelpcenter or konqueror or
meinproc4 some local docbooks and the new styles will be applied.

-T.C.

["kde-default.css" (text/css)]

/*
    KDE-wide default CSS for HTML documentation (all media types).
    Copyright (C) 2000 Frederik Fouvry

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA

    Send comments, suggestions, etc. to Frederik Fouvry 
    <fouvry@sfs.nphil.uni-tuebingen.de>. */

/*
   Important note: these setting may be overridden by localised CSS.  Do not 
   add here any localization-sensitive style declarations.
   
   Any updates should be validated, e.g. http://jigsaw.w3.org/css-validator/ */

/* Note: "should be inherit" means that in a proper browser inherit should work.
   Somehow Netscape manages to interpret "inherit" as bright green. 
   Yuck.  */

body {
  background: white none;
  color: black;
  font-family: sans-serif;
  padding: 0 15px 0 0;
  margin: 0; 
}

.legalnotice, .copyright {
  padding: 0;
  margin: 0; 
}

.abstract {
  font-weight: bolder;
  padding-right: 1em; 
}

.toc, .list-of-tables {
  padding-left: 1em;
}

.sect1, .chapter, .synopsis, .appendix, .preface, .article, .refsect1, .index, \
.glossary, .glossdiv, .gloss-article, .section {  padding-left: 1em;
}

.gloss-article, .glossdiv {
  padding-right: 1em;
}

.toc .chapter {
padding: 0em 0em 0em 1em;
}

.author {
  color: rgb(82,80,82);
  font-weight: bolder;
  padding: 0;
  margin: 0;
}

.othercredit {
  line-height: 1em;
}

.chapter .sect1, .chapter .titlepage, .sect1 .titlepage, .article .titlepage {
  padding: 0em;
}

.titlepage {
  padding-left: 1em;
  padding-right: 1em;
}

/* Links in Navigation */

.navLeft a:link, .navCenter a:link, .navRight a:link, .header a:link, .header \
a:visited, .bottom-nav a:link, .bottom-nav a:visited {  color: #41597A;
  font-weight: bold;
}


/* Nice link colors for the main text */

> link { 
  color: #41597A;
}

> visited { 
  color: #597ba8;
}

.navLeft {
  position: absolute; 
  left: 20px;
}

.navRight {
  position: absolute; 
  right: 20px;
}

.navCenter {
  text-align: center;
  align: center;
}

.bannerBottomLeft {
  position: absolute; left: 0px;
}

.bannerBottomRight {
  position: absolute; right: 0px;
}

.header {
  background: #3E91EB none;
  border-bottom: 1px solid #206dcd;
  border-top: 1px solid white;
  color: white;
  font-size: small;
  height: 1.7em;
  line-height: 1em;
  margin: 0px;
  padding-bottom: 0px;
  padding-left: 1em;
  padding-right: 0px;
  padding-top: 0px;
  vertical-align: middle;
}

.bottom-nav { 
  background-color: #3E91EB; 
  border-bottom: 1px solid #206dcd; 
  border-top: 1px solid white;
  color: white; 
  font-size: small; 
  height: 1.7em; 
  line-height: 1em; 
  margin: 0px; 
  padding-bottom: 0px; 
  padding-left: 1em;
  padding-right: 0px; 
  padding-top: 10px; 
  vertical-align: middle; 
}

#logo {
  background: url('kde_logo_bg.png') transparent repeat;
}

/* A little bit of padding makes the tables for keybindings etc much easier to read \
*/

table { 
  padding: 5px; 
} 

dl { 
  margin-top: 0em; 
  margin-bottom: 0.5em; 
}

dt { 
  margin-top: 1em; 
}
div.toc dt { 
  margin-top: 0px; 
}
div.screenshot { 
  margin-bottom: 1em;
  margin-top: 1em; 
}

div.informalexample { 
  border-style: dotted;
  padding: 10px;
}

/* But no padding for navigation elements */

.toplogo, .navbackground { 
  padding: 0px; 
}

table.programlisting
table.screen { 
  border-style: none;
  background-color: rgb(224,224,224);
  table-layout: auto; /* 100%? */
  color: rgb(0,0,0); /* should be inherit */
}

/* Same as previous block, but more general (previous is HTML only)
   Not all browsers understand this yet.
   TABLE[class~=programlisting]
   TABLE[class~=screen] { border-style: none;
          background-color: rgb(224,224,224);
          table-layout: auto;
          color: inherit;
}
*/

p { 
  text-align: justify; 
}

/* More specific settings */
/* Temporary patch: browsers break on bad HTML */
/* P, H1, H2, H3, H4, H5, TD, TH { font-family: Helvetica, Arial, sans-serif;
    } */

p, h1, h2, h3, h4, h5, h6, td, th { 
  font-family: sans-serif;
}

/* Visual cues for GUI elements etc in the text */

.guimenu, .guimenuitem, .guisubmenu { 
  background-color: rgb(220,220,220);
  color: rgb(0,0,0); /* should be inherit */
}

.guilabel, .interface, .guibutton, .guiicon { 
  background-color: rgb(220,220,220);
  color: rgb(0,0,0); /* should be inherit */
}

.shortcut { 
  background-color: rgb(220,220,220);
  color: rgb(0,0,0); /* should be inherit */
}

.shortcut .keycap { 
  background-color: rgb(220,220,220);
  color: rgb(0,0,0); /* should be inherit */
}

.question { 
  font-weight: bolder; 
}

.accel { 
  background-color: rgb(220,220,220);
  color: rgb(0,0,0); 
  text-decoration: underline;
}

.option, .command { 
  background-color: rgb(255,255,255);
  color: rgb(0,96,160);
  font-weight: bold;
}

h1, h2, h3, h4, h5, h6 { 
  color: rgb(82,80,82);
  background-color: transparent;
}

.arg, .parameter, .replaceable { 
  background-color: rgb(255,255,255);
  color: rgb(0,128,64);
  font-style: italic;
}

.screen, .programlisting { 
  background-color: rgb(220,220,220);
  color: rgb(0,0,0); /* should be inherit */
  border-style: dotted;
  border-color: rgb(0,0,0);
  border-width: thin; 
  padding: 5px; 
} 


/* This one is set in inches because the admonitions are set in inches
   and they're more difficult to change.  We can live with it in here, 
   for the meantime, it gives consistent margins */

.example { 
  margin-left: 0.5in; 
  margin-right: 0.5in;
}

div.mediaobject, div.mediaobjectco { 
  /* float: right; */ 
  /* might make it much nicer. although someone has to
     understand the rules ;-)  You also don't want it to be
     surrounded by text it doesn't refer to ...  But that
     may be among others a question of writing style. */
  text-align: center; /* a bit of a hack: it should
                         position _images_ */
}

.caption { 
  margin: 0em 2em 0em 2em;
  text-align: center;
}

.inlinemediaobject { 
  vertical-align: baseline; 
  padding-right: 1em;
  padding-left: 1em;		
}

/* An idea that could be nice: a search engine looking for specific
classes could display them in some conspicuous color.  All that is
needed is an on the fly generated style element/style sheet. */

/* Only used in the hand-made HTML license texts */
body.license { 
  background-color: rgb(255,255,255);
  text-align: justify; 
  color: rgb(0,0,0);
}
pre.license { 
  background-color: rgb(255,255,255);
  font-family: monospace;
  color: rgb(0,0,0);
}


["kde-docs.css" (text/css)]

/*
 * kde-docs.css -- Style sheets for the KDE documentation generated
 * HTML.
 *
 * Started by Michael Pyne <mpyne@kde.org>
 */
html, body {
    padding: 0;
    width: 100%;
    height: 100%;
}

/* These two divs force the content to fill up at least the viewport, which
 * is needed in order to force the footer to the bottom of short pages.
 */
#content {
    min-height: 100%;
    position: relative;
}

#contentBody {
    padding: 0;
    padding-bottom: 1em;
    margin: 0;
    width: 100%;
}

/* This is for the header's navigation bar */
#content > .navCenter {
    background: #F8F8F8;
    border-bottom: 1px solid #DDD;
}

/* Standard nav bar elements */
div.navCenter table {
    empty-cells: show;
    border: 0px;
    width: 100%;
}

div.navCenter td {
    font-weight: normal;
}

div.navCenter td.prevCell {
    padding-left: 20px;
    text-align: left;
}

div.navCenter td.nextCell {
    padding-right: 20px;
    text-align: right;
}

div.navCenter td.upCell {
    text-align: center;
}

/* Actual documentation styling */
div.table table {
    text-align: left; /* Disable justification */
    border: 1px solid black;
    border-collapse: collapse;
}

/* Give alternating row colors */
div.table tr:nth-child(odd) {
    background-color: #eee;
}

div.table tr:nth-child(even) {
    background-color: white;
}

div.table th {
    background-color: white;
    font-weight: normal;
    text-align: center;
    vertical-align: middle;
    border-bottom: 1px solid black;
}

div.table td {
    text-align: left;
    padding: 4px;
}

div.tip, div.note, div.warning, div.important {
    padding: 6pt;
    padding-top: 3pt;
}

div.tip > .title, div.warning > .title, div.note > .title, div.important > .title {
    padding: 4pt 1cm;
    margin: 0;
    margin-top: 4pt;
}

div.tip {
    border: 1px solid #EEF;
    border-left: 1px solid #88F;
    background: #EFEFFF;
}

div.tip > .title {
    border: 1px solid #88F;
    background: #CFCFFF;
    color: #222;
}

div.important {
    border: 1px solid #FF2;
    border-left: 1px solid #888;
    background: #FF7;
}

div.important > .title {
    border: 1px solid #836900;
    background: #FC0;
    color: #222;
}

div.note {
    border: 1px solid #EEE;
    border-left: 1px solid #888;
    background: #EFEFEF;
}

div.note > .title {
    border: 1px solid #888;
    background: #CFCFCF;
    color: #222;
}

div.warning {
    border: 1px solid #FEE;
    border-left: 1px solid #F88;
    background: #FFEFEF;
    margin-bottom: 6pt;
}

div.warning > .title {
    border: 1px solid #F88;
    background: #FFAFAF;
    color: #222;
}

/* Make the content wrapping div have a nice margin. */
body div.chapter, body div.sect1, body div.book, body div.article {
    margin-left: 2em;
    margin-right: 2em;
}

div.sect2 {
    width: 100%;
}

.programlisting, pre.screen {
    -khtml-border-radius: 7px;

    /* This will work someday */
    border-radius: 7px;

    /* To support border radius on our OSS browser friends when
     * viewing online */
    -webkit-border-radius: 7px;
    -moz-border-radius: 7px;
}

.programlisting {
    border: 1px solid black;
    background: white;
}

.guimenu, .guimenuitem, .guisubmenu,
.guilabel, .interface, .guibutton {
    background-color: rgb(220, 220, 220);
    color: black;
    border: 1px solid rgb(190, 190, 190);

    -khtml-border-radius: 3px;
    -moz-border-radius: 3px;
    -webkit-border-radius: 3px;
    border-radius: 3px;
}

.shortcut {
    background-color: #DDF;
    border: 1px dotted #BBF;
    font-weight: normal;

    -khtml-border-radius: 2px;
    -moz-border-radius: 2px;
    -webkit-border-radius: 2px;
    border-radius: 2px;
}

.keycap, .keysym {
    background-color: #DFDFFF;
    font-weight: bold;

    -khtml-border-radius: 2px;
    -moz-border-radius: 2px;
    -webkit-border-radius: 2px;
    border-radius: 2px;
}

pre.screen {
    border: 2px solid gray;
    background: black;

    color: white;
    font-weight: normal;
    font-family: monospace;
}

/* Make a screen black on white */
pre.screen * {
    color: white;
    background: black;
    font-weight: normal;
    font-family: monospace;
}

pre.screen .userinput {
    color: green;
}

.informalexample {
    margin: 0px;
    padding: 0px;
    border: 0px;
    border-left: 1px dotted black;
    padding-left: 4px;
}

div.tip {
    margin-bottom: 12pt;
}

div.tip:last-child() {
    margin-bottom: 0pt;
}

pre:last-child() {
    margin-bottom: 0px;
}

div.titlepage {
    margin-left: 0px;
}

h3.title {
    margin-left: 0cm;
}

.screenshot, .informalfigure {
    border: 1px solid gray;
    background-color: rgb(240,240,240);
}

/* We no longer render <hr>s around <mediaobject>s, but this hides them in case
 * old generated HTML is displayed with the new style.
 */
.mediaobject hr, .mediaobjectco hr {
    display: none;
}

/*
 * This gives us the styling for the header and footer.
 * See customization/kde-navig.xsl for where it's used.
 */
#header {
    width: 100%;
    height: 51px;
    color: #535353;
    background: #eeeeee;
    border-bottom: #bcbcbc 1px solid;
}

#header_content {
    margin: 0 auto;
    width: 80%;
    height: 51px;
    background: url("top.jpg") top left repeat-x;
}

#header_right img {
    position: relative;
    top: 8px; /* Vertically center */
}

#header_left {
    background: url("top-left.jpg") top left no-repeat;
    padding-left: 20px;
    height: 51px;
}

#header_right {
    background: url("top-right.jpg") top right no-repeat;
    color: white;
    padding-right: 20px;
    height: 51px;
    text-align: left;
    font-size: 18pt;
    font-weight: bold;
    vertical-align: middle;
    text-shadow: #112 2px 2px 2px;
    white-space: nowrap;
    overflow: hidden;
    line-height: 51px;
}

/* Used for the text and footer area at the bottom. */
#footer {
    width: 100%;
    background-color: #eeeeee;
    border: 0px;

    /* Force footer to bottom of viewport/page */
    /* Either should be position:fixed to stay always at the bottom of the viewport, or 
       removed to be at the bottom of the page. I chose bottom of the page.
       position: absolute; */
    bottom: 0;
    height: 8.7em;
}

#footer_text {
    text-align:center;
    vertical-align: middle;
    padding-top: 12pt;
}

#footer .navCenter {
    border-top: 1px solid #DDD;
    border-bottom: 1px solid #AAA;
}

/* Two rows on this navCenter, so make the cells equal width */
#footer .navCenter td {
    width: 33%;
}

a.footer_email {
    color: #282828;
    text-decoration: underline;
}

@media print {
    #header_right {
        color: black;
        text-shadow: gray 2px 2px 2px;
    }

    .navCenter {
        display: none;
    }

    #footer {
        border-top: 1px solid #DDD;
    }
}


_______________________________________________
kde-doc-english mailing list
kde-doc-english@kde.org
https://mail.kde.org/mailman/listinfo/kde-doc-english


[prev in list] [next in list] [prev in thread] [next in thread] 

Configure | About | News | Add a list | Sponsored by KoreLogic