headers
David Goodger | 6 Sep 2004 01:16
Favicon

Re: Newbie to DocUtils

[Colin J. Williams]
 > I am slowly fighting my way through DocFactory, which is a great
 > tool as far as it goes.
 >
 > 1. It would really help if there were an index to the various docs,
 >    as with Python.chm

Patches are welcome!

 > 2. Tables are a real problem.

How so?

 >    There is a CSV directive which might be helpful, but I haven't
 >    yet sorted out how to specify line breaks, as with a chunk of
 >    Python code.

The CSV-table directive is meant for copy & paste (or file inclusion)
from CSV sources.  It's not really meant for original data entry.

 > 3. It would be nice if the editor incorporated ^W for window closing
 >    and a re based Find and Replace, so that one can Find "^" to
 >    replace with ".. ".  To comment out code.

You can comment out an entire block with a single ".." and
indentation:

..
    Put the ".." on the first line by itself,
    then indent everything you'd like to
(Continue reading)

Permalink | Reply |
headers
engelbert.gruber | 6 Sep 2004 09:11
Picon

Re: Newbie to DocUtils

On Sun, 5 Sep 2004, David Goodger wrote:

>  > 6. There is an ocasional need, which I have, to enter math
>  >    expresions - something like TexAide would help, but this outputs
>  >    LaTex, I don't know how that fits with the need to produce
>  >    HTML. [http://www.mathtype.com/en/].  It involves working through
>  >    the clipboard and then removing the superfluous stuff.
>
> Many people have asked for math markup, but as yet nobody has done the
> work necessary for a robust solution.  As Felix pointed out, question
> 2.14 in the FAQ summarizes this issue:
> <http://docutils.sourceforge.net/FAQ.html>.

for a possible solution see sandbox/cben/rolehack (i dont know in which
state it is, but beni used it for his documents).

cheers, the sandbox is full of goodies, but no one dig's it.

--

-- 
 BINGO: Wie gehts Ihnen mit ...?
 --- Engelbert Gruber -------+
  SSG Fintl,Gruber,Lassnig  /
  A6170 Zirl   Innweg 5b   /
  Tel. ++43-5238-93535 ---+

-------------------------------------------------------
This SF.Net email is sponsored by BEA Weblogic Workshop
FREE Java Enterprise J2EE developer tools!
Get your free copy of BEA WebLogic Workshop 8.1 today.
http://ads.osdn.com/?ad_id=5047&alloc_id=10808&op=click
(Continue reading)

Permalink | Reply |
headers
Beni Cherniavsky | 14 Sep 2004 13:38
Picon

Re: Newbie to DocUtils

engelbert.gruber <at> ssg.co.at wrote on 2004-09-06:

> On Sun, 5 Sep 2004, David Goodger wrote:
>
> >> 6. There is an ocasional need, which I have, to enter math
> >>    expresions - something like TexAide would help, but this outputs
> >>    LaTex, I don't know how that fits with the need to produce
> >>  HTML. [http://www.mathtype.com/en/].  It involves working through
> >>    the clipboard and then removing the superfluous stuff.
> >
> > Many people have asked for math markup, but as yet nobody has done the
> > work necessary for a robust solution.  As Felix pointed out, question
> > 2.14 in the FAQ summarizes this issue:
> > <http://docutils.sourceforge.net/FAQ.html>.
>
> for a possible solution see sandbox/cben/rolehack (i dont know in which
> state it is, but beni used it for his documents).
>
It allows LaTeX formulas in reST source, passing them as-is to LaTeX
and converting to images for HTML.  It's supposed to be working well.
Instructions at
http://docutils.sourceforge.net/sandbox/cben/rolehack/README.html

If you have any trouble with it, I'd be glad to help - best with cc:
to this list.

> cheers,the sandbox is full of goodies, but no one dig's it.
>
That's true :-)
(Continue reading)

Permalink | Reply |
headers
Colin J. Williams | 6 Sep 2004 03:28
Picon
Favicon

Re: Newbie to DocUtils

Many thanks for your comments, I'll try to respond more fully in October.

Meanwhile, I'll respond on a couple of matters:
1. Regarding the math usage, I have part of a document, with the math 
stuff, built with LyX and the rest with ReSt.  I'm almost through 
merging these now, but this is not an approach I would recommend.  Since 
doing this, I've come across TeXaide. this involves working through the 
clipboard, but it is something I would explore for any other project.

2. In the FAQ, regarding extension usage, I see:
It's ".txt". Some people would like to use ".rest" or ".rst" or 
".restx", but why bother? ReStructuredText source files are meant to be 
readable as plaintext, and most operating systems already associate 
".txt" with text files. Using a specialized filename extension would 
require that users alter their OS settings, which is something that many 
users will not be willing or able to do.

It seems to me, at least for Windows users, there is a benefit in using 
a distinct extension in that with the Explorer one can click on the file 
to execute docfactory.  Clicking on a .txt file typically initiates 
Notepad or, in my case SciTE.

Thanks again

Colin W.

David Goodger wrote:

> [Colin J. Williams]
> > I am slowly fighting my way through DocFactory, which is a great
(Continue reading)

Permalink | Reply |
headers
David Goodger | 6 Sep 2004 03:56
Favicon

Re: Newbie to DocUtils

[Colin J. Williams]
 > 1. Regarding the math usage, I have part of a document, with the
 > math stuff, built with LyX and the rest with ReSt.  I'm almost
 > through merging these now, but this is not an approach I would
 > recommend.  Since doing this, I've come across TeXaide. this
 > involves working through the clipboard, but it is something I would
 > explore for any other project.

(Is there a "not" missing in that last sentence?  It doesn't quite
parse as-is.)

TeXaide looks like a fine tool, but useless to non-Windows users.

 > It seems to me, at least for Windows users, there is a benefit in
 > using a distinct extension in that with the Explorer one can click
 > on the file to execute docfactory.  Clicking on a .txt file
 > typically initiates Notepad or, in my case SciTE.

Of course, you're free to set that up on your system.  I just don't
think it's the best default for Docutils users.  And we don't
distribute OS-specific installers anyhow.

If you (or anybody else) can write up a description of how to set up
extension bindings, I'd be happy to put it in a Windows tips doc.
(Same goes for other OSes.)  If you can write a program that does the
magic necessary to set it up automatically, that can go in the distro
too.

--

-- 
David Goodger <http://python.net/~goodger>
(Continue reading)

Permalink | Reply |
headers
Colin J. Williams | 6 Sep 2004 16:03
Picon
Favicon

Re: Newbie to DocUtils


David Goodger wrote:

> [Colin J. Williams]
> > 1. Regarding the math usage, I have part of a document, with the
> > math stuff, built with LyX and the rest with ReSt.  I'm almost
> > through merging these now, but this is not an approach I would
> > recommend.  Since doing this, I've come across TeXaide. this
> > involves working through the clipboard, but it is something I would
> > explore for any other project.
>
> (Is there a "not" missing in that last sentence?  It doesn't quite
> parse as-is.)

Does replacing a period by a comma clarify things:

    I've come across TeXaide, this
     > involves working through the clipboard, but it is something I would
     > explore for any other project.

What I'm trying to say is that the idea of working through the clipboard 
and
deleting the extraneous stuff is cumbersome, but it may the the best 
there is
currently.

>
> TeXaide looks like a fine tool, but useless to non-Windows users.
>
I hadn't looked into this.
(Continue reading)

Permalink | Reply |

Gmane