UseModWiki소스수정/Configuration

UseModWiki Ext 버전 환경 설정

/home/gildong/                           - 자기의 홈 디렉토리
/home/gildong/public_html/               - 자기의 홈페이지의 루트 디렉토리
/home/gildong/public_html/cgi-bin/       - CGI 스크립트가 들어갈 수 있는 디렉토리

/home/gildong/public_html/cgi-bin/wiki/  - UseModWiki 를 설치할 디렉토리
/home/gildong/wikidata                   - UseModWiki 데이타가 들어갈 디렉토리 (public_html 밖으로 빼내는 것을 권장)
/home/gildong/public_html/upload         - 업로드한 화일이 들어갈 디렉토리 
                                           (public_html 아래에 있어야 함. 위의 데이타 디렉토리와는 따로 둘 것)

wiki.pl 쪽에서의 수정

$ConfigFile  = "./myconfig.pl";               # config 화일의 경로

config.pl 설정

$DataDir      = "data";          # Main wiki directory

$UrlPrefix = "http:/cgi-bin/utf";  # URL prefix for other variables ($...Url)
                                   # like "http:/wiki","http://mydomain.com/wiki",etc.

• StyleSheetUrl(3)
• IconUrl(4)
• InterIconUrl(5)
• EmoticonUrl(6)
• UploadUrl(7)
• JavaScriptUrl(8)
• OekakiJarUrl(9)

웹 브라우저 입장에서,
스타일 쉬트:  http://서버.주소/~gildong/cgi-bin/wiki/wiki.css
자바스크립트: http://서버.주소/~gildong/cgi-bin/wiki/wikiscript.js
            ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
            이 부분이 공통으로 들어가는 부분이므로
$UrlPrefix = "http://서버.주소/~gildong/cgi-bin/wiki";

서버 주소를 생략한 경우
$UrlPrefix = "http:/~gildong/cgi-bin/wiki";
$UrlPrefix = "http:/cgi-bin/wiki";           (자기가 도메인을 따로 구입해서 운영하는 경우)
이 두 경우는 사파리 브라우저가 인식하지 못한다.

http: 부분까지 생략한 경우
$UrlPrefix = "/~gildong/cgi-bin/wiki";
이 경우는 다른 건 문제가 아닌데, 업로드한 이미지를 화면에 바로 보여주지 못하게 된다. 이 경우에는 UploadUrl 변수 쪽에다가 http: 를 붙여 줄 것
$UploadUrl = "http://서버.주소/$UrlPrefix/upload";

$CookieName   = "Wiki";          # Name for this wiki (for multi-wiki sites)

$SiteName     = "Wiki";          # Name of site (used for titles)

$HomePage     = "HomePage";      # Home page (change space to _)

$RCName       = "RecentChanges"; # Name of changes page (change space to _)

$LogoUrl      = "";              # URL for site logo ("" for no logo)

$ENV{PATH}    = "/bin:/usr/bin/:/usr/local/bin/";     # Path used to find "diff"

$ScriptTZ     = "";              # Local time zone ("" means do not print)

$RcDefault    = 30;              # Default number of RecentChanges days

@RcDays       = qw(1 3 7 30 90); # Days for links on RecentChanges

$KeepDays     = 14;              # Days to keep old revisions

$SiteBase     = "";              # Full URL for <BASE> header

$FullUrl      = "";              # Set if the auto-detected URL is wrong

$RedirType    = 1;               # 1  = CGI.pm, 2  = script, 3  = no redirect

$AdminPass    = "admin";         # Set to non-blank to enable password(s)
$EditPass     = "edit";          # Like AdminPass, but for editing only

$StyleSheetUrl= "$UrlPrefix/wiki.css";      # URL for CSS stylesheet (like "/wiki.css")

$NotFoundPg   = "";              # Page for not-found links ("" for blank pg)

$EmailFrom    = "Wiki";          # Text for "From: " field of email notes.
$SendMail     = "/usr/sbin/sendmail";  # Full path to sendmail executable

• EmailFrom(31) - 메일 발송자 이름
• SendMail(32) - 메일을 발송할 때 사용되는 sendmail 프로그램의 경로

$FooterNote   = "";              # HTML for bottom of every page

$EditNote     = "";              # HTML notice above buttons on edit page

$MaxPost      = 1024 * 1024 * 3; # Maximum 3MB posts (file upload limit)

$NewText      = "";              # New page text ("" for default message)

$HttpCharset  = "UTF-8";         # Charset for pages, like "iso-8859-2"

$UserGotoBar  = "";              # HTML added to end of goto bar
$UserGotoBar2 = "";
$UserGotoBar3 = "";
$UserGotoBar4 = "";

예:
$UserGotoBar  = "<a href='http://www.usemod.org'>UseModWiki</a>";

### Translation
do "./translations/ko_KR.UTF-8.pl";     # korean, UTF-8 encoding
# do "./translations/ko_KR.EUC-KR.pl";    # korean, EUC-KR encoding

### 인자 없이 wiki.pl 을 부르면 $LogoPage 를 embed 형식으로 출력
$LogoPage     = "";                             # this page will be displayed when no parameter

### 페이지 처리 시간 출력
$CheckTime    = 0;                              # 1 = mesure the page-processing time (requires Time::HiRes module), 0 = do not

### 아이콘 디렉토리 URL
$IconUrl      = "$UrlPrefix/icons/";          # URL for directory containing icon files
### interwiki 아이콘 디렉토리 URL
$InterIconUrl = "$UrlPrefix/icons-inter/";    # URL for directory containing interwiki icons files
### 이모티콘 디렉토리 URL
$EmoticonUrl  = "$UrlPrefix/emoticon/";  # URL for directory containing emoticon files

### 업로드한 파일이 저장되는 디렉토리 경로와, 브라우저 출력에 사용되는 URL
$UploadDir    = "./upload";                     # directory containing uploaded files
$UploadUrl    = "$UrlPrefix/upload";     # URL for the directory containing uploaded files
                                                #  if $UploadUrl = "", it has the same value as $UploadDir

$UploadDir = "/home/gildong/public_html/upload";
     # "그림.jpg" 파일을 업로드하면 이 디렉토리에 저장된다.
$UploadUrl = "http://서버.주소/~gildong/upload";
     # 웹 브라우저 입장에서는 "http://서버.주소/~gildong/upload/그림.jpg" 가 그 파일의 경로

### 템플릿 페이지
$TemplatePage = "TemplatePage";                 # name of template page for creating new page

### java script 함수
$JavaScriptUrl= "$UrlPrefix/wikiscript.js";   # URL for JavaScript code (like "/wikiscript.js")
### Oekaki용 .jar 파일
$OekakiJarUrl = "$UrlPrefix/oekakibbs.jar";   # URL for oekaki .jar file

### for {{{lang }}} block
$SOURCEHIGHLIGHT = "/usr/local/bin/source-highlight";    # Path of "source-highlight" binary
@SRCHIGHLANG     = qw(
        bib bison caml changelog cpp csharp diff flex fortran html java javascript
        langdef latex logtalk lua nohilite outlang pascal perl php postscript
        prolog python ruby sh sml sql style syslog tcl xml
    );                                                  # Supported languages

• SOURCEHIGHLIGHT(59) - source-highlight 유틸리티가 있는 경로
• SRCHIGHLANG(60) - source-highlight 에서 지원하는 언어 옵션들을 나열

### for "#EXTERN " directive
$EditGuideInExtern = 0;    # 1 = show edit guide in bottom frame, 0 = don't show
$SizeTopFrame      = 160;  # Height of top frame
$SizeBottomFrame   = 150;  # Height of bottom frame

• EditGuideInExtern(61) - 값이 1이면 화면을 세 프레임으로 나누어서 상단-메뉴바, 중단-외부 사이트, 하단-편집 가이드를 출력한다. 값이 0이면 하단 프레임 없이 두 프레임만 출력한다.
• SizeTopFrame(62), SizeBottomFrame(63) - 상단 프레임과 하단 프레임의 높이를 픽셀 단위로 준다. 홈페이지마다 로고나 글자의 크기 때문에 이 값을 직접 조절해 주어야 한다.

### rss from usemod 1.0
$InterWikiMoniker = '';         # InterWiki moniker for this wiki. (for RSS)
$SiteDescription  = $SiteName;  # Description of this wiki. (for RSS)
$RssLogoUrl       = '';         # Optional image for RSS feed
$RssDays          = 7;          # Default number of days in RSS feed
$RssTimeZone      = 9;          # Time Zone of Server (hour), 0 for GMT, 9 for Korea

• InterWikiMoniker(64) - 뭔지 모르겠다. 아마 인터위키에서처럼 자신의 홈페이지를 가리키는 명칭을 얘기하는 듯.
• SiteDescription(65) - 주석문으로 보건데, 간단한 사이트 소개?
• RssLogoUrl(66) - 로고 이미지의 URL 을 적어준다.
• RssDays(67) - 별도로 인자를 주지 않았을 때, 디폴트로 며칠 동안의 변경 내역을 보여 줄지를 정한다. 여기서는 7일.
• RssTimeZone(68) - 홈페이지가 있는 서버의 시계가 어디에 맞춰져 있는지를 적어준다. 세계표준시라면 0, 한국표준시라면 9 가 될 것이다.
  • RssTimeZone 옵션은 ScriptTZ(69)와 의미가 다르다는 것에 주의. 예를 들어 서버 시스템의 시계가 한국시각에 맞춰져 있고 사이트도 한국시각으로 운영한다면, ScriptTZ는 서버 시각과 사이트의 시각의 차이이미로 "0"또는 ""이고, RssTimeZone은 서버 시각과 표준시와의 차이이므로 "9"이다.

### 스크립트 뒤에 / or ? 선택 from usemod1.0
$SlashLinks   = 1;      # 1 = use script/action links, 0 = script?action

• 0 이면 "wiki.pl?페이지이름" 형태로 링크가 걸린다.
• 1 이면 "wiki.pl/페이지이름" 형태로 링크가 걸린다

### trackback 보내기
$SendPingAllowed = 0;   # 0 - anyone, 1 - who can edit, 2 - who is admin

• 0 - 아무나 보낼 수 있음
• 1 - 그 페이지를 수정할 권한이 있는 사람만 보낼 수 있음
• 2 - 관리자만 보낼 수 있음

### LaTeX 변환 지원
$UseLatex    = 0;       # 1 = Use LaTeX conversion   2 = Don't convert

### 사용자 정의 헤더
$UserHeader  = '';      # Optional HTML header additional content

예:
$UserHeader  = <<EOF;               <-- 여러 줄을 출력하고 싶으면 여기를 이렇게 쓰면,
<link rel="stylesheet" media="print" href="/cgi-bin/wiki/wiki_print.css">
EOF                                 <-- 이 줄 바로 위까지가 다 UserHeader의 값이 된다.

### 존재하지 않는 페이지 표시 방식
$EditNameLink = 1;      # 1 = edit links use name (CSS), 0 = '?' links

• 1이면 페이지 이름의 첫글자에 링크가 걸린다.
• 0이면 페이지 이름 뒤에 "?"가 추가되어 여기에 링크가 걸린다.

### 방문자 브라우저의 주소창의 인코딩 추측 (utf-8 은 쓰지 말 것)
### The encoding of URL request from visitor's browser may be one of these:
### ex: ('euc-jp', 'shiftjis', '7bit-jis')
### caution: Don't write 'utf-8'. It is included implicitly.
@UrlEncodingGuess = ('euc-kr');

$UseEmoticon    = 1;        # 1 = use emoticon, 0 = not use

$ClickEdit      = 1;        # 1 = edit page by double click on page, 0 = no use

$EditPagePos    = 1;        # 1 = bottom, 2 = top, 3 = top & bottom

$NamedAnchors   = 1;        # 0 = no anchors, 1 = enable anchors, 2 = enable but suppress display

$UseSubpage  = 1;       # 1 = use subpages,       0 = do not use subpages

$UseCache    = 0;       # 1 = cache HTML pages,   0 = generate every page

$EditAllowed = 1;       # 1 = editing allowed,    0 = read-only

$RawHtml     = 1;       # 1 = allow <HTML> tag,   0 = no raw HTML in pages

$HtmlTags    = 1;       # 1 = "unsafe" HTML tags, 0 = only minimal tags

$UseDiff     = 1;       # 1 = use diff features,  0 = do not use diff

$FreeLinks   = 1;       # 1 = use [[word]] links, 0 = LinkPattern only
$WikiLinks   = 1;       # 1 = use LinkPattern,    0 = use [[word]] only

• FreeLinks(90) - 0이면 오직 위키네임에 해당하는 경우(ex: HelloWorld)만 링크가 된다. 1이면 [[페이지]]처럼 대괄호쌍을 사용하여 링크를 걸 수도 있다.
• WikiLinks(91) - 위 옵션과 반대. 0이면 오직 대괄호쌍을 사용한 링크만 된다. 1이면 위키네임을 사용한 링크도 된다.

$AdminDelete = 1;       # 1 = Admin only page,    0 = Editor can delete pages

$RunCGI      = 1;       # 1 = Run script as CGI,  0 = Load but do not run

$EmailNotify = 0;       # 1 = use email notices,  0 = no email on changes

$EmbedWiki   = 0;       # 1 = no headers/footers, 0 = normal wiki pages

# Minor options:
$LogoLeft    = 0;       # 1 = logo on left,       0 = logo on right
# 로고 그림의 위치, 1이면 왼쪽, 0이면 오른쪽.

$RecentTop   = 1;       # 1 = recent on top,      0 = recent on bottom
# 최근 변경 내역 화면에서
# 1 = 새글이 위쪽에서 아래로 보임, 0 = 새글이 아래쪽에 보임

$UseDiffLog  = 0;       # 1 = save diffs to log,  0 = do not save diffs
# 1이면 diff출력이 생길 때마다 그 내용을 diff_log라는 파일에 저장하고, 0이면 저장 안함.

$KeepMajor   = 1;       # 1 = keep major rev,     0 = expire all revisions

$KeepAuthor  = 1;       # 1 = keep author rev,    0 = expire all revisions

$ShowEdits   = 0;       # 1 = show minor edits,   0 = hide edits by default
# 1이면 minor edit라고 한 것까지 다 보여준다.

$HtmlLinks   = 1;       # 1 = allow A HREF links, 0 = no raw HTML links
# A HREF 태그 허용 여부. 1이면 되고, 0이면 안 된다.

$ThinLine    = 1;       # 1 = fancy <hr> tags,    0 = classic wiki <hr>
# 1이면 가로줄을 그릴 때 "-"의 갯수에 따라 굵기 조절 가능

$BracketText = 1;       # 1 = allow [URL text],   0 = no link descriptions
# URL에 괄호로 설명달기 허용여부. 1이어야 설명을 달 수 있다.

$UseAmPm     = 1;       # 1 = use am/pm in times, 0 = use 24-hour times
# 1이면 12시간제, 0이면 24시간제.

$UseIndex    = 0;       # 1 = use index file,     0 = slow/reliable method
# 인덱스 파일을 사용할지 여부. 1이면 쓰고(빠르다), 0이면 안 쓴다(안정적이다).

$NetworkFile = 1;       # 1 = allow remote file:, 0 = no file:// links
# file://를 URL로 허용할지 여부. 1이면 허용

$BracketWiki = 1;       # 1 = [WikiLnk txt] link, 0 = no local descriptions
# 위키네임으로 된 링크에 괄호로 설명달기. 1이면 허용.

$UseLookup   = 0;       # 1 = lookup host names,  0 = skip lookup (IP only)
# 최근변경내역이나 페이지 히스토리 등에서,
# 0 = IP주소만, 1 = 호스트 이름까지 표시
# 서버에 따라서 이 값을 1로 하면 페이지를 저장할 때 시간이 오래 걸리는 경우가 있다.

$FreeUpper   = 0;       # 1 = force upper case,   0 = do not force case
# 링크 패턴에서 첫 글자를 대문자로 강제할지 여부. 1이면 반드시 대문자여야 한다.

$FastGlob    = 1;       # 1 = new faster code,    0 = old compatible code
# 페이지 목록을 사용하는 데 쓰이는 것 같지만 정확한 효과는 모르겠음

# HTML tag lists, enabled if $HtmlTags is set.
# Scripting is currently possible with these tags,
# so they are *not* particularly "safe".
# HTML 태그 허용으로 설정했을 때, 허용할 태그를 정한다.
# Tags that must be in <tag> ... </tag> pairs:
# 여는 태그와 닫는 태그가 있어야 하는 태그들
@HtmlPairs = qw(b i u font big small sub sup h1 h2 h3 h4 h5 h6 cite code
  em s strike strong tt var div center blockquote ol ul dl table caption span);
# Single tags (that do not require a closing /tag)
# 태그 하나만으로 충분한 태그들.
@HtmlSingle = qw(br p hr li dt dd tr td th);
@HtmlPairs = (@HtmlPairs, @HtmlSingle);  # All singles can also be pairs

# == You should not have to change anything below this line. =============
$IndentLimit = 20;                  # Maximum depth of nested lists
$PageDir     = "$DataDir/page";     # Stores page data
$HtmlDir     = "$DataDir/html";     # Stores HTML versions
$UserDir     = "$DataDir/user";     # Stores user data
$KeepDir     = "$DataDir/keep";     # Stores kept (old) page data
$TempDir     = "$DataDir/temp";     # Temporary files and locks
$LockDir     = "$TempDir/lock";     # DB is locked if this exists
$InterFile   = "intermap";          # Interwiki site->url map
$RcFile      = "$DataDir/rclog";    # New RecentChanges logfile
$RcOldFile   = "$DataDir/oldrclog"; # Old RecentChanges logfile
$IndexFile   = "$DataDir/pageidx";  # List of all pages
$LinkDir     = "$DataDir/link";    # by gypark. Stores the links of each page
$CountDir    = "$DataDir/count";    # by gypark. Stores view-counts
$HiddenPageFile = "$DataDir/hidden";  # hidden pages list file

# == End of Configuration =================================================

wiki.css 설정

• UseModWikiHelp - UseModWiki 의 설치, 환경설정, 스타일쉬트 등에 대한 설명을 볼 수 있다.