Outils pour utilisateurs

Outils du site


public:specs_commande_edition

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentes Révision précédente
Prochaine révision
Révision précédente
public:specs_commande_edition [2018/06/12 11:29]
slh@ens-lyon.fr
public:specs_commande_edition [2021/07/07 11:38] (Version actuelle)
matthieu.decorde@ens-lyon.fr
Ligne 1: Ligne 1:
 ======= Commande Édition ======= ======= Commande Édition =======
- 
-====== Objectif ====== 
  
 Afficher une édition de qualité des textes d'un corpus. Pouvoir naviguer entre les pages des textes. Afficher une édition de qualité des textes d'un corpus. Pouvoir naviguer entre les pages des textes.
 +
 +===== Infrastructure =====
 +
 +==== Édition externe ====
 +
 +Pouvoir accéder à des pages d'​édition externes à TXM, stockées sur un serveur qui suiventles contraintes de TXM (span de mots, etc.)
  
 ===== Hyperliens ===== ===== Hyperliens =====
  
-==== Concordance ====+==== Édition -> Concordance ====
  
 Pouvoir faire la concordance d'un mot ou un span sélectionné. Pouvoir faire la concordance d'un mot ou un span sélectionné.
- 
-====== Méthode ====== 
  
 ===== Affichage ===== ===== Affichage =====
Ligne 17: Ligne 19:
 Utiliser un navigateur intégré dans un widget SWT qui soit capable de gérer le HTML5, CSS3, Javascript. Utiliser un navigateur intégré dans un widget SWT qui soit capable de gérer le HTML5, CSS3, Javascript.
  
-===== Navigateur intégré ​=====+==== Navigateur intégré ====
  
 Voir la classe "​org.txm.rcpapplication.editors.TXMBrowser"​. Voir la classe "​org.txm.rcpapplication.editors.TXMBrowser"​.
Ligne 93: Ligne 95:
     * le #PCDATA est filtré pour la ponctuation -> remplacement du pattern de l'​occurrence dans la CQL par []?     * le #PCDATA est filtré pour la ponctuation -> remplacement du pattern de l'​occurrence dans la CQL par []?
     * on utilise '​frpos'​ pour décider de la ponctuation -> remplacement du pattern de l'​occurrence dans la CQL par []?     * on utilise '​frpos'​ pour décider de la ponctuation -> remplacement du pattern de l'​occurrence dans la CQL par []?
 +
 +===== Recherche =====
 +
 +==== Macros ====
 +
 +Macro CQLToEdition qui prend en paramètres :
 +  * corpus : sélectionné ou son nom
 +  * requête CQL : ''​%%<​div_identifiant-de-la-notice="​AFE86002932">​[]%%''​
 +et qui ouvre l'​édition du corpus sur la page où se trouve le premier mot du premier match de la requête.
 +
 +Permet d'​écrire des macros spécialisées comme LireNoticeSujet,​ qui appelle CQLToEdition,​ ayant les paramètres suivants :
 +  * corpus : sélectionné ou son nom (AFNOTICES)
 +  * identifiant-notice : AFE86002932
 +
 +Macro StructToEdition qui prend en paramètres :
 +  * corpus : sélectionné ou son nom
 +  * structure : div
 +  * propriété : identifiant-de-la-notice
 +  * valeur : AFE86002932
 +et qui ouvre l'​édition du corpus sur la page où se trouve le premier mot du premier match de la requête construite à partir de structure, propriété et valeur.
 +
 +==== Accès ====
 +
 +L'​interface de la recherche plein texte peut être accédée par :
 +  * boutons de barre d'​outils
 +    * un bouton '​Loupe'​ -> Ouvrir l'​interface
 +      * boutons de navigation : lancer la recherche (bouton Play), occurrence suivante (bouton Flèche droite), etc.
 +      * bouton Concordance : Ouvrir une concordance avec la même requête courante (si présente) et même liste de matchs, focus sur le match courant
 +      * bouton Progression : Ouvrir une progression avec la même requête courante (si présente) et même liste de matchs, focus sur le match courant
 +    * un bouton '​Croix'​ qui remplace le bouton '​Loupe'​ dans la barre d'​outils -> Fermer l'​interface
 +  * des raccourcis clavier
 +    * Ctrl + F (ou CMD + F, pour Mac OS X) -> Ouvrir l'​interface
 +    * Ctrl + G (ou CMD + G, pour Mac OS X) -> Occurrence suivante
 +    * Shift + Ctrl + G (ou Shift + CMD + G, pour Mac OS X) -> Occurrence précédente
 +    * Esc -> Fermer l'​interface
 +  * résultats d'​autres commandes
 +    * Index : menu contextuel sur une ligne de mot, '​Afficher en plein texte / Display in Plain Text'
 +      * l'​interface est ouverte avec une requête permettant la recherche des occurrences,​ focus sur le premier match, mise en évidence des autres matchs
 +    * Concordance : retour au texte, l'​interface est ouverte pour pouvoir naviguer dans la liste des matchs de la Concordance,​ focus sur le match courant de la concordance,​ mise en évidence des autres matchs
 +    * Progression : comportement analogue
 +
 +=== Mode unique ===
 +
 +Ajouter un champ de recherche et pouvoir naviguer dans les résultats. Le champ de recherche évolue en fonction de l'​étape de la recherche : 1) démarrage 2) expression et validation de la recherche 3) Navigation dans les résultats 4) fin
 +
 +Interface par étape :
 +  - ''​%%[Loupe]%%''​
 +  - ''​%%[ï][______] [Loupe] [|<​][<​] ​    ​[>​][>​|] [x]%%''​
 +  - ''​%%[ï][la req] [Loupe] [|<​][<​] 1/N [>​][>​|] [x]%%''​
 +  - ''​%%[Loupe]%%''​
 +
 +Description des éléments :
 +  * ''​%%[Loupe]%%''​ : 
 +    * démarre la recherche ​
 +    * ou lance la recherche à partir de la page courante
 +  * ''​%%[x]%%''​ : ferme la recherche
 +  * ''​%%[ï][______]%%''​ : champ requête CQL habituel
 +  * ''​%%[|<​][<​] 1/N [>​][>​|]%%''​ : les champs de navigation habituels
 +
 +
 +=== Multiple modes (proposition MD) ===
 +
 +Ajouter un champ de recherche et pouvoir naviguer dans les résultats. Le champ de recherche évolue en fonction de l'​étape de la recherche : 1) démarrage 2) choix du mode 3) expression et validation de la recherche 4) Navigation dans les résultats 5) fin
 +
 +Interface par étape :
 +  - ''​%%[Loupe]%%''​
 +  - ''​%%[CQL][Texte][Structure] [x]%%''​
 +  - (en fonction du mode choisi)
 +    * ''​%%Requête : [ï][______][OK] [x]%%''​
 +    * ''​%%Texte : [propriété|v][______|v][OK] [x]%%''​
 +    * ''​%%Structure : [structure|v][propriété|v][OK][______|v] [x]%%''​
 +  - ''​%%CQL : [|<​][<​] 1/N [>​][>​|] [x]%%''​
 +
 +Description des éléments :
 +  * ''​%%[Loupe]%%''​ : démarre la recherche
 +  * ''​%%[x]%%''​ : revient à l'​étape précédente de recherche
 +  * ''​%%[OK]%%''​ : lance la recherche
 +  * ''​%%[ï][______]%%''​ : champ requête CQL habituel
 +  * ''​%%Texte : [propriété|v][______|v]%%''​ : structure "​text"​ ; propriété par défaut "​id"​ ; champ texte de la valeur avec auto-complétion
 +  * ''​%%Structure : [structure|v][propriété|v]%%''​ : structure "​p"​ ou "​div"​ ou "​s"​ par défaut ; propriété par défaut "​id"​ ou "​n";​ champ texte de la valeur avec auto-complétion
 +  * ''​%%CQL : [|<​][<​] 1/N [>​][>​|]%%''​ : "​CQL"​ est la CQL générée ; les champs de navigation habituels
 +
 +
 +SLH
 +<​code>​
 +il y aurait plein de choses à discuter dans ce que tu viens d'​écrire : 
 +- pourquoi distinguer la navigation dans la structure '​text'​ de celle des autres structures ? 
 +- la navigation dans les occurrences d'une recherche plein texte "​opérée depuis l'​édition"​ devrait se superposer avec la navigation dans les occurrences d'une concordance d'où l'on vient par un backtotext
 +- la "​recherche"​ d'un texte doit être homogénéisée avec la navigation dans les textes
 +- la "​recherche"​ d'une structure doit être homogénéisée avec la navigation dans les pages si l'​édition est paginée par structures
 +- une recherche plein texte pourrait a contrario amener à une concordance
 +- une recherche de type '​Requête'​ pourrait plutôt s'​appeler '​Mots'​ pour être plus homogène avec les requêtes de type '​Texte'​ et '​Structure'​
 +- l'​ordre pourrait être du plus petit au plus grand : Mots, Structures, Textes
 +- etc.
 +</​code>​
 +===== Recherche avancée =====
 +
 +A l'​instar de la recherche URS, ouvrir une vue ou une boite de dialogue avec une interface complète de recherche avec toutes les options possibles.
  
 ===== Sommaire ===== ===== Sommaire =====
Ligne 100: Ligne 200:
 ==== Solution ==== ==== Solution ====
  
-Si le répertoire **edit** d'une édition ​quelconque ​contient un fichier **toc.html**,​ une composant SWT affiche ce HTML avec des CSS, des images dans un sous-répertoire,​ etc. dans une vue (Vue Sommaire) dédiée à cette édition. [le HTML est produit en dehors de TXM, ou bien au moment de l'​import,​ par une XSL]+Si le répertoire **edit** d'une édition contient un fichier **toc.html** ​
 +  * accès au sommaire : un bouton Sommaire s'​ajoute à la barre d'​outils de l'​éditiondonc à l'​ouverture de l'​édition. Cliquer sur ce bouton ouvre ou ferme une vue Sommaire associée 
 +  * gestion du sommaire : une composant SWT affiche ce HTML avec des CSS, des images dans un sous-répertoire,​ etc. dans une vue (Vue Sommaire) dédiée à l'édition. [le HTML est produit en dehors de TXM, ou bien au moment de l'​import,​ par une XSL (pour un fichier TEI, on peut viser certains éléments <div> par exemple)]
  
 Le fichier toc.html est responsable de l'​affichage (contenu, mise en forme, styles, etc. par exemple en CSS), et de l'​interaction avec le sommaire (ouverture/​fermeture de la hiérarchie de sections, etc. par exemple en Javascript). Le fichier toc.html est responsable de l'​affichage (contenu, mise en forme, styles, etc. par exemple en CSS), et de l'​interaction avec le sommaire (ouverture/​fermeture de la hiérarchie de sections, etc. par exemple en Javascript).
Ligne 106: Ligne 208:
 Dès qu'un lien du HTML (balise <a>) est sollicité, TXM prend le relais et ouvre la page correspondant au lien cliqué -> la vue est associée à l'​éditeur Edition. Dès qu'un lien du HTML (balise <a>) est sollicité, TXM prend le relais et ouvre la page correspondant au lien cliqué -> la vue est associée à l'​éditeur Edition.
  
-On peut fermer ou ouvrir cette vue à n'​importe quel moment, si possible en reprenant l'​aspect et la position du dernier accès lors de la session de travail. Le sommaire est ouvert depuis l'​éditeur de l'​édition concernée.+On peut fermer ou ouvrir cette vue à n'​importe quel moment, si possible en reprenant l'​aspect et la position du dernier accès lors de la session de travail.
  
 ===== Annotation ===== ===== Annotation =====
  
 Voir les spécifications d'​[[https://​groupes.renater.fr/​wiki/​txm-info/​public/​annotation/​specs_assisted_annotation/​specs_annotation_edition|Annotation assisté par l'​édition]] Voir les spécifications d'​[[https://​groupes.renater.fr/​wiki/​txm-info/​public/​annotation/​specs_assisted_annotation/​specs_annotation_edition|Annotation assisté par l'​édition]]
public/specs_commande_edition.1528795765.txt.gz · Dernière modification: 2018/06/12 11:29 par slh@ens-lyon.fr