From: Christian Weiske <cweiske@cweiske.de>
Date: Thu, 11 May 2023 19:55:45 +0000 (+0200)
Subject: Add README
X-Git-Url: https://git.cweiske.de/gamestick-pjgsapi.git/commitdiff_plain/4b860b4195c4c36db58348b97ee7a6a6609a191e

Add README
---

diff --git a/.gitignore b/.gitignore
index a580b75..c20a6c8 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,2 +1,3 @@
 /cache/
 /config.php
+/README.html
diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..8b5ae01
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,33 @@
+PlayJam GameStick API server
+****************************
+
+Makes PlayJam GameSticks usable after the official server had been shut down
+in 2017.
+
+
+Setup
+=====
+
+1. Copy ``config.php.dist`` to ``config.php``
+2. Clone the `game data repository <https://codeberg.org/gamestick-fans/game-data>`_::
+
+     $ git clone https://codeberg.org/gamestick-fans/game-data.git
+3. Unpack one of the cache files::
+
+     $ cd game-data
+     $ gunzip -k caches/2017-01-12T00\:19\:12-alex.shorts.pretty.json.gz
+4. Generate the popular and featured menus from the cache file::
+
+     $ ./bin/list-popular.php 'caches/2017-01-12T00:19:12-alex.shorts.pretty.json' > ../cache/popular.txt
+     $ ./bin/list-featured.php 'caches/2017-01-12T00:19:12-alex.shorts.pretty.json' > ../cache/featured.json
+5. Fill the caches for this API::
+
+     $ cd ..
+     $ ./bin/generate-apps-cache.php game-data/classic/
+6. Setup the Apache web server and point the virtual host to the ``www/`` directory.
+
+
+About
+=====
+This server software was written by `Christian Weiske <https://cweiske.de/>`_
+and is licensed under the AGPL v3.
diff --git a/cache/.gitkeep b/cache/.gitkeep
new file mode 100644
index 0000000..e69de29