snomedinternational/snomedct-browser

SNOMED International 浏览器前端

!最后提交 !问题 !贡献者

!许可证 !GitHub 年度提交活动

这是一个通用的浏览器前端项目，IHTSDO浏览器中的特定实例通过该项目的分支进行定制。浏览器连接到由以下项目提供的后端REST API：https://github.com/IHTSDO/snowstorm

项目结构

index.html包含渲染浏览器UI、切换不同SNOMED CT版本和UI布局（视角）的所有逻辑。

• bootstrap-custom：包含Bootstrap框架自定义构建的文件夹
• css：本网站的样式表
• external-libs：本网站使用的JavaScript库
• snomed-interaction-components：本网站包含的SNOMED CT小部件的JavaScript、CSS和字体
• img：网站图片
• i18n：网站和小部件的国际化文件
• index.html：单页应用

国际化

本项目使用jquery-i18n-properties插件支持国际化，将UI组件翻译成多种语言（https://github.com/jquery-i18n-properties/jquery-i18n-properties%EF%BC%89%E3%80%82

i18n文件夹包含基础语言文件（/i18n/Languages.properties），该文件定义英语标签：

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

在名称中包含ISO语言代码的其他文件中，标签会被翻译，例如：

Languages_es.properties（西班牙语）

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（丹麦语）

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

本地配置、构建和运行浏览器

本地配置

运行npm install使本地应用识别grunt安装。

构建

Grunt默认任务将创建所有组件，在项目根文件夹运行grunt将构建所有小部件并创建分发文件：

• js
  • internal-libs/snomed-interaction-components.min.js
• css
  • css/snomed-interaction-components.min.css

本地运行

为在本地环境中获取API端点信息，需使用类似以下的配置：

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

    location / {
      root /文件路径/sct-browser-frontend/;
    }       
    
    location /snowstorm/ {
      proxy_pass https://dev-browser.ihtsdotools.org/snowstorm/;
    }
	}	
}

URL快捷方式

浏览器包含URL参数，可作为快捷方式，用于以预定义设置或内容选择打开浏览器，无需从主视图选择选项。

用法示例： [***]

Docker

若要基于本地修改构建镜像，在命令行运行：

bash
docker build -t snomedinternational/snomedct-browser .

或直接运行以下命令（将<host>替换为snowstorm实例的完整URL）：

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