Extension:CharInsert

From mediawiki.org
Jump to navigation Jump to search
This page is a translated version of the page Extension:CharInsert and the translation is 100% complete.
MediaWiki manüel uzantıları
OOjs UI icon advanced-invert.svg
CharInsert
Sürüm durumu: kararlı
Uygulama Etiket , Sayfa işlemi , Vikim
Açıklama JavaScript karakter ekleme kutuları oluşturmaya izin verir.
Yazar(lar) Brion Vibber (Brion VIBBERmesaj)
En son sürüm continuous updates
Uyumluluk politikası MediaWiki ile birlikte anlık görüntüler yayımlanır. Master geriye dönük olarak uyumlu değil.
MediaWiki 1.25+
PHP 5.4+
Lisans GNU Genel Kamu Lisansı 2.0 veya üstü
İndir
‎<charinsert>
Translatewiki.net adresinde mevcutsa, CharInsert uzantısını çevirin

Kullanım ve sürüm matrisini kontrol edin.

Sorunlar Açık görevler · Hata bildir

CharInsert uzantısı, tıklandığında önceden tanımlanmış metni metin kutusu içine ekleyen JavaScript bağlantıları oluşturmaya izin verir.

Bu bağlantılar genellikle MediaWiki:Edittools (bu vikideki örnek) sistem mesajında ​​kullanılır.

Sözdizimi

Karakterleri boşlukla ayrılmış bir liste veya eklenmesine izin vermek istediğiniz etiketleri içeren ‎<charinsert> etiketleri kullanın.

Aşağıdakileri yapmak için bir yer tanımlamak için bir etiketin içinde + işaretini kullanabilirsiniz:

  • seçili metni ekle veya
  • metin seçilmemişse imleci yerleştirin.

Şablonları ve boşlukları ‎<nowiki> içine almanız gerekir:

<charinsert><nowiki>== + ==</nowiki> <nowiki>{{stub}}</nowiki></charinsert>

Kullanım ve örnek çıkışı

Bireysel karakterler

Bireysel karakterler yalnızca "charinsert" etiketleri arasında listelenir.

<charinsert>Á á Ć ć É é Í í Ĺ ĺ Ń ń Ó ó Ŕ ŕ Ś ś Ú ú Ý ý Ź ź</charinsert>

şunu sonuçlanır

Á á Ć ć É é Í í Ĺ ĺ Ń ń Ó ó Ŕ ŕ Ś ś Ú ú Ý ý Ź ź

Bağlantılara tıklamak, giriş veya düzenleme alanı olmadığından hiçbir etkisi olmayacaktır.

Birleşik karakterler

Birleşik karakterler "charinsert" etiketleri arasında listelenir ve "+" işaretiyle bağlanır.

<charinsert>“+” ‘+’ «+» ‹+› „+“ ‚+‘ [[+]] {{+}}</charinsert>

şunu sonuçlanır

“” ‘’ «» ‹› „“ ‚‘ [[]] {{}}

Giriş veya düzenleme alanı olmadığı için bağlantılara tıklamanın bir etkisi olmayacaktır.

Notlar

  • Oluşturulan JavaScript bağlantıları, düzenleme penceresinin etrafındaki diğer alanlarda da çalışır, ör. MediaWiki:Copyrightwarning veya MediaWiki:Newarticletext olarak, önceden Inputbox ile yüklenmiş sayfada ve hatta metin önizlemesinden.
  • Ayrıca MediaWiki:Uploadtext içinde resim açıklama şablonları eklemek için de kullanılabilirler.
  • Üstteki araç çubuğu düğmelerinin aksine, bu uzantı, eklenen "örnek metni" belirtmenin bir yolunu sağlamaz.
  • Yeni satırlar eklemek için &#10; kullanın (\n).
  • Gerektiğinde ‎<nowiki>...‎</nowiki> etiketlerinde beyaz boşluklar ekleyin.
  • ‎<charinsert>...‎</charinsert> etiketlerini MediaWiki:Edittools içine ekleyin.

Kurulum

T88922 hatası nedeniyle CharInsert tarafından sağlanan araç çubuğu, MediaWiki 1.27.x üzerinde kullanıldığında "Yükle" özel sayfasında çalışmıyor. MediaWiki 1.28+ için sağlanan sürümü kullanın, ancak bazı Küçük Araçlar daha fazla güncelleme olmadan beklendiği gibi çalışmayabileceğini unutmayın.
  • Dosyaları indirin ve extensions/ klasörünüzdeki CharInsert adlı dizine yerleştirin.
  • LocalSettings.php dosyanızın altına aşağıdaki kodu ekleyin:
    wfLoadExtension( 'CharInsert' );
    
  • Küçük aracını Edittools kullanıyorsanız, kodunu en son sürüm olarak güncelleyin (≥ 27 Mayıs 2016)
  • Yes Yapıldı – Uzantının başarıyla yüklendiğini doğrulamak için vikinizde Special:Version seçeneğine gidin.

MediaWiki 1.24 veya önceki bir sürümü çalıştıran kullanıcılara:

Yukarıdaki talimatlar, bu eklentiyi wfLoadExtension() kullanarak kurmanın yeni yolunu açıklar. Bu uzantıyı önceki sürümlerine (MediaWiki 1.24 ve önceki sürümler) yüklemeniz gerekirse, wfLoadExtension( 'CharInsert' ); yerine kullanmanız gerekir:

require_once "$IP/extensions/CharInsert/CharInsert.php";

Gelişmiş Kurulum

Önemli: Bunun çalışması için Extension:Gadgets sahip olmalısınız.

Stil

Charinsert-sample-edittools-box.png

Karakter ekleme listelerine ek stil vermek için, Edittools'unuzun içeriğini <div class="mw-charinsert-buttons"> ile ‎</div> arasında sarın ve onlar için stili MediaWiki:Common.css sayfanızda ekleyin.. Bu site (www.mediawiki.org), bağlantıların düğmeler gibi görünmesini sağlamak için bunu yapar (yandaki ekran görüntüsünde gösterildiği gibi). Aşağıdaki stil sayfası bunun için kullanıldı, aynı stili uygulamak için MediaWiki:Common.css sayfanıza kopyalayın.

 
/**
 * Styling for links generated by [[MediaWiki:Edittools]]
 * @source https://www.mediawiki.org/wiki/Extension:CharInsert#Styling
 * @updated 2020-03-17
 */
.mw-charinsert-buttons {
	border: 1px solid #aaa;
	margin-top: 10px;
	padding: 1px;
	font-size: 1.1em;
	text-align: center;
}

.mw-charinsert-buttons a {
	background-color: #cde !important;
	color: #000;
	border: thin #069 outset;
	padding: 0 1px 1px;
	font-weight: bold;
	font-size: 0.9em;
	text-decoration: none;
}

.mw-charinsert-buttons a:hover,
.mw-charinsert-buttons a:active {
	background-color: #bcd;
	border-style: inset;
}

.client-js .mw-edittools-section {
	display: inline;
}

.client-js .mw-edittools-section input[type="button"] {
	font-size: 0.9em;
	margin-left: 1px;
	padding-left: 1px;
	padding-right: 1px;
}

Alternatif olarak, Wikimedia Design Style Guide ve WikimediaUI temasına daha yakın bir stil seçebilirsiniz:

 
/**
 * Styling for links generated by [[MediaWiki:Edittools]] in WikimediaUI inspired theme.
 * @source https://www.mediawiki.org/wiki/Extension:CharInsert#Styling
 * @updated 2020-03-17
 */
.mw-charinsert-buttons {
	margin-top: 8px;
	border: 1px solid #c8ccd1;
	padding: 2px 4px 4px;
	font-size: 1.1em;
	text-align: center;
}

.mw-charinsert-buttons a {
	background-color: #f8f9fa !important;
	color: #202122;
	border: thin #36c outset;
	padding: 0 1px 2px;
	font-size: 0.9em;
	font-weight: bold;
	text-decoration: none;
}

.mw-charinsert-buttons a:hover {
	background-color: #fff;
    color: #404244;
}

.mw-charinsert-buttons a:active {
	background-color: #c8ccd1;
	border-style: inset;
}

.client-js .mw-edittools-section {
	display: inline;
}

.client-js .mw-edittools-section input[type="button"] {
	background-color: #f8f9fa;
	color: #202122;
	margin-left: 1px;
    border-radius: 2px;
	padding: 1px 6px;
	font-size: 0.9em;
    /* Apply pointer cursor to all interactive elements. */
    cursor: pointer;
}

.client-js .mw-edittools-section input[type="button"]:hover {
	background-color: #fff;
    color: #404244;
}

.client-js .mw-edittools-section input[type="button"]:active {
	background-color: #c8ccd1;
    color: #000;
}

Betikleme

Çok sayıda CharInsert bağlantınız varsa, bunları ayrı gruplara koymak ve bir açılır menü ile dinamik geçişe izin vermek için JavaScript kullanılabilir. Örneğin, aksanlı karakterleri viki sözdiziminden vb. ayırmak için. Birkaç site (mediawiki.org, de.wikipedia.org ve en.wikipedia.org gibi) bunu yapmıştır. Gerçi hepsi bunu farklı şekillerde uyguladılar. Aşağıda, mediawiki.org'da nasıl yapıldığı belgelenmiştir:

1. MediaWiki:Edittools üzerindeki tüm charinsert etiketlerini ‎<div> konteynere sarın ve ona açıklayıcı, benzersiz bir kimlik verin (örneğin "mw-edittools-charinsert"):

<div id="mw-edittools-charinsert" class="mw-charinsert-buttons" title="Click on the wanted special character.">
...
</div>
2. Her bir karakter bloğu bloğunu aşağıdaki gibi ‎<p> etiketlerine sarın:
<p class="mw-edittools-section" data-section-title="Wiki-Syntax" style="display: none;">
...
</p>
Note:
  • 'mw-edittools-section' kelimesini değiştirmeyin
  • "data-section-title=" arkasındaki metin, açılır menüde bu grubu tanımlayacaktır.
  • 'style="display: none;"' yönergesine sahip olmayan bir grup olduğundan emin olun: Bu, açılır menüdeki varsayılan seçim olacaktır. Bu sitede 'Standart' olarak adlandırılırken, diğer gruplar karakterlerin önemli olduğu dile göre adlandırılır.
3. MediaWiki:Gadget-Edittools.js içeriğini kendi vikinizde eşit olarak adlandırılan bir sayfaya kopyalayın
4. MediaWiki:Gadgets-definition dosyanıza aşağıdaki kodu ekleyin:
* Edittools[ResourceLoader|default]|Edittools.js

İngilizce Vikipedi CharInsert menüsü

İngilizce Vikipedi'de kullanılan gibi CharInsert menüsünü uygulamak için, küçük araçları Charinsert-core, Charinsert-styles ve Charinsert olarak dışa aktarın ve ardından bunları Special:Import üzerinden kendi vikinize aktarın veya elle yapmak istiyorsanız aşağıdaki dördü vikinize arayüz sayfalarını kopyalayın:

* charinsert[ResourceLoader|default|peers=charinsert-styles]|charinsert.js
* charinsert-core[ResourceLoader|hidden|dependencies=jquery.textSelection,user,mediawiki.storage]|charinsert-core.js
* charinsert-styles[ResourceLoader|hidden|type=styles]|charinsert-styles.css
  • MediaWiki:Edittools (Wikipedia) - Yalnızca JavaScript'i kapalı veya desteklenmeyen kullanıcılar için (ki bu WikiEditor uzantısını da devre dışı bırakır), bu nedenle gerçekten gerekli veya yararlı da değildir. Sembolleri/karakterleri editör penceresinin altında sadece basit metin olarak gösterir, daha sonra kopyala yapıştır yapılabilir ve böylece editörlere bir miktar yardımcı olabilir. Görünüşe göre, devre dışı bırakılmış JavaScript için İngilizce Vikipedi'de etkinleştirilmiyor.

Note: Bu özel İngilizce Vikipedi karakter seti, vikinizde kullanılacaklarsa ayrı olarak tanımlanması gereken şablonlar da içerir.

İngilizce Vikipedi Çözümü kontrol edildi: 6 Kasım 2018