Looking for offline docs

[Bill Woodward]

Good morning,

I'm going to be travelling this weekend (Austin, TX to Heidelberg,
Germany), without network access. I'd like to do some work with
TurboGears, and was wondering if there was a download for the docs for
TurboGears, Kid, SQLObject, CherryPy, and MochiKit, so I can access
them offline. I, of course, have already downloaded to 20-minute Wiki
video, but I need something a little more complete.

TIA,
- Bill

--
Bill Woodward wpw...@saifa.net http://www.saifa.net

"I have more trouble with D. L. Moody than with any other man I ever
met." -- D. L. Moody
s/D. L. Moody/Bill Woodward/g

[Kevin Dangoor]

That's a fair bit of time on the plane. I can see why you'd want offline docs.

I'd recommend checking out the subversion repository. Since there are
svn:externals set up, it will automatically grab the code from kid,
sqlobject, cherrypy, mochikit and formencode. All but turbogears and
cherrypy have their docs in restructured text, so you can conveniently
read just like that.

You can generate an offline version of the TurboGears site by running:
python setup.py docs

You will probably hit an error if you do that on a machine other than
mine. If you delete the "copydirs" line in setup.cfg, though, it
should work just fine. You won't have the epydoc API docs that way.
(But, you've got all of the code anyhow...)

Kevin

--
Kevin Dangoor
Author of the Zesty News RSS newsreader

email: k...@blazingthings.com
company: http://www.BlazingThings.com
blog: http://www.BlueSkyOnMars.com

[Bill Woodward]

On 10/6/05, Kevin Dangoor <dan...@gmail.com> wrote:
>
> That's a fair bit of time on the plane. I can see why you'd want offline docs.
>
> I'd recommend checking out the subversion repository. Since there are
> svn:externals set up, it will automatically grab the code from kid,
> sqlobject, cherrypy, mochikit and formencode. All but turbogears and
> cherrypy have their docs in restructured text, so you can conveniently
> read just like that.
>
> You can generate an offline version of the TurboGears site by running:
> python setup.py docs
>
> You will probably hit an error if you do that on a machine other than
> mine. If you delete the "copydirs" line in setup.cfg, though, it
> should work just fine. You won't have the epydoc API docs that way.
> (But, you've got all of the code anyhow...)
>
> Kevin
>

Thanks for the info. I was able to build the docs successfully
(although I did have to create a 'dist' directory), but I'm having
trouble building and installing turbogears itself. However, I'll
send another email about that.

Thanks again,

[wi...@phototropia.org]

Friends:
Now , with turbogears, I am using a text editor as an ide. Before
starting my first turbogear project, I was planning on moving to the
eric3 ide for my python coding.
1)Are any of you using an ide for your turbogears projects, and how is it
going?
2)Many of us struggle with project management, especially many of us whose
primary coding skills come for college courses, where it is not
emphasized. This becomes more confusing when an ide or app. has its own,
or an esoteric project management system. Between eggs and this fact, I
would not have tried turbogears if it didn't utilize so many apps that I
know to be really good. I am now happy that I did largely because
turbogears rolls things for me without stealing control.
Maybe documenting the use of an ide's project management system with
turb ogears would lower its barrier of entry, or documenting how to
set up a project with just a text editor would be better?
I ask this because I hope to be able to contibute to the wiki, and
would like to document tools/methods useful to the community while I
improve in their usage.

Will

[David Guaraglia]

Hi Will,

I'm using Scite currently for most of my python development, but after
watching the 20 Minutes Wiki video I fell in love with Textmate. In
fact, it looks *a lot* like Scite with a file browser, so I decided to
create a file browser that could be attached to Scite, maybe name it
"SciteMate", who knows... I'm reading a lot of documents (the ones
describing the interface to Scite, and such), and I think it would be
easy to implement. More news on this when I have something useable.

About Eric3: it's a great IDE, but I don't use it because it has a few
shortcomings (at least under Windows): it's too slow (Scintilla, the
editor component crawls some times), doesn' draw very well, doesn't
complete from the symbols defined in the current file, and the debugger
is... well, let's say that "intuitive" isn't the definition for some of
it's features.

Python doesn't need a lot to get started, and really there's little need
for something like a 'project' manager in an script language, as you
don't need to compile and link the resulting files. So my best
recomendation would be Scite + good configuration + some debugger (if
under windows, winpdb is a nice option).

David

[Kevin Dangoor]

On 10/7/05, David Guaraglia <dguar...@gmail.com> wrote:
> I'm using Scite currently for most of my python development, but after
> watching the 20 Minutes Wiki video I fell in love with Textmate. In
> fact, it looks *a lot* like Scite with a file browser, so I decided to
> create a file browser that could be attached to Scite, maybe name it
> "SciteMate", who knows... I'm reading a lot of documents (the ones
> describing the interface to Scite, and such), and I think it would be
> easy to implement. More news on this when I have something useable.

It would be nice to have something like TextMate for the times when I
need to use Windows. Right now, I use jEdit on Windows.

> About Eric3: it's a great IDE, but I don't use it because it has a few
> shortcomings (at least under Windows): it's too slow (Scintilla, the
> editor component crawls some times), doesn' draw very well, doesn't
> complete from the symbols defined in the current file, and the debugger
> is... well, let's say that "intuitive" isn't the definition for some of
> it's features.
>
> Python doesn't need a lot to get started, and really there's little need
> for something like a 'project' manager in an script language, as you
> don't need to compile and link the resulting files. So my best
> recomendation would be Scite + good configuration + some debugger (if
> under windows, winpdb is a nice option).

I was a heavy user of Eclipse when I was writing Java. I agree with
you here, that the value of an IDE is somewhat diminished with a
language like Python. TextMate's ability to "find in project" and
switch quickly between files is all the project management I've seemed
to need for comfortably doing Python development.

Kevin

[Lee McFadden]

I quite like vim for python development. In fact, i use vim for most
text editing if I can.

On windows, however it's a bit more difficult. Komodo by ActiveState
is very good, but I don't want to pay for it (I'm cheap like that) and
SciTE is my current favorite. Still, IDLE does ok for pottering
around and pythonwin (via the win32 extensions) isn't half bad either.

In the end it just comes down to to personal preference and trying a
few different editors really.

[João Paulo Fernandes Farias]

If you have a big screen and like vim, I would recommend PIDA[1].

Pida is just vim with some extra stuff...

[1] http://pida.berlios.de/index.php/Main_Page

--
JP

[Tim Lesher]

On 10/7/05, wi...@phototropia.org <wi...@phototropia.org> wrote:
>
> Friends:
> Now , with turbogears, I am using a text editor as an ide. Before
> starting my first turbogear project, I was planning on moving to the
> eric3 ide for my python coding.
> 1)Are any of you using an ide for your turbogears projects, and how is it
> going?

Well, it looks like the only major editor not yet mentioned is emacs.
So, I'll put in my own vote. I use emacs with James Clark's excellent
nxml-mode for kid. It automatically checks both well-formedness and
validity as you type. Good stuff.


--
Tim Lesher <tle...@gmail.com>

[Jeremy Jones]

João Paulo Fernandes Farias wrote:

> If you have a big screen and like vim, I would recommend PIDA[1].
>
> Pida is just vim with some extra stuff...
>
> [1] http://pida.berlios.de/index.php/Main_Page

I never knew this existed! Thank you for pointing it out! This is
*exactly* what I've been looking for!

- jmj

[Mike Pirnat]

Hopefully pida is getting a bit more stable... I played around with it
a bit a month or two ago, and while it shows tremendous promise, I
managed to encounter a number of wonky issues (the embedded vim liked
to segfault a lot). If it's starting to settle down, I'll have to
give it another look; it seemed like a really great idea with a really
similar philosophy to TurboGears.

--
Mike Pirnat
mpi...@gmail.com

[Jeremy Jones]

I'm using it right now. I'll write back (or probably blog...or maybe
both) about how it's going. It's got a couple of annoyances, but
overall it's exactly what I've been looking for.

- jmj

[Lee McFadden]

I've also switched to it and I'll be looking to try and get it working
under windows (although I'm not holding my breath).

[David Guaraglia]

Hope you are lucky, though it's a PITA (no pun intended) to make
something written in GTK work on windows...

David