diff options
Diffstat (limited to 'latex-bugs.html')
| -rw-r--r-- | latex-bugs.html | 427 |
1 files changed, 0 insertions, 427 deletions
diff --git a/latex-bugs.html b/latex-bugs.html deleted file mode 100644 index 83650d9..0000000 --- a/latex-bugs.html +++ /dev/null @@ -1,427 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
- "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
-<meta name="generator" content="AsciiDoc 10.0.0a2" />
-<title>Bugs in asciidoc latex backend</title>
-<link rel="stylesheet" href="./asciidoc.css" type="text/css" />
-<link rel="stylesheet" href="./layout2.css" type="text/css" />
-<script type="text/javascript" src="./asciidoc.js"></script>
-<script type="text/javascript">
-/*<![CDATA[*/
-asciidoc.install();
-/*]]>*/
-</script>
-</head>
-<body style="max-width:70em">
-<div id="layout-menu-box">
-<div id="layout-menu">
- <div>»<a href="index.html">Home</a></div>
- <div>»<a href="userguide.html">User Guide</a></div>
- <div>»<a href="INSTALL.html">Installation</a></div>
- <div>»<a href="faq.html">FAQ</a></div>
- <div>»<a href="manpage.html">asciidoc(1)</a></div>
- <div>»<a href="a2x.1.html">a2x(1)</a></div>
- <div>»<a href="asciidocapi.html">API</a></div>
- <div>»<a href="plugins.html">Plugins</a></div>
- <div>»<a href="http://powerman.name/doc/asciidoc">Cheatsheet</a></div>
- <div>»<a href="testasciidoc.html">Tests</a></div>
- <div>»<a href="CHANGELOG.html">ChangeLog</a></div>
- <div>»<a href="support.html">Support</a></div>
- <div id="page-source">»<a href="latex-bugs.txt">Page Source</a></div>
-</div>
-</div>
-<div id="layout-content-box">
-<div id="layout-banner">
- <div id="layout-title">AsciiDoc</div>
- <div id="layout-description">Text based document generation</div>
-</div>
-<div id="layout-content">
-<div id="header">
-<h1>Bugs in asciidoc latex backend</h1>
-<span id="author">Geoff Eddy</span><br />
-<span id="revision">version 9.1.0,</span>
-08 February 2021
-</div>
-<div id="content">
-<div id="preamble">
-<div class="sectionbody">
-<div class="paragraph"><p>Benjamin Klum was unable to maintain the LaTeX backend beyond version
-8.2.7, and as a consequence the <code>latex.conf</code> file ceased to work with
-<code>asciidoc</code> sometime after this. For version 8.4.3 I made some changes
-to the file to get it working again. This document summarises the
-remaining issues which I have found with generating LaTeX and thence
-PDF output with <code>asciidoc</code>, which is done as follows:</p></div>
-<div class="ulist"><ul>
-<li>
-<p>
-<code>asciidoc --backend=latex --unsafe FILE.txt</code>
-</p>
-</li>
-<li>
-<p>
-<code>latex FILE.tex</code>
-</p>
-</li>
-<li>
-<p>
-<code>kpdf FILE.pdf</code>
-</p>
-</li>
-</ul></div>
-<div class="paragraph"><p>Many of these were found by processing the <code>asciidoc.txt</code> file and
-comparing the HTML output with the PDF.</p></div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_footnotes">Footnotes</h2>
-<div class="sectionbody">
-<div class="dlist"><dl>
-<dt class="hdlist1">
-Priority
-</dt>
-<dd>
-<p>
-Low.
-</p>
-</dd>
-<dt class="hdlist1">
-Problem
-</dt>
-<dd>
-<p>
-References to footnotes, and a sensible value for the
-<code>[footnoteref-inlinemacro]</code> section, don’t seem to be possible.
-</p>
-</dd>
-<dt class="hdlist1">
-Cause
-</dt>
-<dd>
-<p>
-LaTeX doesn’t support footnoting much beyond creating a
-footnote at a certain point in text and displaying the footnote
-itself.
-</p>
-</dd>
-<dt class="hdlist1">
-Solution
-</dt>
-<dd>
-<p>
-Unclear. How important or necessary is this, anyway?
-</p>
-</dd>
-</dl></div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_spurious_text_at_starts_of_paragraphs">Spurious text at starts of paragraphs</h2>
-<div class="sectionbody">
-<div class="dlist"><dl>
-<dt class="hdlist1">
-Priority
-</dt>
-<dd>
-<p>
-Medium
-</p>
-</dd>
-<dt class="hdlist1">
-Problem
-</dt>
-<dd>
-<p>
-It is necessary to insert spurious text in paragraphs.
-</p>
-</dd>
-<dt class="hdlist1">
-Cause
-</dt>
-<dd>
-<p>
-This <code>asciidoc</code> input:
-</p>
-<div class="literalblock">
-<div class="content">
-<pre><code>-------------------------------------------------------------------
-Text
--------------------------------------------------------------------</code></pre>
-</div></div>
-<div class="paragraph"><p>generates this LaTeX code:</p></div>
-<div class="literalblock">
-<div class="content">
-<pre><code>\begin{lstlisting}
-SPURIOUS TEXTText\end{lstlisting}</code></pre>
-</div></div>
-<div class="paragraph"><p>which should be:</p></div>
-<div class="literalblock">
-<div class="content">
-<pre><code>\begin{lstlisting}[]
-Text\end{lstlisting}</code></pre>
-</div></div>
-</dd>
-<dt class="hdlist1">
-Solution
-</dt>
-<dd>
-<p>
-Find out a way to generate the correct LaTeX output as
-above. The obvious solution, as explained in <code>latet.conf</code>, doesn’t
-work.
-</p>
-</dd>
-</dl></div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_tables">Tables</h2>
-<div class="sectionbody">
-<div class="dlist"><dl>
-<dt class="hdlist1">
-Priority
-</dt>
-<dd>
-<p>
-Rather high.
-</p>
-</dd>
-<dt class="hdlist1">
-Problem
-</dt>
-<dd>
-<p>
-Not all of the table configuration options can be passed
-through to the LaTeX backend. In particular, I’ve had to assume that
-all tables will be fifteen or fewer left-justified columns wide.
-</p>
-</dd>
-<dt class="hdlist1">
-Cause
-</dt>
-<dd>
-<p>
-The table models in LaTeX and HTML are too dissimilar for one
-<code>asciidoc</code> specification to generate valid output in both formats by
-simple regexp replacement. Related to this is the unfortunate fact
-that <code><COLGROUP></code> and related tags aren’t a required part of HTML4,
-and some broswers (at least Firefox and Konqueror) don’t implement
-them.
-</p>
-</dd>
-<dt class="hdlist1">
-Solution
-</dt>
-<dd>
-<p>
-Perhaps table processing could be handled by a Python
-plugin, which would read in a table spec and generate the appropriate
-text?
-</p>
-</dd>
-</dl></div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_unicode_escaping">Unicode escaping</h2>
-<div class="sectionbody">
-<div class="dlist"><dl>
-<dt class="hdlist1">
-Priority
-</dt>
-<dd>
-<p>
-Rather high, to me at least.
-</p>
-</dd>
-<dt class="hdlist1">
-Problem
-</dt>
-<dd>
-<p>
-The commented-out section in <code>latex.conf</code>, if uncommented,
-converts <code>&#960;</code> to <code>\unichar{960}</code>, which then causes LaTeX to
-complain that the resulting command is unavailable in encoding T1. The
-more common non-ASCII characters, such as those in <code>félicité</code> and
-<code>świeca</code>, are handled properly, but some - such as the IPA characters
-in the <code>tipa</code> package - are not.
-</p>
-</dd>
-<dt class="hdlist1">
-Cause
-</dt>
-<dd>
-<p>
-The encodings in the LaTeX output are wrong.
-</p>
-</dd>
-<dt class="hdlist1">
-Solution
-</dt>
-<dd>
-<p>
-Correct the encodings.
-</p>
-</dd>
-</dl></div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_text_colours">Text colours</h2>
-<div class="sectionbody">
-<div class="dlist"><dl>
-<dt class="hdlist1">
-Priority
-</dt>
-<dd>
-<p>
-Probably low
-</p>
-</dd>
-<dt class="hdlist1">
-Problem
-</dt>
-<dd>
-<p>
-The text colour options are not processed by LaTeX; for
-example <code>[#ff0000]#Red text#</code> is not rendered in red.
-</p>
-</dd>
-<dt class="hdlist1">
-Cause
-</dt>
-<dd>
-<p>
-LaTeX and HTML represent RGB triads differently: HTML is happy
-with <code>#ff8000</code>, but LaTeX needs <code>[rgb]{1,0.5,0}</code>.
-</p>
-</dd>
-<dt class="hdlist1">
-Solution
-</dt>
-<dd>
-<p>
-Provide some sort of internal RGB conversion mechanism
-which can convert RGB triads to different representations.
-</p>
-</dd>
-</dl></div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_text_sizes">Text sizes</h2>
-<div class="sectionbody">
-<div class="dlist"><dl>
-<dt class="hdlist1">
-Priority
-</dt>
-<dd>
-<p>
-Probably low
-</p>
-</dd>
-<dt class="hdlist1">
-Problem
-</dt>
-<dd>
-<p>
-The text size options are not processed by LaTeX:
-<code>[,,1]#text#</code> is rendered in the same size as normal text.
-</p>
-</dd>
-<dt class="hdlist1">
-Cause
-</dt>
-<dd>
-<p>
-HTML size tags - <code>h1</code> through <code>h7</code> - are directly derivable
-from the size number, whereas LaTeX has a series of descriptive words
-(<code>HUGE</code> through <code>normalsize</code> to <code>scriptsize</code>).
-</p>
-</dd>
-<dt class="hdlist1">
-Solution
-</dt>
-<dd>
-<p>
-Provide a way to treat the number as an index into an
-array.
-</p>
-</dd>
-</dl></div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_background_colour_in_paragraphs">Background colour in paragraphs</h2>
-<div class="sectionbody">
-<div class="dlist"><dl>
-<dt class="hdlist1">
-Priority
-</dt>
-<dd>
-<p>
-Medium
-</p>
-</dd>
-<dt class="hdlist1">
-Problem
-</dt>
-<dd>
-<p>
-If the <code>backgroundcolor</code> attribute is specified in the
-<code>lstset</code> command, all paragraphs are displayed as black rectangles by
-<code>kpdf</code>, <code>xpdf</code>, and <code>evince</code>, although <code>kdvi</code> has no problems. I’ve
-had to remove the attribute, and so paragraphs all appear on white
-backgrounds. The PDF viewers also complain:
-</p>
-<div class="literalblock">
-<div class="content">
-<pre><code>Error (NNNN): Unknown operator 'rgb'</code></pre>
-</div></div>
-</dd>
-<dt class="hdlist1">
-Cause
-</dt>
-<dd>
-<p>
-Apparently a known bug in the output of <code>pdflatex</code>. Not a bug
-in <code>asciidoc</code>.
-</p>
-</dd>
-<dt class="hdlist1">
-Solution
-</dt>
-<dd>
-<p>
-Wait until this bug is fixed?
-</p>
-</dd>
-</dl></div>
-</div>
-</div>
-</div>
-<div id="footnotes"><hr /></div>
-<div id="footer">
-<div id="footer-text">
-Version 9.1.0<br />
-Last updated 2021-09-19 06:37:12 UTC<br />
-AsciiDoc is a trademark of the Eclipse Foundation, Inc.
-</div>
-<div id="footer-badges">
-<a href="https://validator.w3.org/check?uri=referer">
- <img style="border:0;width:88px;height:31px"
- src="https://www.w3.org/Icons/valid-xhtml11-blue"
- alt="Valid XHTML 1.1" height="31" width="88" />
-</a>
-<a href="https://jigsaw.w3.org/css-validator/">
- <img style="border:0;width:88px;height:31px"
- src="https://jigsaw.w3.org/css-validator/images/vcss-blue"
- alt="Valid CSS!" />
-</a>
-</div>
-</div>
-</div>
-</div>
-</body>
-</html>
|