Extension:TextExtracts

This page is a translated version of the page Extension:TextExtracts and the translation is 100% complete.
Bu uzantı MediaWiki 1.34 ve üstü ile gelir. Böylece tekrar indirmek zorunda değilsiniz. Ancak, verilen diğer talimatları izlemeniz gerekir.
MediaWiki manüel uzantıları
OOjs UI icon advanced-invert.svg
TextExtracts
Sürüm durumu: kararlı
Uygulama API
Açıklama API'ye düz metin veya sayfa içeriğinin sınırlı HTML alıntıları sağlar
Yazar(lar) Max Semenik (MaxSemmesaj)
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.23+
PHP 5.4+
Veritabanı değişiklikleri Hayır
Lisans GNU Genel Kamu Lisansı 2.0 veya üstü
İndir
  • $wgExtractsExtendOpenSearchXml
  • $wgExtractsRemoveClasses
Translatewiki.net adresinde mevcutsa, TextExtracts uzantısını çevirin

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

Sorunlar Açık görevler · Hata bildir

TextExtracts uzantısı, düz metin veya sınırlı HTML (kaldırılan bazı CSS sınıfları için içerik içeren HTML) sayfa içeriğinin alınmasını sağlayan bir API sağlar.

İndir

Uzantı doğrudan Git'ten alınabilir [?]:

  • Kodu göz at
  • Bazı uzantıların kararlı sürümler için etiketleri vardır.
  • Her dal geçmiş bir MediaWiki sürümüyle ilişkilendirilmiştir. Ayrıca en son alfa sürümünü içeren bir "ana" dalı da vardır (MediaWiki'nin alfa sürümünü gerektirebilir).

Anlık görüntüyü ayıklayın ve MediaWiki kurulumunuzun extensions/TextExtracts/ dizinine yerleştirin.

Git'e aşina iseniz ve sunucunuza kabuk erişiminiz varsa, uzantıyı aşağıdaki gibi elde edebilirsiniz:

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

Kurulum

  • Dosyaları indirin ve extensions/ klasörünüzdeki TextExtracts adlı dizine yerleştirin.
  • LocalSettings.php dosyanızın altına aşağıdaki kodu ekleyin:
    wfLoadExtension( 'TextExtracts' );
    
  •   Yapıldı – Uzantının başarıyla yüklendiğini doğrulamak için vikinizde Special:Version seçeneğine gidin.

MediaWiki 1.26 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.26 ve önceki sürümler) yüklemeniz gerekirse, wfLoadExtension( 'TextExtracts' ); yerine kullanmanız gerekir:

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

Yapılandırma seçenekleri

  • 1, <tag>, <tag>.class, .<class>, #<id> dizisidir ve bu işlem ayıklanmaya dahil edilmeyecektir.
    Örneğin, $wgExtractsRemoveClasses[] = 'dl';, genellikle özetlerde istenmeyen şablonlanmamış hatnotlar için kullanılan girintili metni kaldırır.
    extension.json, "noexcerpt" sınıfının bir olduğu varsayılanları tanımlar. Bu, onu hariç tutmak için herhangi bir şablona eklenebilir.
  • $wgExtractsExtendOpenSearchXml, TextExtracts'ın alıntılarını Opensearch API modülüne sağlayıp sağlamayacağını tanımlar. Varsayılan false şeklindedir.

API



prop=extracts (ex)

(main | query | extracts)

Returns plain-text or limited HTML extracts of the given pages.

Parameters:
exchars

How many characters to return. Actual text returned might be slightly longer.

Type: integer
The value must be between 1 and 1,200.
exsentences

How many sentences to return.

Type: integer
The value must be between 1 and 10.
exlimit

How many extracts to return. (Multiple extracts can only be returned if exintro is set to true.)

Type: integer or max
The value must be between 1 and 20.
Default: 20
exintro

Return only content before the first section.

Type: boolean (details)
explaintext

Return extracts as plain text instead of limited HTML.

Type: boolean (details)
exsectionformat

How to format sections in plaintext mode:

plain
No formatting.
wiki
Wikitext-style formatting (== like this ==).
raw
This module's internal representation (section titles prefixed with <ASCII 1><ASCII 2><section level><ASCII 2><ASCII 1>).
One of the following values: plain, raw, wiki
Default: wiki
excontinue

When more results are available, use this to continue.

Type: integer

Başka bir örnek

Sonuç
{
    "query": {
        "pages": {
            "9228": {
                "pageid": 9228,
                "ns": 0,
                "title": "Earth",
                "extract": "Earth, also called the world and, less frequently, Gaia, (or Terra in some works of science fiction)..."
            }
        }
    }
}

Caveatlar

API'yı kullanırken dikkat edilmesi gereken çeşitli şeyler vardır

  • `exsentences` kullanılmasını önermiyoruz. HTML özleri için çalışmaz ve mevcut olmadığı birçok kenar durumu vardır. Örneğin "Arm. Gen. Ing. John Smith bir askerdi." 4 cümle olarak değerlendirilecektir. Bunu düzeltmeyi planlamıyoruz.
  • Satır içi görüntüler yanıttan çıkarılır (HTML modunda bile). Bu, Matematik uzantısı kullanıyorsanız ve potansiyel istemci bölümünüzde formüller kullanıyorsanız, özet çıkışında görünmeyebilecekleri anlamına gelir.
  • HTML modunda iyi biçimlendirilmiş HTML'yi garanti edemeyiz. Sonuçta ortaya çıkan HTML geçersiz veya bozuk olabilir.
  • Düz metin modunda:
    • alıntılar çıkarılamaz (phab:T197266 sayfasına bakın)
    • bir paragraf HTML etiketi ile bitiyorsa, ör. ref etiketi, yeni satırlar atılabilir (phab:T201946 sayfasına bakın),
    • listelerden sonra yeni satırlar atılabilir phab:T208132

SSS

Bir sayfa önizlemesinden/alıntısından içeriği nasıl kaldırabilirim?

TextExtracts, noexcerpt sınıfıyla işaretlenmiş herhangi bir öğeyi keser. Bu küresel wgExtractsRemoveClasses tarafından sağlanır.

Ayrıca bakınız