확장기능:Poem

이 확장 기능은 미디어위키 1.21 이상에서 포함됩니다. 따라서 다시 다운로드하지 않아도 됩니다. 하지만 여전히 제공되는 별개의 지침을 따라야 합니다.

미디어위키 확장 기능 설명서

Poem 출시 상태: 안정
구현	태그
설명	시 서식에 쓸 수 있는 ‎<poem> 추가
만든 이	Nikola Smolenski토론
최신 버전	지속적인 업데이트
MediaWiki	1.25+
데이터베이스 변경	아니오
라이선스	Creative Commons Zero v1.0 Universal
다운로드	확장 기능 다운로드 Git [?]: Git master 다운로드 저장소 보기 (Phabricator · GitHub) 커밋 기록 repository contributors (GitHub) 코드 리뷰
태그 ‎<poem>
사용된 훅 ParserFirstCallInit
Quarterly downloads	57 (Ranked 86th)
Public wikis using	10,039 (Ranked 12th)
Poem 확장 기능 번역 (translatewiki.net에서 가능한 경우)
이슈	미해결 작업 · 버그 보고

The Poem extension allows easy formatting of poems and similar material within Wikitext . Once the extension is enabled, you can put any block of text within ‎<poem>‎</poem> tags, which has the following effects:

• All newlines are preserved by converting them into ‎<br /> tags

• The block of text is enclosed in ‎<p>...‎</p> tags (as well as a div of class "poem")

• Colons at the beginning of a line are converted into 1 em indentation

• Spaces at the beginning of a line are preserved and no longer invoke the ‎<pre> tag

The extension preserves wikilinks, bolding, etc. if they are present in the poem.

Usage

Example

Input text

Output

<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.

Example with indentation

Input text

Output

<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 ;

Style

The poem text is wrapped in a div, which has no style by default; but inherits any style or class option passed to the poem.

For example, while indented text can be used for simple examples to prevent filling and draw a nice blue box, it can be hard to read in some cases, since long lines aren't broken. A similar, but somewhat better effect can be obtained with:

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

When applied to the above example, the result is as follows:

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" option

Applying the ‎<poem> tag with the compact option to a text of more than two lines, every line becomes a separate paragraph. (That is to say, it allows for more compact markup, not for a more compact output.)

Subsequent use of the ‎<poem> tag with the compact option, with up to two newlines in between, gives just a single newline between texts, not a new paragraph.

Thus, applied to texts of more than two lines each, every line becomes a separate paragraph, except that the last line of each text and the first line of the next text are combined into one paragraph.

Input	Output	Input	Output
<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!

Input	Output	Input	Output
<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.

Problems and solutions

• Variables and ParserFunctions do work inside the ‎<poem>...‎</poem> container, but NOT within the <poem ... > tag itself; this prevents templates with code such as <poem style="{{{1}}}">.
• One workaround is to use <div style="{{{1}}}"><poem> ... </poem></div> instead.
• Another way is to use the #tag magic word: {{#tag:poem| ... |style="{{{1}}}"}}.
  • NB: this would however seem not to work with the "compact" option.

Input (inside OK, within not OK)	Output
<poem style="{{{1|border: 1px solid Black;}}}"> One, {{{2|Two.}}} </poem>	One, Two.
Input (both inside and within OK)	Output
<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.

Installation

• 파일을 다운로드하고 Poem 폴더를 extensions/ 디렉토리에 넣어 주세요.
  개발자와 코딩 기여자는 Git을 이용해 확장기능을 다운받는 것이 좋습니다.cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Poem
• 아래의 코드를 LocalSettings.php 코드의 마지막에 추가합니다.

  wfLoadExtension( 'Poem' );
  

•  완료 – 위키의 ‘Special:Version’에 이동해서, 확장기능이 올바르게 설치된 것을 확인합니다.

Vagrant 설치:

• Vagrant 를 사용하고 있는 경우에는, vagrant roles enable poem --provision로 설치해주세요