Skip to content
Nimrod CSS
Find file
Latest commit f6f4e5c @dom96 dom96 Implemented quotes.

README.md

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!

Note: If you do not have a mail server set up locally, you can specify -d:dev during compilation to prevent nimforum from attempting to send emails and to automatically activate user accounts

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.

Something went wrong with that request. Please try again.