UseModWiki소스수정/Footnote매크로

1. Footnote 매크로

1.1. 사용법

1.1.1. ext2.1j - 동일한 내용의 각주가 두 번 이상 나올 때

1.2. 부작용

1.3. wiki.pl 수정

1.4. macros/footnote.pl 추가

1.5. translations/korean.pl 수정

1.6. wiki.css 수정

1.7. 추가 업데이트 내역

1.8. 사용자 의견

1. Footnote 매크로

• 필수 요구 사항: 없음
• 선택 요구 사항: 없음

1.1. 사용법

오른쪽의 각주 번호를 클릭하세요<footnote(여기에 각주가 들어감)>

• 각주 번호를 클릭하면 해당 각주 주석문으로, 주석문 왼쪽의 번호를 클릭하면 원래의 위치로 돌아간다.
• 본문의 각주 번호는 A.footnote 로, 하단의 주석문 내용은 DIV.footnote 로 둘러쌓인다. UseModWiki스타일쉬트에서 적절히 꾸며 준다.

1.1.1. ext2.1j - 동일한 내용의 각주가 두 번 이상 나올 때

홍길동<footnote(아들)>이 어쩌고 저쩌고...
홍판서<footnote(길동 애비)>가 어쩌고 저쩌고...
다시 홍길동<footnote(아들)>이 이러쿵 저러쿵...
임금<footnote(당시 왕이 누구더라만)>이 홍길동<footnote(아들)>에게...

1.2. 부작용

1.3. wiki.pl 수정

1.4. macros/footnote.pl 추가

use strict;

my $MyFootnoteCounter;
my @MyFootnotes;
my %SaveNumFootnote;

sub footnote {
    my ($txt) = @_;

    $MyFootnoteCounter = 0;
    $txt =~ s/(&__LT__;footnote\(([^\n]+?)\)&__GT__;)/&MacroFootnote($2)/gei;

    # 본문 하단에 각주 출력
    if ($MyFootnoteCounter > 0) {
        map { s/_MARK_// } @MyFootnotes;
        $txt .= "<DIV class='footnote'>".
            "\n" . T('Footnote') . ": <br>\n".
            join('', @MyFootnotes). "</DIV>";
    }

    return $txt;
}

sub MacroFootnote {
    my ($note) = @_;

    $MyFootnoteCounter++;
    my $number = "<A name='FN_$MyFootnoteCounter' href='#FNR_$MyFootnoteCounter'>$MyFootnoteCounter</A>.";

    # URL이 있을 경우 동일한 내용이란 걸 파악하기 위해서, Restore를 해 줘야 함
    my $note_restored = &RestoreSavedText($note);   # 내용 비교는 이 변수를 사용

    if (defined $SaveNumFootnote{$note_restored}) {
        # 동일한 내용의 각주가 이미 있다면 그 각주에다가 새 번호 삽입
        $MyFootnotes[$SaveNumFootnote{$note_restored}] =~ s/_MARK_/$number _MARK_/;
    } else {
        # 새로운 내용의 각주 추가
        push @MyFootnotes,
             $number.
            " _MARK_$note".
            "<br>\n";
        $SaveNumFootnote{$note_restored} = $#MyFootnotes;
    }
    return "<A class='footnote' name='FNR_$MyFootnoteCounter' href='#FN_$MyFootnoteCounter'>$MyFootnoteCounter</A>";
}

1;

1.5. translations/korean.pl 수정

Footnote
각주

1.6. wiki.css 수정

DIV.footnote {
    border-top:1px solid silver;
    padding:5px;
}

A.footnote {
    font-size: 80%;
    vertical-align: super;
}

1.7. 추가 업데이트 내역

1.8. 사용자 의견

안녕하세요, 핸드스토리 베타테스터에 합격하신 분과는 삐져서 대화할 수 없습니다. ^^;; 팝업이 되었든 floating object 가 되었든간에 html 소스만 그렇게 출력해주면 되겠죠. 근데 a 태그에 title 속성을 주면 마우스를 갖다대었을 때 뜨지 않을까 싶네요.

-- Raymundo 2004-3-12 10:11 pm

방금, title 속성에 주석의 내용을 넣도록 고쳤다가 낭패를 봤네요. 각주 안에 위키네임이나 페이지링크가 들어갈 경우 그게 a href 로 변한 다음에 footnote 가 적용이 되니까, a 태그 안에 다시 a 태그가 들어가면서 난리가 납니다. 해결책을 찾기 전에는 (제가 직접 찾을 생각은 없습니다 ^^) 어찌할 수 없겠습니다.

-- Raymundo 2004-3-12 10:52 pm

헉~ 자바스크립트로 어떻게 해결안될까요...ㅜㅡ?

-- Bab2 2004-3-12 11:00 pm

제가 자바스크립트에는 완전 문맹이란 것을 익히 아실터이니... 누군가 가르쳐 주기 전까지는 해결 안 되겠군요 :-)

-- Raymundo 2004-3-13 12:12 am

어라, 그러고 보니 그러네요. ^^;

-- Raymundo 2004-3-23 10:20 pm

수정했습니다.

-- Raymundo 2004-3-23 10:44 pm

그러네요. 근데 논문같은데서 각주 4를 보러갔더니 "1장 각주 3을 참고" 이런 식으로 나오는 경우도 있어서 1번이 괜찮을 것 같기도 하고... 동일 내용을 생각하면 두번재 안이 좋을 것 같기도 하고..

-- Nyxity 2007-3-12 9:00 am

아니 이건 웬 뜬금없는 각주입니까? :-)

-- Raymundo 2009-12-22 12:53 am

UseModWiki소스수정/각주매크로 좀 무자비하게 고쳐봤습니다. 어차피 많이 쓰는 것도 아닌데... 라는 생각이 들어서.

-- 조프 2009-12-22 2:22 am

It's needed because of the behavior of Usemodwiki.

At first, this footnote patch treated each footnote independently.

Next, I thought that if more than one footnote have same text, it would be good to show them in one line.

example)
1. a footnote
2. 4. 6. same text for three footnotes
3. another footnote
...

But I found a problem that if the footnote include a URL, usemod stored the URL and replaced it with index numbers. Let's assume the above footnote 2,4,and 6 is "same url http://url", then they are shown as:
2. same url 1
...
4. same url 2
...
6. same url 3

And then, the index numbers are replaced with URL again (that is, restored) before printed. So, my patch fails to show them in one line.

The patch of current version, using "RestoreSavedText", is to resolve the problem. Now this macro tries to restore URL at first, and then compare the content of footnotes to see they are same or not.

I wish you could understand my poor English :-)

-- Raymundo 2012-5-20 3:19 am

It's been long time! How are you? :-)

You are right. I've been aware of that problem for years. :'(

URL processing is performed *before* macro processing. So it seems that it needs much more work than it looks to fix the problem. I don't know how to fix it with simple modification.

-- Raymundo 2013-12-10 9:38 pm

 

sub WikiToHTML { 

... 

+  if ($MyFootNoteCounter > 0) { 

+    map {s/_MARK_//} @MyFootnotes; 

+    $pageText .= '<div class=clear></div><hr class=footnote>'; 

+    $pageText .= '<span class=foot>' . CommonMarkup(join(' ', @MyFootnotes)) . '</span>'; 

+  } 

... 

    while (@HeadingNumbers) { 

... 

} 

 

sub CommonMarkup { 

... 

 +  s/(\[\[\[([^\n]+?)\]\]\])/FootNote($2)/ige; # I have the syntaxis [[[blah blah]]] 

   s/^{{{\r?\n(.*?)\n}}}\r?$/StoreRaw(qq|<pre class="code">\n|) . StoreCodeRaw($1) . StoreRaw("\n<\/pre>")/igesm; 

Umm... Frankly speaking, I don't know. There may be any side effect that we couldn't imagine, or not.

-- Raymundo 2013-12-12 10:43 pm