Extension:BootstrapComponents

From mediawiki.org
This page is a translated version of the page Extension:BootstrapComponents and the translation is 20% complete.
Outdated translations are marked like this.
MediaWiki manüel uzantıları
BootstrapComponents
Sürüm durumu: kararlı
Uygulama Ayrıştırıcı uzantısı
Açıklama Editörlere Twitter Bootstrap 4 tarafından sunulan belirli bileşenlere kolay erişim sağlamayı amaçlamaktadır
Yazar(lar) Tobias Oetterer (Oetterermesaj)
En son sürüm 5.1.1 (2023-09-07)
MediaWiki 1.35+
PHP 7.4+
Veritabanı değişiklikleri Hayır
Composer mediawiki/bootstrap-components
Lisans GNU Genel Kamu Lisansı 3.0 veya üstü
İndir
README
RELEASE-NOTES
Örnek

  • $wgBootstrapComponentsDisableSourceLinkOnImageModal
  • $wgBootstrapComponentsEnableCarouselGalleryMode
  • $wgBootstrapComponentsModalReplaceImageTag
  • $wgBootstrapComponentsWhitelist

BootstrapComponents uzantısı, editörlere Twitter Bootstrap 4 tarafından sunulan belirli bileşenlere kolay erişim sağlar.

Kurulum

Bu uzantıyı kurmanın iki yolu vardır: yükleme, etkinleştirme ve bağımlılık yönetimi için Composer'ı kullanabilir veya tüm bunları manüel olarak yapabilirsiniz.

Bu uzantı, 4.0 veya sonraki sürümlerde Bootstrap uzantısının yüklenmesini gerektirir. BootstrapComponents yüklemek için Composer'ı kullanmak bununla ilgilenecektir.

Composer

Bu en kolay ve önerilen yaklaşımdır.

Aşağıdaki komutu çalıştırmanız yeterlidir:

COMPOSER=composer.local.json composer require mediawiki/bootstrap-components "^5.0"

Aşağıdakileri composer.local.json ile ekleyecektir:

{
	"require": {
		"mediawiki/bootstrap-components": "^5.0"
	}
}

Manüel

You need to download and activate the extension yourself. Also, you need to take care of dependencies.

  • First, you should take care of dependencies. That means installing the Bootstrap extension. See there for details on how to do this.
  • Then you need to download this extension, by cloning its repository using git. Venture into your extensions directory and run:
git clone https://github.com/oetterer/BootstrapComponents

You can also download the archive and extract it yourself.

Activation

Since release 4.0, you have to enable the extension in your configuration manually.

Previously, this would automatically be done by Composer. Please add the following line to your LocalSettings.php:

wfLoadExtension( 'Bootstrap' );
wfLoadExtension( 'BootstrapComponents' );

Yapılandırma

You can change some of the behaviour of this extension with the following four settings inside your wiki's configuration.

Just add the corresponding line to your "LocalSettings.php" file.

$wgBootstrapComponentsWhitelist

Default setting is true.

This allows you to enable all, some, or none of the components inside your wiki code.

If you want all components available, set this to true:

$wgBootstrapComponentsWhitelist = true;

If you want only a selection of components, set this to an array containing the whitelisted components. For a list of all components, please refer to the documentation.

$wgBootstrapComponentsWhitelist = [ 'card', 'tooltip', 'modal' ];

When using modals[1], you might want to disable popovers[2].

See known issues for more.

To disable all components simply set this to false.

$wgBootstrapComponentsModalReplaceImageTag

Default setting is false.

You can have this extension change the normal image handling in your wiki. If you set this to true, all image tags not containing a link= parameter will be converted into a modal. So when you click on the image, instead of being referred to the corresponding page in the file namespace, a modal opens up showing the image with a possible caption (if you provided one) and a link to the source page of the file.

Example:

$wgBootstrapComponentsModalReplaceImageTag = true;

Most regular options that can be used with images are recognized and processed accordingly. Please see the help page for images.

Even after enabling this option you can suppress image modals on a given page by adding the magic word __NOIMAGEMODAL__ somewhere on the page. If you want to suppress modal conversion for an individual image, give it the css class no-modal.

Example:

[[File:NormalImage.png|class=no-modal|alt=normal|This image is displayed normally]]

Please see known issues for additional information.

$wgBootstrapComponentsDisableSourceLinkOnImageModal

Default setting is false.

When using image modals (thus having $wgBootstrapComponentsModalReplaceImageTag set to true) enabling this suppresses the source link in the footer section of the modal.

$wgBootstrapComponentsEnableCarouselGalleryMode

Default setting is true.

This adds the mode carousel to the ‎<gallery>-tag which, when used turns your gallery into a carousel. For Information on how to use galleries, please see the gallery documentation.

Örnekler

Ayrıca bakınız

Notes

  1. modal matches an element that is in a state in which it excludes all interaction with elements outside it until the interaction has been dismissed
  2. popover elements will appear above all other elements