Artifact 4ac7121aa47d8ce6321128097884528354428a7606d60a83efb01c1e31270fad:
- File
www/server/any/althttpd.md
— part of check-in
[1fd407f6]
at
2023-05-10 17:02:02
on branch trunk
— In an effort to make www/* source documents read as cleanly as their
rendered counterparts, replaced nearly all use of HTML "p" tags, relying
instead on the Wiki and Markdown markup features to achieve the same
appearance. The only uses remaining are:
- in Markdown nested lists, where blank lines should render the list items as separate paragraphs just as at the list's top level; since it does not, if you want a line break, you either have to wrap the item in "p" tags or do the double-br hack.
- in Wiki where blank lines within a list give you a separate list in the HTML output; this is fine for bullet lists, but with numbered lists it causes the numbering to restart unless you do the same sort of manual HTML workaround as with the prior item
- in plain HTML docs and wiki docs between "nowiki" tags
In many places, this cleanup gets rid of pointless stray "p" tags, placating HTML verifiers. (user: wyoung size: 1407) [more...]
Serving via althttpd
Althttpd is a light-weight web server that has been used to implement the SQLite and Fossil websites for well over a decade. Althttpd strives for simplicity, security, ease of configuration, and low resource usage.
To set up a Fossil server as CGI on a host running the althttpd web server, follow these steps.
- Get the althttpd webserver running on the host. This is easily done by following the althttpd documentation.
- Create a CGI script for your Fossil repository. The script will
be typically be two lines of code that look something like this:
#!/usr/bin/fossil repository: /home/yourlogin/fossils/project.fossil
Modify the filenames to conform to your system, of course. The CGI script accepts other options besides the repository:" line. You can add in other options as you desire, but the single "repository:" line is normally all that is needed to get started.
- Make the CGI script executable.
- Verify that the fossil repository file and the directory that contains the repository are both writable by whatever user the web server is running and.
And you are done. Visit the URL that corresponds to the CGI script you created to start using your Fossil server.