fink / web Goto Github PK

Our primary installation instructions right now are on http://finkproject.org/doc/bundled/install-fast.php resp. http://finkproject.org/doc/bundled/install-first.php

We mention connect.apple.com several times there, shouldn't we turn this into hyperlinks? More importantly, though, it tells the user to
Start out by copying the fink-0.35.1.tar.gz file to your home folder [...]

But as far as I can tell, there are no instructions on how to obtain this. I think we really should provide a hyperlink to it. Or perhaps even add a suitable wget / curl invocation for downloading it. Something like:

If you have not yet done so, download fink-0.35.1.tar.gz, for example via a webbrowser. Alternatively, you can download it directly in the terminal by entering the following command ... insert suitable curl invocation ...

The code for our website (and manual) is currently still stored in the web CVS module (resp. the virtual CVS modules xml and website, the former of which consists of the web/xml subdir, the latter is web minus web/xml).

Importing the code with its history (with fixed committer names, etc.) to git will be only the first step for that. We also need to adapt the code to work with git.

The primary obstacle I am aware of is that the XML files and surrounding scripts heavily rely on CVS tags like $Author$ and $Date$ in order to generate info about who last changed each page, and when.

One way to go about that is to simply remove the use of those tags from the XML files. Then, in the first iteration, just treat them as blank (we loose some nice information on the website, but at least we can switch to git). Better (and the long-term goal) will be to add a preprocess script which, given the XML file, uses git to retrieve the required information about each XML file, and then passes the data on to the XML preprocessor (resp. generates a temporary XML files with the correct data inserted -- but these are implementation details anyway).

Other than that (and some reordering of the file structure), we should be good.

This copy of the old CVS module is outdated. The real copy that's being updated is called "website".