Extension:Poem

From mediawiki.org
This page is a translated version of the page Extension:Poem and the translation is 100% complete.
Bu uzantı MediaWiki 1.21 ve üstü ile gelir. Böylece tekrar indirmek zorunda değilsiniz. Ancak, verilen diğer talimatları izlemeniz gerekir.
MediaWiki manüel uzantıları
Poem
Sürüm durumu: kararlı
Uygulama Etiket
Açıklama Şiir biçimlendirme için ‎<poem> etiket ekler
Yazar(lar) Nikola Smolenskimesaj
En son sürüm güncellemeler devam etmekte
MediaWiki 1.25+
Veritabanı değişiklikleri Hayır
Lisans Creative Commons Zero v1.0 Universal
İndir
‎<poem>
Quarterly downloads 62 (Ranked 91st)
Public wikis using 10,039 (Ranked 12th)
Translatewiki.net adresinde mevcutsa, Poem uzantısını çevirin
Sorunlar Açık görevler · Hata bildir

Poem uzantısı, şiirlerin ve benzer materyallerin Vikimetin içerisinde kolayca biçimlendirilmesini sağlar. Uzantı etkinleştirildiğinde, aşağıdaki efektlere sahip olan herhangi bir metin bloğunu ‎<poem>‎</poem> etiketi içine koyabilirsiniz:

  • Tüm yeni satırlar, onları ‎<br /> etiketine dönüştürerek korunur
  • Metin bloğu ‎<p>...‎</p> etiketine ("poem" sınıfının bir div'sine eklenmiştir) eklenmiştir
  • Satırın başındaki sütunlar, 1 girintiye dönüştürülür.
  • Satırın başındaki boşluklar korunur ve artık ‎<pre> etiketini çağırmaz

Uzantı, şiirde mevcutsa, vikilinkleri, kalın harfleri vb. korur.

Kullanım

Örnek

Giriş metni Çıkış
<poem>
In [[Wikipedia:Xanadu|Xanadu]] did Kubla Khan
A stately pleasure-dome decree:
Where Alph, the sacred river, ran
Through caverns measureless to man
Down to a sunless sea.

So twice five miles of fertile ground
With walls and towers were girdled round:
And there were gardens bright with sinuous rills,
Where blossomed many an incense-bearing tree;
And here were forests ancient as the hills,
Enfolding sunny spots of greenery.
</poem>

In Xanadu did Kubla Khan
A stately pleasure-dome decree:
Where Alph, the sacred river, ran
Through caverns measureless to man
Down to a sunless sea.

So twice five miles of fertile ground
With walls and towers were girdled round:
And there were gardens bright with sinuous rills,
Where blossomed many an incense-bearing tree;
And here were forests ancient as the hills,
Enfolding sunny spots of greenery.

Girintili örnek

Giriş metin Çıkış
<poem>
Une terre au flanc maigre, âpre, avare, inclément
Où les vivants pensifs travaillent tristement, 
::Et qui donne à regret à cette race humaine
Un peu de pain pour tant de labeur et de peine ; 
::Des hommes durs, éclos sur ces sillons ingrats ; 
Des cités d’où s’en vont, en se tordant les bras, 
::La charité, la paix, la foi, sœurs vénérables ; 
L’orgueil chez les puissants et chez les misérables ; 
</poem>

Une terre au flanc maigre, âpre, avare, inclément
Où les vivants pensifs travaillent tristement,
Et qui donne à regret à cette race humaine
Un peu de pain pour tant de labeur et de peine ;
Des hommes durs, éclos sur ces sillons ingrats ;
Des cités d’où s’en vont, en se tordant les bras,
La charité, la paix, la foi, sœurs vénérables ;
L’orgueil chez les puissants et chez les misérables ;

Stil

Şiir metni, varsayılan olarak stili olmayan bir div içine sarılır; ancak şiire aktarılan herhangi bir style veya class seçeneğini miras alır.

Örneğin, girintili metin basit örnekler için doldurmayı önlemek ve güzel bir mavi kutu çizmek için kullanılabilirken, bazı durumlarda uzun satırlar kesik olmadığından okumak zor olabilir. Benzer, ancak biraz daha iyi bir etki şunlarla elde edilebilir:

<poem style="border: 2px solid #d6d2c5; background-color: #f9f4e6; padding: 1em;">

Yukarıdaki örneğe uygulandığında, sonuç aşağıdaki gibidir:

In Xanadu did Kubla Khan
A stately pleasure-dome decree:
Where Alph, the sacred river, ran
Through caverns measureless to man
Down to a sunless sea.

So twice five miles of fertile ground
With walls and towers were girdled round:
And there were gardens bright with sinuous rills,
Where blossomed many an incense-bearing tree;
And here were forests ancient as the hills,
Enfolding sunny spots of greenery.

"compact" seçeneği

‎<poem> etiketini compact seçeneği ile iki satırdan fazla olan bir metne uygulamak, her satır ayrı bir paragraf hâline gelir. (Yani, daha kompakt bir çıkış için değil, daha kompakt işaretlemeye izin verir.)

‎<poem> etiketinin compact seçeneğiyle, aralarında en fazla iki satırsonu olacak şekilde sonraki kullanımı, metinler arasında yeni bir paragraf değil, yalnızca tek bir satırsonu verir.

Böylece, her biri iki satırdan fazla olan metinlere uygulandığında, her metnin son satırı ile bir sonraki metnin ilk satırının bir paragrafta birleştirilmesi dışında her satır ayrı bir paragraf hâline gelir.

Giriş Çıkış Giriş Çıkış
<poem>
One,
Two.
</poem>
<poem>
Three?
Four!
</poem>

One,
Two.

Three?
Four!

<poem compact>
One,
Two.
</poem>
<poem compact>
Three?
Four!
</poem>
One,
Two.
Three?
Four!
Giriş Çıkış Giriş Çıkış
<poem>
One,
Two.
Extra.
</poem>
<poem>
Three?
Four!
Extra.
</poem>

One,
Two.
Extra.

Three?
Four!
Extra.

<poem compact>
One,
Two.
Extra.
</poem>
<poem compact>
Three?
Four!
Extra.
</poem>
One,

Two.

Extra.
Three?

Four!

Extra.

Sorunlar ve çözümler

  • Variables ve ParserFunctions, ‎<poem>...‎</poem> kapsayıcısının içinde çalışır, ancak <poem ... > etiketinin kendisinde DEĞİLDİR; bu, <poem style="{{{1}}}"> gibi kodlu şablonları önler.
  • Bir geçici çözüm, bunun yerine <div style="{{{1}}}"><poem> ... </poem></div> kullanmaktır.
  • Başka bir yol da #tag sihirli kelimesi: {{#tag:poem| ... |style="{{{1}}}"}} kullanmaktır.
    • Not: Bu, "compact" seçeneğiyle çalışmıyor gibi görünüyor.
Giriş (Tamam içinde, tamam değil içinde) Çıkış
<poem style="{{{1|border: 1px solid Black;}}}">
One,
{{{2|Two.}}}
</poem>

One,
Two.

Giriş (hem içeride hem de Tamam içinde) Çıkış
<div style="{{{1|border: 1px solid Black;}}}">
<poem>
One,
{{{2|Two.}}}
</poem>
</div>

One,
Two.

{{#tag:poem|
One,
{{{2|Two.}}}
|style="{{{1|border: 1px solid Black;}}}"
}}

One,
Two.


Kurulum

  • Dosyaları indirin ve extensions/ klasörünüzdeki Poem 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/Poem
  • LocalSettings.php dosyanızın altına aşağıdaki kodu ekleyin:
    wfLoadExtension( 'Poem' );
    
  • Yes Yapıldı – Uzantının başarıyla yüklendiğini doğrulamak için vikinizde Special:Version seçeneğine gidin.


Vagrant kurulumu:

  • Vagrant kullanıyorsanız, vagrant roles enable poem --provision ile yükleyin