/usr/share/doc/texinfo/html/HTML-CSS.html is in texinfo-doc-nonfree 6.5.0-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for GNU Texinfo (version 6.5, 25 August 2017),
a documentation system that can produce both online information and a
printed manual from a single source using semantic markup.
Copyright (C) 1988, 1990, 1991, 1992, 1993, 1995, 1996, 1997,
1998, 1999, 2001, 2001, 2003, 2004, 2005, 2006, 2007, 2008, 2009,
2010, 2011, 2012, 2013, 2014, 2015, 2016 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation; with no
Invariant Sections, with the Front-Cover Texts being "A GNU Manual",
and with the Back-Cover Texts as in (a) below. A copy of the license
is included in the section entitled "GNU Free Documentation
License".
(a) The FSF's Back-Cover Text is: "You have the freedom to copy and
modify this GNU manual. Buying copies from the FSF supports it in
developing GNU and promoting software freedom." -->
<!-- Created by GNU Texinfo 6.4.90, http://www.gnu.org/software/texinfo/ -->
<head>
<title>HTML CSS (GNU Texinfo 6.5)</title>
<meta name="description" content="HTML CSS (GNU Texinfo 6.5)">
<meta name="keywords" content="HTML CSS (GNU Texinfo 6.5)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Command-and-Variable-Index.html#Command-and-Variable-Index" rel="index" title="Command and Variable Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Generating-HTML.html#Generating-HTML" rel="up" title="Generating HTML">
<link href="HTML-Xref.html#HTML-Xref" rel="next" title="HTML Xref">
<link href="HTML-Splitting.html#HTML-Splitting" rel="prev" title="HTML Splitting">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smalllisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>
</head>
<body lang="en">
<a name="HTML-CSS"></a>
<div class="header">
<p>
Next: <a href="HTML-Xref.html#HTML-Xref" accesskey="n" rel="next">HTML Xref</a>, Previous: <a href="HTML-Splitting.html#HTML-Splitting" accesskey="p" rel="prev">HTML Splitting</a>, Up: <a href="Generating-HTML.html#Generating-HTML" accesskey="u" rel="up">Generating HTML</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Command-and-Variable-Index.html#Command-and-Variable-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="HTML-CSS-1"></a>
<h3 class="section">22.3 HTML CSS</h3>
<a name="index-HTML_002c-and-CSS"></a>
<a name="index-CSS_002c-and-HTML-output"></a>
<a name="index-Cascading-Style-Sheets_002c-and-HTML-output"></a>
<p>Cascading Style Sheets (CSS for short) is an Internet standard for
influencing the display of HTML documents: see
<a href="http://www.w3.org/Style/CSS/">http://www.w3.org/Style/CSS/</a>.
</p>
<p>By default, <code>makeinfo</code> includes a few simple CSS commands to
better implement the appearance of some Texinfo environments. Here
are two of them, as an example:
</p>
<div class="example">
<pre class="example">pre.display { font-family:inherit }
pre.smalldisplay { font-family:inherit; font-size:smaller }
</pre></div>
<p>A full explanation of CSS is (far) beyond this manual; please see the
reference above. In brief, however, the above tells the web browser
to use a ‘smaller’ font size for <code>@smalldisplay</code> text, and to
use the same font as the main document for both <code>@smalldisplay</code>
and <code>@display</code>. By default, the HTML ‘<samp><pre></samp>’ command uses
a monospaced font.
</p>
<p>You can influence the CSS in the HTML output with two
<code>makeinfo</code> options: <samp>--css-include=<var>file</var></samp> and
<samp>--css-ref=<var>url</var></samp>.
</p>
<a name="index-texinfo_002dbright_002dcolors_002ecss"></a>
<a name="index-Visualizing-Texinfo-CSS"></a>
<p>The option <samp>--css-ref=<var>url</var></samp> adds to each output HTML file
a ‘<samp><link></samp>’ tag referencing a CSS at the given <var>url</var>. This
allows using external style sheets. You may find the file
<samp>texi2html/examples/texinfo-bright-colors.css</samp> useful for
visualizing the CSS elements in Texinfo output.
</p>
<p>The option <samp>--css-include=<var>file</var></samp> includes the contents
<var>file</var> in the HTML output, as you might expect. However, the
details are somewhat tricky, as described in the following, to provide
maximum flexibility.
</p>
<a name="index-_0040import-specifications_002c-in-CSS-files"></a>
<p>The CSS file may begin with so-called ‘<samp>@import</samp>’ directives,
which link to external CSS specifications for browsers to use when
interpreting the document. Again, a full description is beyond our
scope here, but we’ll describe how they work syntactically, so we can
explain how <code>makeinfo</code> handles them.
</p>
<a name="index-Comments_002c-in-CSS-files"></a>
<p>There can be more than one ‘<samp>@import</samp>’, but they have to come
first in the file, with only whitespace and comments interspersed, no
normal definitions. (Technical exception: a ‘<samp>@charset</samp>’
directive may precede the ‘<samp>@import</samp>’’s. This does not alter
<code>makeinfo</code>’s behavior, it just copies the ‘<samp>@charset</samp>’ if
present.) Comments in CSS files are delimited by ‘<samp>/* ... */</samp>’, as
in C. An ‘<samp>@import</samp>’ directive must be in one of these two forms:
</p>
<div class="example">
<pre class="example">@import url(http://example.org/foo.css);
@import "http://example.net/bar.css";
</pre></div>
<p>As far as <code>makeinfo</code> is concerned, the crucial characters are
the ‘<samp>@</samp>’ at the beginning and the semicolon terminating the
directive. When reading the CSS file, it simply copies any such
‘<samp>@</samp>’-directive into the output, as follows:
</p>
<ul>
<li> If <var>file</var> contains only normal CSS declarations, it is
included after <code>makeinfo</code>’s default CSS, thus overriding it.
</li><li> If <var>file</var> begins with ‘<samp>@import</samp>’ specifications (see
below), then the ‘<samp>import</samp>’’s are included first (they have to come
first, according to the standard), and then <code>makeinfo</code>’s
default CSS is included. If you need to override <code>makeinfo</code>’s
defaults from an ‘<samp>@import</samp>’, you can do so with the ‘<samp>!
important</samp>’ CSS construct, as in:
<div class="example">
<pre class="example">pre.smallexample { font-size: inherit ! important }
</pre></div>
</li><li> If <var>file</var> contains both ‘<samp>@import</samp>’ and inline CSS
specifications, the ‘<samp>@import</samp>’’s are included first, then
<code>makeinfo</code>’s defaults, and lastly the inline CSS from
<var>file</var>.
</li><li> Any @-directive other than ‘<samp>@import</samp>’ and ‘<samp>@charset</samp>’
is treated as a CSS declaration, meaning <code>makeinfo</code> includes
its default CSS and then the rest of the file.
</li></ul>
<p>If the CSS file is malformed or erroneous, <code>makeinfo</code>’s output
is unspecified. <code>makeinfo</code> does not try to interpret the
meaning of the CSS file in any way; it just looks for the special
‘<samp>@</samp>’ and ‘<samp>;</samp>’ characters and blindly copies the text into the
output. Comments in the CSS file may or may not be included in the
output.
</p>
<p>In addition to the possibilities offered by CSS, <code>makeinfo</code>
has many user-definable customization variables with which you can
influence the HTML output. See <a href="Customization-Variables.html#Customization-Variables">Customization Variables</a>.
</p>
<hr>
<div class="header">
<p>
Next: <a href="HTML-Xref.html#HTML-Xref" accesskey="n" rel="next">HTML Xref</a>, Previous: <a href="HTML-Splitting.html#HTML-Splitting" accesskey="p" rel="prev">HTML Splitting</a>, Up: <a href="Generating-HTML.html#Generating-HTML" accesskey="u" rel="up">Generating HTML</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Command-and-Variable-Index.html#Command-and-Variable-Index" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>
|