Extension:CharInsert

From mediawiki.org
This page is a translated version of the page Extension:CharInsert and the translation is 99% complete.
Outdated translations are marked like this.
MediaWiki manüel uzantıları
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 (Brooke 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.42
Lisans GNU Genel Kamu Lisansı 2.0 veya üstü
İndir
‎<charinsert>
Quarterly downloads 95 (Ranked 62nd)
Public wikis using 9,224 (Ranked 15th)
Translatewiki.net adresinde mevcutsa, CharInsert uzantısını çevirin
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

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

Giriş veya düzenleme alanı olmadığı için bağlantılara tıklamanın 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.

Ekran metnini geçersiz kılma

MediaWiki sürümü:
1.38
Gerrit change 748823

label özniteliğinde farklı bir görüntüleme metni belirtilebilir (bunu kullanırsanız, farklı görüntüleme metinleri belirtmek için her karakter için ayrı <charinsert> etiketleri kullanmalısınız).

<charinsert label="Latin A">A</charinsert> <charinsert label="Kiril А">А</charinsert> <charinsert label="Yunan Alfa">Α</charinsert>

şunu sonuçlanır

Latin A Kiril А Yunan Alfa

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

  • Dosyaları indirin ve extensions/ klasörünüzdeki CharInsert adlı dizine yerleştirin.
    Developers and code contributors should install the extension from Git instead, using:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/CharInsert
  • 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.

Gelişmiş Kurulum

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

Stil

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>
Not Not::
  • '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:

  • MediaWiki:Gadgets-definition dosyanızda, aşağıdaki tanımları ekleyin:
    * 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.

Not Not: 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