TiddlyHome

HomePage

2008-09-27 08:15

Welcome to TiddlyHome 2.0 ^Beta

TiddlyHome 2.0 is an early alpha Google AppEngine hosting service for TiddlyWiki users.

Guided tour

Use /BidiX/tiddlywikis and /BidiX/namespaces to explore
Use /comments to leave comment
But please login and try
... and stay tuned !

Your own TiddlyWiki at TiddlyHome 2.0

a google account is required
login and set a username for TiddlyHome2
create a new TiddlyWiki at /{YourName}/tiddlywikis page
Optionally, from the new tiddlywiki page, you can Upload a local TiddlyWiki

How it works

environment

TiddlyHome2 is a Google App Engine application where :

user authentication is done by Google Account
authorization and protection are manage by user
content (tiddlers) are saved in Google Datastore
conform to the TiddlyWiki single file paradigm

The data model:

User owns Namespaces
User owns Tiddlywikis
Namespace owns Tiddlers
TiddlyWiki, in a Namespace, references Tiddlers

RESTFull Api

see TiddlyHome Restful API for details
Then TiddlyHome 2.0 could be easily called from an other application

TiddlyHome Restful API

2008-09-27 08:13

Following this model above the TiddlyHome1 API.

URI Resources

User

{username}
Display the resource {username}

Namespace

{username}/namespaces
Namespace container owns by {username}.
{username}/namespaces{namespace_id}
{namespace_id} owns by {username}.

Tiddler

{username}/namespaces{namespace_id}/tiddlers
Tiddler container in {namespace_id} owns by {username}.
{username}/namespaces{namespace_id}/tiddlers{tiddler_id}
{tiddler_id} in {namespace_id} owns by {username}.

Tiddlywiki

{username}/tiddlywikis
Tiddlywiki container own by {username}.
{username}/tiddlywikis{tiddlywiki_id}
{tiddlywiki_id} owns by {username}.

Requests to TiddlyHome Service

Actually PUT is not implemented.

For now requested content-type (HTTP Request header) are not interpreted. All responses, except when specified, are in Content-type: text/html.

Return code conform to model.

User

GET {username}
Return username and mail address.Need more developments.
GET www.google.com/accounts/ServiceLogin?...
For now available only from a browser. Redirect to the current page once the login (or logout) is done.

Namespace

GET {username}/namespaces
List of Namespace own by {username}.
POST {username}/namespaces
Create or update namespace with these attributes :
- name
- access: 'on' | ''
- owner_name:
- previous_name: if different from name, previous name is deleted.
- return_url: response redirect to this url
GET {username}/namespaces?new
Return a form that submit a POST {username}/namespaces. This form is empty.
GET {username}/namespaces{namespace_id}
return an HTML page for {namespace_id} details.
GET {username}/namespaces{namespace_id}?edit
Return a form that submit a POST {username}/namespaces. This form is filled with {namespace_id} details.
DELETE {username}/namespaces{namespace_id}
GET {username}/namespaces{namespace_id}?delete
Delete {namespace_id}.

Tiddlywiki

GET {username}/tiddlywikis
List of Tiddlywiki own by {username}.
POST {username}/tiddlywikis
Create or update tiddlywiki with these attributes :
- name
- namespace_name
- access: 'on' | ''
- title
- subtitle
- {tiddler_title}: 'on' | '' (for each tiddler in {namespace_name})
- previous_name: if different from name, previous name is deleted.
- return_url: response redirect to this url
PUT {username}/tiddlywikis{tiddlywiki_id}?put
POST {username}/tiddlywikis{tiddlywiki_id}?put
Not documented
GET {username}/tiddlywikis?new
Return a form that submit a POST {username}/tiddlywikis. This form is empty.
GET {username}/tiddlywikis{tiddlywiki_id}
return an HTML page for {tiddlywiki_id} details.
GET {username}/tiddlywikis{tiddlywiki_id}.html
return a TiddlyWiki page for {tiddlywiki_id}.
GET {username}/tiddlywikis{tiddlywiki_id}.xml
return a xml page in RSS format for {tiddlywiki_id}.
GET {username}/tiddlywikis{tiddlywiki_id}?edit
Return a form that submit a POST {username}/tiddlywikis. This form is filled with {tiddlywiki_id} details.
GET {username}/tiddlywikis{tiddlywiki_id}?upload
Return a form that upload a TiddlyWiki a POST {username}/tiddlywikis{tiddlywiki_id}?put.
DELETE {username}/tiddlywikis{tiddlywiki_id}
GET {username}/tiddlywikis{tiddlywiki_id}?delete
Delete {tiddlywiki_id}.

Tiddler

GET {username}/namespaces{namespace_id}/tiddlers
List of Tiddler in {namespace_id}.
POST {username}/namespaces{namespace_id}/tiddlers
Create or update a tiddler with these attributes :
- title
- tags
- text
- html: wikified text
- previous_title: if different from title, previous title is deleted.
- return_url: response redirect to this url
GET {username}/namespaces{namespace_id}/tiddlers?new
Return a form that submit a POST {username}/namespaces{namespace_id}/tiddlers. This form is empty.
GET {username}/namespaces{namespace_id}/tiddlers{tiddler_id}.html
return an HTML page {tiddler_id} only with html content for publishing (Tiddlyhomes use this for HomePage and HelpPage).
GET {username}/namespaces{namespace_id}/tiddlers{tiddler_id}.txt
return a text/plain page for {tiddler_id} text.
GET {username}/namespaces{namespace_id}/tiddlers{tiddler_id}.js
return a text/plain page for {tiddler_id} text.
GET {username}/namespaces{namespace_id}/tiddlers{tiddler_id}.tw
return a text/plain page for {tiddler_id} in TiddlyWiki StoreArea format.
GET {username}/namespaces{namespace_id}/tiddlers{tiddler_id}?edit
Return a form that submit a POST {username}/namespaces{namespace_id}/tiddlers. This form is filled with {tiddler_id} details.
DELETE {username}/namespaces{namespace_id}/tiddlers{tiddler_id}
GET {username}/namespaces{namespace_id}/tiddlers{tiddler_id}?delete
Delete {tiddler_id}.

OldHomePage

2008-09-26 19:57

Welcome to TiddlyHome 2.0 ^Beta

TiddlyHome 2.0 is an early alpha Google AppEngine hosting service for TiddlyWiki users where :

tiddlers are store in Datastore
users are managed by Google Account

The data model:

User owns Namespaces
User owns Tiddlywikis
Namespace owns Tiddlers
TiddlyWiki, in a Namespace, references Tiddlers

RESTFul API:

Two basic URL templates:

/{user_id}/namespaces/{namespace_id}/tiddlers/{tiddler_id}[.suffix]
/{user_id}/tiddlywikis/{tiddlywiki_id}[.suffix]

Command:

/storeTiddler : update a tiddler with UploadTiddlerPlugin
/{user_id}/tiddlywikis/{tiddlywiki_id}?upload : upload a Tiddlywiki file into {tiddlywiki_id}

Experiment:

iTW - a TiddlyWiki for iPhone available /BidiX/tiddlywikis/iTW.html

Sandbox:

Use /BidiX/namespaces and /BidiX/tiddlywikis to explore
Use /comments to leave comment
But please login and play with it
... and stay tuned !

A Model for a RESTful API

2008-09-26 19:55

This article suggests a model for a RESTful API usable in a browser without using AJAX and that manage a suffix to request a particular content-type.

This model is implemented has a generic extension to Google Engine webapp. See it in action in TiddlyWiki context at TiddlyHome

Resource

The typical URI of a resource is :

{type}s{id}[.{format}]

like in /tiddlywikis/HowTo.html.

To obtain the list of all resources of a type simply :

{type}s

Membership relation

When the resource is linked to an other resource, especially to explain membership, the URI becomes :

{parent_type}s{parent_id}{children_type}s{children_id}

(ex: /tiddlywikis/HowTo/tiddlers/Upload ).

Basic functions on resource

In RESTful API, the CRUD basic functions on a persistent resource can be accessed using HTTP methods :

HTTP Method	Function
`GET {uri_id`}	Read {resource_id}
`PUT {uri_id`}	Create or Update {resource_id}
`DELETE {uri_id`}	Delete {resource_id}
`POST {a_form`}	Ask service to Create, Update or Delete some resource using {a_form}

API to manage a resource

API call	Application function called
`GET {type}s`	Type.list()
`GET {type}{id}[.{format}]`	id.display[_in_{format}]()
`GET {type}{id}[.{format}]`	404
`PUT {type}s{id`}	id.put()
`DELETE {type}s{id`}	id.delete()
`POST {type}s`	Type.create_or_update()

RESTful extensions for browser

Since methods PUT and DELETE can't easily be activated in a browser (except using AJAX). The query_string part of the URL is used to simulate PUT or DELETE.
On server, the Handler first changes the query_string in the corresponding method :

URL with query_string	API Call
`GET {type}s{id}?delete`	`DELETE {type}s{id`}
`GET {type}s{id}?put`	`PUT {type}s{id`}
`GET {type}s?new`	`GET {type}s` - with an attribut in_form = True
`GET {type}s{id}?edit`	`GET {type}s{id`} - with an attribut in_form = True

Specifying Content-type

To easily specify the content-type required, a suffix is added to the resource like : .html, .xml, .txt .js ...

Return codes

Finally HTTP Status are used in response to HTTP request. Their normalised meaning are used, sometimes with some restrictive sense in the API context.

HTTP Code	HTTP status message	API Meaning
200	OK	Ok
201	Created	New entity created
400	Bad Request	The URL can't be processed (Type doesn't exist, bad format requested ...)
401	Unauthorized	The logged user is not authorized to execute this action
403	Forbidden	Action is not allowed
404	Not Found	Resource doesn't exist
405	Method not allowed	This resource doesn't allow this method (operation)
406	Not acceptable

Overview

2008-09-23 20:29

Welcome to TiddlyHome 2.0 ^Beta

TiddlyHome 2.0 is an early alpha Google AppEngine hosting service for TiddlyWiki users where :

tiddlers are store in Datastore
users are managed by Google Account

The data model:

User owns Namespaces
User owns Tiddlywikis
Namespace owns Tiddlers
TiddlyWiki, in a Namespace, references Tiddlers

RESTFul API:

Two basic URL templates:

/{user_id}/namespaces/{namespace_id}/tiddlers/{tiddler_id}[.suffix]
/{user_id}/tiddlywikis/{tiddlywiki_id}[.suffix]

Command:

/storeTiddler : update a tiddler with UploadTiddlerPlugin
/{user_id}/tiddlywikis/{tiddlywiki_id}?upload : upload a Tiddlywiki file into {tiddlywiki_id}

Experiment:

iTW - a TiddlyWiki for iPhone available /BidiX/tiddlywikis/iTW.html

Sandbox:

Use /BidiX/namespaces and /BidiX/tiddlywikis to explore
Use /comments to leave comment
But please login and play with it
... and stay tuned !

zzTweaks

2008-09-23 20:26

config.options. chkOpenInNewWindow = false;

UploadTiddlerPlugin

2008-09-14 20:54

/*** |''Name:''|UploadTiddlerPlugin| |''Description:''|Upload a tiddler and Update a remote TiddlyWiki | |''Version:''|1.2.2| |''Date:''|2008-09-13| |''Source:''|http://tiddlywiki.bidix.info/#UploadTiddlerPlugin| |''Usage:''|Uses {{{<>}}}
with those UploadTiddler Options :
chkUploadTiddler: <

HelpPage

2008-09-05 20:26

TiddlyHome is a hosting service for TiddlyWiki

To learn more on TiddlyWiki the starting point is the TiddlyWiki site maintained by JeremyRuston the creator of TiddlyWiki.

Then TiddlyHome could become the online home for your TiddlyWikis.

Getting started

Login with your Google account
Create an empty TiddlyWiki
If you already have a TiddlyWiki, Upload your TiddlyWiki from your local disk
Now you can access your TiddlyWiki online
Access it online and edit
Download to edit in local. You will be able to Upload it later

To learn more

But there are a lot of other functionalities that you will be able to use when you need them

Share tiddlers between several TiddlyWikis
Create namespaces to host your Tiddlers
Publish a blog or an article you have edited in TiddlyWiki
etc.

To be guided, feel free to ask BidiX.

Version 0-1.2 - 2008-07-05

2008-07-08 05:51

title and shadow tiddlers updated in html template from TiddlyWiki entity
markup blocks updated in html template with corresponding tiddlers
iTW is working
extend tiddler title with {tiddlywiki_name}:: to get it private for a tiddlywiki
html_escape and html_unescape use xml.sax.saxutils library

Version 0-1.5 - 2008-07-08

2008-07-08 05:50

Correction de html_unescape: ajout de """
?download
remove logging for each imported tiddler

Experimental iTW available at TiddlyHome 2.0

2008-07-07 05:58

Just as a proof of concept, an iTW is available at http://tiddlyhome.appspot.com/BidiX/tiddlywikis/iTW . The full TiddlyWiki is available (in Safari) at http://tiddlyhome.appspot.com/BidiX/tiddlywikis/iTW.html.

Tickets

2008-07-06 21:49

~~not logged user can't see Tiddlywikis~~
~~username of a Tiddler must be a string. When a tiddlywiki is uploaded, the modifier should not change.~~
~~Error when unlogged user try to edit a Namespace~~
~~Error when a not logged user try to delete~~
~~a tiddler edit add a new key of this tiddler in tiddlywiki.tiddlers~~
~~if a . (dot) in tiddler title or Tiddlywiki name or Namespace name (in url) the dispatcher is unable to handle (it tries a format)~~
if <tiddlywiki_id>.tiddlers isn't clean (some tiddlers don't exist anymore). Format .html is in error
<tiddler>.modified could be a string => <tiddlywiki>.xml bugs.
Bad request when tiddler has a '/' in title
~~Bug in Firefox with external links ????~~

Version 0-1.1 - 2008-06-30

2008-07-01 06:03

cgi.escape of tiddler.text in tiddler.displayInStoreArea
redirectAll of BidiX to TiddlyHome

Version 0.12 - 2008-06-15

2008-07-01 05:51

redirect permanently /BidiX/tiddlywiki/feed.xml to /BidiX/tiddlywikis/feed.xml

Version 0.10 - 2008-06-14

2008-07-01 05:51

Better Tiddler presentation
Code refactoring
Change all urls from /<type>/<type_id> to /<type>s/<type_id>

Version 0.14 - 2006-06-15

2008-07-01 05:51

Refactoring of send_page
presentation enhancement
Ticket 6 : if a . (dot) in tiddler title or Tiddlywiki name or Namespace name (in url) the dispatcher is unable to handle (it tries a format)
install HelpHandler

Version 0.20 - 2008-06-16

2008-07-01 05:51

Ticket 2 username of a Tiddler must be a string. When a tiddlywiki is uploaded, the modifier should not change.
Don't display user's email address if current_user not logged.
Sort tiddler :
1. by Date in <tiddlywiki_id>.xml
2. by Title in <tiddlywiki_id> and <namespace_id>

Version 0.14 - 2008-06-15

2008-07-01 05:51

Refactoring of send_page
presentation enhancement
Ticket 6 : if a . (dot) in tiddler title or Tiddlywiki name or Namespace name (in url) the dispatcher is unable to handle (it tries a format)
install HelpHandler

Version 0.24 - 2008-08-20

2008-07-01 05:51

Modifer is now a String not a User
When a Namespace is deleted : Tiddlers and TiddlyWikis are deleted
<tiddlywiki>.xml sorted by modifier

Version 0.26 - 2006-06-22

2008-07-01 05:51

SiteTitle, SiteSubitle and SiteUrl Shadow tiddlers filled with <tiddlywiki> attributes
html header filled with <tiddlywiki> attributes
zzTiddlyHomeTweaks and StoreTiddlerPlugin added to new TiddlyWiki

Version 0.05 - 2008-05-29

2008-07-01 05:51

decode('utf-8') on uploaded file
some css tweaks

Version 0.04 - 2008-05-28

2008-07-01 05:51

.txt and .js for tiddler
Home page in a tiddler
.html for tiddler

Version 0.03 - 2008-05-27

2008-07-01 05:50

Ticket 1 : Access to public tiddlywiki by not logged user bug

Version 0.00

2008-07-01 05:50

2008-05-30

Ticket 3

2008-05-29

decode('utf-8') on uploaded file
some css tweaks

2008-05-28

.txt and .js for tiddler
Home page in a tiddler
.html for tiddler

2008-05-27

Access to public tiddlywiki by not logged user bug (Ticket 1)

Version 0.09 - 2008-06-09

2008-07-01 05:50

bug in <tiddlywiki>.xml</tiddlywiki>

Version 0.08 - 2008-06-09

2008-07-01 05:50

Ticket 5 : a tiddler edit add a new key of this tiddler in tiddlywiki.tiddlers

Version 0.07 - 2008-06-08

2008-07-01 05:50

UploadTiddlerPlugin 1.2.0
1. Upload a new html field with a rendered format using core wikifyStatic
Tiddler
1. optionnal attribut html
manage <tiddlywiki_id>.xml
use tiddler.html for .html tiddler format
use TiddlyWiki format to manage TiddlyHome site
1. HomePage
2. News
3. Help
4. Feed
presentation (CSS)
1. Traditional ul/li

</tiddlywiki_id>

Version 0.06 - 2008-05-30

2008-07-01 05:50

Ticket 3 : Error when unlogged user try to edit a Namespace

Options

2008-06-25 07:07

Basic

UserName :
UploadUserName :
UploadFilename :
UploadTiddlerStoreUrl :
UploadTiddler:

see also AdvancedOptions and Tweaks

Data Model

2008-06-24 09:22

User is an extension of Google User with a username
User owns Namespaces
User owns Tiddlywikis
Namespace owns Tiddlers
TiddlyWiki, in a Namespace, references Tiddlers

Some rules :

only the owner of an entity (TiddlyWiki, Namespace, Tiddler) can edit it
a Namespace (or a TiddlyWiki) can be private.
only the owner of a private Namespace (or a Tiddlywiki) can see it

DefaultTiddlers

2008-06-22 20:53

HomePage

TiddlyHome

HomePage

Welcome to TiddlyHome 2.0 Beta

Guided tour

Your own TiddlyWiki at TiddlyHome 2.0

How it works

environment

The data model:

RESTFull Api

TiddlyHome Restful API

URI Resources

User

Namespace

Tiddler

Tiddlywiki

Requests to TiddlyHome Service

User

Namespace

Tiddlywiki

Tiddler

OldHomePage

Welcome to TiddlyHome 2.0 Beta

The data model:

RESTFul API:

Command:

Experiment:

Sandbox:

A Model for a RESTful API

Resource

Membership relation

Basic functions on resource

API to manage a resource

RESTful extensions for browser

Specifying Content-type

Return codes

Overview

Welcome to TiddlyHome 2.0 Beta

The data model:

RESTFul API:

Command:

Experiment:

Sandbox:

zzTweaks

UploadTiddlerPlugin

HelpPage

Getting started

To learn more

Version 0-1.2 - 2008-07-05

Version 0-1.5 - 2008-07-08

Experimental iTW available at TiddlyHome 2.0

Tickets

Version 0-1.1 - 2008-06-30

Version 0.12 - 2008-06-15

Version 0.10 - 2008-06-14

Version 0.14 - 2006-06-15

Version 0.20 - 2008-06-16

Version 0.14 - 2008-06-15

Version 0.24 - 2008-08-20

Version 0.26 - 2006-06-22

Version 0.05 - 2008-05-29

Version 0.04 - 2008-05-28

Version 0.03 - 2008-05-27

Version 0.00

2008-05-30

2008-05-29

2008-05-28

2008-05-27

Version 0.09 - 2008-06-09

Version 0.08 - 2008-06-09

Version 0.07 - 2008-06-08

Version 0.06 - 2008-05-30

Options

Basic

Data Model

DefaultTiddlers

Welcome to TiddlyHome 2.0 ^Beta

Welcome to TiddlyHome 2.0 ^Beta

Welcome to TiddlyHome 2.0 ^Beta