Source code of the EasyRPG homepage at https://easyrpg.org
- ruby >=2.7, version 3 is recommended
- nanoc >=4.12
- tidy-html5
- some gems
Homepage development is hosted by GitHub, project files are available in this git repository:
https://github.com/EasyRPG/easyrpg.org
Install needed gems (choose one):
$ make install # for building the site
$ make install-devel # for additional development and testing
$ make install-ci # for CI server, skips stuff
This will install all needed gems in the vendor/bundle
folder and provide
available commands in the bin
directory. You can use helper.bash
script
to add them to your $PATH
and therefore make them available to your shell.
Alternatively, you may run commands with prefix, i.e. bin/nanoc
.
$ source helper.bash
$ nanoc # to build the page
$ nanoc compile --watch # Automatically rebuild website on changes
$ nanoc view # Make website available at https://localhost:3000
$ nanoc live # Combination of last two commands
For convenience there is a Makefile
provided:
$ make # Compile website and view it
$ make compile # Compile website
$ make all # Clear, compile and check website
$ make check # Check compiled website for problems
$ make clean # Remove generated page
$ make distclean # Remove any generated files and bundled gems
For different environments, there are several changes in behaviour defined
(e.g. minifying of css/js, changed url), the environment variable NANOC_ENV
and CLI switch -env=SomeEnv
can be used. Currently, options are: default
(used if not provided), development
, production
, pr
and netlify
.
Site is available in a namespace at https://easyrpg.netlify.app. Pull request builds will be linked automatically after CI run.
Available options:
- File an issue at https://github.com/EasyRPG/easyrpg.org/issues
- Open a thread at https://community.easyrpg.org
- Chat with us via IRC: #easyrpg at Libera Chat
- Contact us at https://easyrpg.org/contact/
The homepage is currently provided "as-is", we are currently not able to have a common license for all files, as they have been cluttered over the years. We are going to clear that up and hope to provide it under a Creative Commons license later. We hope that this is in the intention of the original authors and designers (see issue #5 for reference).
Included are the following 3rd party software:
-
jQuery - https://jquery.com - Copyright (c) JS Foundation and other contributors, provided under the MIT license
-
jQuery EasyTabs plugin - https://os.alfajango.com/easytabs/ - Copyright (c) 2010-2011 Steve Schwartz (JangoSteve), dual licensed under the MIT and GPL licenses
-
Flurry jQuery Plugin - https://github.com/joshmcrty/Flurry - Copyright (c) 2016 Josh McCarty, provided under the GPLv2 license
-
Magnific Popup - https://dimsemenov.com/plugins/magnific-popup/ - Copyright (c) 2014-2016 Dmitry Semenov, provided under the MIT license
-
Favicons have been processed by https://realfavicongenerator.net
-
IRC contact page is provided by https://kiwiirc.com