0
0
mirror of https://github.com/naturalcrit/homebrewery.git synced 2025-12-24 16:22:44 +00:00
Files
homebrewery/README.md
2020-01-21 10:05:22 -05:00

2.3 KiB

The Homebrewery

The Homebrewery is a tool for making authentic looking D&D content using Markdown. It is distributed under the terms of the MIT License.

Quick Start

The easiest way to get started using the Homebrewery is to use it on our website. If you have larger brews or want to make changes to the code follow the installation instructions below.

Installation

First, install two programs that the Homebrewery requires to run.

  1. install node
  2. install mongodb

Second, download a copy of the repository. If you have git you can do so with

git clone https://github.com/naturalcrit/homebrewery.git

Third, you will need to modify line 9 of the file server.js so that it looks like:

//app.use(require('./server/forcessl.mw.js'));

Fourth, you will need to install the program and run it using the two commands:

  1. npm install
  2. npm start

You should now be able to go to http://localhost:8000 in your browser and use the Homebrewery offline.

Standalone PHB Stylesheet

If you just want the stylesheet that is generated to make pages look like they are from the Player's Handbook, you will find it in the phb.standalone.css file.

If you are developing locally and would like to generate your own, follow the above steps and then run npm run phb.

Issues, Suggestions, and Bugs

If you run into any issues using The Homebrewery or have suggestions for improvement, please submit an issue on GitHub. You can also get help for issues on the subreddit r/homebrewery

Changelog

You can check out the changelog.

License

This project is licensed under the MIT license. Which means you are free to use The Homebrewery in any way that you want, except for claiming that you made it yourself.

If you wish to sell or in some way gain profit for what's created on this site, it's your responsibility to ensure you have the proper licenses/rights for any images or resources used.