Wikipedia:Bahagian: Perbezaan antara semakan
Kandungan dihapus Kandungan ditambah
Tiada ringkasan suntingan |
Tiada ringkasan suntingan |
||
Baris 1:
{{panduan}}
{{gaya}}
Sesebuah halaman harus dibahagi kepada '''bahagian''' (''section'') dengan menggunakan sintaks pengatas bahagian. Halaman yang menggunakan lebih daripada tiga pengatas bahagian akan dijanakan jadual kandungan (''table of contents'', TOC) secara automatik. Laman ini menjelaskan sintaks unsur-unsur ini.
==Pembentukan dan penomboran bahagian==
{{for|butiran cara menamakan bahagian, atau penggunaan bahagian yang betul pada struktur rencana |Wikipedia:Panduan tataletak}}
'''Bahagian''' terbentuk dengan menaipkan pengatasnya seperti berikut.
<pre>
==Bahagian==
===
====
</pre>
Tolong ''jangan'' gunakan hanya satu tanda sama dengan di setiap belah kata ({{xt|<nowiki>=Heading=</nowiki>}}). Ini akan menyebabkan pengatas bahagian menjadi sebesar tajuk laman.
Setiap nama pengatas bahagian (termasuk subbahagian) sewajarnya unik pada halaman. Jika nama pengatas yang sama dipakai lebih daripada sekali dalam satu laman, masalah berikut akan timbul:
* [[Bantuan:Pautan wiki|Pautan dalam (''wikilink'')]] pada bahagian, dalam bentuk {{xt|<nowiki>[[Tajuk rencana#Pengatas bahagina]]</nowiki>}}, akan berpaut kepada bahagian pertama yang empunya nama itu dalam laman, padahal ia mungkin bukanlah bahagian yang disasarkan oleh pautan itu.
* Apabila sesuatu bahagian yang berkongsi nama itu disunting, sejarah dan ringkasan penyuntingan akan kekaburan bahagian mana yang disunting.
* Apabila meyimpan laman selepas menyunting bahagian, pelayar mungkin berpandu arah ke bahagian yang salah.
===
Untuk pengguna berdaftar yang memasang "[[Khas:Keutamaan#preftab-1|Nomborkan tajuk secara automatik]]" dalam tetapan keutamaannya, bahagian-bahagiannya diberi nombor pada jadual kandungan dan di awal setiap pengatas bahagian.
==Jadual isi kandungan (TOC)==
{{Jalan pintas|WP:TOC}}
{{For|kandungan Wikipedia|Portal:Kandungan}}
Untuk setiap laman yang lebih daripada tiga pengatas, sebuah '''jadual isi kandungan (''table of contents'', TOC)''' dijana secara automatik daripada pengatas bahagian, melainkan:
*(untuk pengguna) anda mematikan fungsi ini dalam [[Khas:Keutamaan|keutamaan]] anda
*(untuk rencana) [[Bantuan:Kata sakti|Kata sakti]] <tt><nowiki>__NOTOC__</nowiki></tt> (dengan '''dua tanda garis bawah (''underscore'')''' di setiap belah kata) dibubuh pada rencana
===Menentukan kedudukan jadual isi kandungan===
Apabila <tt><nowiki>__FORCETOC__</nowiki></tt> atau <tt><nowiki>__TOC__</nowiki></tt> (dengan '''dua tanda garis bawah''' di setiap belah kata) ditaipkan dalam teks wiki, jadual isi kandungan dipaparkan walaupun lamannya tidak lebih tiga pengatasnya.
Dengan <tt><nowiki>__FORCETOC__</nowiki></tt>, jadual kandungan diletakkan sebelum pengatas bahagian pertama. Dengan <tt><nowiki>__TOC__</nowiki></tt>, ia diletakkan di kedudukan yang sama dengan kod ini. Sepatutnya ada teks pendahuluan rencana sebelum jadual isi kandungan. Biarpun disaran supaya meletakkan pengatas selepas jadual isi kandungan, <tt><nowiki>__TOC__</nowiki></tt> boleh digunakan untuk untuk memperbaiki kedudukan jadual isi kandungan, khususnya apabila jadual itu kelihatan terlalu rendah apabila dibiarkan berada di atas pengatas pertama begitu sahaja.
====Mengapungkan jadual isi kandungan====
Kadang-kadang, jadual isi kandungan boleh diapungkan ke kanan atau kiri dengan menggunakan templat {{tl|TOC kanan}} atau {{tl|TOC kiri}} jika ia diperlukan dalam tataletak rencana, ataupun apabila tetapan jadual isi kandungan yang sediakala bertindan dengan unsur-unsur lain pada laman rencana. Sebelum mengapungkan jadualnya, pertimbangkan garis-garis panduan berikut:
# Jika mutu penampilan rencana akan terjejas oleh perubahan, jangan apungkan jadual isi kandungan.
# Jika diapungkan, jadual isi kandungan harus diletakkan selepas bahagian pendahuluan teks wiki demi kekonsistenan. Pengguna alat [[pembaca skrin]] tidak menjangkakan apa-apa teks di antara jadual isi kandungan dan pengatas pertama, maka ketiadaan teks di atas jadual isi kandungan boleh mengelirukan. Lihat [[Wikipedia:Kemudahan_pembacaan#Struktur_rencana]]
# Apabila jadual isi kandungan diapungkan, semak sama ada tataletak laman terjejas jika jadual isi kandungan disorokkan oleh pengguna.
# Jika senarai bahagiannya panjang lebar, maka jadual isi kandungannya mungkin terlalu panjang. Jadual isi kandungan, baik terapung mahupun tidak, boleh dikenakan templat {{tl|TOC limit}} untuk memendekkan jadual isi kandungan dengan menyorokkan subbahagian yang tersarang (''nested section'').
# Jadual isi kandungan yang sediakala diletakkan sebelum baris pengatas pertama, dan selepas apa jua teks pendahuluan (melainkan diubah oleh penyunting laman). Jika ringkasan pendahuluannya terlalu panjang sehingga pembaca terpaksa menatal (menskrol) ke bawah semata-mata untuk mencari jadual isi kandungannya, anda boleh mengapungkan jadual isi kandungan supaya ia kelihatan menghampiri bahagian atas rencana. Setidak-tidaknya, jadual isi kandungan terapung sewajarnya terletak selepas perenggan pertama teks pendahuluan.
# Jika jadual isi kandungan yang luas diapungkan, ini akan menyebabkan lajur teks bacaan menjadi lebih sempit bagi pengguna yang skrinnya berleraian rendah (''low resolution''). Jika lebar jadual isi kandungan mencecah 30% skrin pengguna (lebih kurang dua kali saiz bar pandu arah Wikipedia di kiri), maka ia tidak sesuai diapungkan. (Peratusan tersebut berdasarkan anggapan ''setup'' pengguna yang biasa.)
# Jika jadual isi kandungan terletak di sekitar imej atau petak terapung yang lain, ia boleh terapung selagi lajur teks tidak menjadi lebih sempit daripada 30% lebar skrin pengguna.
# Jadual isi kandungan yang terapung di kiri boleh menjejaskan senarai berbulet mahupun bernombor.
===Mengehadkan kedalaman jadual isi kandungan===
Apabila sesuatu laman rencana atau projek mempunyai banyak sangat subbahagiannya, ada baiknya anda menyorokkan subbahagian tahap rendah dari jadual isi kandungan. Anda boleh menentukan had untuk aras bahagian terendah yang boleh dipaparkan dengan menggunakan {{tlp|TOC limit|2=limit=''n''}}, yang mana ''n'' ialah bilangan tanda = yang digunakan di setiap belah pengatas bahagian aras terendah yang boleh dipaparkan (cth. 3 untuk memaparkan ===bahagian=== sambil menyorokkan ====bahagian====). Parameter limit=''n'' juga boleh dipakai sama caranya untuk {{tl|TOC kiri}} atau {{tl|TOC kanan}}.
===Pautan kepada jadual isi kandungan===
Jadual isi kandungan dijana secara automatik dengan id HTML "toc". Anda boleh membuat pautan kepada jadual itu dengan <nowiki>[[#toc]]</nowiki>:
* Halaman sama:
** kod wiki: <nowiki>[[#toc|Kandungan]]</nowiki>
** pautan: [[#toc|Kandungan]]
* Halaman lain:
** kod wiki: <nowiki>[[Bantuan:Penanda wiki#toc|Kandungan]]</nowiki>
** pautan: [[Bantuan:Penanda wiki#toc|Kandungan]] (laman bantuan penanda wiki)
==Pautan bahagian==
Dalam kod HTML, setiap bahagian ada atribut "id" yang memegang tajuk bahagian. Inilah yang membolehkan [[w:hyperlink|pembuatan pautan]] terus kepada bahagian. Penambat bahagian (''section anchor'') ini digunakan secara automatik oleh MediaWiki apabila ia menjana jadual isi kandungan sesuatu laman; maka, apabila anda mengklik pengatas bahagian pada jadual isi kandungan, anda akan terus dibawa ke bahagian itu. Selain itu, penambat bahagian boleh dipautkan terus ke sebahagian dalam laman secara manual.
Misalnya, kod HTML yang dijana pada awal bahagian adalah seperti berikut:
<pre><nowiki><h2><span class="mw-headline" id="Section_linking">Section linking</span></h2></nowiki></pre>
Pautan kepada bahagian ini ([[Wikipedia:Bahagian#Pautan bahagian|Pautan bahagian]]) berbentuk seperti berikut:
:<tt><nowiki>[[Wikipedia:Bahagian#Pautan bahagian|Pautan bahagian]]</nowiki></tt>
Untuk membuat pautan kepada bahagian di laman yang sama, gunakan <tt><nowiki>[[#tajuk bahagian|teks paparan]]</nowiki></tt>. Untuk pautan kepada bahagian di laman lain, gunakan pula <tt><nowiki>[[tajuk laman#tajuk bahagian|teks paparan]]</nowiki></tt>.
Penambat tidak mengendahkan kedalaman bahagian; maka pautan kepada subbahagian atau sub-subbahagian dsb. berbentuk <tt><nowiki>[[#tajuk subbahagian]]</nowiki></tt> dan <tt><nowiki>[[#tajuk sub-subbahagian]]</nowiki></tt> dsb.
Tanda garis bawah dan nombor dibubuh pada nama bahagian yang terkongsi. Cth. untuk tiga bahagian bernama "Contoh", nama-namanya (untuk membuat pautan bahagian) haruslah berbentuk "Contoh", "Contoh_2" dan "Contoh_3". Akan tetapi, selepas menyunting bahagian "Contoh_2" atau "Contoh_3" (lihat di bawah), anda masih tiba di bahagian "Contoh" pertama dari [[Bantuan:Ringkasan penyuntingan|ringkasan penyuntingan]].
Jika bahagian itu ada pengatas jarak kosong, ini menyebabkan adanya pautan dalam jadual isi kandungan yang tidak berfungsi. Untuk menghasilkan sasaran penambat target tanpa pengatas bahagian, gunakan templat {{tl|anchor}} atau rentang: <tt><nowiki><span id="anchor_name"></span></nowiki></tt>.
'''Catatan:'''
* Penggunaan [[Khas:Keutamaan#preftab-2|ciri pemformatan tarikh]] pada pengatas bahagian merumitkan pemautan bahagian.
* Teks pengatas bahagian yang dijadikan pautan dalam tidak merumitkan dari segi pemautan bahagian; bagaimanapun, penyunting yang menetapkan keutamaan supaya bahagian disunting dengan mengklik pengatas tidak dapat mengklik pautan-pautan ini:
**[[#Demo a]]
**[[Wikipedia:Bahagian#Demo http:.2F.2Fa]]
**http://meta.wikimedia.org/wiki/Help:Section#Demo_http:.2F.2Fa
* [[Bantuan:Pautan berpaip#Teknik paip|Teknik paip]] tidak berkesan untuk pautan bahagian:
** <tt><nowiki>[[#bahagian|]]</nowiki></tt> -> [[#bahagian|]]
** <tt><nowiki>[[laman#bahagian|]]</nowiki></tt> -> [[laman#bahagian|]]
** <tt><nowiki>[[ruang nama:laman#bahagian|]]</nowiki></tt> -> [[ruang nama:laman#bahagian|]]
<!--
===Pautan dan lencongan bahagian===
Pautan yang menentukan bahagian pada laman lencongan berpadan dengan pautan kepada bahagian laman yang disasarkan oleh lencongan itu.
[[Wikipedia:Lencongan|Lencongan]] kepada bahagian laman juga berkesan, cth. cuba the redirect page [[Help:Section linking and redirects|Section linking and redirects]].
A complication is that, unlike renaming a page, renaming a section does not create some kind of redirect.
Also, there is no separate [[Help:What links here|backlink feature for sections]], pages linking to the section are included in the list of pages linking to the page. Possible workarounds:
*Instead of linking directly to a section, link to a page that redirects to the section; when the name of the section is changed, change the redirect target. This method also provides more or less a "what links here" for sections (look for redirects linking to the page, select the one linking to the section; this may be recognized from the name even if the section name has changed).
*Put an penambat and link to that
*Put a comment in the wikitext at the start of a section listing pages that link to the section
*Make the section a separate page/template and either transclude it into, or just link to it from, its parent page; instead of linking to the section one can then link to the separate page.
Redirect pages can be categorized by adding a category tag after the redirect command. In the case that the target of the redirect is a section, this has to some extent the effect of categorizing the section: through the redirect the category page links to the section; however, unless an explicit link is put, the section does not link to the category. On the category page, redirects are displayed with class redirect-in-category, so they can be shown in e.g. italics; this can be defined in [[MediaWiki:Common.css]]. See also [[WP:Categorizing redirects]].
-->
==Menyunting bahagian==
Bahagian boleh disunting secara berasingan dari seluruh laman dengan mengklik pautan berlabel "[sunting]" dekat pengatas itu, atau mengklik-kanan pengatas bahagian, bergantung pada tetapan [[Khas:Keutamaan|keutamaannya]]. Ini namanya "ciri penyuntingan bahagian" (<nowiki>Keutamaan -> Menyunting -> "Bolehkan penyuntingan bahagian melalui pautan [sunting]"</nowiki>). Ciri ini akan membawa anda kepada laman penyuntingan yang ber-URL seperti berikut:
{{fullurl:Wikipedia:Bahagian|action=edit§ion=2}}
Diingatkan di sini bahawa ''nombor'' bahagian digunakan, bukan ''tajuk''nya; subbahagian juga diberikan nombor tunggal, cth. bahagian 2.1 boleh diberi nombor 3, kemudian bahagian 3 diberi nombor 4, dsb. Anda juga boleh terus menaipkan URL laman penyuntingan sebegini dalam ruangan alamat pelayar anda.
Ciri ini memudahkan kita jika kerja suntingan tidak melibatkan bahagian lain atau teks dari bahagian lain (jika diperlukan, buka pautan sunting bahagian dalam tetingkap/tab baru, atau ketika menyunting bahagian, buka halaman utama dalam tetingkap/tab yang lain). Penyuntingan bahagian meringankan alleviates masalah menyunting laman-laman yang besar.
Peletakan "<nowiki>__NOEDITSECTION__</nowiki>" di mana-mana sahaja dalam laman akan menggugurkan pautan sunting, tetapi tidak mematikan fungsi penyuntingan begitu sahaja, kerana URL dan fungsi klik-kanan pada bahagian masih berkesan.
Anda boleh menyunting bahagian sebelum atau selepasnya untuk menambahkan bahagian baru, atau menggabungkan bahagian dengan memadamkan pengatas; tetapi dalam hal ini, nama bahagian yang dimuatkan dalam ringkasan penyuntingan adalah tidak betul dan wajar diubah atau dipadamkan.
<!--
===Menambahkan bahagian di hujung===
On talk pages and pages with in the wikitext the code <nowiki>__NEWSECTIONLINK__</nowiki> a special link labeled "{{MediaWiki:addsection}}" or "+" is provided to add a new section to the end of the page.
The URL for such an action looks like:
{{fullurl:Wikipedia:Sandbox|action=edit§ion=new}}.
In this case, a text box having as title "{{MediaWiki:subject}}", will appear and the content you type in it will become the name of the new section heading. There is no inputbox for the [[Help:edit summary|edit summary]]; it is automatically created.
:See also [[Help:Edit summary#Section editing|linking in an edit summary to a section]], [[Help:Edit summary#"Post a comment" talk page feature|"Post a comment" feature]].
===Editing before the first section===
By default, there is no link to edit the lead section of a page, so the entire page must edited. Lead section editing can be enabled through ''[[Special:Preferences]] → Gadgets → User interface gadgets: editing → Add an [edit] link for the lead section of a page.''
===Preview===
The preview in section editing does not always show the same as the corresponding part of the full page, e.g. if on the full page an image in the previous section intrudes into the section concerned.
The edit page shows the list of templates used on the whole page, i.e. also the templates used in other sections.
===
Subsections are included in the part of the section that is edited. Section numbering is relative to the part that is edited, so on the relative top level there is always just number 1, relative subsections all have numbers starting with 1: 1.1., 1.2, etc.; e.g., when editing subsection 3.2, sub-subsection 3.2.4 is numbered 1.4. However, the heading ''format'' is according to the absolute level.
===Editing a footnote===
To edit a footnote rendered in a section containing the code <nowiki><references /></nowiki>, edit the section with the footnote mark referring to it, see [[Help:Footnotes]]. However, the resulting text of the footnote is not shown in a preview of the section via "Show preview", so any mistake made by the editor will not be discovered until after the section edit is saved via "Save page". A workaround is to temporarily add a <nowiki><references/></nowiki> or <nowiki>{{reflist}}</nowiki> tag at the end of the section prior to previewing it. But after you are satisfied with the text of the reference shown in the preview, this temporary tag must be removed before the edit is saved.
===Editing a page with large sections===
If a page has very large sections, or is very large and has no division into sections, and one's browser or connection does not allow editing of such a large section, then one can still:
*append a section by specifying a large section number (too large does not matter); however, one has to start with a blank line before the new section
*append content to the last section by not starting with a
If one can view the wikitext of a large section, one can divide the page into smaller sections by step by step appending one, and finally deleting the original content (this can be done one large section at a time). Thus temporarily there is partial duplication of the content, so it is useful to put an explanation in the edit summary.
===Sections within parser functions===
When conditionally (using a [[Help:Magic words|parser function]])
transcluding a template with sections, edit links of this and subsequent sections will edit the wrong section or give the error message that the section does not exist (although the page (including TOC) is correctly displayed and the TOC links correctly). This is because for the targets of the edit links the content of conditionally included templates is considered part of the page itself, and the sections are counted after expansion.
Thus the edit links of the sections of the included template link to the page itself instead of the template, and the edit links after the included template link to the correct page but the wrong section number.
More generally conditional sections give such a complication.
The problem does not occur when transcluding a template with a conditional name (which has more advantages). Use {{tim|void}} for the template to transclude to produce nothing.
{{Help:Editing sections of included templates}}
===Sections vs. separate pages vs. transclusion===
Advantages of separate pages:
# separate edit histories
# some template limits apply ''per page''
# automatic redirect on renaming
# loading ''one'' small page is faster than loading ''one'' large page – but are readers more likely to want to use just one section or to browse many of the sections of the topic? – see advantages of combined pages
# can separately be put in categories (however, see also below)
# with [[Semantic MediaWiki]]: have separate annotations
Advantages of one combined page with sections:
# loading ''one combined'' page is ''faster and more convenient'' than loading ''several divided'' ones
# searching within one large page or its wikitext with a local search function is faster and has advantages over searching several pages using the site search engine or a web search engine
# the TOC provides for convenient navigation.
# more likelihood of editorial cohesion of a concept compared to having several definitions likely to be independently edited
# duplication of items relevant to each section, such as navigation templates and infoboxes is avoided
An alternative is [[Help:Template#Composite pages|composing a page of other pages using the template feature]] (creating a [[w:compound document|compound document]] by [[w:Wikipedia:transclusion|Transclusion]]). This allows easy searching within the combined rendered page, but not in the combined wikitext. As a disadvantage, a title for each page has to be provided. For the pre-expand include size limit this is disadvantageous even compared with one large page: the pre-expand include size is the sum of the pre-expand include sizes of the components plus the sum of sizes of the wikitexts of the components.-->
==Bahagian tunjuk cara==
===Tunjuk cara http://a===
Bahagian ini dipautkan dari [[#Pautan bahagian]].
==Lihat juga==
*[[Help:Preferences]]
{{H:f|langs=|enname=
[[Category:Bantuan unsur rencana Wikipedia]]
[[als:Hilfe:Inhaltsverzeichnis]]
[[ar:مساعدة:قسم]]
[[de:Hilfe:Inhaltsverzeichnis]]
[[en:Help:Section]]
[[fa:راهنما:بخش]]
[[it:Aiuto:Sezioni]]
[[he:עזרה:תוכן עניינים]]
[[hu:Wikipédia:Fejezet]]
[[ja:Help:セクション]]
[[pl:Wikipedia:Dzielenie artykułów na sekcje]]
[[pt:Ajuda:Secção]]
[[ru:Справка:Секции]]
[[si:විකිපීඩියා:SECT]]
[[tt:Bülek]]
[[yi:הילף:אפטיילונג]]
[[zh:Help:章节]]
|