]> git.jsancho.org Git - datasette-pytables.git/blobdiff - README.md
A smaller screenshot
[datasette-pytables.git] / README.md
index 0347a31f1ce42d18656fce566573a8f906af1e58..57e027049ead7f5689b7bdb576d46d5b8ded94bd 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,17 +1,22 @@
-# datasette-pytables
+[![Build Status](https://travis-ci.org/PyTables/datasette-pytables.svg?branch=master)](https://travis-ci.org/PyTables/datasette-pytables)
+
 
-Datasette-PyTables provides a web interface and a JSON API for [PyTables](https://github.com/PyTables/PyTables) files, allowing them to be accessible for Javascript programs, for example. It works in conjunction with [Datasette-Core](https://github.com/PyTables/datasette-core), a modified version of the original [Datasette](https://github.com/simonw/datasette), which provides a web interface for SQLite files.
+# datasette-pytables
 
-The modified version is able to work with SQLite files, like the original project, but can accept external connectors for any kind of database files, so you can develop your own connector for your favourite data container if you want (read [developers doc](https://github.com/PyTables/datasette-pytables/blob/master/DEVELOPERS.md))
+Datasette-PyTables provides a web interface and a JSON API for [PyTables](https://github.com/PyTables/PyTables) files, allowing them to be accessible for e.g. Javascript programs. It works in conjunction with [Datasette-Core](https://github.com/PyTables/datasette-core), a trivial fork of the original [Datasette](https://github.com/simonw/datasette), which provides a web interface for SQLite files.  This fork is able to work with SQLite files, like the original project, but can accept external connectors for any kind of database files, so you can develop your own connector for your favourite data container if you want (read [developers doc](https://github.com/PyTables/datasette-pytables/blob/master/DEVELOPERS.md)).
 
 ## Installation
 
-Run `pip install datasette-pytables` to add the modified version of Datasette and the PyTables connector to your environment. Easy!
+Run `pip install datasette-pytables` to install both the forked version of Datasette and the PyTables connector. Easy as pie!
 
 ## How to serve PyTables files
 
     datasette serve path/to/data.h5
 
-This will start a web server on port 8001, so you can access to your data visiting [http://localhost:8001/](http://localhost:8001/)
+This will start a web server on port 8001; then you can access to your data visiting [http://localhost:8001/](http://localhost:8001/)
 
 Read the [Datasette documentation](http://datasette.readthedocs.io/en/latest/) for more advanced options.
+
+See how a typical Table query looks like in the Datasette-PyTables web interface:
+
+![Datasette Screenshot](/images/Datasette-Screenshot.png)