sct browser frontend

Frontend Peramban oleh SNOMED Internasional

Ini adalah proyek front-end browser umum, contoh spesifik yang digunakan di browser IHTSDO disesuaikan di cabang proyek ini.

Browser terhubung ke REST API backend yang disediakan oleh proyek: https://github.com/IHTSDO/snowstorm

Struktur Proyek

Index.html mencakup semua logika untuk merender UI Browser, beralih antara rilis SNOMED CT yang berbeda dan tata letak UI (perspektif).

• bootstrap-custom: folder yang berisi build kustom kerangka Boostrap
• css: stylesheet untuk situs ini
• external-libs: perpustakaan js yang digunakan oleh situs ini
• snomed-interaction-components: js, css dan font untuk widget SNOMED CT yang terdapat di situs ini
• img: gambar untuk situs
• i18n: file internasionalisasi untuk situs dan widget
• index.html: aplikasi satu halaman

Internasionalisasi

Proyek ini menggunakan plugin jquery-i18n-properties untuk mendukung internasionalisasi, terjemahan komponen UI ke banyak bahasa. (https://github.com/jquery-i18n-properties/jquery-i18n-properties)

Folder i18n berisi file bahasa dasar (/i18n/Languages.properties), file ini mendefinisikan label untuk bahasa Inggris:

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

Di file lain, yang menyertakan kode bahasa ISO pada namanya, labelnya diterjemahkan, seperti:

Languages_es.properties (Spanyol)

 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 (Denmark)

 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

Konfigurasi lokal, buat dan jalankan browser secara lokal

Konfigurasi lokal

Jalankan npm install untuk membuat aplikasi lokal mengetahui instalasi kasar Anda.

Membangun

Tugas default Grunt akan membuat semua komponen ini, menjalankan grunt di folder root proyek akan membuat semua widget dan membuat file distribusi.

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

Jalankan secara lokal

Untuk mendapatkan informasi titik akhir api dalam lingkungan lokal, konfigurasi yang mirip dengan berikut harus digunakan:

 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/;
    }
	}	
}

Pintasan URL

Browser menyertakan parameter URL yang akan bertindak sebagai pintasan untuk membuka browser dengan pengaturan atau pilihan konten yang telah ditentukan sebelumnya, sehingga tidak perlu memilih opsi dari tampilan utama.

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

Parameter	Contoh Nilai	Menggunakan
edisi	UTAMA/SNOMEDCT-ES, UTAMA/SNOMEDCT-AU	Menetapkan edisi yang akan dijelajahi, menggunakan nama edisi yang ditentukan oleh backend.
perspektif	penuh, menjelajah, dll.	Mengatur perspektif yang akan dimuat.
bahasa	id, es, da, pt	Mengatur bahasa UI.
konsepId1	SCTID apa pun	Menetapkan widget detail konsep pertama ke konsep ini.
terima Lisensi	BENAR	Lisensi Browser SNOMED CT diterima secara otomatis tanpa menampilkan jendela modal. Ini berarti Anda secara eksplisit menerima lisensi tersebut.
diagram MarkupEnabled	BENAR	Diagram CT SNOMED Markup diaktifkan.

Buruh pelabuhan

Jika Anda ingin membuat image berdasarkan perubahan lokal apa pun yang telah Anda buat, jalankan perintah berikut pada baris perintah:

docker build -t snomedinternational/snomedct-browser .

Atau Anda bisa langsung menjalankan perintah berikut, mengganti variabel <host> dengan URL lengkap ke instance badai salju Anda:

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