texinfo-doc-nonfree 6.1.0-2 / usr / share / doc / texinfo / html / HTML-Translation.html

This file is indexed.

/usr/share/doc/texinfo/html/HTML-Translation.html is in texinfo-doc-nonfree 6.1.0-2.

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
<!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.1, 6 February 2016),
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.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>GNU Texinfo 6.1: HTML Translation</title>

<meta name="description" content="GNU Texinfo 6.1: HTML Translation">
<meta name="keywords" content="GNU Texinfo 6.1: HTML Translation">
<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-Splitting.html#HTML-Splitting" rel="next" title="HTML Splitting">
<link href="Generating-HTML.html#Generating-HTML" rel="prev" title="Generating HTML">
<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-Translation"></a>
<div class="header">
<p>
Next: <a href="HTML-Splitting.html#HTML-Splitting" accesskey="n" rel="next">HTML Splitting</a>, Up: <a href="Generating-HTML.html#Generating-HTML" accesskey="u" rel="up">Generating HTML</a> &nbsp; [<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-Translation-1"></a>
<h3 class="section">22.1 HTML Translation</h3>

<a name="index-HTML-translation"></a>

<a name="index-HTML-output_002c-browser-compatibility-of"></a>
<p>First, the HTML generated by <code>makeinfo</code> is standard
HTML&nbsp;4.  It also tries to be compatible with earlier standards
(e.g., HTML&nbsp;2.0, RFC-1866).  Thus, please report output from an
error-free run of <code>makeinfo</code> which has practical browser
portability problems as a bug (see <a href="Reporting-Bugs.html#Reporting-Bugs">Reporting Bugs</a>).
</p>
<a name="index-html32_002epm"></a>
<p>Some known exceptions to HTML&nbsp;3.2 (using
&lsquo;<samp>--init-file=html32.pm</samp>&rsquo; produces strict HTML&nbsp;3.2 output;
see <a href="Invoking-texi2any.html#Invoking-texi2any">Invoking <code>texi2any</code></a>):
</p>
<ol>
<li> HTML&nbsp;3.2 tables are generated for the <code>@multitable</code> command
(see <a href="Multi_002dcolumn-Tables.html#Multi_002dcolumn-Tables">Multi-column Tables</a>), but they should degrade reasonably in
browsers without table support.

</li><li> The HTML&nbsp;4 &lsquo;<samp>lang</samp>&rsquo; attribute on the &lsquo;<samp>&lt;html&gt;</samp>&rsquo; attribute
is used.

</li><li> Entities that are not in the HTML&nbsp;3.2 standard are also used.

</li><li> CSS is used (see <a href="HTML-CSS.html#HTML-CSS">HTML CSS</a>).

</li><li> A few HTML&nbsp;4 elements are used: <code>thead</code>, <code>abbr</code>,
<code>acronym</code>.

</li></ol>

<p>To achieve maximum portability and accessibility among browsers (both
graphical and text-based), systems, and users, the HTML output is
intentionally quite plain and generic.  It has always been our goal
for users to be able to customize the output to their wishes via CSS
(see <a href="HTML-CSS.html#HTML-CSS">HTML CSS</a>) or other means (see <a href="Customization-Variables.html#Customization-Variables">Customization Variables</a>.
If you cannot accomplish a reasonable customization, feel free to
report that.
</p>
<p>However, we do not wish to depart from our basic goal of widest
readability for the core output.  For example, using fancy CSS may
make it possible for the HTML output to more closely resemble the
TeX output in some details, but this result is not even close to
being worth the ensuing difficulties.
</p>
<p>It is also intentionally not our goal, and not even possible, to pass
through every conceivable validation test without any diagnostics.
Different validation tests have different goals, often about pedantic
enforcement of some standard or another.  Our overriding goal is to
help users, not blindly comply with standards.
</p>
<p>To repeat what was said at the top: please report output from an
error-free run of <code>makeinfo</code> which has <em>practical</em> browser
portability problems as a bug (see <a href="Reporting-Bugs.html#Reporting-Bugs">Reporting Bugs</a>).
</p>
<p>A few other general points about the HTML output follow.
</p>
<a name="index-Navigation-bar_002c-in-HTML-output"></a>
<p><strong>Navigation bar:</strong> By default, a navigation bar is inserted at the
start of each node, analogous to Info output.  If the
&lsquo;<samp>--no-headers</samp>&rsquo; option is used, the navigation bar is only
inserted at the beginning of split files.  Header <code>&lt;link&gt;</code>
elements in split output can support Info-like navigation with
browsers like Lynx and Emacs&nbsp;W3<!-- /@w --> which implement this HTML&nbsp;1.0
feature.
</p>
<a name="index-Footnote-styles_002c-in-HTML"></a>
<p><strong>Footnotes:</strong> for HTML, when the footnote style is &lsquo;<samp>end</samp>&rsquo;,
or if the output is not split, footnotes are put at the end of the
output.  If the footnoet style is set to &lsquo;<samp>separate</samp>&rsquo;, and the
output is split, they are placed in a separate file.  See <a href="Footnote-Styles.html#Footnote-Styles">Footnote Styles</a>.
</p>
<a name="index-Escaping-to-HTML"></a>
<a name="index-Raw-HTML"></a>
<p><strong>Raw HTML</strong>: <code>makeinfo</code> will include segments of Texinfo
source between <code>@ifhtml</code> and <code>@end ifhtml</code> in the HTML
output (but not any of the other conditionals, by default).  Source
between <code>@html</code> and <code>@end html</code> is passed without change
to the output (i.e., suppressing the normal escaping of input
&lsquo;<samp>&lt;</samp>&rsquo;, &lsquo;<samp>&gt;</samp>&rsquo; and &lsquo;<samp>&amp;</samp>&rsquo; characters which have special
significance in HTML).  See <a href="Conditional-Commands.html#Conditional-Commands">Conditional Commands</a>.
</p>

<hr>
<div class="header">
<p>
Next: <a href="HTML-Splitting.html#HTML-Splitting" accesskey="n" rel="next">HTML Splitting</a>, Up: <a href="Generating-HTML.html#Generating-HTML" accesskey="u" rel="up">Generating HTML</a> &nbsp; [<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>

APT Browse - Built by Thomas Orozco.