The Black Hack RPG text and tables, ready to be translated into your language
Python HTML CSS Makefile
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
.github refs #45 -- help about the PDF page breaks in the "Contributing" docu… Jan 14, 2017
brazilian-portuguese last fixes Oct 9, 2016
english tiny typo in English "Additional Things" Jul 24, 2016
french cleanup italian meta Sep 2, 2016
german Merge WIP into Master (#6) Jun 30, 2017
italian Fix the Italian "Cockatrice" translation Sep 3, 2016
japanese Update of Japanese translation -> v1.1 Sep 2, 2016
korean Update Mar 29, 2017
spanish Fix ugly table headers in Spanish translation Jan 16, 2017
static German PDFs upgraded Jul 3, 2017
templates Korean translation Jan 14, 2017
toolbox Rough versions of PDF. using the "beta" generator Sep 20, 2016
.gitignore refs #31 -- basic slugification test structure Aug 13, 2016
.travis.yml travis test Apr 19, 2016 v2.4.2 Jul 3, 2017
LICENSE initial commit for German version Mar 10, 2017
Makefile refs #21 -- Adding a PDF Builder Sep 20, 2016 contributing docs revamp Sep 21, 2016
build-requirements.pip Back to Python-Markdown 2.6.7, the 2.6.8 has added a regression with … Jan 26, 2017 refs #21 -- moving things around Sep 17, 2016 refs #21 -- Adding a PDF Builder Sep 20, 2016 refs #21 -- Adding a PDF Builder Sep 20, 2016
test-requirements.pip refs #31 -- basic slugification test structure Aug 13, 2016
tox.ini Don't give a specific version for python 3 Dec 4, 2016
wkhtmltopdf.css German PDFs upgraded Jul 3, 2017

The Black Hack

This project publishes the "raw text" of the Roleplaying game "The Black Hack", by David Black. As specified in the License document, the text and tables are open game content.

It means that anyone can use this open game content and make derivative works without asking for permission, as long as this derivative fits the Open Gaming License terms.

GitHub tag Travis

The name "The Black Hack" is used here with kind permission of the author.

See the License for more details.


The main document describing the guidelines on how to contribute is readable here. Please read it carefully in order to make sure your contribution will be easily reviewed and accepted.


You must have Python language available on your system, and either a way to create a virtualenv with a recent version of tox or a recent version of tox available system-wide.

To build the HTML pages, you can run on of the following commands:

make html
tox -e html

The build pages are in the build/ directory. This may help you if you try to fix or translate into a new language.

You'll probably won't have to, but if you want to build PDF files, you'll need to install wkhtmltopdf on your system. And you may run tox -e pdf to build PDF files.

If you want to target a specific language, you can run:

tox -e pdf -- french