<!--
SPDX-FileCopyrightText: 2024 Lady <https://www.ladys.computer/about/#lady>
SPDX-License-Identifier: CC0-1.0
-->
# Lady’s Gitweb

This repository contains the source code for [Lady’s Gitweb
  instance][Git].
For more information, see [the Gitweb documentation][gitweb].

## Overview of Files

### Files Generated as Part of Gitweb Installation

The following files were created when installing Gitweb for the first
  time, and consequently were primarily authored by other people.

- **`gitweb.cgi`:**
  The Gitweb C·G·I script.

- **`static/gitweb.css`:**
  The C·S·S styling provided with Gitweb.

- **`static/gitweb.js`:**
  The Javascript provided with GitWeb.
  This file was originally built from a catenation of multiple source
    files.

### Files from Other Sources

- **`markdown.js`, `markdown.js.map`, and `markdown.wasm`:**
  These files provide version 1.2.0 of [Rasmus Andersson’s Web·assembly
    Markdown parser][markdown-wasm], used to dynamically render
    Markdown on the client.

### Additional Files

These files were created by Lady.

- **`git-favicon.png`:**
  The site favicon.

- **`git-logo.png`:**
  The site’s 27×72 button.

- **`gitweb_config.perl`:**
  Configuration for `gitweb.cgi`.

- **`mime.types`:**
  Additional media types which Gitweb should support.

- **`post-receive`:**
  A post⹀receive hook for updating a Gitweb installation at
    `/var/www/gitweb` upon changes to the `live` branch of this
    repository.

## License

This repository conforms to [REUSE][].

This repository contains a number of files from different locations and
  made available under different licenses, so it is necessary to check
  the comment header to determine the license associated with the code.
For some files which were programmatically generated, there may not be
  a comment header; in these cases one must check the accompanying
  `.license` file.

Note that the list of code authors provided in REUSE headers only
  includes those which were originally listed in the source files, and
  may be incomplete (for example; many contributors to Gitweb did not
  bother updating the copyright notices on the files they touched).
You should assume that there may be additional copyright holders for
  any code which did not originate with Lady.

[Git]: <https://git.ladys.computer/>
[REUSE]: <https://reuse.software/>
[gitweb]: <https://git-scm.com/docs/gitweb>
[markdown-wasm]: <https://rsms.me/markdown-wasm/>
