h5ai/README.md

52 lines
2.3 KiB
Markdown
Raw Normal View History

2011-07-29 03:25:48 +02:00
# h5ai
2013-08-16 18:29:02 +02:00
**h5ai** is a modern HTTP web server index for Apache httpd, lighttpd, nginx and Cherokee.
2012-10-13 15:23:30 +02:00
The preferred way to report a bug or make a feature request is to
2013-09-04 15:57:48 +02:00
create [a new issue](https://github.com/lrsjng/h5ai/issues/new) on GitHub!
2011-11-26 20:53:51 +01:00
2011-07-29 03:25:48 +02:00
2012-10-13 15:23:30 +02:00
## Install
2013-08-16 18:18:38 +02:00
**Note:** please don't use files from the `src` folder for installation,
they need to be preprocessed to work correctly!
2012-10-13 15:23:30 +02:00
You'll find a preprocessed package, as well as detailed installation
instructions on the [project page](http://larsjung.de/h5ai/).
2011-06-16 01:24:49 +02:00
2012-08-05 17:39:33 +02:00
## Build
2013-08-16 18:18:38 +02:00
There are repositories for the latest [releases](http://release.larsjung.de/h5ai/) and [dev builds](http://release.larsjung.de/h5ai/dev/).
But if you want to build **h5ai** yourself you need to install the build tool [fQuery](http://larsjung.de/fquery/) first:
2012-08-05 17:39:33 +02:00
> npm install -g fquery
2012-09-18 16:46:48 +02:00
This will install fQuery and its command line tool `makejs`. Run `makejs --help` to see if everything
2013-08-16 18:18:38 +02:00
worked fine. To clone and build the project run the following commands.
2012-10-13 15:36:04 +02:00
You'll find a new directory `build` including a fresh zipball.
2012-09-18 16:46:48 +02:00
> git clone git://github.com/lrsjng/h5ai.git
> cd h5ai
2012-09-18 16:59:11 +02:00
> makejs release
2012-08-05 17:39:33 +02:00
2011-11-01 22:33:00 +01:00
2012-10-13 15:23:30 +02:00
## License
2013-09-04 15:57:48 +02:00
**h5ai** is provided under the terms of the [MIT License](https://github.com/lrsjng/h5ai/blob/develop/LICENSE.md).
2012-10-13 15:26:44 +02:00
2012-10-13 15:23:30 +02:00
It profits from these great projects:
2014-05-29 17:38:04 +02:00
[Evolvere Icon Theme](http://franksouza183.deviantart.com/art/Evolvere-Icon-theme-440718295) (CC BY-NC-ND 3.0),
[Faenza Icons](http://tiheum.deviantart.com/art/Faenza-Icons-173323228) (GPL),
[Gnome Symbolic Icon Theme](https://git.gnome.org/browse/gnome-icon-theme-symbolic/) (CC BY-SA 3.0),
2012-10-13 15:23:30 +02:00
[HTML5 ★ Boilerplate](http://html5boilerplate.com) (MIT),
2012-10-13 21:37:06 +02:00
[jQuery.filedrop](http://www.github.com/weixiyen/jquery-filedrop) (MIT),
2012-10-13 15:23:30 +02:00
[jQuery.fracs](http://larsjung.de/fracs/) (MIT),
2013-09-04 15:57:48 +02:00
[jQuery.mousewheel](https://github.com/brandonaaron/jquery-mousewheel) (MIT),
2012-10-13 15:23:30 +02:00
[jQuery.qrcode](http://larsjung.de/qrcode/) (MIT),
[jQuery.scrollpanel](http://larsjung.de/scrollpanel/) (MIT),
2014-05-29 17:38:04 +02:00
[jQuery](http://jquery.com) (MIT),
2013-09-04 15:57:48 +02:00
[markdown-js](https://github.com/evilstreak/markdown-js) (MIT),
2012-10-13 15:23:30 +02:00
[Modernizr](http://www.modernizr.com) (MIT/BSD),
[modulejs](http://larsjung.de/modulejs/) (MIT),
[Moment.js](http://momentjs.com) (MIT),
[SyntaxHighlighter](http://alexgorbatchev.com/SyntaxHighlighter/) (MIT/GPL),
[Underscore.js](http://underscorejs.org) (MIT)