Ekstensi:CSS

Manual pengaya MediaWiki

CSS Status keluaran: stabil
Penerapan	Fungsi pengurai
Deskripsi	Menyediakan sebuah fungsi parser untuk menambahkan berkas CSS, artikel CSS, atau aturan baris CSS ke dalam artikel
Perancang	Aran Dunkley Rusty Burchfield
Versi terbaru	3.5.0
MediaWiki	>= 1.43.0
Parameter $wgCSSIdentifier
Pengait yang digunakan ParserFirstCallInit RawPageViewBeforeOutput
Lisensi	Lisensi Publik Umum GNU 2.0 atau lebih baru
Unduh	Unduh pengaya Git [?]: Telusuri repositori (GitHub) Tinjauan kode Gerrit log commit Git Unduh bola tar sumber
Contoh	organicdesign.nz
Terjemahkan pengaya CSS jika tersedia di translatewiki.net
Masalah	Tugas terbuka · Laporkan kekutu

Ekstensi CSS memungkinkan stylesheet CSS agar dimasukkan ke dalam artikel tertentu. CSS yang akan dimasukkan bisa artikel lain, sebuah berkas, atau bisa aturan yang ditentukan langsung di dalam fungsi parser.

Pemakaian

Misalnya, jika Anda memiliki artikel CSS berjudul "StyleSheetsaya.css" yang sudah berisi gaya, Anda akan menambahkan sintaks fungsi parser berikut ke dalam artikel "HalamanCantiksaya" yang akan Anda beri gaya,

{{#css:MyStyles.css}}

Jika kasusnya "StyleSheetsaya.css" adalah sebuah berkas di direktori /wiki/kulit, maka cara menambahkannya seperti berikut. Catat: berkasnya harus benar-benar berupa path yang diawali slash untuk menunjukkan dia bukan judul artikel.

{{#css:/skins/MyStyles.css}}

Alternatifnya, aturan CSS bisa langsung ditambahkan dalam fungsi parser (dalam baris) seperti contoh berikut,

{{#css:
  body {
    background: yellow;
    color: red;
    font-size: 1.25rem;
  }
}}

Pemasangan

• Unduh dan pindahkan folder CSS yang diekstrak ke direktori extensions/ Anda.
  Pengembang dan penyumbangsih kode sebaiknya memasang pengaya dari Git sebagai gantinya, menggunakan:

  cd extensions/
  git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/CSS
  

• Hanya ketika memasang dari Git, jalankan Composer untuk memasang ketergantungan PHP, dengan mengeluarkan perintah composer install --no-dev di direktori pengaya. (Lihat T173141 untuk komplikasi yang mungkin terjadi.)
• Tambahkan kode berikut di bawah berkas LocalSettings.php Anda:

  wfLoadExtension( 'CSS' );
  

• Atur konfigurasi seperlunya.
• Selesai – Telusuri ke Special:Version di wiki Anda untuk memastikan pengayanya berhasil dipasang.

Atau Anda bisa memilih mengatur URL basis untuk berkas eksternal.

Selain itu, Anda juga bisa menetapkan URL dasar untuk berkas eksternal.

$wgCSSPath = false;  # Default, relatif ke $wgScriptPath
$wgCSSPath = '';  # Relatif ke akar server Anda
$wgCSSPath = 'https://example.org/stylesheets';  # Relatif ke situs yang berbeda

Kiat

Mengubah warna atau latar belakang halaman tertentu

Memanfaatkan fungsi parser untuk menggunakan CSS dari halaman lain tidak akan bekerja untuk mengubah warna atau latar belakang halaman, tetapi fungsi parser itu sendiri memungkinkan mengubah latar belakang halaman. Untuk menangani masalah ini, CSS dapat diunggah melalui transklusi, yang tidak mungkin gagal dalam mengubah latar belakang halaman. Untuk mengatasi masalah ini, CSS bisa dimuat melalui transklusi, yang tidak menyebabkan masalah gagal memuat perubahan ke latar belakang halaman.

Lihat pula

• Extension:NewPageCSS
• Ekstensi:TemplateStyles - ekstensi serupa yang membersihkan CSS dan menyimpannya di halaman terpisah.