55 lines
1.8 KiB
Markdown
55 lines
1.8 KiB
Markdown
# xdfcgi
|
|
|
|
A common gateway inferface (CGI) program written in C to display data related to Race CTS leaderboards of Xonotic servers. It may also serve as a static page generator.
|
|
|
|
## Requirements
|
|
sqlite-devel python3 python-sqlite
|
|
|
|
The first is only needed for compilation of the C program. The latter two are only for the auxiliary script `allmaps.py`.
|
|
|
|
## Compiling
|
|
`make` makes a CGI program.
|
|
|
|
`make staticgen` makes a static page generator.
|
|
|
|
## Usage: CGI Query Strings
|
|
The program queries the database `db/cts.db` (`./src/dbquery.c`, function `static bool executequery`)
|
|
|
|
* `(none)`
|
|
- Query file: `queries/mranks.sql`
|
|
- Requests the map list of the server and related data.
|
|
|
|
* `?map=[map name]`
|
|
- Query file: `queries/mleaderboard-ojoin.sql`
|
|
- Requests the leaderboard of the map.
|
|
|
|
* `?player=[clientid]`
|
|
- Query file: `queries/rplayers.sql`
|
|
- Requests a player's ranks for all maps leaderboards s/he is present on.
|
|
|
|
## Usage: Static Page Generation
|
|
|
|
python scripts/allmaps.py
|
|
|
|
The CGI program is still invoked in static generation. The files `allmaps.py`, `output/leaderboard.css`, `template.html`, `template_map.html` help produce the output.
|
|
|
|
Before executing `allmaps.py`, copy and modify the templates.
|
|
|
|
cp ./template-generic.html ./template.html
|
|
cp ./template_map-generic.html ./template_map.html
|
|
|
|
`allmaps.py` outputs an html file for all distinct maps in the database. The leaderboards for each map (equivalent to `?map=[map name]`) are in `output/maps/`.
|
|
|
|
## Game Versions Used Under:
|
|
* Xonotic 0.8.1
|
|
* Xonotic 0.8.2
|
|
|
|
## Compilers
|
|
* gcc (GCC) 10.2.1
|
|
* MinGW, GCC 4.7.1
|
|
__________________
|
|
|
|
This program uses an sqlite3 database file created from `~/.xonotic/data/data/server.db`.
|
|
|
|
The database may be built using [xonotic-py-sqlite3-defrag2db](https://git.teknik.io/antares/xonotic-py-sqlite3-defrag2db).
|