diff --git a/README.rst b/README.rst index 7203aaa..9a6b11a 100644 --- a/README.rst +++ b/README.rst @@ -3,14 +3,14 @@ Brutal Maze Brutal Maze is a thrilling shoot 'em up game with minimalist art style. -.. image:: https://raw.githubusercontent.com/McSinyx/brutalmaze/master/screenshot.png - :target: https://McSinyx.github.io/brutalmaze/ +.. image:: https://brutalmaze.rtfd.io/_images/screenshot.png + :target: https://brutalmaze.rtfd.io/recplayer.html -The game features a trigon trapped in an infinite maze. As our hero tries to -escape, the maze's border turns into aggressive squares trying to stop him. -Your job is to help the trigon fight against those evil squares and find a way -out (if there is any). Be aware that the more get killed, the more will show up -and our hero will get weaker when wounded. +The game features a trigon trapped in an infinite maze. As our hero tries +to escape, the maze's border turns into aggressive squares trying to stop per. +Your job is to help the trigon fight against those evil squares and find +a way out (if there is any). Be aware that the more get killed, +the more will show up and our hero will get weaker when wounded. Brutal Maze has a few notable features: @@ -30,17 +30,14 @@ Installation Brutal Maze is written in Python and is compatible version 3.6 and above. The installation procedure should be as simple as follows: -* Install Python and `pip `_. Make sure the - directory for `Python scripts `_ +* Install Python and pip_. Make sure the directory for `Python scripts`_ is in your ``$PATH``. * Open Terminal or Command Prompt and run ``pip install --user brutalmaze``. -For more information, see -`Installation `_ -page from Brutal Maze wiki. +For more information, see Installation_ page from the documentation. After installation, you can launch the game by running the command -``brutalmaze``. Below are the default bindings, which can be configured as +``brutalmaze``. Below are the default bindings, which can be configured as shown in the next section: F2 @@ -62,9 +59,9 @@ Left Mouse Right Mouse Close-range attack, also dodge from bullets. -Additionally, Brutal Maze also supports touch-friendly control. In this mode, -touches on different grid (empty, wall, enemy, hero) send different signals (to -guide the hero to either move or attack, or start new game). Albeit it is +Additionally, Brutal Maze also supports touch-friendly control. In this mode, +touches on different grid (empty, wall, enemy, hero) send different signals +(to guide the hero to either move or attack, or start new game). Albeit it is implemented using *mouse button up* event, touch control is not a solution for mouse-only input, but an attempt to support mobile GNU/Linux distribution such as postmarketOS, i.e. it's meant to be played using two thumbs :-) @@ -90,21 +87,18 @@ Later-read preferences will override previous ones. Remote control -------------- -If you enable the socket server [4]_, Brutal Maze will no longer accept direct -input from your mouse or keyboard, but wait for a client to connect. Details -about I/O format are explained carefully in -`Remote control `_ -wiki page. +If you enable the socket server [4]_, Brutal Maze will no longer accept +direct input from your mouse or keyboard, but wait for a client to connect. +The I/O format is explained in details in the `Remote Control`_ page. Game recording -------------- Either game played by human or client script can be recorded to JSON format. This can be enabled by setting the output directory to a non-empty string [5]_. -Recordings can be played on the repo's Github Page which the above screenshot -is linked to. +Recordings can be played using Brutal Maze `HTML5 record player`_. -License +Copying ------- Brutal Maze's source code and its icon are released under GNU Affero General @@ -114,19 +108,24 @@ allow them to download the source code corresponding to the modified version running there. This project also uses Tango color palette and several sound effects, whose -authors and licenses are listed in -`Credits `_ wiki page. +authors and licenses are listed in the Copying_ page in our documentation. -.. [0] Broken on vanilla pygame on GNU/Linux. For workarounds, see issue - `#11 `_. +.. [0] Broken on vanilla pygame on GNU/Linux. For workarounds, see issue + `#3 `_. .. [1] This can be copied to desired location by ``brutalmaze --write-config - PATH``. ``brutalmaze --write-config`` alone will print the file to stdout. + PATH``. ``brutalmaze --write-config`` alone will print the file to stdout. .. [2] These will be listed as fallback config in the help message - (``brutalmaze --help``). See `wiki `_ - for more info. + (``brutalmaze --help``). See the Configuration_ documentation for more info. .. [3] If specified by ``brutalmaze --config PATH``. .. [4] This can be done by either editing option *Enable* in section *Server* - in the configuration file, or launching Brutal Maze using ``brutalmaze - --server``. -.. [5] ``brutalmaze --record-dir DIR``. Navigate to `wiki `_ + in the configuration file or launching the game via ``brutalmaze --server``. +.. [5] ``brutalmaze --record-dir DIR``. Navigate to Configuration_ to see more options. + +.. _pip: https://pip.pypa.io/en/latest/ +.. _Python scripts: https://docs.python.org/3/install/index.html#alternate-installation-the-user-scheme +.. _Installation: https://brutalmaze.rtfd.io/install.html +.. _Remote Control: https://brutalmaze.rtfd.io/remote.html +.. _HTML5 record player: https://brutalmaze.rtfd.io/recplayer.html +.. _Copying: https://brutalmaze.rtfd.io/copying.html +.. _Configuration: https://brutalmaze.rtfd.io/config.html diff --git a/brutalmaze/game.py b/brutalmaze/game.py index fef7494..ecf23d6 100644 --- a/brutalmaze/game.py +++ b/brutalmaze/game.py @@ -16,7 +16,7 @@ # You should have received a copy of the GNU Affero General Public License # along with Brutal Maze. If not, see . -__version__ = '0.9.2' +__version__ = '0.9.3' import re from argparse import ArgumentParser, FileType, RawTextHelpFormatter diff --git a/docs/source/conf.py b/docs/source/conf.py index f8f1a8e..c94e002 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -22,7 +22,7 @@ copyright = '2017-2020, Nguyễn Gia Phong' author = 'Nguyễn Gia Phong' # The full version, including alpha/beta/rc tags -release = '0.9.2' +release = '0.9.3' # -- General configuration --------------------------------------------------- diff --git a/docs/source/credits.rst b/docs/source/copying.rst similarity index 98% rename from docs/source/credits.rst rename to docs/source/copying.rst index f4ec6a7..2e8be16 100644 --- a/docs/source/credits.rst +++ b/docs/source/copying.rst @@ -1,4 +1,4 @@ -Credits +Copying ======= This listing is our best-faith, hard-work effort at accurate attribution, @@ -21,8 +21,8 @@ running there. Other creative works retain their original licenses as listed below. -Tango Color Palette -------------------- +Color Palette +------------- Brutal Maze uses the Tango color palette by `the Tango desktop project`_ to draw all of its graphics. The palette is released to the Public Domain. diff --git a/docs/source/images/screenshot.png b/docs/source/images/screenshot.png deleted file mode 120000 index ad2460b..0000000 --- a/docs/source/images/screenshot.png +++ /dev/null @@ -1 +0,0 @@ -../../../screenshot.png \ No newline at end of file diff --git a/docs/source/images/screenshot.png b/docs/source/images/screenshot.png new file mode 100644 index 0000000..48d5f88 Binary files /dev/null and b/docs/source/images/screenshot.png differ diff --git a/docs/source/index.rst b/docs/source/index.rst index 9fd2712..cb67b83 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -4,7 +4,6 @@ Overview Brutal Maze is a thrilling shoot 'em up game with minimalist art style. .. image:: images/screenshot.png - :target: recplayer.html Notable features: @@ -28,11 +27,11 @@ Table of Contents config gameplay remote - credits + copying -Indices and tables ------------------- +Record Player +------------- -* :ref:`genindex` -* :ref:`modindex` -* :ref:`search` +.. raw:: html + + diff --git a/screenshot.png b/screenshot.png deleted file mode 100644 index 48d5f88..0000000 Binary files a/screenshot.png and /dev/null differ