UseModWiki소스수정/LaTeX플러그인

1. LaTeX 플러그인

1.1. 사용법

1.2. plugin/latex.pl 추가

1.3. wiki.css 추가

1.4. wiki.pl 수정

1.5. 추가 업데이트 내역

1.6. 사용자 의견

1. LaTeX 플러그인

• 선택 요구 사항: LWP::Simple 모듈이 있어야 이미지를 캐시로 가져올 수 있다. 모듈이 없으면 매번 저 사이트에서 변환해서 가져온다.

1.1. 사용법

inline 수식
 $$ 수식 $$

블록 형태 수식:
 \[ 수식 \]
   또는
 {{{#!latex
 수식
 }}}

문장 중간에서는 $$ \sum_{n=1}^\infty a_n = \int_0^1 f $$로 쓰여지고,
독립된 수식에서는 \[ \sum_{n=1}^\infty a_n = \int_0^1 f \]로 쓰여진다.

1.2. plugin/latex.pl 추가

# latex plugin
# http://www.codecogs.com/latex/eqneditor.php 이용
#
# usage :
#  1) inline:
#    $$ equation $$ - inline
#      or
#    {{{#!latex inline
#     equation
#    }}}
#
#  2) display:
#    \[ equation \]
#      or
#    {{{#!latex
#     equation       - display
#    }}}

use strict;
use warnings;

sub plugin_latex {
    my ($content, @opt) = @_;
    my $img;
    my $class;

    # 캐시 저장할 이미지 파일명
    require Digest::MD5;
    my $hash = Digest::MD5::md5_hex($content.join('',@opt));
    my $imgfile = "$hash.png";

    # 저장할 디렉토리
    my $dir = "$UploadDir/latex";
    my $url = "$UploadUrl/latex";

    # 옵션 inline 처리
    if ( $opt[0] eq 'inline' ) {
        $content = '\inline '.$content;
        $class   = 'latexinline';
    }
    else {
        $class   = 'latexdisplay';
    }

    # 반환할 이미지 태그
    my $alt = "latex equation";
    my $img_cached = qq(<img src="$url/$imgfile" class="$class" alt="$alt">);

    # 캐시에 있으면 주소 반환
    if ( -f "$dir/$imgfile" ) {
        return $img_cached;
    }

    # 캐시에 없으면 새로 구성

    $content =~ s/\r?\n/ /g;
    my $src       = "http://latex.codecogs.com/gif.latex?$content";
    my $img_latex = qq(<img src="$src" class="$class" alt="$alt">);

    # LWP::Simple이 없으면 온라인 사이트의 변환 결과 주소를 바로 반환 - 느리다
    if ( not eval { require LWP::Simple } ) {
        return $img_latex;
    }

    # 캐시 디렉토리에 저장하고 주소 반환
    eval {
        CreateDir($UploadDir);
        CreateDir($dir);
    };
    return $img_latex if $@;

    my $res = LWP::Simple::getstore($src, "$dir/$imgfile");
    if ( $res eq "200" ) {
        return $img_cached;
    }
    else {
        return $img_latex;
    }
}

1;

1.3. wiki.css 추가

/* latex plugin */
img.latexinline {
    vertical-align: middle;
    display: inline;
}

img.latexdisplay {
    display: block;
    margin: 1em auto 1em 10%;
}

1.4. wiki.pl 수정

sub CommonMarkup {
    ...
### LaTeX 지원
        if ($UseLatex) {
            s/\\\[((.|\n)*?)\\\]/&StoreRaw(&MakeLaTeX("\$"."$1"."\$", "display"))/ige;
            s/\$\$((.|\n)*?)\$\$/&StoreRaw(&MakeLaTeX("\$"."$1"."\$", "inline"))/ige;
        }
# 아래 추가
        else {
            s/\$\$(.*?)\$\$/StorePlugin('latex inline', $1)/ges;
            s/\\\[(.*?)\\\]/StorePlugin('latex',        $1)/ges;
        }
    ...
}

1.5. 추가 업데이트 내역

1.6. 사용자 의견