File	Date	Author	Commit
AmiU4Shots	2004-08-03	Andrew Taylor	[359559] fixed image paths
css	2024-06-19	Karl Robillard	[4eb5fa] xu4.css: Prevent line break after date slash wi...
images	2024-06-26	Karl Robillard	[d98c9c] Add ankh favicon.
page-spec	2025-08-30	Karl Robillard	[5776b2] Remove a few PHP items from index.html and Make...
sheetmusic	2004-07-14	Doug Day	[e3de7f] Add web page to CVS
webmaps	2021-12-17	Karl Robillard	[6527ee] Update links to the Discussion forum and Source...
Makefile	2025-08-30	Karl Robillard	[5776b2] Remove a few PHP items from index.html and Make...
README	2024-06-26	Karl Robillard	[d86d70] README: Update link to shell service docs.
download.html	2025-08-16	Karl Robillard	[270802] Change download page to HTML.
faq.html	2025-08-17	Karl Robillard	[59114f] Change github.com URLs to codeberg.org.
history.html	2025-08-17	Karl Robillard	[59114f] Change github.com URLs to codeberg.org.
index.html	2025-08-30	Karl Robillard	[5776b2] Remove a few PHP items from index.html and Make...
links.html	2025-08-16	Karl Robillard	[270802] Change download page to HTML.
make-page.b	2025-08-17	Karl Robillard	[7311c8] make-page.b: Add *ln-file function to replace P...
screenshots.html	2025-08-16	Karl Robillard	[270802] Change download page to HTML.

Read Me

Quick and dirty guide to our Website
====================================

Overview
--------

Most of the site is in the "web" Git repository, but a separate download
directory is used on the web server for files that are large or change
frequently.

The site HTML is built using a code generator (a small Boron script).
A Makefile is used for updates, with transfers done via rsync.


Initial Setup
-------------

 - Export the environment variable "SF_USER" with your SourceForge user name.

 - Checkout the web repository:

       git clone ssh://${SF_USER}@git.code.sf.net/p/xu4/web

 - Run "make fetch_dl" to get a local copy of the download directory.


Modifying the Site
------------------

 - Change files in the page-spec/, css/, images/ & download/ directories as
   desired.

 - Run "make" to generate a local copy of the HTML files.  These may be
   inspected in a web browser before updating the site.

 - Use "make update" to upload the changed files to the web server

 - Commit and push both the page-spec/ source files and the generated output
   to Git.  The outputs are kept in the repository so that:

     1. Page changes can be checked using "git diff".
     2. Replacing the generator script (or returning to manual edits) could
        be more easily done.


Removing Files
--------------

To remove files from the server use an rsync command with the "--delete"
option or login to the web server.

To login create an interactive shell session
(see https://sourceforge.net/p/forge/documentation/Shell%20Service/):

    ssh -t ${SF_USER},xu4@shell.sourceforge.net create
    cd /home/project-web/xu4/htdocs