[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: project idea for texinfo project
From: |
Gavin Smith |
Subject: |
Re: project idea for texinfo project |
Date: |
Tue, 22 Mar 2016 06:50:43 +0000 |
On 17 February 2016 at 09:08, Giuseppe Scrivano <address@hidden> wrote:
> Per Bothner <address@hidden> writes:
>
>> see attachment.
>
> thanks, I've included it in the ideas page.
Please update the text to the attached file, if you can. It is
capitalization changes as well as a small change to wording in the
second paragraph.
--- tt.html 2016-03-22 06:49:11.000000000 +0000
+++ tt.html.new 2016-03-22 06:53:29.000000000 +0000
@@ -1,15 +1,16 @@
<h3 id="texinfo"><a
href="https://www.gnu.org/software/texinfo/">Texinfo</a></h3>
<p>
-GNU documentation is based on the texinfo source format (conceptually
+GNU documentation is based on the Texinfo source format (conceptually
similar to markdown, but better for documentation). There are tools to
-convert texinfo into various formats, including pdf, html, and info
-format. The info format is used for reading the documentation in a
+convert Texinfo into various formats, including PDF, HTML, and Info
+format. The Info format is used for reading the documentation in a
terminal emulator (using the <code>info</code> program) or in
the <code>emacs</code> editor.</p>
<h4>Keyboard-centric UI in JavaScript for GNU HTML documentation</h4>
<p>
-The info format is very bare-bones (no fonts or images). On the other
+The <code>info</code> program is very bare-bones (no fonts or images).
+On the other
hand, the <code>info</code> program has a number of conveniences for
browsing documentation, and the keyboard-centric user interface is
very efficient.
@@ -31,14 +32,14 @@
</ul>
<p>
The focus of this project is writing logic and event handlers in JavaScript.
-You may also want to make some tweaks to how the texinfo tools generate HTML so
+You may also want to make some tweaks to how the Texinfo tools generate HTML so
the HTML is cleaner and easier to work with.</p>
<p>
Once we have a good basic browser-based documentation reader (hopefully
by the mid-term), there are some possible enhancements.
One is to generate on-the-fly a navigation bar. For example see
the <a href="http://www.gnu.org/software/kawa">Kawa homepage</a>, which
-is generated from texinfo, but goes through some extra complex
+is generated from Texinfo, but goes through some extra complex
processing. It would be nice if it could be done in JavaScript and
CSS.</p>
<p>
tt.html.new
Description: Binary data
- Re: project idea for texinfo project,
Gavin Smith <=