Re: overhauling the manual (was pyblosxom 1.4 status)

will <[email protected]>
Newsgroups gmane.comp.web.pyblosxom.devel
Message-ID <[email protected]>
On 5/23/07, John Gabriele <[email protected]> wrote:
>
> Sounds great.
>
> Couple issues:
>
> 1. I don't yet know how to tell reST I want all the separate docs
> stitched together.

I'm thinking instead of creating a complete manual it's easier to
create a bunch of "articles" that cover specific topics.

Then we could create an "index.txt" that walks through which files
have what information so that users have some way of navigating a
bunch of files.


> 2. Not sure how to make internal links to a location in another
> chapter if that chapter resides in a separate file. Will have to
> fiddle with this, but it's late and I'm going to bed. :)

I didn't think of this...  I'm not sure there's a lot of inter-topic linking.


> See attached for the first 3 chapters.

w00t!  I did a pass over them, changed the flavours.txt document I did
to match them, and checked them in.

You can see current versions of everything here:

http://pyblosxom.svn.sourceforge.net/viewvc/pyblosxom/trunk/pyblosxom/docs/

/will

-------------------------------------------------------------------------
This SF.net email is sponsored by DB2 Express
Download DB2 Express C - the FREE version of DB2 express and take
control of your XML. No limits. Just data. Click to get it now.
http://sourceforge.net/powerbar/db2/
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.