sessioncommunities.online/CONTRIBUTING.md

Contribution guidelines

Development environment

Prerequisites

• PHP 8.1+
• make
• entr to watch for file changes
• xdg-open link handler to invoke browser
• libgd (php-gd, phpX.Y-gd) for downsizing images

Official repositories

• Codeberg: https://codeberg.org/gravel/sessioncommunities.online
• Lokinet Gitea (mirror): https://lokilocker.com/gravel/sessioncommunities.online
• GitHub (archive): https://github.com/mdPlusPlus/sessioncommunities.online
• Lokinet Gitea (archive): https://lokilocker.com/SomeGuy/sessioncommunities.online

Structure

fetch-servers.php queries available servers, and generate-html.php generates static HTML. Static HTML is generated from the sites directory to the output directory, which additionally contains static assets. All contents of sites are invoked to produce a HTML page unless they are prefixed with a + sign.

Development

Run at least once: make fetch to query servers. This takes around 15 seconds thanks to the coroutine implementation.

Run when developing: make dev to watch for changes & serve HTML locally in browser.

See Makefile for more details.

Recommended:

• Add the default include paths (., php) to your PHP intellisense.

• Symlink the commit hooks provided in etc/hooks to .git/hooks/<hook> to run a full test cycle when committing to main.

Running your own copy

• point your webserver at the output folder
• install and enable systemd services from the etc/systemd folder or an equivalent timer for periodic updates

Code style guidelines

General

Indentation: Tabs (4-wide)

Filename seperator: Hyphen (-)

PHP

Identifier casing: snake_case and CONSTANT_CASE

Comments and documentation: PHPDoc

HTML & CSS

Identifier casing: kebab-case, legacy snake_case

Comments and documentation: PHP no-ops instead of HTML comments, if possible

JavaScript

Identifier casing: camelCase and CONSTANT_CASE, occasional snake_case for references to DOM

Comments and documentation: JSDoc