Author: mfortun Date: 2011-08-30 13:09:30 +0200 (Tue, 30 Aug 2011) New Revision: 1204 Url: http://nuiton.org/repositories/revision/wikitty/1204 Log: checkpoint for how to doc Modified: trunk/wikitty-publication/src/site/doc/Faire_une_application_publication.rst trunk/wikitty-publication/src/site/doc/Outils_publication.rst Modified: trunk/wikitty-publication/src/site/doc/Faire_une_application_publication.rst =================================================================== --- trunk/wikitty-publication/src/site/doc/Faire_une_application_publication.rst 2011-08-30 10:32:56 UTC (rev 1203) +++ trunk/wikitty-publication/src/site/doc/Faire_une_application_publication.rst 2011-08-30 11:09:30 UTC (rev 1204) @@ -6,33 +6,67 @@ Comment faire ? --------------- +Pour faire une application pour Wikitty Publication ce n'est pas compliqué. +Il y a deux solutions: Depuis un système de fichier **************************** +L'idéal est utilisé le plugin maven prévu à cet effet. +Il faut un Pom élémentaire comme présenté dans la doc outils_publication, et +d'initiliser le repo local avec la commande wp:init et de bien respecter +les endroit où mettre les fichiers: -Utiliser le plug in maven -avec le pom élémentaire -se régéffer à la doc sur les outils pour connaitre les goals. +src/main/wp + #toute les pages +src/main/ressources/images + #stocker les images +src/main/ressources/jar + #stoker les jars -goal init -et après on code au bon endroit +Comme cela est fait dans l'exemple fournit dans Wikitty Publication. -exemple parlant +Dans le cas où l'on developpe sur un système de fichier il faut faire attention +au extension des fichiers auquelles corresponds leurs mime type, celon le mapping +contenu dans l'application soit par défaut: +text/javascript=wp +text/html.javascript=htmljs +text/html.java=htmlja +image/jpeg=jpg +image/png=png +text/java=java +application/jar=jar +application/uml.jar=zargo + +Les mime type déterminent les langages présent dans les fichiers et donc +comment ils seront éxécuté, pour en savoir plus voir la documentation sur +Wikitty Publication Web Application ou celle traitant de l'ajout de langage. + + Directement dans le Navigateur ****************************** +Une autre solution est de modifier creer ses wikitty directement par +l'intermédiaire de l'interface d'édition, comme dans un wiki. +Néanmoins cette solution ne permet que de créer des wikitty dont l'extension +existe déjà dans le WikittyService. -uniquement des wikitty dont les extensions existe déja -WikittyPubText pour le code -WikittyPubData pour image/ tout ce qui est binaire +Sinon l'interface permet de créer/modifier n'importe quel type de wikitty. +On ajouter les extentions que l'on veut au wikitty et remplir les champs. +Interface d'édition: + + /[contextData]/edit/.action (avec contextData ce qu'on veut, voir la partie sur le war pour savoir à quoi cela correspond) + Quoi mettre dans le code ? -------------------------- En quoi l'écrire **************** + + + Langage le bon mime type @@ -41,6 +75,7 @@ Bindings ******** +Les bindings sont des éléments important dans @@ -56,23 +91,68 @@ Détails de l'exemple -------------------- +Dans Wikitty Publication se trouve un exemple d'application dans +/src/site/exemple, l'exemple est éclaté en deux "projet". +Le projet resourceEntity: + resourceEntity/ + |-- changelog.txt + |-- LICENSE.tx + |-- LICENSE.txt + |-- pom.xml + |-- README.txt + `-- src + `-- main + |-- java + |-- resources + `-- xmi + |-- wp-resource.properties + |-- wp-resource.zargo -Faire des entités avec wikitty +ResourceEntity est un mini projet d'utilisation de Wikitty et création d'entity +et des nouvelles extensions de wikitty. Pour pouvoir utiliser resourceAppli +il faut contruire le jar de resourceEntity, puisque les entités sont utilisé +à l'intérieur. +Le projet resourceAppli: + resourceAppli/ + |-- pom.xml + `-- src + `-- main + |-- resources + | |-- images + | | `-- wikittypubuml.png + | `-- jar + `-- wp + |-- clearProxy.java + |-- dummy.htmljs + |-- Javahtml.htmlja + |-- JavaView.java + |-- resources.htmljs + |-- SelfModify.htmljs + |-- Test.java + `-- view.htmljs +Ce projet est le "parfait" exemple d'utilisation, l'architecture à été initialisé +avec la commande wp:init. Pour le faire fonctionner il faut rajouter le jar +correspondant au projet resourceEntity dans le dossier src/main/resources/jar. +Et lancer la commande wp:run. -Expliquer le cheminement faire -un pom prendre en exemple l'exemple en détaillant le tout. +L'application sera disponible à l'adresse: + * http://localhost:8080/[contextData]/view/.action (avec contextData ce qu'on veut, voir la partie sur le war pour savoir à quoi cela correspond) +Fichier de l'application: + * clearProxy.java, va supprimer tout les wikitty du proxy (sauf ceux de l'application) + * dummy.htmljs, exemple d'utilisation de post + * Javahtml.htmlja, intégration d'interface html avec du java + * JavaView.java, exemple avec du java corps de méthode sans signature + * resources.htmljs, permet de créer des resources Entity: intégration d'ihm, mécanisme post, utilisation des bindings, instanciation de java dans du javascript. + * view.htmljs, permet de faire des réservations de ressource: intégration d'ihm, mécanisme post, utilisation des bindings, instanciation de java dans du javascript. + * Test.java, dummy exemple + * SelfModify.htmljs, un wikitty pub text qui se tripote le content. -Faire ses entités -dévelloper classiquement en javascript avec les bindings -Possibilité des bindings - -et le java pour manipuler les entitées Modified: trunk/wikitty-publication/src/site/doc/Outils_publication.rst =================================================================== --- trunk/wikitty-publication/src/site/doc/Outils_publication.rst 2011-08-30 10:32:56 UTC (rev 1203) +++ trunk/wikitty-publication/src/site/doc/Outils_publication.rst 2011-08-30 11:09:30 UTC (rev 1204) @@ -115,6 +115,20 @@ * [uploadUrl] url d'envoi pour le serveur * [publicationVersion] la version du war de Wikitty Publication à utiliser pour les tests locaux. +De plus si l'on déclare des dépendances dans ce pom, de façon "classique" par +exemple: + + <dependencies> + <dependency> + <groupId>commons-fileupload</groupId> + <artifactId>commons-fileupload</artifactId> + <version>1.2.2</version> + </dependency> + </dependencies> + +Les dépendances seront automatiquement téléchargées et ajoutées dans le dossier +adéquat. + Goals Disponibles ***************** @@ -133,11 +147,14 @@ src/main/ressources/images #stocker les images src/main/ressources/jar - #stoker les binaires + #stoker les jars wp:run pour lancer l'application sur un serveur local avec le war de Wikitty -Publication avec la version en paramètre. +Publication avec la version en paramètre. Adresse: + + * http://localhost:8080/[contextData]/view/.action (avec contextData ce qu'on veut, voir la partie sur le war pour savoir à quoi cela correspond) + wp:deploy pour déployer l'application sur le WikittyService [wikittyServiceUrl] (utilisation de la synchronisation) avec la bonne architecture: @@ -146,7 +163,7 @@ [applicationName].ressources.images #stocker les images [applicationName].ressources.jar - #stoker les binaires + #stoker les jars wp:update pour mettre à jour sur le WikittyService [wikittyServiceUrl] (utilisation de la synchronisation)