Templat:Medical cases chart/doc

Ini ialah sublaman pendokumenan untuk Templat:Medical cases chart.
Ia mempunyai maklumat penggunaan, kategori dan kandungan lain yang bukan sebahagian daripada laman templat templat laman.

Templat ini menggunakan Lua:

This template uses TemplateStyles:

Template:Medical cases chart/styles.css

Keterangan

Templat ini sepatutnya digunakan untuk segala macam carta kes perubatan berdasarkan {{Bar box}} demi penyeragaman. Carta bar ini membina bar-bar melintang pada setiap tarikh sah dengan bilangan kes yang boleh disusunkan kepada sebanyak 5 macam klasifikasi. Ia juga mempunyai dua lajur yang boleh digunakan untuk menonjolkan sebarang nilai tertentu serta memaparkan sebarang perubahan relatif ataupun perubahan mutlak. Templat ini harus ditransklusi ke dalam templat-templat lain, BUKAN ke dalam laman rencana. Elak dari menggunakan templat-templat berbeza selain daripada {{Medical cases chart}} demi menyesuaikan pemformatan. Berikanlah cadangan ciri-ciri yang boleh dimasukkan ke templat in di laman perbincangan (dalam bahasa Inggeris). Sebaliknya, jika cadangan anda tidak begitu kontroversial, suntinglah sendiri kod yang ada di dalam templat ini.

Penggunaan

{{Medical cases chart
|barwidth   = keluasan kawasan bar (thin|medium|wide)                                        [tidak wajib, lalai: medium]
|numwidth   = keluasan nilai-nilai di lajur-lajur sebelah kanan (xx atau xxxx)<-(n|t|m|w|d)  [tidak wajib, lalai: mm,
                                                                                              lihat keterangan di bawah]
|float      = lokasi carta di dalam laman (left|right|none)                                  [tidak wajib, lalai: kanan] 

|pretitle   = teks di permulaan tajuk                                                        [tidak wajib]
|disease    = nama penyakit
|location   = lokasi wabak yang dipaparkan di dalam carta
|location2  = lokasi lebih luas seperti negeri/wilayah atau negara                           [tidak wajib]
|location3  = lokasi paling luas seperti negara                                              [tidak wajib]
|posttitle  = teks di penghujungan tajuk                                                     [tidak wajib]
|outbreak   = nama wabak utama (untuk pautan {{navbar}})

|recoveries = paparkan penyembuhan di dalam petunjuk (no|n|0)                                [tidak wajib]
|altlbl1    = label alternatif untuk klasifikasi kes yang ketiga                             [tidak wajib, lalai: 
                                                                                              Dalam rawatan]
|altlbl2    = label alternatif untuk klasifikasi kes yang keempat                            [tidak wajib]
|altlbl3    = label alternatif untuk klasifikasi kes yang kelima                             [tidak wajib]

|togglesbar = HTML buat bar 'toggles' untuk tunjuk/sorok baris-baris                         [tidak wajib]  {WIP}

|right1     = tajuk lajur data pertama                                                       [tidak wajib, lalai: # kes]
|right2     = tajuk lajur data kedua                                                         [tidak wajib]

|divisor    = mengatasi (override) secara manual penskalaan bar                              [tidak wajib, lalai: auto]
|collapsible= sama ada baris-baris boleh disorok (yes|y|1)                                   [tidak wajib]  {WIP}
|data       = garis-garis data untuk setiap tarikh sah (lihat syntax Data dan Row)

|caption    = keterangan di bawah carta                                                      [tidak wajib]
}}

Parameter numwidth menggunakan none (tiada luas), thin (tipis), medium (sederhana), wide (lebar) dan default (lalai). Urutan yang dipilih daripada inisial-inisial tersebut (n|t|m|w|d) akan menentukan keluasan setiap nombor di dalam lajur data. Setiap lajur mempunyai dua nombor (nilai dan perubahan), maka setiap inisial akan sepadan dengan setiap nombor. Jika hanya satu lajur sahaja yang digunakan, urutan numwidth sebegini: xx. Jika kededua lajur digunakan, urutannya begini: xxxx. Oleh itu, gunakanlah keluasan carta yang sekecil mungkin tanpa memecahkan nombor-nombor ketika dipandang di mudah alih.

Data

Parameter data patut diisi dengan jujukan baris-baris yang seakan dengan format Row. Kelainannya ialah dalam penggunaan semicolon, ; sebagai pemisah parameter. Tambahan pula parameter-parameter yang asyik berulang seperti divisor, numwidth dan collapsible boleh ditulis sekali sahaja di dalam badan {{Medical cases chart}} dan tidak perlu diulang-ulang. Lihat contoh-contoh di bawah.

Row

Parameter usang

Parameter row patut diisi dengan jujukan {{Medical cases chart/Row}}. Elakkan dari menggunakan templat-templat bar yang lain agar dapat mengekalkan konsistensi. Syntax-nya seperti berikut:

{{Medical cases chart/Row
 |1          = ''valid date''                                                                   [secara lalai: ⋮, dengan itu 
                                                                                             perubahan tertentu menjadi (=)]
 |2          = ''nilai untuk kematian''
 |3          = ''nilai untuk penyembuhan''
 |4          = ''nilai untuk jumlah kes (klasifikasi ketiga)''
 |alttot1    = ''nilai alternatif untuk kes dalam rawatan (klasifikasi ketiga)''
 
 |5          = ''nilai untuk klasifikasi keempat''
 |6          = ''nilai untuk jumlah klasifikasi kelima''
 |alttot2    = ''nilai alternatif untuk klasifikasi kelima''
 
 |7          = ''nilai dalam lajur pertama''
 |8          = ''perubahan dalam lajur pertama''
 |firstright1= ''sama ada perubahan dalam lajur pertama n.a./tidak berkaitan'' (yes|y|1)
 
 |9          = ''nilai dalam lajur kedua''
 |10         = ''perubahan dalam lajur kedua''
 |firstright2= ''sama ada perubahan dalam lajur kedua n.a./tidak berkaitan'' (yes|y|1)
 
 |divisor    = ''penskalaan bar (nilai lebih besar = bar lebih kecil)''                         [secara lalai: 1]
 |numwidth   = ''keluasan nilai-nilai di lajur-lajur sebelah kanan'' (xx or xxxx)<-(n|t|m|w|d)  [defaults to: mm]
 
 |collapsible= ''sama ada baris-baris boleh disorok'' (yes|y|1)                                 {WIP}
 |collapsed  = ''mengatasi (override) secara manual keadaan awal garis'' (yes|y|1)              {WIP}
 |id         = ''mengatasi (override) secara manual id garis/row''                              {WIP}
}}

Kesemua parameter di atas tidak wajib, tetapi collapsed dan id tiada kesan jika tidak digunakan dengan collapsible.

Jika tarikh sah tidak diisi, garis tersebut akan dianggap sebagai lompatan tarikh di mana tiada kes baru yang dilaporkan. Bilangan kematian dan penyembuhan akan ditolak secara automatik dari nilai untuk jumlah kes. Jika anda ingin melakukan kiraan secara manual bagi nilai di dalam klasifikasi tersebut (biasanya untuk kes dalam rawatan), gunakan alttot1. Sama juga untuk nilai untuk jumlah klasifikasi kelima dan alttot2. Perubahan pada lajur pertama dan lajur kedua akan dikurung secara automatik.

Contoh-contoh

{{Medical cases chart
|numwidth=mw

|disease=Selesema Hijau
|location=Savannah|location2=Georgia|location3=Amerika Syarikat
|outbreak=wabak selesema hijau 2009

|recoveries=n

|data=
2009-04-13;;;42;;;42;firstright1=y
2009-04-14;;;356;;;356;+748%
2009-04-15;;;1503;;;1,503;+322%
2009-04-16;57;;5915;;;5,915;+294%
2009-04-17;2000;;9500;;;~9,500;+60.6%
}}

Selesema Hijau di Savannah, Georgia, Amerika Syarikat ( l b s ) # kematian Kes aktif
Tarikh			# kes
2009-04-13			42(n.a.)
2009-04-14			356(+748%)
2009-04-15			1,503(+322%)
2009-04-16			5,915(+294%)
2009-04-17			~9,500(+60.6%)

{{Medical cases chart
|barwidth=wide
|numwidth=mwwd

|pretitle=Anggaran
|disease=Selesema Sepanyol
|location=Dunia
|posttitle=(tidak termasuk Oceania)
|outbreak=pandemik selesema 1918

|altlbl1=Kes disahkan
|altlbl2=Disyaki
|altlbl3=Dianggarkan

|right1=Kes disahkan
|right2=Termasuk kes yang disyaki dan dianggarkan

|divisor=2550
|data=
1918-03-10;(2060-300);(3000-800);6000;;;6000;firstright1=y
1918-07;12600;20000;40000;12000;;alttot2=(34000-15000-8700+40);40000;+500%;10500;firstright2=y
;12600;20000;40000;12000;;alttot2=(34000-15000-8700+40);40000;;10500
1919;100000;250000;;;1000000;;;1mi;+500k

|caption=Bar untuk cerita semalam
}}

Anggaran Selesema Sepanyol di Dunia (tidak termasuk Oceania) ( l b s ) # kematian Sembuh Kes disahkan Disyaki Dianggarkan 1918191819191919 MacMacAprAprMeiMeiJunJunJulJulOgoOgoSepSepOktOktNovNovDisDis JanJanFebFebMacMacAprAprMeiMeiJunJunJulJulOgoOgoSepSepOktOkt 15 hari terakhir15 hari terakhir
Tarikh	Kes disahkan	Termasuk kes yang disyaki dan dianggarkan
1918-03-10	6000(n.a.)
⋮
1918-07	40000(+500%)	10500(n.a.)
⋮	40000(=)	10500(=)
1919		1mi(+500k)
Bar untuk cerita semalam

Contoh sebenar

COVID-19 di Tanah Besar China ( l b s ) # kematian Sembuh Diuji Didiagnosis secara klinikal (D.K.) Diuji atau D.K. 2019201920202020 DisDis JanJanFebFebMacMacAprApr 15 hari terakhir15 hari terakhir
Tarikh	# kes (selain D.K.)	# kes (termasuk D.K.)
2019-12-31		27(n.a.)
⋮		27(=)
2020-01-03		44(+63%)
2020-01-04		44(=)
2020-01-05		59(+34%)
⋮
2020-01-10	41(n.a.)
⋮	41(=)
2020-01-16	45(+9.7%)
2020-01-17	62(+38%)
2020-01-18	121(+95%)
2020-01-19	198(+64%)
2020-01-20	291(+47%)
2020-01-21	440(+51%)
2020-01-22	571(+30%)
2020-01-23	830(+45%)
2020-01-24	1,287(+55%)
2020-01-25	1,975(+53%)
2020-01-26	2,744(+39%)
2020-01-27	4,515(+64%)
2020-01-28	5,974(+32%)
2020-01-29	7,711(+29%)
2020-01-30	9,692(+26%)
2020-01-31	11,791(+22%)
2020-02-01	14,380(+22%)
2020-02-02	17,205(+20%)
2020-02-03	20,438(+19%)
2020-02-04	24,324(+19%)
2020-02-05	28,018(+15%)
2020-02-06	31,161(+11%)
2020-02-07	34,546(+11%)
2020-02-08	37,198(+7.7%)
2020-02-09	40,171(+8.0%)
2020-02-10	42,638(+6.1%)	48,315^[i](n.a.)
2020-02-11	44,653(+4.7%)	55,220(+14%)
2020-02-12	46,472(+4.1%)	58,761^[ii](+6.4%)
2020-02-13	48,467(+4.3%)	63,851(+8.7%)
2020-02-14	49,970(+3.1%)	66,492(+4.1%)
2020-02-15	51,091(+2.2%)	68,500(+3.0%)
2020-02-16		70,548(+3.0%)
2020-02-17		72,436(+2.7%)
2020-02-18		74,185^[iii](+2.4%)
2020-02-19		75,002^[iv](+1.1%)
2020-02-20		75,891(+1.2%)
2020-02-21		76,288(+0.52%)
2020-02-22		76,936(+0.85%)
2020-02-23		77,150(+0.28%)
2020-02-24		77,658(+0.66%)
2020-02-25		78,064(+0.52%)
2020-02-26		78,497(+0.55%)
2020-02-27		78,824(+0.42%)
2020-02-28		79,251(+0.54%)
2020-02-29		79,824(+0.72%)
2020-03-01		80,026(+0.25%)
2020-03-02		80,151(+0.16%)
2020-03-03		80,270(+0.15%)
2020-03-04		80,409(+0.17%)
2020-03-05		80,552(+0.18%)
2020-03-06		80,651(+0.12%)
2020-03-07		80,695(+0.05%)
2020-03-08		80,735(+0.05%)
2020-03-09		80,754(+0.02%)
2020-03-10		80,778(+0.03%)
2020-03-11		80,793(+0.02%)
2020-03-12		80,813(+0.02%)
2020-03-13		80,824(+0.01%)
2020-03-14		80,844(+0.02%)
2020-03-15		80,860(+0.02%)
2020-03-16		80,881(+0.02%)
2020-03-17		80,894(+0.02%)
2020-03-18		80,928(+0.04%)
2020-03-19		80,967(+0.05%)
2020-03-20		81,008(+0.05%)
2020-03-21		81,054(+0.06%)
2020-03-22		81,093(+0.05%)
2020-03-23		81,171(+0.10%)
2020-03-24		81,218(+0.06%)
2020-03-25		81,285(+0.08%)
2020-03-26		81,340(+0.07%)
2020-03-27		81,394(+0.06%)
2020-03-28		81,439(+0.06%)
2020-03-29		81,470(+0.04%)
2020-03-30		81,518(+0.06%)
2020-03-31		81,554(+0.04%)
2020-04-01		81,589(+0.04%)
2020-04-02		81,620(+0.04%)
2020-04-03		81,639(+0.02%)
2020-04-04		81,669(+0.04%)
2020-04-05		81,708(+0.05%)
2020-04-06		81,740(+0.04%)
2020-04-07		81,802(+0.08%)
2020-04-08		81,865(+0.08%)
2020-04-09		81,907(+0.05%)
2020-04-10		81,953(+0.06%)
2020-04-11		82,052(+0.12%)
2020-04-12		82,160(+0.13%)
2020-04-13		82,249(+0.11%)
2020-04-14		82,295(+0.06%)
2020-04-15		82,341(+0.06%)
2020-04-16		82,692(+0.40%)
2020-04-17		82,719(+0.03%)
2020-04-18		82,735(+0.02%)
2020-04-19		82,747(+0.01%)
2020-04-20		82,758(+0.01%)
Dari 10 Februari 2020 dan seterusnya, data termasuk kes-kes di Hubei yang tidak diuji untuk virus itu tetapi didiagnosis secara klinikal berdasarkan pengimejan perubatan yang menunjukkan tanda-tanda radang paru-paru.^[1] Data yang diuji oleh makmal juga tersedia secara berasingan untuk 10–15 Februari 2020.^[2] Data dari 16 Februari 2020 dan seterusnya tidak termasuk kes berasingan yang diuji oleh makmal. Dari 19 Februari 2020 dan seterusnya, hanya kes baru yang diuji oleh makmal yang dikira terhadap jumlah keseluruhan (tetapi kes didiagnosis klinikal yang dikira lebih awal tidak dibuang).^[3] Sumber data dari laporan harian NHC.

Ralat petik: Tag <ref> wujud untuk kumpulan bernama "lower-roman", tetapi tiada tag <references group="lower-roman"/> yang berpadanan disertakan

^ 国家卫生健康委员会办公厅 (5 February 2020). "新型冠状病毒感染肺炎的诊疗方案（试行第五版）" ["Diagnosis and Treatment of New Coronavirus Infected Pneumonia (Trial Version 5)"] (PDF). 国家卫生健康委员会办公厅 (dalam bahasa Chinese). Diarkibkan (PDF) daripada yang asal pada 5 February 2020. Dicapai pada 5 February 2020.CS1 maint: unrecognized language (link)
^ "2020年2月11日湖北省新型冠状病毒肺炎疫情情况" [Epidemic situation of new coronavirus pneumonia in Hubei Province on February 11, 2020] (dalam bahasa Cina).
^ Woodyatt, Amy; Kottasová, Ivana; Griffiths, James; Regan, Helen. "China changed how it counts coronavirus cases again. Here's why". CNN.

[5] 国家卫生健康委员会办公厅 (5 February 2020). "新型冠状病毒感染肺炎的诊疗方案（试行第五版）" ["Diagnosis and Treatment of New Coronavirus Infected Pneumonia (Trial Version 5)"] (PDF). 国家卫生健康委员会办公厅 (dalam bahasa Chinese). Diarkibkan (PDF) daripada yang asal pada 5 February 2020. Dicapai pada 5 February 2020.CS1 maint: unrecognized language (link)

[6] "2020年2月11日湖北省新型冠状病毒肺炎疫情情况" [Epidemic situation of new coronavirus pneumonia in Hubei Province on February 11, 2020] (dalam bahasa Cina).

[7] Woodyatt, Amy; Kottasová, Ivana; Griffiths, James; Regan, Helen. "China changed how it counts coronavirus cases again. Here's why". CNN.

[i]

[ii]

[iii]

[iv]

[1]

[2]

[3]