ទំព័រគំរូ:ប្រអប់ព័ត៌មាន/doc

Test Infobox
	Caption for example.png
Header defined alone
	Data defined alone
All three defined (header, label, data, all with same number)
Label and data defined (label)	Label and data defined (data)
	Below text
	v; t; e;

អក្សរនៅក្នុងប្រអប់ព័ត៌មានខាងលើ
	ចំណងជើងក្បាលរងរបស់ ប្រអប់ព័ត៌មាន
	ចំណងជើងក្បាលរងបន្ទាប់របស់ ប្រអប់ព័ត៌មាន
	(ប្រអប់ព័ត៌មានទាំងមូលគឺស្ថិតនៅទីនេះ)

អក្សរនៅក្នុងទីតាំងលើ ប្រអប់ព័ត៌មាន
	ចំណងជើងក្បាលរងរបស់ ប្រអប់ព័ត៌មាន
	(ប្រអប់ព័ត៌មានទាំងមូលគឺស្ថិតនៅទីនេះ)

This is a documentation subpage for ទំព័រគំរូ:ប្រអប់ព័ត៌មាន.
It may contain usage information, categories and other content that is not part of the original ទំព័រគំរូ page.

ទំព័រគំរូដោយចេតនាជាទំព័រគំរូមេតា: ទំព័រគំរូដែលប្រើសម្រាប់សង់ទំព័រគំរូឯទៀត។ វាមិនមានន័យថាសម្រាប់ប្រើដោយផ្ទាល់ក្នុងអត្ថបទនោះទេ តែអាចប្រើបានលើជំហរតែមួយដងបើត្រូវបានទាមទារ។ មើលជំនួយ:ប្រអប់ព័ត៌មាន សម្រាប់លំណែនាំនៃប្រអប់ព័ត៌មាន និងព័ត៌មាន អំពីរបៀបកែច្នៃវា។ មើលចំណាត់ថ្នាក់ក្រុម:ទំព័រគំរូ ប្រអប់ព័ត៌មាន សម្រាប់ទំព័រគំរូប្រអប់ព័ត៌មានជាក់លាក់។

ការប្រើប្រាស់

ការប្រើប្រាស់មានលក្ខណៈស្រដៀងទៅនឹង {{navbox}}, ប៉ុន្តែគ្រាន់តែពុម្ពគម្រូនេះមានភ្ជាប់មកជាមួយនូវ ភាពខុសគ្នាបន្ថែមទៀត។ នៅក្នុងជួរនិមួយៗនៅលើតារាង អាចមានទាំង បឋមកថា, ឬ ស្លាក/ទិន្នន័យ, ឬ តែទិន្នន័យ។ មានភាពភាពមិនចុះសម្រុងគ្នា ដូច្នេះប្រសិនបើអ្នកកំណត់ជួយមួយជាមួយនឹង បឋមកថា និង ស្លាក/ទិន្នន័យ នោះ ស្លាក/ទិន្នន័យ នឹងមិនស្គាល់។

ដើម្បីបញ្ចូលរូបភាពទៅក្នុងទីតាំងផ្សេងក្រៅបពីកន្លែងនៅខាងលើ ប្រអប់ព័ត៌មាន ឬ បញ្ចូលទៅក្នុងទិន្នន័យនោះ អ្នកអាចប្រើជាជួរ ដែលដាក់តែវាលទិន្នន័យបានហើយ។

ទីលំដាប់

ដើម្បីឲ្យមានភាពអាចបត់បែនបាន នៅពេលគ្រោងនៃប្រអប់ព័ត៌មានត្រូវបានប្ដូរនោះ វាអាចមានប្រយោជន៍នៅពេលកំពុងអភិវឌ្ឍប្រអប់ព័ត៌មានដោយមិនប្រើភាពទាក់ទងគ្នារវាងជួរ បឋមកថា និង ស្លាក/ទិន្នន័យ។ ការវាស់ស្ទង់សម្រាប់ជួរថ្មី អាចនឹងត្រូវបានបញ្ចូលទៅខាងក្នុងនៅពេលខាងមុខ ដោយមិនមានការប្ដូរលេខលំដាប់ឡើយ។ ជាឧទាហរណ៍៖

|header3  = Section 1
|label5   = Label A
|data5    = Data B
|label7   = Label C
|data7    = Data C
|header10 = Section 2
|label12  = Label D
|data12   = Data D

ការវាស់ស្ទង់

មើល/ពិភាក្សា/កែតំណភ្ជាប់

name: ជាឈ្មោះពុម្ពទំព័រគម្រូដែលតំណភ្ជាប់ "មើល/ពិភាក្សា/កែប្រែ" សំដៅទៅរក។ អ្នកអាចប្រើ {{subst:PAGENAME}}។ ប្រសិនបើការវាស់ស្ទង់នេះត្រូវបានលុបនោះ តំណភ្ជាប់ មើល/ពិភាក្សា/កែប្រែ នឹងមិនបង្ហាញឡើងទេ។

ចំណងជើង

មានវិធីពីរផ្សេងគ្នា ដើម្បីដាក់ចំណងជើងឲ្យ ប្រអប់ព័ត៌មាន។ ទី១ មានចំណងជើងនៅខាងក្នុងព្រំដែនប្រអប់ព៌តមាន, ទី២ គឺដាក់វានៅខាងលើ។ អ្នកអាចប្រើវិធីទាំងពីរនេះក្នុងពេលតែមួយ ប្រសិនជាអ្នកចង់, ឬប្រើតែមួយក៏បានដែរ, ឬមិនប្រើ (ការធ្វើបែបនេះមិនបានណែនាំឲ្យប្រើទេ)។

title: ជាអក្សរដាក់នៅក្នុងទីតាំងខាងលើតារាង/ប្រអប់។
above: ជាអក្សរដាក់នៅខាងក្នុង ផ្នែកខាងលើតារាង/ប្រអប់។

មាតិកាដែលអាចដាក់បានតាមចិត្ត

subheader, subheader2: ជាចំណងជើងបន្ថែមដែលដាក់នៅចន្លោះ {{{title}}} និង {{{above}}}.
image, image2: ជារូបបង្ហាញនៅកំពូលពុម្ពគម្រូ។ ប្រើរូបមន្ដរូបភាពពេញលេញ, ឧទាហរណ៍ [[ឯកសារ:example.png|200px|alt=Example alt text]]. រូបភាពគឺត្រូវបានកំណត់ឲ្យដាក់នៅកណ្ដាលតាមលំនាំដើម។ មើល WP:ALT។
caption, caption2: ជាអក្សរដាក់នៅផ្នែកខាងក្រោមរូបភាព។
header(n): ជាអក្សរប្រើជាបឋមកថានៅក្នុងជួរទី n។
label(n): ជាអក្សរប្រើជាស្លាកនៅក្នុងជួរទី n។
data(n): ជាអក្សរប្រើសម្រាប់បង្ហាញជាទិន្នន័យនៅក្នុងជួរទី n។
below: ជាអក្សរដាក់នៅបាត។ ប្រឡោះនៅបាតត្រូវបានបម្រុសសម្រាប់ កំណត់ត្រាបាតក្រោម (footnotes), មើលផងដែរ, និង ព័ត៌មានផ្សេងៗ។
child: មើលជំពូក embedding សម្រាប់ព័ត៌មានលម្អិត។

កំណត់ចំណាំ៖ នៅពេលឥឡូវ, បឋមកថា, ស្លាក និង ទិន្នន័យ នៅជាមួយតម្លៃ n ដូចគ្នា វាមិនមែនមិនចុះសម្រុងគ្នាទៀតទេ គឺវានឹងត្រូវបង្ហាញ។ មើលការផ្ដល់លទ្ធផលនៃ header4, label4, និង data4 នៅក្នុងជំពូកឧទាហរណ៍ខាងក្រោម។

រចនាបថ CSS ដែលអាចប្រើតាមចិត្ត

bodystyle: អនុវត្តទៅលើតារាងប្រអប់ព័ត៌មានទាំងមូល
titlestyle: អនុវត្តតែលើអធិប្បាយប្រធានប៉ុណ្ណោះ។ ការបញ្ចូលពណ៌ផ្ទាំងក្រោយជាធម្មតាគឺមិនមានមែនជាភាពឈ្លាសឡើយ ដោយពាក្យពេចន៍គឺត្រូវបានប្រតិបត្តិនៅ "ខាងក្រៅ" នៃប្រអប់ព័ត៌មាន
abovestyle: អនុវត្តតែលើបន្ទប់ "លើ" នៅផ្នែកខាងលើ។ រចនាបថតាមលំនាំដើមមានពុម្ពអក្សរធំ font-size:large ដោយបន្ទប់នេះជាធម្មតាត្រូវបានប្រើសម្រាប់ប្រធាន ប្រសិនជាអ្នកចង់ប្រើពុម្ពអក្សរស្មើវិញ ដាក់ "font-size:medium;" ក្នុង abovestyle
imagestyle: អនុវត្តទៅលើបន្ទប់ដែលមានរូប។ នេះរួមទាំងពាក្យពេចន៍នៃអធិប្បាយរូប ប៉ុន្តែអ្នកគួរកំណត់លក្ខណៈសម្បត្តិនៃពាក្យពេចន៍ជាមួយ captionstyle ជាជាង imagestyle ក្នុងករណីអធិប្បាយត្រូវបានរើចេញនៅពេលខាងមុខ
captionstyle: អនុវត្តទៅលើពាក្យពេចន៍នៃអធិប្បាយរូប
headerstyle: អនុវត្តទៅលើពួកបន្ទប់នៃបឋមកថាទាំងអស់
labelstyle: អនុវត្តទៅលើពួកបន្ទប់នៃស្លាកទាំងអស់
datastyle: អនុវត្តទៅលើពួកបន្ទប់នៃទិន្នន័យទាំងអស់
belowstyle: អនុវត្តតែលើបាតបន្ទប់

ថ្នាក់នៃ HTML

bodyclass: ថាវរូបនេះត្រូវបានបញ្ចូលទៅក្នុងគុណលក្ខណ៍ "ថ្នាក់" សម្រាប់ប្រអប់ព័ត៌មានទាំងមូល។
titleclass: ថាវរូបនេះត្រូវបានបញ្ចូលទៅក្នុងគុណលក្ខណ៍ "ថ្នាក់" សម្រាប់អធិប្បាយនៃប្រធានរបស់ទំព័រគំរូ។
aboveclass: ថាវរូបនេះត្រូវបានបញ្ចូលទៅក្នុងគុណលក្ខណ៍ "ថ្នាក់" សម្រាប់បន្ទប់ "លើ" របស់ទំព័រគំរូ។
aboverowclass: ថាវរូបនេះត្រូវបានបញ្ចូលទៅក្នុងគុណលក្ខណ៍ "ថ្នាក់" សម្រាប់ជួរនៃតារាងពេញលេញដែលបន្ទប់ "លើ" ស្ថិតនៅ។
subheaderclass: ថាវរូបនេះត្រូវបានបញ្ចូលទៅក្នុងគុណលក្ខណ៍ "ថ្នាក់" សម្រាប់បឋមកថារងរបស់ទំព័រគំរូ។
subheaderrowclass: ថាវរូបនេះត្រូវបានបញ្ចូលទៅក្នុងគុណលក្ខណ៍ "ថ្នាក់" សម្រាប់ជួរនៃតារាងពេញលេញដែលបឋមកថារងស្ថិតនៅ។
imageclass: ថាវរូបនេះត្រូវបានបញ្ចូលទៅក្នុងគុណលក្ខណ៍ "ថ្នាក់" សម្រាប់រូប ហើយវាជាពិសេសត្រូវបានប្រើនៅឈ្នាប់ជាមួយ {{Image class names}}។
imagerowclass1, imagerowclass2: ថាវរូបនេះត្រូវបានបញ្ចូលទៅក្នុងគុណលក្ខណ៍ "class" សម្រាប់ជួរនៃតារាងពេញលេញដែលរូបរៀងៗគ្នាស្ថិតនៅ។
rowclass(n): ថាវរូបនេះត្រូវបានបញ្ចូលទៅក្នុងគុណលក្ខណ៍ "ថ្នាក់" សម្រាប់ជួរជាក់លាក់ រួមទាំង ស្លាកឬពាក្យពេចន៍ពន្យល់ដទៃ។
class(n): ថាវរូបនេះត្រូវបានបញ្ចូលទៅក្នុងគុណលក្ខណ៍ "ថ្នាក់" សម្រាប់បន្ទប់ទិន្នន័យនៃជួរជាក់លាក់។ ប្រសិនបើគ្មានបន្ទប់ទិន្នន័យនោះវាក៏គ្មានផលឡើយ។
belowclass: ថាវរូបនេះត្រូវបានបញ្ចូលទៅក្នុងគុណលក្ខណ៍ "ថ្នាក់" សម្រាប់បន្ទប់បាតរបស់ទំព័រគំរូ។

មីក្រូហ្វរម៉ាត

ទំព័រគំរូនេះគាំទ្រការបន្ថែមនៃព័ត៌មានមីក្រូហ្វរម៉ាត។ វាត្រូវបានធ្វើឡើងដោយគុណលក្ខណ៍ "ថ្នាក់" បន្ទប់ទិន្នន័យផ្សេងៗ ចង្អុលប្រាប់នួវបែនៃព័ត៌មានដែលចុះទៅក្នុង។ ដើម្បីកំណត់ចង្អុលប្រអប់ព័ត៌មានមួយដោយរួមមានព័ត៌មាន hCard ជាឧទាហរណ៍ បន្ថែមថាវរូបតទៅនេះ:

|bodyclass = vcard

ហើយសម្រាប់ជួរនីមួយៗដោយរួមមានបន្ទប់ទិន្នន័យមួយដែលជាផ្នែកនៃ vcard បន្ថែមថាវរូបថ្នាក់ជាបន្ត:

|class1 = fn
|class2 = org
|class3 = tel

...ហើយជាដើម៘ "លើ" និង "ប្រធាន" ផងដែរអាចបានអោយនូវថ្នាក់ ដោយពួកវានេះ ជាធម្មតាត្រូវបានប្រើដើម្បីបង្ហាញឈ្មោះនៃប្រធានវត្ថុនៃទំព័រគំរូ។

មើលវីគីភីឌា:វីគីគម្រោង មីក្រូហ្វរម៉ាត សម្រាប់ព័ត៌មានបន្ថែមអំពីការបន្ថែមព័ត៌មានទ្រង់ទ្រាយតូចៗទៅក្នុងវីគីភីឌា និង មីក្រូហ្វរម៉ាត សម្រាប់ព័ត៌មានបន្ថែមពីពួកមីក្រូហ្វរម៉ាតជាទូទៅ។

ប្រធានទ្រេត

ពួកប្រធាននៃអត្ថបទអាចធ្វើអោយទ្រេតបាន ក្នុងបន្ទាត់ជាមួយ WP:ITALICTITLE ដោយបោះចូលនូវចូល italic title ។

បើកប្រធានទ្រេតដោយបោះចូលនូវ |italic title={{{italic title|}}} ពីប្រអប់ព័ត៌មាន។
បិទតាមលំនាំដើមតែអោយករណីខ្លះទ្រេតដោយបោះចូលនូវ |italic title={{{italic title|no}}}
កុំបង្កើតប្រធានទ្រេតណាដោយមិនបោះចូលនូវថាវរូបអ្វីសោះឡើយ។

Making fields optional

A row with a label but no data is not displayed. This allows for the easy creation of optional infobox content rows. To make a row optional use a parameter that defaults to an empty string, like so:

|label5 = Population
|data5  = {{{population|}}}

This way if an article doesn't define the population parameter in its infobox the row won't be displayed.

For more complex fields with pre-formated contents that would still be present even if the parameter wasn't set, you can wrap it all in an "#if" statement to make the whole thing vanish when the parameter is not used. For instance, the "#if" statement in the following example reads "#if:the parameter mass has been supplied |then display it, followed by 'kg'":

|label6 = Mass
|data6  = {{#if:{{{mass|}}}|{{{mass}}} kg}}

For more on #if, see here.

You can also make headers optional in a similar way. If you want a header to appear only if one or more of the data fields that fall under it are filled, one could use the following pattern as an example of how to do it:

{{Infobox
|name    = {{subst:PAGENAME}}
|title   = Example of an optional header
|header1 = {{#if:{{{item_one|}}}{{{item_two|}}}{{{item_three|}}}|Optional header}}
|label2  = Item one
|data2   = {{{item_one|}}}
|label3  = Item two
|data3   = {{{item_two|}}}
|label4  = Item three
|data4   = {{{item_three|}}}
}}

header1 will be shown if any of item_one, item_two, or item_three is defined. If none of the three parameters are defined the header won't be shown.

The trick to this is that the "if" returns false only if there is nothing whatsoever in the conditional section, so only if all three of item_one, item_two and item_three are undefined will the if statement fail.

Examples

{{Infobox
|name         = Infobox/doc
|bodystyle    = 
|title        = Test Infobox
|titlestyle   = 

|image        = [[File:example.png|200px|alt=Example alt text]]
|imagestyle   = 
|caption      = Caption for example.png
|captionstyle = 
|headerstyle  = background:#ccf;
|labelstyle   = background:#ddf;
|datastyle    = 

|header1 = Header defined alone
|label1  = 
|data1   = 
|header2 = 
|label2  = Label defined alone does not display (needs data, or is suppressed)
|data2   = 
|header3 =
|label3  = 
|data3   = Data defined alone
|header4 = All three defined (header, label, data, all with same number)
|label4  = does not display (same number as a header)
|data4   = does not display (same number as a header)
|header5 =
|label5  = Label and data defined (label)
|data5   = Label and data defined (data)

|belowstyle = background:#ddf;
|below = Below text
}}

Notice how when a label is defined without an accompanying data cell the row doesn't appear in the displayed infobox, and when a header is defined on the same row as a data cell all of them are displayed.

For this example, bodystyle = width:20em; and labelstyle = width:33%;

Test Infobox
Header 4
Label 1	Data 1
Label 2	Data 2
Label 3	Data 3
Label 5	Data 5: Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
Below text
v t e

{{Infobox
|bodystyle   = width:20em;
|name        = Infobox/doc
|title       = Test Infobox
|titlestyle  = 
|headerstyle = 
|labelstyle  = width:33%
|datastyle   = 

|header1 = 
|label1  = Label 1
|data1   = Data 1
|header2 = 
|label2  = Label 2
|data2   = Data 2
|header3 = 
|label3  = Label 3
|data3   = Data 3
|header4 = Header 4
|label4  = 
|data4   = 
|header5 = 
|label5  = Label 5
|data5   = Data 5: Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.

|belowstyle = 
|below = Below text
}}

Embedding

One infobox template can be embedded into another using the |child= parameter. This feature can be used to create a modular infobox, or to create more well defined logical sections.

Top level title
First subsection
Label 1.1	Data 1.1

Second subsection
Label 2.1	Data 2.1

Below text

{{Infobox
| title = Top level title
| data1 = {{Infobox
  | child = yes
  | title = First subsection
  | label1= Label 1.1
  | data1 = Data 1.1
}}
| data2 = {{Infobox
  | child = yes
  | title = Second subsection
  | label1= Label 2.1
  | data1 = Data 2.1
}}
|belowstyle = 
|below = Below text
}}

Full blank syntax

(Note: the template currently handles up to 80 rows; only 20 are included here since infoboxes larger than that will be relatively rare. Just extend the numbering as needed. The microformat "class" parameters are also omitted as they are not commonly used.)

{{Infobox
|name         = {{subst:PAGENAME}}
|bodystyle    = 
|title        = 
|titlestyle   = 
|above        = 
|abovestyle   = 

|imagestyle   = 
|captionstyle = 

|image        = 
|caption      = 
|image2       = 
|caption2     = 

|headerstyle  = 
|labelstyle   = 
|datastyle    = 

|header1  = 
|label1   = 
|data1    = 
|header2  = 
|label2   = 
|data2    = 
|header3  = 
|label3   = 
|data3    = 
|header4  = 
|label4   = 
|data4    = 
|header5  = 
|label5   = 
|data5    = 
|header6  = 
|label6   = 
|data6    = 
|header7  = 
|label7   = 
|data7    = 
|header8  = 
|label8   = 
|data8    = 
|header9  = 
|label9   = 
|data9    = 
|header10 = 
|label10  = 
|data10   = 
|header11 = 
|label11  = 
|data11   = 
|header12 = 
|label12  = 
|data12   = 
|header13 = 
|label13  = 
|data13   = 
|header14 = 
|label14  = 
|data14   = 
|header15 = 
|label15  = 
|data15   = 
|header16 = 
|label16  = 
|data16   = 
|header17 = 
|label17  = 
|data17   = 
|header18 = 
|label18  = 
|data18   = 
|header19 = 
|label19  = 
|data19   = 
|header20 = 
|label20  = 
|data20   = 

|belowstyle =
|below = 
}}

Porting to other MediaWikis

The infobox template requires the tidy extension to be installed, and may not work with other MediaWikis the WP:TRAN has a version of Infobox that has been modified to work on other MediaWikis.

ការ​ប្រើ​ប្រាស់