Documentation du Quomodo Authoring Toolkit

Quomodo Authoring Toolkit (QAT) est un environnement de développement pour applications web collaboratives en HTML et javascript. Une page web Quomodo contient des smartnotes au moyen desquelles un utilisateur peut communiquer ou interagir avec d'autres membres d'un espace. Une smartnote peut être gratuite ou payante: la recette d'une smartnote est partagée en deux (50/50) entre Quomodo et l'auteur de la smartnote. QAT vous permet de créer votre propre smartnote en peu de temps .

A première vue, les smartnotes Quomodo ressemblent beaucoup aux Gadgets Microsoft, Google, et aux Widgets d'Apple. Il y a cependant deux différences importantes.

1. une smartnote Quomodo est partagée par les membres d'un groupe existant, et elle s'appuie sur l'existence du groupe auquel l'utilisateur appartient, et au sein duquel il communique, pour fournir une nouvelle gamme de services,
2. il est très facile de développer une smartnote Quomodo: vous pouvez commencer en quelques minutes, et des outils très simples suffisent.

Toute page web Quomodo appartient à un certain espace. Fondamentalement, un espace est partagé par un groupe ou une famille qui s'en sert pour mieux communiquer et interagir. Une smartnote est un élément HTML (un DIV) de la page, qui peut lui-même contenir du code HTML. La page d'un espace affiche les smartnotes de ce dernier. Un espace donné peut contenir des notes de différentes sortes. Une smartnote donnée appartient à un seul espace.

Par défaut, tous les membres de l'espace partagent toutes les smartnotes. Une smartnote peut gérer - et partager ou non - des informations propres à chaque utilisateur.

Le contenu et le comportement d'une smartnote sont décrits par des données, le Javascript Source Data de la smartnote, que le serveur Quomodo stocke et fournit sous la forme d'un Object (objet) Javascript (parfois appelé JSON: JavaScript Object Notation). Ce sont vos routines Javascript qui transforment le JSON en HTML, en renseignant un modèle HTML que vous fournissez également.

Une page peut contenir plusieurs smartnotes de la même sorte. Aussi le Source Data d'une smartnote contient-il un identifiant qui identifie de façon unique chaque instance de chaque sorte de smartnote dans un espace. Lors de la création d'une nouvelle instance d'une smartnote, le système lui attribue un identifiant unique.

Une smartnote a habituellement deux modes: le mode view (utilisation normale) et le mode edit (édition, c'est-à-dire modifications). Dans le mode edit l'utilisateur interagit soit directement avec la smartnote soit avec un menu que vous pouvez installer dans la marge gauche de la page, et qui ne s'affiche que quand l'utilisateur commute la smartnote en mode edit. Les modifications de l'utilisateur sont stockés dans le JSON. Lorsqu'il clique sur le boutton valider le JSON modifié est enregistré sur le serveur Quomodo.