Outils pour utilisateurs

Outils du site


public:txm_portal_manual_writing

Ceci est une ancienne révision du document !


Rédaction du manuel administrateur de portail TXM

Cette page contient des sections en cours de rédaction qui seront transférées dans le manuel ODT.

Mettre à jour un corpus déjà installé sur un portail

(Complément à la section 1.1 ou nouvelle section 1.2)

[En cours de rédaction]

  1. S'assurer que personne n'est en train d'interroger le portail (interface d'administration / control panel / update logs)
  2. Arrêter l'appli portail via manager de tomcat ;
  3. Se connecter en ssh au portail ;
  4. Si on veut conserver les sous-corpus et partitions des utilisateurs de l'ancienne version du corpus, récupérer le fichier import.xml et coller le contenu de l'émément preBuild dans import.xml du nouveau corpus (cela suppose que la nouvelle version n'est pas très différente de l'ancienne : mêmes métadonnées, pas de retrait de textes)
  5. Exporter le nouveau corpus au format binaire et le déposer sur le serveur
  6. Supprimer l'ancien dossier de corpus avec la commande rm -rf MONCORPUS
  7. Décompresser le nouveau corpus
  8. Redémarrer l'appli portail via manager
  9. Ouvrir ou rafraichir le portail dans le navigateur, attendre la fin du chargement
  10. Normalement, la mise à jour du corpus se fait toute seule
  11. Vérifier que les mises à jours sont bien répercutées sur le portail
  12. Si le portail devient instable, redémarrer Tomcat et recharger la page du portail dans le navigateur

CSS

(Complément à la section 5.1)

Afin d'éviter tout risque de conflit de règles CSS entre l'interface du portail et les différents corpus, il est recommandé de suivre la procédure suivante :

  • Utiliser le module d'import XTZ (ou XML-TEI Zero) avec production des pages d'édition en mode XSL (cf. Section 6.1.5.2 du Manuel TXM) avec les feuilles de style 1-default-html.xsl et 2-default-pager.xsl (version du 17/05/2019 ou ultérieure)
  • Chaque page d'édition est alors imbriquée dans 2 éléments div
    • div class=“[NOM-DU-CORPUS]”
      • div class=“txmeditionpage”
  • Chaque élément XML des documents sources du corpus est transformé en <div> ou en <span> avec l'attribut class (cf. la Spec de l'import XTZ)
  • Créer une feuille de style [NOM-DU-CORPUS].css
    • chaque règle doit comporter la contrainte de position dans .[NOM-DU-CORPUS]
    • par exemple, pour styler un paragraphe dans un corpus TEST :
      • .TEST p {color:red;}
  • Pour créer des règles applicables à toutes les pages d'édition sur un portail (sans risque de conflit avec l'interface), préfixer les règles de .txmeditionpage et les placer dans txm.css ou TXM WEB.css
public/txm_portal_manual_writing.1558100004.txt.gz · Dernière modification: 2019/05/17 15:33 par slh@ens-lyon.fr