GitXplorerGitXplorer
s

xychan

public
2 stars
1 forks
1 issues

Commits

List of commits on branch master.
Unverified
c11b5fee351c3da403397d42a628400388b66275

Cosmetic fixes. Newlines after posts. Pin only first post.

ssixohsix committed 14 years ago
Unverified
faa1c16383ff8cf7fc6103f188db4c600374a1ae

Update readme

ssixohsix committed 14 years ago
Unverified
d548c090bbe457d629d4529afe8d869dda11c3cd

Update readme

ssixohsix committed 14 years ago
Unverified
79ffac0eb629abe5e69d034a2d356fdbe8354ad6

Update readme

ssixohsix committed 14 years ago
Unverified
5779f4db1feeca0f45957e609674f40bdfd95307

Give 404 error when image not found.

ssixohsix committed 14 years ago
Unverified
9093020fb35d807c39edb085b00803b80b032ec1

- Version bump.

ssixohsix committed 14 years ago

README

The README file for this repository.

xychan

xychan is a "chan-style" message board system like Wakaba, Kareha, Futaba, etc. Unlike these systems it's written in Python instead of a mess of Perl or PHP.

Actions speak louder than words. You can try it out here.

What is this, really?

A "chan board" is a message board that allows for Anonymous posting. Users can post messages without registering for an account or even entering a name. However, there are means for them to authenticate themselves and "prove" their identify if they so desire.

Another focus is the ability of users to post images. One image can be included with every post. A thumbnail of the image appears with the post.

Design Goals

xychan is designed to be:

  • easily deployed on almosy any web server (via CGI, FastCGI, Passenger, or any WSGI runner)
  • easily configured (uses SQLAlchemy to work with any database, from SQLite3 to MySQL, PostgreSQL, etc.)
  • easily extended and customized with CSS or template modification
  • scalable (at least compared to those other message boards)
  • small yet powerful

Status

This is BETA quality software. It is not yet stable. It changes a lot.

Downloads

How do I run it? - the EASY way (cgi)

  • Your web server needs Python 2.5 or higher
  • Your web server needs ImageMagick to support images on the board
  • Download the easily deployable zip file, above
  • Copy it to your webserver in an empty directory that supports CGI
  • Unzip it
  • Modify xychan.cgi in case there's anything you want to change there
  • Modify htaccess and copy it to .htaccess
  • Access path/to/xychan.cgi/setup on your webserver

How do I run it? - the SMART way

  • Your web server needs Python 2.5 or higher

  • Your web server needs ImageMagick to support images in the board

  • Your web server needs the following Python packages installed:

    • bottle
    • sqlalchemy
    • Some kind of database (eg. sqlite3)
  • Untar the xychan codebase

  • In your WSGI server::

     from xychan import app
     app.configure_db("postgres://user:password@host/dbname")
     # (or some similar SQLAlchemy db url)
     app.configure_image_dir("/some/safe/path/in/your/filesystem")
    

License

xychan is Free Software available under the GPL3 (GNU General Public License v3).

Those wanting to make closed-source commercial forks should contact me.

Why is it called xychan?

Characters typed at random.