77b7812994
There was no information about how to create the db. I also added informations about compiling it on OS X (which can be removed after the bcryptnim maintainer has updated his package. There is a PR for that from me).
2.2 KiB
nimforum
This is Nim's forum. Available at http://forum.nim-lang.org.
Building
You can use nimble (available here
to get all the necessary
dependencies.
Clone this repo and execute nimble build in this repositories directory.
See also: Running the forum for how to create the database
Dependencies
The code depends on the RST parser of the Nim compiler and on Jester. The code generating captchas for registration uses the cairo module, which requires you to have the cairo library installed when you run the forum, or you will be greeted by a cryptic error message similar to:
$ ./forum could not load: libcairo.so(1.2)
Mac OS X
cairo
If you are using macosx and have installed the cairo library through
MacPorts you still need to add the library path to
your LD_LIBRARY_PATH environment variable. Example:
$ LD_LIBRARY_PATH=/opt/local/lib/ ./forum
Replace /opt/local/lib with the correct path on your system.
bcrypt
On macosx you also need to make sure to use the bcrypt >= 0.2.1 module if that is not yet updated you can install it with:
nimble install https://github.com/oderwat/bcryptnim.git@#fix-osx
You may also need to change nimforum.nimble such that it uses 0.2.1 by
changing the dependencies slightly.
[Deps]
Requires: "nimrod >= 0.10.3, cairo#head, jester#head, bcrypt >= 0.2.1"
Running the forum
Important: You need to compile and run createdb to generate the initial database
before you can run forum the first time!
This is as simple as:
nim c -r createdb
After that you can just run forum and if everything is ok you will get the info which URL you need to open in your browser (http://localhost:5000) to access it.
There is an update helper editdb which you can safely ignore for now.
The files captchas.nim, cache.nim are included by forum.nim and do
not need to be compiled by you.
Copyright
Copyright (c) 2012-2015 Andreas Rumpf, Dominik Picheta.
All rights reserved.
License
Nimforum is licensed under the MIT license.