mirror of https://github.com/naturalcrit/homebrewery.git synced 2025-12-24 18:32:41 +00:00

Files

G.Ambatte ba600f5da6 FreeBSD installation (#1165 )

* Update server.js

Eliminate requirement to CD into project directory prior to running `npm start` or `node server.js`.

* Add rc.d daemon script

Adds a RC.d daemon script to control the HomeBrewery status. Based on Andrew Pearson's Node-RED script for the same purpose.

* Create install.sh

* Update install.sh

* Update install.sh

Switch to latest version of MongoDB

* Add config items

Add config items and default values:
- web_port (8001)
- environment (local)

* Remove environment variables from rc.d

Remove environment variables from rc.d as they are now in config/default.json.

* Update server.js

Change to setting NODE_ENV; default to 'local' if not set via environment variable or in the config file.

* Remove --force option

Remove --force option from `npm audit fix`. While this has not caused any issues to date, there is no guarantee that it will continue to be the case.

* Create README.FREEBSD.md

Initial write up of install instructions. Includes instruction to `wget` from the `naturalcrit/homebrewery` project rather than the FreeBSD fork, on the assumption that the PR will be merged at some point.

* Update install.sh

Change to main project repo, on assumption that the PR will be merged at some point

* Change install directory

Change of install directory to `/usr/local/homebrewery`

* Update homebrewery

Add `dev_mode` to the HomeBrewery service, which starts the HomeBrewery project in live rebuild mode.

* Update server.js

Eliminating unnecessary debugging code, reducing line count and making lint happy :)

* Update server.js

Lint is happy, now attempting to pacify CircleCI

* Move NODE_ENV to service file; remove from server.js and config/default.json

* Remove hanging comma in config.json
Change default port assignment from 8000 to 8001 in config.json and FreeBSD service config

* Add link to FreeBSD install documenation in the main README.md file

* Fix for MongoDB package update breaking install script
Change to enable use of rcvars for NODE_ENV and PORT

2021-01-10 17:44:49 -05:00

6.1 KiB

Raw Blame History

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. The code is open source, so feel free to clone it, tinker with it. If you want to make changes to the code, you can run your own local version for testing by following the installation instructions below.

Installation

First, install three programs that the Homebrewery requires to run and retrieve updates:

install node
install mongodb (Community version)

For easiest installation, follow these steps:
1. In the installer, uncheck the option to run as a service
2. You can install MongoDB Compass if you want a GUI to view your database documents
3. Go to the C drive and create a folder called "data"
4. Inside the "data" folder, create a new folder called "db"
5. Open a command prompt or other terminal and navigate to your mongodb install folder (c:program files\mongo\server\4.4\bin)
6. In the command prompt, run "mongod", which will start up your local database server
7. While MongoD is running, open a second command prompt and navigate to the mongodb install folder
8. In the second command prompt, run "mongo", which allows you to edit the database
9. Type use homebrewery to create the homebrewery database. You should see switched to db homebrewery
10. Type db.brews.insert({"title":"test"}) to create a blank document. You should see WriteResult({ "nInserted" : 1 })
11. Search in Windows for "Advanced system settings" and open it
12. Click "Environment variables", find the "path" variable, and double-click to open it
13. Click "New" and paste in the path to the mongodb "bin" folder
14. Click "OK", "OK", "OK" to close all the windows
install git (select the option that allows Git to run from the command prompt)

Checkout the repo (documentation):

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

Second, you will need to add the environment variable NODE_ENV=local to allow the project to run locally.

You can set this temporarily in your shell of choice:

Windows Powershell: $env:NODE_ENV="local"
Windows CMD: set NODE_ENV=local
Linux / OSX: export NODE_ENV=local

Third, you will need to install the Node dependencies, compile the app, and run it using the two commands:

npm install
npm start

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

Running the application via Docker

Please see the docs here: README.DOCKER.md

Running the application on FreeBSD or FreeNAS

Please see the docs here: README.FreeBSD.md

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.

Contributing

You are welcome to contribute to the development and maintenance of the project! There are several ways of doing that:

At the moment, we have a huge backlog of issues and some of them are outdated, duplicates or doesn't contain any useful info. In order to help you can mark duplicates, try to reproduce some complex or weird issues, try with finding a workaround for a reported bug or just mention issue managers team to let them know about outdated issue via @naturalcrit/issue-managers.
Our subreddit is constantly growing and there are number of bug reports: any help with sorting them out is very welcome.
And of course you can contribute by fixing a bug or implementing a new feature by yourself, we are waiting for your pull requests!

Anyway, if you would like to get in touch with the team and discuss/coordinate your contribution to the project, please join our gitter chat.

6.1 KiB Raw Blame History