antville/README.md

52 lines
3.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# About Antville
Antville is an open source project providing a high performance, feature-rich blog hosting software. Antville can host tens of thousands of blogs. Server power is the only limit. Installation and use is easy.
Antville is written in server-side JavaScript and developed with Helma Object Publisher. Antville works with a relational database in the back-end.
[Look at the project site for more information.](https://project.antville.org)
## Status
Antvilles codebase is of stable quality and ready for production deployment. Try out [Antville.org](https://antville.org) for a demonstration.
There still could be bugs hidden in Antvilles source code. If you find one please let us know. The creators of Antville do not take any responsibility for what the software might do.
## System Requirements
To run Antville you need [Helma Object Publisher](https://github.com/antville/helma) and a relational database software. We tested Antville with [PostgreSQL](https://postgresql.org) and [MySQL](https://mysql.com) [MariaDB](https://mariadb.com) should work, too.
To enable Antville sending notification e-mails you need access to an SMTP server.
Helma comes with an embedded webserver (Jetty) so you do not need to install one. Yet, you can also use the webserver of your choice.
For details please refer to the installation instructions of Helma Object Publisher and the corresponding software packages.
The `INSTALL.md` file contains detailed instructions to install Antville.
## Documentation and Further Information
For documentation and further information about Antville you can refer to:
- [project.antville.org](https://project.antville.org)
- [about.antville.org](https://about.antville.org)
- [help.antville.org](https://help.antville.org)
Feel free to ask any question about Antville at our [support site](https://help.antville.org).
## Bug Reporting and Feature Requests
If you think you found a bug [please let us know](https://project.antville.org).
A great place for your feature requests or proposals is the [project development site](https://project.antville.org).
Antville is open-source, and we want to encourage you to change its code according to your likeness. We are curious about your ideas and suggestions. Feel free to drop us a message to <mail@antville.org> or through any channels mentioned before.
## About Helma Object Publisher
[Helma Object Publisher](https://github.com/antville/helma) is an open source project providing a powerful, fast and scriptable web application server written in Java.
Define HopObjects and map them to a relational database table. Create, change and delete HopObjects at your whim using a comfortable object-container model. Manual fiddling around with database code is not necessary.
HopObjects extend the native JavaScript object. They got all the common features you know and more. One highlight are the special templating features to ease the rendering of objects for the Web.
Combine HopObjects to create a hierarchical structure. A URL in Helma mirrors this structure. Each part of the URL path corresponds to a relational database mapping, similar to the document tree of static websites. Helmas URL space is an analogy to the Document Object Model implemented in client-side JavaScript.