sct browser frontend

Frontend du navigateur par SNOMED International

Il s'agit d'un projet frontal de navigateur générique, les instances spécifiques utilisées dans les navigateurs IHTSDO sont personnalisées dans les branches de ce projet.

Le navigateur se connecte à une API REST backend fournie par le projet : https://github.com/IHTSDO/snowstorm

Structure du projet

Le fichier index.html inclut toute la logique de rendu de l'interface utilisateur du navigateur, en basculant entre les différentes versions de SNOMED CT et les dispositions de l'interface utilisateur (perspectives).

• bootstrap-custom : dossier contenant une version personnalisée du framework Boostrap
• css : feuilles de style pour ce site
• external-libs : bibliothèques js utilisées par ce site
• snomed-interaction-components : js, css et polices pour les widgets SNOMED CT contenus dans ce site
• img : images pour le site
• i18n : fichiers d'internationalisation du site et des widgets
• index.html : application d'une page

Internationalisation

Ce projet utilise le plugin jquery-i18n-properties pour prendre en charge l'internationalisation et la traduction des composants de l'interface utilisateur dans de nombreuses langues. (https://github.com/jquery-i18n-properties/jquery-i18n-properties)

Le dossier i18n comprend le fichier de langue de base (/i18n/Languages.properties), ce fichier définit les étiquettes pour la langue anglaise :

 i18n_app_name = IHTSDO SNOMED CT Browser
i18n_release = Release
i18n_perspective = Perspective
i18n_about = About
i18n_provide_feedback = Provide feedback on this browser

Dans d'autres fichiers, qui incluent le code de langue ISO dans le nom, les étiquettes sont traduites, comme :

Languages_es.properties (espagnol)

 i18n_app_name = Navegador de SNOMED CT 
i18n_release = Edición
i18n_perspective = Perspectiva
i18n_about = Sobre
i18n_provide_feedback = Proporcione sus comentarios sobre este navegador

Languages_da.properties (danois)

 i18n_welcome = Velkommen
i18n_app_name = IHTSDO SNOMED CT Browser
i18n_release = Udgivelse
i18n_perspective = Visning
i18n_about = Om
i18n_provide_feedback = Send en kommentar om denne browser

Configuration locale, créez et exécutez le navigateur localement

Configuration locale

Exécutez npm install pour informer l'application locale de votre installation Grunt.

Construire

La tâche par défaut de Grunt créera tous ces composants, exécuter grunt dans le dossier racine du projet construira tous les widgets et créera les fichiers de distribution.

• js
  • bibliothèques internes/snomed-interaction-components.min.js
• css
  • css/snomed-interaction-components.min.css

Exécuter localement

Afin d'obtenir des informations sur le point de terminaison de l'API dans l'environnement local, une configuration similaire à la suivante doit être utilisée :

 user 'details here';
worker_processes  1;
 
events {
    worker_connections  1024;
}
 
http {
	include    mime.types;
    server {
		listen		8080;
		server_name	localhost;

    location / {
      root /FileLocation/sct-browser-frontend/;
    }       
    
    location /snowstorm/ {
      proxy_pass https://dev-browser.ihtsdotools.org/snowstorm/;
    }
	}	
}

Raccourcis URL

Le navigateur comprend des paramètres d'URL qui serviront de raccourcis pour ouvrir le navigateur avec des paramètres prédéfinis ou des sélections de contenu, évitant ainsi la nécessité de sélectionner des options dans la vue principale.

Utiliser : http://browser.ihtsdotools.org/index.html?perspective=full&conceptId1=195967001

Paramètre	Exemple de valeur	Utiliser
édition	PRINCIPAL/SNOMEDCT-ES, PRINCIPAL/SNOMEDCT-AU	Définit l'édition qui sera parcourue, en utilisant les noms d'édition définis par le backend.
perspective	complet, navigation, etc.	Définit la perspective à charger.
langues	fr, es, da, pt	Définit la langue de l'interface utilisateur.
IDconcept1	n'importe quel SCTID	Définit le premier widget de détails du concept sur ce concept.
accepterLicence	vrai	la licence du navigateur SNOMED CT est automatiquement acceptée sans afficher la fenêtre modale. Cela signifie que vous acceptez explicitement la licence.
création de diagrammesMarkupEnabled	vrai	Le balisage des diagrammes SNOMED CT est activé.

Docker

Si vous souhaitez créer une image basée sur les modifications locales que vous avez apportées, exécutez ce qui suit sur la ligne de commande :

docker build -t snomedinternational/snomedct-browser .

Ou vous pouvez simplement exécuter la commande suivante, en remplaçant la variable <host> par l'URL complète de votre instance de tempête de neige :

docker run --name snowstorm-nginx -d -p 80:80 --env API_HOST= < host > snomedinternational/snomedct-browser