h5ai/README.md

52 lines
2.3 KiB
Markdown
Raw Normal View History

2011-07-28 21:25:48 -04:00
# h5ai
2013-08-16 12:29:02 -04:00
**h5ai** is a modern HTTP web server index for Apache httpd, lighttpd, nginx and Cherokee.
2012-10-13 09:23:30 -04:00
The preferred way to report a bug or make a feature request is to
2013-09-04 09:57:48 -04:00
create [a new issue](https://github.com/lrsjng/h5ai/issues/new) on GitHub!
2011-11-26 14:53:51 -05:00
2011-07-28 21:25:48 -04:00
2012-10-13 09:23:30 -04:00
## Install
2013-08-16 12:18:38 -04:00
**Note:** please don't use files from the `src` folder for installation,
they need to be preprocessed to work correctly!
2012-10-13 09:23:30 -04:00
You'll find a preprocessed package, as well as detailed installation
instructions on the [project page](http://larsjung.de/h5ai/).
2011-06-15 19:24:49 -04:00
2012-08-05 11:39:33 -04:00
## Build
2013-08-16 12:18:38 -04: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 11:39:33 -04:00
> npm install -g fquery
2012-09-18 10:46:48 -04:00
This will install fQuery and its command line tool `makejs`. Run `makejs --help` to see if everything
2013-08-16 12:18:38 -04:00
worked fine. To clone and build the project run the following commands.
2012-10-13 09:36:04 -04:00
You'll find a new directory `build` including a fresh zipball.
2012-09-18 10:46:48 -04:00
> git clone git://github.com/lrsjng/h5ai.git
> cd h5ai
2012-09-18 10:59:11 -04:00
> makejs release
2012-08-05 11:39:33 -04:00
2011-11-01 17:33:00 -04:00
2012-10-13 09:23:30 -04:00
## License
2013-09-04 09:57:48 -04:00
**h5ai** is provided under the terms of the [MIT License](https://github.com/lrsjng/h5ai/blob/develop/LICENSE.md).
2012-10-13 09:26:44 -04:00
2012-10-13 09:23:30 -04:00
It profits from these great projects:
2014-05-29 11:38:04 -04: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 09:23:30 -04:00
[HTML5 ★ Boilerplate](http://html5boilerplate.com) (MIT),
2014-05-29 11:38:31 -04:00
[jQuery](http://jquery.com) (MIT),
2012-10-13 15:37:06 -04:00
[jQuery.filedrop](http://www.github.com/weixiyen/jquery-filedrop) (MIT),
2012-10-13 09:23:30 -04:00
[jQuery.fracs](http://larsjung.de/fracs/) (MIT),
2013-09-04 09:57:48 -04:00
[jQuery.mousewheel](https://github.com/brandonaaron/jquery-mousewheel) (MIT),
2012-10-13 09:23:30 -04:00
[jQuery.qrcode](http://larsjung.de/qrcode/) (MIT),
[jQuery.scrollpanel](http://larsjung.de/scrollpanel/) (MIT),
2013-09-04 09:57:48 -04:00
[markdown-js](https://github.com/evilstreak/markdown-js) (MIT),
2012-10-13 09:23:30 -04: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)