Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Python docutils publishing on Google App Engine
Python Shell
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
decorator
doc
extractor
lib
model
tag
test
tools
var
.gitignore
.lvimrc
Makefile
ReadMe.rst
_conf.py
api.py
app.yaml
appengine_config.py
bluelines.py
chars.py
cleanup_sessions.py
cron.yaml
exception.py
gauth.py
handler.py
handler_old.py
index.yaml
interface.py
main.py
remote_api.py
render.py
server.py
storage.py
util.py

ReadMe.rst

Blue Lines

Python Docutils publishing

created:2009-03-27
updated:2010-06-22
project:https://launchpad.net/blue-lines
homepage:http://blue-lines.appspot.com/

Work in progress.

  • This would be not only a web-frontend for Docutils but also a document storage. Alas, there's still much to be done.
  • Current focus is on restfull API, HTML UI stuff is mostly old. There is a pre 0.1 version API that is somewhat working. At this point, http://rst2a.com is a more viable alternative if you need a docutils web-service.

About this file

This is the main page for the project, source code available using bzr branch lp:new-lines or git clone git://github.com/dotmpe/Blue-Lines.git.

The GAE deployment is at http://blue-lines.appspot.com/. This document should be online there.

Blue Lines project brings Python docutils and Nabu data mining to the GAE platform.

This primary goal is to publish reStructuredText files to various formats, a service is similar to rst2a but with different focus. The secondary aims are building indices from Nabu extracted data, and to experiment with various aspects of Du.

Description

The on-line features are under development, the current aims are:

  • A multi-user document base with private and public classification, authorised by Google Accounts. Future enhancements could possibly include user-groups and a PGP trust network?
  • Extraction and indexing of various data and microformats, such as references, contacts, book descriptions, etc.
  • Linking to documents on the web or on Blue Lines, within ones own document base or someone elses. Verifying the integrity of these references.
  • Backup and document processing using a to-be completed reStructuredText writer.
  • read on .. (Here be dragons).

Warning

Nabu Xml-RPC compatibility has been suspended in favor of an RESTfull API.

Download the old client here.

Overview

main.py
Script with WSGI Application hook for Google App-Engine.
handler.py
Maps requests to handler classes, runs all HTTP views among which legacy Nabu XMLRPC and the Blue Lines XMLRPC.
lib/
Holds bl_lib.zip which packs up all libraries for convenient deployment. Dependencies are discussed below.
server.py
The BL server facade, backward compatible with Nabu.
extractors/
Docutils transforms that are used to retrieve data entities from literal content.
model/
Data entities specific to GAE.
doc/
Static documentation that goes with the source-code. Also used to bootstrap the application's web-frontend.
var/
Static templates and other media.
tools/
Command-line scripts utilities.

Test

empty?

Dependencies

All external libraries are packed into lib/bl_lib.zip, available for download from Launchpad. The Makefile in the lib directory does an half-hearted attempt to gather these together, but will need to be adjusted per-host.

Libraries included into the ZIP archiver are:

Development

TODO: Links to current design documents, future plans go here.

Contributing

Launchpad provides the bug reporting and mailing list facilities. To get involved or if you need help, please subscribe there.

Any input is appreciated and it would be great to keep all efforts are bundled within one project, so please don't hesitate to vent your thoughts at the mailinglist.

TODO: establish HACKING guidelines.


[1]Using ReStructuredText on App Engine
Something went wrong with that request. Please try again.