www-new/srv/@dweb.md

1.8 KiB

dweb - A simple website written in D

dweb is a simple website framework inspired by the werc software.

Its principles are:

  • Database free, uses files and directories instead.
  • Written using the D programming language.
  • Minimize tedious work: eg., no need to ever write HTML, use markdown instead.
  • Very minimalist yet extensible codebase. Handlers for special things should be easy to add.

It was created because werc was annoying to deploy on UW Computer Science Club's Apache setup and because Not Invented Here.

Install Guide

You will need:

  • An HTTP server with CGI support.
  • The D compiler.

Extract the contents into the location you want to serve webpages from. Edit the following files:

  • $DWEB_ROOT/.htaccess: make the rewrite path work for your setup.
  • $DWEB_ROOT/src/config.d: change these things as desired. Custom handlers are added in init_handlers. The key is the glob to activate the handler, and the value is the bin/ relative path of the handler.
  • $DWEB_ROOT/src/web.d: this is the core code.
  • $DWEB_ROOT/pub/: static content goes here.
  • $DWEB_ROOT/srv/: directories, markdown webpages etc. go in here.
  • $DWEB_ROOT/bin/: custom handlers go here.

Run ./build in $DWEB_ROOT/src to recompile the website software.

Source

You can get the source code on github or by running

 git clone git://github.com/j3parker/dweb.git

Contact

For questions, suggestions, bug reports and contributing patches email j3parker

License

Public domain.

Credits

The idea and css stolen from werc. This page itself also plagarised.

Thanks to John Gruber for the Markdown.pl script.