Josh Kuperman <[EMAIL PROTECTED]> wrote: > Sure I'd be happy to work on it. Though the only difficult thing about > it is getting all the html documentation uniformly placed I think it > can be done very simply. What I think would be great is if every > package had a index.html file in /sw/share/doc/$PACKAGENAME which > would either say the html docs hadn't been created yet, or pointed or > was symlinked to docs in /sw/share/doc/$PACKAGENAME/html/
Getting the fink maintainers to do this consistently would certainly take quite some time, at the very least. In the meanwhile, we would have the awkward situation that many of the things you clicked on would just give a directory listing. Also, I have several hundred packages installed. If only 10% of these actually have html docs, do I want to be clicking on all these directories of the other ones, just to be told that there are no html docs? I was thinking that we could ask fink maintainers to put a file with a few lines like <li> <a href="../mypackage/packagedocs/index.html">my package</a></li> into a standard place, and then somehow assemble all of those lines into the web page that we want. > > The following can be done now. This example assume the Apache included > with OS X and fink in the usual place.. > > Edit /etc/httpd/httpd.conf and Put something like this in > > Alias /finkdoc /sw/share/doc > <Directory /sw/share/doc> > order allow,deny > allow from all > #or if you want to keep it on a local vpn or somesuch > #allow from 192.168.1.0/24 > #deny from all > #hopefully my rather mid level older iMac won't get swamped with > #people trying to read fink docs > Options Indexes FollowSymLinks > </Directory> > > This makes my it so I can type in http://www.ssimr.com/finkdoc and > look at the doc directory. This is enough to get to the html docs in > two or three clicks. The downside is that many packages don't have > html documentation. Though most browser can also read the text > files. I could write a perl script to create a web page that just > included the html docs. Though I think simply asking that all packages > have an index.html in /sw/share/doc/$PACKAGENAME would work. > I'm a bit worried about how we get an addition made to httpd.conf in the context of fink. Many people will be editing this file on their own. However, so long as "FollowSymLinks" applies in the root web directory, you can just make a symlink from there to an appropriate place in the fink tree. That strikes me as something that is very doable. > This isn't to say a lot more couldn't be done -- thorough indexing and > crossreferencing, etc. Obviously in the ideal world everything would > be done in SGML and the install scripts would generate all the > extremely comprehensive and accurate docs in man, texinfo, and html > format (maybe even some pdf and/or ps books) in the right place. > -- Dave _______________________________________________ Fink-users mailing list [EMAIL PROTECTED] https://lists.sourceforge.net/lists/listinfo/fink-users
