diff options
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 56 |
1 files changed, 56 insertions, 0 deletions
diff --git a/README.md b/README.md new file mode 100644 index 000000000..7a3793424 --- /dev/null +++ b/README.md @@ -0,0 +1,56 @@ +# FileBin + +A pastebin software running on [https://paste.xinu.at](https://paste.xinu.at). +In addition to uploading text and code it also supports binary files. + +Additional documentation can be found in [`./doc`](doc/). + +## Installation/Development + +Git is used for tracking changes and updating installations. The repository is +located at [https://git.server-speed.net/users/flo/filebin/](https://git.server-speed.net/users/flo/filebin/). +Clone the repository and follow the instructions in `./INSTALL`. Do not +install using tarballs as this is not supported. + +`dev` is the development branch and should not be used in production. All +stable changes go to `master` and will be tagged regularly following [semver +guidelines](http://semver.org/). + +### Mailing List + +Currently there is only [one mailing +list](https://lists.server-speed.net/listinfo/filebin-general) for everything +(general discussion, patches, announcements, ...). If need be more lists will be +created at a later date. + +### IRC + +The official IRC channel is [irc.freenode.net/#filebin](irc://irc.freenode.net/#filebin). + +### Patches + +Please submit patches (preferably git send-email) to the [filebin-general +mailing list](https://lists.server-speed.net/listinfo/filebin-general). You do +not need to register to be allowed to post. + +You can also open a pull request on [GitHub](https://github.com/Bluewind/filebin). + + +## Dependencies + +* PHP >=5.5 with the following modules + * gd for thumbnail generation + * exif for thumbnail generation + * phar for tarball creation + * mysql, mysqli, pgsql, pdo_mysql (any of those) for database access + * mbstring for multibyte support + * finfo for mimetype detection + * xdebug for tests (not required on production) + +* [composer](https://getcomposer.org/) for dependency management +* [pygmentize](http://pygments.org/) for code highlighting +* [ansi2html](http://pypi.python.org/pypi/ansi2html) for shell output rendering (ANSI color codes) +* [imagemagick](http://www.imagemagick.org/) for additional thumbnail generation + * ghostscript for PDF thumbnail creation via imagemagick +* [node.js](https://nodejs.org/) for javascript minification + |