Google "restructuredtext" (no quotes, all lower case, one word).  You'll get a bunch of hits--the ones starting with "docutils..." are RST's home pages (as it were).  That's about as far as I can take you.
 
 
-----Original Message-----
From: gutvol-d-bounces@lists.pglaf.org [mailto:gutvol-d-bounces@lists.pglaf.org] On Behalf Of Linda M. Everhart
Sent: Saturday, December 18, 2010 3:57 PM
To: Project Gutenberg Volunteer Discussion
Subject: [gutvol-d] Re: restructured-text -- the good, the bad, and the ugly

Al, sorry I didn't explain that well.  I can open the rst files, and read them with all the markup, but I don't know what to use to convert them into something usable like html or mobi.  Someone point me to a webpage that explains this.  I'd like to learn more about it.

Linda M. Everhart



On Dec 18, 2010, at 5:01 PM, Al Haines wrote:

The RST files can be opened with any UTF-8 capable editor--SCUnipad, Windows Notepad, MS Word, etc.  (I can't speak to Mac software.)  If you click on the reStructuredText link, you should get a prompt to open or save the file.  You may have to set up an association of the .rst extension with the editor of your choice.
 
They're meant only as a master file from which other formats are generated--plain text, HTML, epub, etc, etc.  They are not an end-user ebook format.
 
 
BTW--it's probably more accurate to say that PG doesn't actually _use_ formats.  Ebook producers (DP, independents) _use_ formats--PG decides which ones it will accept for posting.  That's how I see it, anyway--dissenters can argue among themselves. <g>
 
Al
 
 
-----Original Message-----
From: gutvol-d-bounces@lists.pglaf.org [mailto:gutvol-d-bounces@lists.pglaf.org] On Behalf Of Linda M. Everhart
Sent: Saturday, December 18, 2010 2:20 PM
To: Project Gutenberg Volunteer Discussion
Subject: [gutvol-d] Re: restructured-text -- the good, the bad, and the ugly

I read the instructions how to make rst, and downloaded the .rst books bowerbird listed.  My Calibre won't convert them, my browser won't open them.  What are they supposed to work with?

Linda M. Everhart



On Dec 18, 2010, at 3:15 PM, Bowerbird@aol.com wrote:

i don't get over to the d.p. forums very often these days,
so i didn't realize they started rolling out their notice on
the shift to restructured-text last saturday, december 11th.

i also didn't know this initiative was so far along, in that
two r.s.t. e-books are already mounted (december 16th):
>   http://www.gutenberg.org/ebooks/34654
>   http://www.gutenberg.org/ebooks/34605

here's my r.s.t. summary:  the good, the bad, and the ugly.

***


_restructured-text_at_project_gutenberg_


_the_good_

project gutenberg is officially using a light-markup format!


_the_bad_

the implementation uptake at d.p. will likely be _very_slow_...


_the_ugly_

this change proves that it is now marcello making p.g. policy.

***

i'll elaborate on this summary in the coming days...

in the meantime...  as you can imagine, over the many years,
i have been an advocate of light-markup all over cyberspace,
so now i can go out and tell the world that project gutenberg
has finally endorsed my position and is using light-markup!

of course, this leaves considerable egg on the faces of people
like walter, who -- just last december 26th -- posted that i was
a "hopeless fool" and that my proposals for light-markup were
"fundamentally impossible".  looks like you were wrong, walter.
way wrong.  way way wrong.  even marcello has given it all up.

-bowerbird
_______________________________________________
gutvol-d mailing list
gutvol-d@lists.pglaf.org
http://lists.pglaf.org/mailman/listinfo/gutvol-d

_______________________________________________
gutvol-d mailing list
gutvol-d@lists.pglaf.org
http://lists.pglaf.org/mailman/listinfo/gutvol-d