Hi, Thanks for your comments; I'll (need to) go forward with this project when I'm back to work next year. I hope I remember to post a summary of what we did and why.
On Wednesday 23 December 2009 19.08:29 Kevin Horn wrote: > On Wed, Dec 23, 2009 at 7:53 AM, Adrian von Bidder <[email protected]>wrote: > > * changes (we work with svn, so we can track changes as is; perhaps > > somebody even has written some kind of "change bars" extension? This > > is not > > mandatory.) > > One of the reasons I like sphinx is that the source files are plain text, > and > are easy to manage is almost any version control system. I'm not > entirely sure what you're looking for here. The VCS part is easy. What I'm looking for (again: optional bonus feature :-) is to produce PDF documents that have change bars at the sides (I've seen this sometimes with standards documents, just black bars at the left or right side of the page to mark places that have changed versus the previous version of the document.) With the right tool, these should be easy to generate from "svn diff" output, but I'm not currently aware of any such tool. (ok, possibly not that easy, you'd need to match reST source code lines given in the diff to output locations...) > I use Sphinx almost exclusively from Windows, and have had no problems. Ok, this is good to hear. > As far as Editors go, I'm a big fan of SciTE, but Editra also looks > pretty nice. > Honestly, there's a bajillion and a half decent editors for Windows, free > and non-free. I think this comes down to user preference. Since I'm happy with vim (on Linux) and use my Windows installation only with reluctance if I absolutely have to, I don't usually care about Windows editors - but since I have to "sell" this proposal to our partners who'll have to write and maintain part of this documentation, I'll have to show them what a decent editor is. (OTOH they'd probably just use Windows notepad and not even notice that they're missing some features... ;-] ) cheers -- vbi -- Verbogeny is one of the pleasurettes of a creatific thinkerizer. --Peter da Silva
signature.asc
Description: This is a digitally signed message part.
