tina integration procedure: last loose ends 1/2

00.DOCUMENTATION/C-advanced/exemple_git_tree.md

-Remarques sur l'intégration de tina
-===================================
+### About deployment of ProjectExplorer
 
-### Pour info: procédure suivie
+This directory contains the copy of "tina2" from the ProjectExplorer repo:
+https://github.com/moma/ProjectExplorer
 
-Je copie ici les 2 commandes utilisées pour rendre visible comment a été faite la fusion du git de tina dans celui de garg.
 
-Grace à cette méthode, quand on clonera le dépot gargantext, on obtiendra aussi les contenus du dépôt tina dans notre sous-dossier **`static/lib/graphExplorer`**.
-
-**NB**  
-Il n'est pas nécessaire de refaire cette procédure, dorénavant les fichiers restent là dans le sous-dossier.
-
-
-  1. on a ajouté le dépôt extérieur de graphExplorer comme si c'était une remote normale  
-     ```
-     git remote add dependancy_graphExplorer_garg https://gogs.iscpif.fr/humanities/graphExplorer_garg
-     ```
-
-  2. on a lancé la commande `subtree` avec cette remote, pour récupérer le dépôt tina et le placer dans garg dans le dossier indiqué par l'option `prefix`
+#### Sub-tree creation
+It was added via:
+```
+git remote add subtreeProjectExplorer https://github.com/moma/ProjectExplorer
+git subtree add --squash --prefix=static/tinawebJS subtreeProjectExplorer master
+```
 
-    ```
-    git subtree add --prefix=static/lib/graphExplorer dependancy_graphExplorer_garg master
-    ```
+#### Configuration
 
-    Résultat:
-    ```
-    # git fetch dependancy_graphExplorer_garg master
-    # (...)
-    # Receiving objects: 100% (544/544), 1.72 MiB | 0 bytes/s, done.
-    # Resolving deltas: 100% (307/307), done.
-    # From https://gogs.iscpif.fr/humanities/graphExplorer_garg
-    #  * branch            master     -> FETCH_HEAD
-    #  * [new branch]      master     -> dependancy_graphExplorer_garg/master
-    # Added dir 'static/lib/graphExplorer'
-    ```
+We generated the production html file:
+```
+cd static/tinawebJS
+bash twtools/adapt_html_paths.sh 'static/tinawebJS/'
+cd ../..
+ln -s static/tinawebJS/explorerjs.prod.html explorerjs.html
+```
 
-  3. au passage la même commande a aussi créé le commit suivant dans ma branche gargantext
-    ```
-    # commit b8d7f061f8c236bad390eb968d153fd6729b7434
-    # Merge: 3bfb707 d256049
-    # Author: rloth <romain.loth@iscpif.fr>
-    # Date:   Thu Jul 7 16:01:46 2016 +0200
-    #
-    #     Add 'static/lib/graphExplorer/' from commit 'd256049'
-    ```
-    (ici le commit *d256049* indique le point où en était le dépôt tina quand il a été copié)
+And we used the adapted settings file (comex branding and no relatedDoc):
+```
+cd static/tinawebJS/
+cp twpresets/settings_explorerjs.comex.js settings_explorerjs.js
+```
 
 
 ### Utilisation en développement quotidien
 
-Il n'y a plus rien de particulier à faire. Le dossier contient les éléments de tina qui nous sont nécessaires. On peut ignorer l'existence du subtree et travailler normalement, dans ce dossier et ailleurs.
+Il n'y a plus rien de particulier à faire du côté de l'appli déployée. Le dossier contient les éléments de tina qui nous sont nécessaires. On peut ignorer l'existence du subtree et travailler normalement, dans ce dossier et ailleurs.
 
 **=> nos opérations de commit / pull quotidiennes ne sont pas affectées**
 
@@ -58,21 +40,21 @@ Il n'est pas non plus nécessaire de prendre en compte la présence ou l'absence
 
 A présent le dépôt tina peut être vu comme une sorte de dépôt upstream circonscrit à un seul sous-dossier **`static/lib/graphExplorer`** !
 
-Mais si des changements interviennent dans le dépôt tina, ils ne seront pas automatiquement intégrés dans sa copie intégrée à garg. Pour opérer des A/R entre les dépôts le plus simple est une 1ère fois d'ajouter le même pointeur extérieur :
+Mais si des changements interviennent dans le dépôt tina, ils ne seront pas automatiquement intégrés dans sa copie intégrée à garg ou comex. Pour opérer des A/R entre les dépôts le plus simple est une 1ère fois d'ajouter le même pointeur extérieur :
 ```
-git remote add dependancy_graphExplorer_garg https://gogs.iscpif.fr/humanities/graphExplorer_garg
+git remote add subtreeProjectExplorer https://github.com/moma/ProjectExplorer
 ```
 
 A partir de là, il devient très simple de faire des opérations push/pull entre dépôts si besoin est..
 
-  1. Récupération de mises à jour tina => garg.
-     Pour intégrer des changements upstream de tina vers garg, il suffit de lancer la commande suivante:
+  1. Récupération de mises à jour tina => comex ou garg.
+     Pour intégrer des changements upstream de tina vers garg ou comex, il suffit de lancer la commande suivante:
 
     ```
-    git subtree pull --prefix=static/lib/graphExplorer dependancy_graphExplorer_garg master --squash
+    git subtree pull --prefix=static/lib/graphExplorer subtreeProjectExplorer master --squash
     ```
 
-  2. Inversement, les changements effectués dans le dossier **`static/lib/graphExplorer`** par les développeurs garg peuvent aussi être poussés du dépôt garg vers le dépôt tina par un subtree push
+  2. Inversement, les changements effectués dans le dossier **`static/lib/graphExplorer`** par les développeurs garg ou comex peuvent aussi être poussés du dépôt garg ou comex vers le dépôt tina par un subtree push
     ```
-    git subtree push --prefix=static/lib/graphExplorer dependancy_graphExplorer_garg master
+    git subtree push --prefix=static/lib/graphExplorer subtreeProjectExplorer master
     ```

twpresets/settings_explorerjs.comex.js

@@ -155,6 +155,7 @@ TW.conf = (function(TW){
   // Modules path
   // ------------
   TWConf.paths = {
+    'ourlibs': 'static/tinawebJS/twlibs',
     'modules': 'twmodules'
   }
   Object.freeze(TWConf.paths)  // /!\ to prevent path modification before load