Wikipedia:Templat diagram rute

Templat peta rute menyederhanakan tabel Wiki dan menyediakan tata letak seragam untuk kotak info peta rute, terutama untuk jalur kereta api namun juga telah digunakan untuk moda transportasi lainnya seperti transportasi air. Setiap templat berisi barisan ikon persegi, yang berjumlah lebih dari 3.000 buah, dengan teks opsional, untuk menyusun elemen lintas halaman pada diagram rute. Ikon tersebut menggambarkan fitur-fitur seperti jalur rel , stasiun kereta api , jembatan , sungai , terowongan, persimpangan , dan stasiun simpang .

Demonstrasi

Legenda

						Depot utara kereta api

					Jakarta (transfer untuk stasiun MRT ASEAN)
						Laut Timor
					Melbourne (transfer untuk layanan bus)
					Sydney (transfer untuk Metro Sydney)

						Depot selatan kereta api

Struktur

Format peta tidaklah wajib namun membutuhkan "pemrograman" yang sangat jeli dan hati-hati agar menghindari kerusakan tata letak artikel yang akan ditransklusi. Bagian berikutnya menjelaskan fungsi dan penggunaan templat.

Sebelum dibuatkannya {{BS-map}}, susunan peta rute biasa membutuhkan templat:

seperti gambar di samping. Format ini telah dipakai secara luas oleh banyak peta rute; namun untuk membuat peta baru sebaiknya mempergunakan templat {{BS-map}} untuk mempermudah penyuntingan.

Templat

Templat-tenplat tersebut dapat dibagi menjadi dua bagian:

templat umum yang merupakan pokok dari peta rute, dan
templat khusus yang memberikan informasi baris demi baris pada peta rute.

Tempat untuk peta mandiri

{{BS-map}}

BS-map adalah templat cakupan untuk templat baris, yang merupakan argumen dari parameter map=. BS-map memiliki parameter yang menyediakan informasi dasar dan dapat diperjelas lagi.

Nama parameter	Fungsi
inline	Menghilangkan judul dan fungsi buka-tutup, menghilangkan float, margin, dan garis tepi, melebarkan hingga 100%, terutama untuk mentransklusikan templat ini ke templat lain seperti {{Infobox jalur KA}}. Jika kode diagram tidak ditransklusi, tetapi berada pada kode di templat kotak info, harap ditambahkan sebelum `{{BS-map}}` untuk memaksa membuat tata letak yang sesuai.
style	Diisi dengan sintaksis CSS.
width	Lebar keseluruhan kotak. Dapat diganti dengan entri style. Tidak ada nilai asli karena dapat mengabaikan parameter tw pada templat BSn yang dipergunakan untuk mengganti lebar kolom teks pada templat BSn bagian yang dapat dibuka-tutup).
title	Judul peta.
title-bg	Warna latar belakang judul. Aslinya putih.
title-color	Warna font untuk judul. Aslinya berwarna hitam.
navbar	Menampilkan kolom l·b·s (lihat, bicara, sunting) di pojok bawah.
collapsible	Perbolehkan apakah dapat dibuka-tutup atau tidak. Aslinya yes, kalau ditulis no akan mengabaikan tombol "sembunyikan/tampilkan".
collapse	Status buka atau tutup. Yes jika dibuka, aslinya no.
legend	Pranala ke legenda jalur: route atau 1 (asali): {{Legenda jalur rel}}, legenda paling umum untuk semua jalur rel. track: {{Legenda tata letak stasiun}} untuk layout stasiun. bus: {{Legenda jalur bus}} untuk jalur bus. canal, water, atau waterway: {{Legenda jalur transportasi air}} untuk peta jalur transportasi air. highway atau road: {{Legenda jalan}} untuk peta jalan atau jalan tol. walkway, foot, atau footpath: {{Legenda jalan setapak}} untuk peta jalan setapak. no atau 0: Tidak ada legenda.
map	Templat BS yang menyusun diagram rute.
mapn	n mengartikan angka 2 hingga 5. Ruang peta tambahan. Dengan memisahkan peta menjadi beberapa bagian, rata kolom tidak akan mempengaruhi satu sama lain. Ini berguna jika Anda menampilkan dua peta, yang satunya menggunakan templat-templat BSn (kolom di kanan) dan lainnya menggunakan templat BSn-2 (kolom teks di kedua sisinya) yang tidak bisa saling menyesuaikan satu sama lain.
map-title mapn-title	n mengartikan angka 2 hingga 5. Judul di tiap peta.
map-collapsible mapn-collapsible	n mengartikan nomor 2 hingga 5. Membolehkan agar bisa dibuka-tutup atau tidak. Aslinya no, yes akan menampilkan tombol "sembunyikan/tampilkan". Anda harus memasukkan data pada parameter mapn-title atau jika tidak, maka parameter ini tidak akan berfungsi
map-collapse mapn-collapse	n mengartikan nomor 2 hingga 5. Status buka atau tutup. yes jika ingin diperluas, aslinya no.
bg	Warna latar belakang keseluruhan diagram, termasuk kolom teks pada templat BSn.
top	Catatan di atas peta.
bottom	Catatan di bawah peta, lebih baik dipakai untuk menempatkan templat {{navbar}}.

Lihat dokumentasi templatnya untuk informasi lebih lanjut.
Jika Anda membuat tabel langsung tanpa menggunakan templat, garis tegak |—yang paling sering dipergunakan dalam sintaksis tabel Wiki—harus diganti dengan {{!}}. Sebagai contoh, {| dikodekan sebagai {{{!}}, dan | sebagai {{!}}-. Sebaliknya, kemunculan tanda garis tegak tersebut akan merusak struktur templat dan isi artikel yang memuatnya. Hal ini disebabkan karena, ketika memproses templat, tanda baca tersebut berfungsi sebagai parameter yang memisahkan entri, yang mengesampingkan fungsi lain.
Ketika pemisah visual diinginkan pada kolom teks, tanda dua garis tegak ( ¦ ) dapat menggantikan tanda garis tegak. Tanda baca ini dapat diketikkan langsung dari papan ketik Anda menggunakan gabungan Alt+0166, atau menggunakan kode HTML: ¦ atau ¦.

Templat ikon

Merupakan bagian terpenting dalam merancang peta. Nomor n setelah nama templat BS (istilah bahasa Jerman untuk Bahnstrecke 'jalur kereta api') mengartikan banyaknya kolom ikon yang tersedia. Pergunakan templat-templat ini secara terus-menerus pada setiap baris baru untuk membuat peta.

Templat baris BSn

{{BS}}
BS1
bs

{{BS2}}
bs2

{{BS3}}
bs3

…

{{BS9}}
bs9

Parameter tak bernama pada {{BS}} didaftarkan di bawah. Parameter ini disusun sama seperti hasil keluaran yang akan ditampilkan.

`{{BS\|`	`Nama ikon`	`\|`	`Jarak/Waktu`	`\|`	`Teks`	`\|`	`Catatan 1`	`\|`	`Catatan 2`	`}}`
	1		2		3		4		5

1: Nama ikon mengartikan nama ikon yang akan ditampilkan pada kolom ikon. (Harap dikosongkan bila tidak ada ikon).

2: Jarak jalur rel atau waktu perjalanan sejak awal keberangkatan.

3: Teks, nama stasiun ataupun fasilitas lainnya.

4: Catatan 1 - Tulisan setelah teks dengan spasi di depannya dengan ukuran kecil.

5: Catatan 2 - Tulisan after catatan 1 dengan ukuran kecil namun rata kanan. (Dapat digunakan untuk menambah kasus lain untuk Jarak/Waktu).

Ketika menambahkan penggayaan khusus pada kolom teks, hati-hati menggunakan tanda sama dengan =, dapat menyebabkan hasil yang tidak diinginkan, karena berfungsi khusus untuk sintaksis parameter bernama pada templat (pada kolom teks menggunakan parameter tak bernama). Masalah ini dapat diselesaikan dengan menambahkan {{=}} seperti layaknya masalah garis tegak lurus di atas.

Teks dan catatan 2 pada baris yang sama

Teks utamaCatatan 2

Catatan 2 yang sangat panjang

Memindahkan catatan 2 ke catatan 1

Teks utamaCatatan 1

Catatan 2 yang sangat panjang

Setelah mempergunakan "float:right" pada catatan 1

Teks utama

Catatan 1

Catatan 2 yang sangat panjang

Terkadang mempergunakan teks utama dan catatan 2 pada baris yang sama mengakibatkan terlalu lebarnya templat peta dikarenakan ada teks catatan 2 yang terlalu panjang di lain baris walaupun sel teks utama maupun catatan 1 pada baris itu dipergunakan ataupun tidak. Masalah ini dapat diselesaikan dengan memindah teks pada catatan 2 ke catatan 1. Jika rata kanan masih dibutuhkan, masukkan <div style{{=}}"float:right"> & </div> pada teks catatan 1.

Templat baris BS dengan nomor (misal, {{BS2}}, {{BS3}}, dst.) urutan parameter tak bernama akan bergeser seiring bertambahnya kolom ikon:

{{BS2| Nama ikon 1 | Nama ikon 2 | Jarak/Waktu | Teks | Catatan 1 | Catatan 2 }}

1 2 3 4 5 6

{{BS3| Nama ikon 1 | Nama ikon 2 | Nama ikon 3 | Jarak/Waktu | Teks | Catatan 1 | Catatan 2 }}

1 2 3 4 5 6 7

dst.

BSn row templates

Icons

Text columns

km / min

0 / 0

AirportNorth terminal

Bus interchange

Main tracks

1 / 1.5

AirportSouth terminal

Semua templat BS memiliki parameter bernama, yang berisi fungsi lanjutan. Bedakan huruf kapital maupun huruf kecil pada nama parameter.

PX: ukuran ikon (misal, PX=50px), aslinya 20px (x20px).
- PX2, PX3, dst.: Ukuran ikon pada nomor kolom ikon yang disebutkan. (PX2 berarti paramater ukuran berkas pada kolom ke-2) Parameter PX berfungsi sebagai lebar keseluruhan ikon atau lebar ikon ke-1.
- Perlu diperhatikan bahwa parameter PX tidak mempengaruhi lebar ikon pada baris lain.
O1 (O satu, bukan nol satu), O12, O13, O14, O15 (diucapkan: O satu dua, bukan O dua belas): Nama ikon yang bertumpang (overlay) pada ikon di bawahnya pada kolom yang sama, maksimum 5 lapisan. Makin besar angka pada parameter menandakan lapisan di atasnya bertumpang pada ikon yang di bawahnya. Lihat pula bagian tumpang tindih antarikon untuk informasi lebih lanjut.
- O2, O22, O23, O24, O25: Nama ikon yang bertumpang tindih pada kolom ke-2.
- On, On2, On3, On4, On5: Nama ikon yang bertumpang tindih pada kolom ke-n, dst.
  - Untuk baris ikon yang sekurang-kurangnya 11 baris ({{BS11}}, {{BS12}}, {{BS11-2}}, {{BS12-2}}, dst.): Gunakan dua digit angka yang merujuk pada ikon yang akan ditumpanginya. Misalnya, O01, O012, O013, O014, O015 untuk ikon pertama, dan O12, O122, O123, O124, O125 untuk ikon ke-12, dst.
L1, L2, L3, dst.: Pranala internal pada ikon yang jika diklik ikon tersebut, maka dapat menggantikan pranala ke halaman deskripsi ikon tersebut.
bg: Gunakan nama warna atau kode RGB HTML (dengan awalan #) untuk menandai bagian yang dianggap penting, aslinya transparan.
tw: Lebar kolom teks. Khususnya diperlukan untuk menggabungkan ikon apabila panjang teks pada templat BS yang "normal" tidak cukup untuk menggantikan bagian yang dapat dibuka-tutup.

Parameter bernama

{{BS| (BHF)|PX=40px|bg=#ccccff|O1= (CSTR)|O12= (uSTRq)
|tw=500px|L1=Train station}}

Templat BSn-2

{{BS-2}}
bs1-2

{{BS2-2}}
bs2-2

{{BS3-2}}
bs3-2

…

{{BS8-2}}
bs8-2

BSn-2 row templates

Teks kiri

Ikon

Teks kanan

ke kota A

Layanan kereta bandara

BandaraTerminal penumpang utara

Halte bus

Jalur utama

Terminal baratBandara

BandaraTerminal selatan

Templat BSn-2 menempatkan teksnya di kedua sisi kolom ikon, tanpa kolom Jarak/Waktu, berbeda dengan templat BSn yang hanya menampilkan teks di kanan kolom ikon. Semua parameter bernama pada templat BSn tetap dipergunakan pada templat ini. Templat ini sebaiknya tidak digabungkan dengan templat BSn yang "hanya memiliki teks kanan" pada diagram yang sama.

Parameter tak bernama pada templat ini terdiri atas:

{{BS-2| Nama ikon | Teks kiri | Teks kanan | Catatan kiri | Catatan kanan 1 | Catatan kanan 2 }}

1 2 3 4 5 6

{{BSn-2| Nama ikon 1 | … | Nama ikon n | Teks kiri | Teks kanan | Catatan kiri | Catatan kanan 1 | Catatan kanan 2 }}

1 n n + 1 n + 2 n + 3 n + 4 n + 5

Menyusun templat BS

Contoh 1

{{BS2| (STR)| (BHF)|}}

{{BS2| (BHF)| (STR)|}}

Contoh 2

{{BS| (KBHFa)|}}

{{BS3| (BHF)| (BHF)| (BHF)|}}

Contoh 3

{{BS4| (BHF)| (BHF)| (BHF)| (BHF)|}}

{{BS2| (KBHFe)| (KBHFe)|}}

Contoh 4

{{BS| (BHF)|}}

{{BS2| (BS2+l)| (BS2c4)|O2= (KBHFa)|}}

{{BS2| (BS2l)| (BS2r)|}}

{{BS| (STR)|}}

Kecuali {{BS}} dan {{BS-2}}, semua templat BSn akan menggabungkan ikon pada baris yang sama, kecuali jika dipisahkan oleh entri kosong. Untuk menggabungkan ikon secara vertikal, buka lagi templat BS baru yang sama dan lanjutkan. (Contoh 1)

Penulis dapat juga menggabungkan dengan templat BSn yang berbeda, karena kolom ikon selalu rata tengah. Umumnya dilakukan dengan menggabungkan ikon berjumlah ganjil dengan ganjil, atau genap dengan genap, dalam hal mengosongkan kolom kosong untuk menyusun ruang grid kolom. Pada contoh 2 dan 3, ikon pada {{BS}} selalu menggabung dengan ikon kedua pada {{BS3}} secara vertikal; sedangkan ikon ke-2 dan ke-3 pada {{BS4}} menggabung berturut-turut dengan ikon pertama dan ke-2 pada {{BS2}}.

Ketika menggabungkan templat ganjil dengan genap (contoh 4), ikon khusus seperti (BS2l) dan (BS2c3) (sudut tambahan) diperlukan untuk membuat percabangan yang sempurna.

Aturan yang sama berlaku juga untuk templat BSn-2, yang kolom ikonnya juga selalu rata tengah. Akan tetapi, mencampurkan BSn dan BSn-2 harus dihindari karena dapat merusak keseluruhan diagram rute.

Catatan untuk pengembang

Ikon milik sendiri

Dalam banyak kasus, ketersediaan ikon di Wikimedia Commons haruslah cukup. Akan tetapi, jika Anda menginginkan membuat ikon karya Anda sendiri, ikuti poin-poin berikut.

Periksa atau Commons:category:BSicon dan subkategorinya untuk memeriksa apakah ikon tersebut sudah tersedia atau belum
Pikirkan jika ikon yang Anda butuhkan dapat ditampilkan dengan menumpangkan dua hingga enam ikon yang ada.
Selalu gunakan format SVG. Dapat dibuat dengan CorelDRAW, Inkscape, Adobe Illustrator atau editor teks HTML atau XML.
- Ukuran gambar tidak dibatasi, namun harus berada pada bidang persegi, biasanya 500×500 piksel (ikon setengah lebar seukuran 250×500px; ikon lebar rangkap dua 1000×500px). Pikirkan bagaimana ikon tersebut muncul apabila diperkecil pada diagram menjadi 20 piksel (asali).
- Berkas SVG tidak boleh berisi gambar bitmap dan seluruh gambarnya dibuat menggunakan peralatan gambar vektor.
- Jangan mempergunakan materi berhak cipta termasuk logo sesuai kebijakan Wikipedia:Penggunaan media nonbebas. Anda dapat memeriksa status hak cipta pada halaman deskripsinya. Anda dapat meminta komentar jika logo tersebut dapat dimasukkan sebagai materi bebas hak cipta dan semata-mata tersusun atas huruf saja dan/atau geometri sederhana, dan memberikan kepada Anda izin mempergunakan logo pada peta.
Selalu ikuti warna dan aturan penamaan ikon pada katalog piktogram.
- Nama berkas harus mengikuti format: "BSicon_prefixROOTsuffix.svg" yang berarti,
- ROOT sebagai nama objek/bentuk,
- prefix sebagai warna, gaya, kegunaan, dan
- suffix sebagai pengubah bentuk.
- pengalihan harus dibuat kepada berkas yang berisi tanda diakritik dari nama tanpa tanda diakritik di Commons. Contoh: Berkas:BSicon BRUECKE.svg beralih ke file:BSicon BRÜCKE.svg.
Pratayang SVG Anda dengan SVG Check.^{pranala rusak} SVG Anda mungkin tidak tertampil sama antara di Wikimedia dan program aplikasi SVG Anda atau penjelajah, terkait dengan daftar font yang berbeda atau mesin perender SVG.
Unggah berkas ke Wikimedia Commons, tambah lisensi hak cipta (umumnya {{PD-shape}}) dan kategori Icons for railway descriptions atau salah satu subkategorinya. Semakin spesifik kategorinya lebih baik. Jika Anda ragu-ragu, silakan masukkan kategori umum BSicon dan tunggu hingga editor di Commons menggantinya.
Jika Anda tidak mampu atau memiliki masalah dengan pembuatan ikon, silakan ajukan pertanyaan ke Commons:Talk:BSicon/New icons and icon requests.

Lihat pula

Wikipedia:Templat peta rute/Tata letak stasiun untuk mencari tahu seluk-beluk tata letak stasiun.

Artikel bertopik Wikipedia ini adalah sebuah rintisan. Anda dapat membantu Wikipedia dengan mengembangkannya.