새 문서 편집 변경점 과거 첨부 복사 이름 바꾸기 동결 해제   전체 문서 일람   도움말   바뀐 글 RSS

PukiWiki/1.4/Manual/Plugin/O-R

Top / PukiWiki / 1.4 / Manual / Plugin / O-R
최종 수정 일시 : 2020-01-09 (목) 02:21:22 (290d)



O

online

종별

블럭형 플러그 인

인라인형 플러그 인

중요도

★★☆☆☆

서식

#online

&online;

개요

현재 PukiWiki 를 참조하고 있는, 대강의 유저 수를 표시합니다.

유저 수는, 플러그 인이 불러와진 시점에서 기록된 IP 주소와 시간 표지 중, 5분 이내(변경가능)로 접속한 주소 수입니다.

플러그 인 내 설정

  • PLUGIN_ONLINE_TIMEOUT 시간 초과 초 수
  • PLUGIN_ONLINE_USER_LIST 유저 정보를 보존할 파일
  • PLUGIN_ONLINE_LIST_REGEX 유저 정보 취득용 정규 표현
비고

유저 수 집계는 문서 단위로 하지 않고, 설치된 PukiWiki 자체에서 항상 실시하므로, 빈번히 불러올 장소로 MenuBar 등을 정해 기술할지 말지 생각한 다음 스킨에 집어넣는 것이 보통입니다.


P

paint

종별

(커맨드)

블럭형 플러그 인

중요도

★☆☆☆☆

서식
#paint(
[]
[,높이]
)
개요

Java 애플릿으로 그린 그림을, 해당 문서에 첨부합니다.

빠과학적 애정에서 배포되는 BBSPainter.jar를 사용하고 있습니다.

폭과 높이로, 기본 캔버스 크기를 지정합니다. 생략시 (80,60)으로 됩니다(변경 가능)

플러그 인 내 설정

  • PAINT_INSERT_INS 입력 내용을 선두/말미 중 어디에 삽입할지 여부
  • PAINT_DEFAULT_WIDTH 기본 그림 그리기 영역의 폭
  • PAINT_DEFAULT_HEIGHT 기본 그림 그리기 영역의 높이
  • PAINT_MAX_WIDTH 그림 그리기 영역의 폭 상한
  • PAINT_MAX_HEIGHT 그림 그리기 영역의 높이 상한
  • PAINT_APPLET_WIDTH 애플릿 영역의 폭
  • PAINT_APPLET_HEIGHT 애플릿 영역의 높이
  • PAINT_NAME_FORMAT  이름란 삽입 포맷
  • PAINT_MSG_FORMAT 한마디란 삽입 포맷
  • PAINT_NOW_FORMAT 시각란 삽입 포맷
  • PAINT_FORMAT 한마디 내용 전체 삽입 포맷(메시지 있음)
  • PAINT_FORMAT_NOMSG 한마디 내용 전체 삽입 포맷(메시지 없음)
비고

PukiWiki의 설치 디렉터리에 상기한 BBSPainter.jar를 넣는 것을 잊지 않으시기 바랍니다. 이 플러그 인이 아무짝에도 쓸모 없어지게 됩니다.

paraedit

종별

커맨드

중요도

★★★★☆

서식

plugin=paraedit

[&parnum=순서별 단락 번호&page=문서 이름&refer=문서 이름]

개요

문서 전체가 아닌 문서의 일부를 편집합니다.

단락 내에 하위 단락이 또 있는 경우 하위 단락들도 전부 함께 편집할 수 있습니다.

이 플러그 인은 tmk 님이 만드셨으며, 그 외 JV44 님의 개편, taru 님의 과거 자료 보존 등을 통해 지금까지 전승되었습니다.

플러그 인 내 설정

  • _EDIT_LINK 편집 링크의 문자열 설정
비고

설치를 위해서는 플러그 인 php 파일뿐만이 아닌 다른 파일의 조정도 함께 필요합니다. 개요 란에서 소개한 분들의 페이지들 및 이 곳에서 설치 안내를 받을 수 있습니다.

pcomment

종별

(커맨드)

블럭형 플러그 인

중요도

★★★☆☆

서식
#pcomment({
[한마디 기록 문서],
[표시 건수],
[noname],
[nodate],
[above],
[below],
[reply]
})
개요

별도 문서로 한마디를 기록할 수 있는 comment 플러그 인입니다. 설치한 장소에는 최신의 한마디만을 표시할 수 있습니다. 라디오 버튼을 표시해, 지정한 부분으로 한마디를 남길 수도 있습니다.

인수

한마디 기록 문서에는 한마디를 기록할 문서 이름을 지정합니다. 생략하면, pcomment 플러그 인 내 PLUGIN_PCOMMENT_PAGE에 지정된 문서로 한마디가 기록됩니다. 기본 문서 이름은 [한마디/(설치한 문서 이름)] 입니다. 지정한 문서가 없더라도, 맨 처음 한마디를 추가한 때에 작성합니다.

표시 건수에는 표시할 최신 한마디 수를 지정합니다. 제1 수준 번호 없이 목록만을 집계합니다. 생략하면, pcomment의 기본 건수(보통 10건. PLUGIN_PCOMMENT_NUM_COMMENTS에서 변경 가능)가 표시됩니다.

표시 건수는 한마디 기록 문서보다 뒤에 지정하시기 바랍니다. 한마디 기록 문서를 생략하고 표시 건수를 지정할 경우, 한마디 기록 문서로 공백을 지정합니다. (예: #pcomment(,15))

noname,nodate,above,below,reply 로 한마디의 표시 방법, 입력 방법을 지정합니다.

  • noname − 이름 입력란을 표시하지 않습니다.
  • nodate − 날짜를 삽입하지 않습니다.
  • above – 삽입한 한마디를 양식 위에 표시합니다. 한마디는 위가 오래되고, 아래로 갈수록 새로운 순으로 놓입니다.
  • below – 삽입한 한마디를 양식 아래에 표시합니다. 한마디는 아래가 오래되고, 위로 갈수록 새로운 순으로 놓입니다.
  • reply – 한마디 앞부분에 라디오 버튼을 표시합니다. 어느 한마디로 대한 덧글이, 그 한마디의 라디오 버튼을 체크할 수 있게 됩니다.
플러그 인 내 설정

  • PLUGIN_PCOMMENT_PAGE  문서 이름의 기본 (%s에 $vars['page']가 들어갑니다)
  • PLUGIN_PCOMMENT_NUM_COMMENTS 표시할 (최신) 기본 한마디 수
  • PLUGIN_PCOMMENT_SIZE_NAME  이름란의 표시 글자 수
  • PLUGIN_PCOMMENT_SIZE_MSG  한마디란의 표시 글자 수
  • PLUGIN_PCOMMENT_DIRECTION_DEFAULT 입력 내용을 선두/말미 중 어디에 삽입할지 여부
  • PLUGIN_PCOMMENT_FORMAT_NAME  이름란 삽입 포맷
  • PLUGIN_PCOMMENT_FORMAT_MSG  한마디란 삽입 포맷
  • PLUGIN_PCOMMENT_FORMAT_NOW  시각란 삽입 포맷
  • PLUGIN_PCOMMENT_FORMAT_STRING 한마디 내용 전체 삽입 포맷
  • PLUGIN_PCOMMENT_AUTO_LOG 자동 과거 기록을 남길 때 문서당 건수(0으로 무효)
  • PLUGIN_PCOMMENT_TIMESTAMP 한마디 문서의 시간 표지를 변경하지 않고, 설치 문서의 시간 표지를 변경할지 여부
비고

변경이 충돌했을 때, 예기치 못한 장소로 한마디가 삽입되는 것을 막기 위해, 덧글 자리를 지정해 기입한 한마디는 above 또는 below의 설정에 따라 가장 앞 또는 뒤에 추가됩니다.

한마디 기입 후 표시될 문서 제목에 「(#pcomment를 쓴 문서)를 변경했습니다」라고 표시되지만, 실제로 변경된 것은 한마디를 기록할 문서입니다.

한마디를 투고하더라도, #pcomment가 쓰인 문서는 변경되지 않으므로, 최종 변경 문서에는 한마디를 기록한 문서만이 변경으로 표시됩니다.

한마디로써 상대 참조([ [../] ]등)을 쓴 경우, 쓴 문서와 써내려가진 문서 어느 쪽인지, 의도대로 변환되지 않을 가능성이 있습니다.

자동 과거 기록을 남기는 기능은 PLUGIN_PCOMMENT_AUTO_LOG 의 건수 + PLUGIN_PCOMMENT_NUM_COMMENTS 의 건수 분의 한마디를 투고한 때 작동합니다.

popular

종별

블럭형 플러그 인

중요도

★★☆☆☆

서식
#popular(
[[건수]
[,[대상 외 문서]
[,true|false]
]]
)
개요

인기 있는(참조 횟수가 많은)문서의 상위 수 건을 표시합니다.

인수

건수로는 일람 수를 지정하시기 바랍니다. 생략시 PLUGIN_POPULAR_DEFAULT가 지정한 건수입니다.

대상 외 문서로는, 표시 대상 외로 할 문서를 정규 표현으로 지정합니다. 예를 들면 FrontPageMenuBar 등의 문서를 일람에 표시시키고 싶지 않을 때 사용합니다.

true, false로, 문서 집계 조건을 지정합니다. 생략시 false 입니다.

  • true – 오늘 참조가 있었던 횟수 순으로 문서를 표시합니다.
  • false – 통산 참조 횟수 순으로 문서를 표시합니다.
플러그 인 내 설정

  • PLUGIN_POPULAR_DEFAULT 건수 미지정시 건수
비고

counter플러그 인의 카운터 정보를 이용하고 있으므로, counter 플러그 인을설치하지 않은 문서는 집계 대상 외로 됩니다. 모든 문서에 counter 플러그 인을 설치하는 것은 비효율적이므로 counter 플러그 인을 Menubar나 스킨으로 설치하는 것이 일반적입니다.


R

random

종별

(커맨드)

블럭형 플러그 인

중요도

★☆☆☆☆

서식
#random(
[메시지]
)
개요

랜덤한 문서로의 링크를 표시할 플러그 인.

표시할 문서의 후보는 설치한 문서의 하위 계층 문서입니다.

인수

메시지로는 링크에 표시할 문자열을 지정합니다. 생략시 'press here.' 로 됩니다.

비고

브라우저 새로 고침 대책은 없습니다. 새로 고침될 때마다 랜덤한 표시를 반복합니다.

read

종별

커맨드

중요도

★★★★★

서식
?cmd=read
&page=문서 이름
개요

지정한 문서를 표시합니다. 해당 문서가 존재하지 않을 경우 편집 상태로 열어, 문서 이름이InterWiki인 경우, 해결을 실시합니다.

plugin=이나 cmd=가 지정되지 않은 경우 내부에서 암묵적으로 불러오므로, 이용자가 의식할 기회는 적습니다.

인수

문서 이름으로는 표시하고 싶은 문서 이름을 지정합니다. 문서 이름은 암호화될 필요가 있습니다.

recent

종별

블럭형 플러그 인

중요도

★★★★★

서식
#recent(
[건수]
)
개요

최근 변경된 문서 중, 최신 수 건을 표시합니다.

인수

건수로는 표시 건수를 지정합니다. 생략시 플러그 인 내 설정으로 지정한 값입니다.

플러그 인 내 설정

  • PLUGIN_RECENT_DEFAULT_LINES 건수 미지정시 건수
  • PLUGIN_RECENT_CACHE RecentChanges의 캐시 장소
  • PLUGIN_RECENT_USAGE 인수 미지정시 표시되는 도움말
  • PLUGIN_RECENT_EXEC_LIMIT 한 문서 중에서 실행 가능한 상한 횟수

redirect

종별

액션형 플러그 인

중요도

★★★☆☆

서식

#redirect(
이동할 문서 이름, 대기 초 수
)

개요

지정한 문서로 자동 이동하는 플러그 인입니다. katamari 님이 만드셨습니다.

서식대로 페이지에 쓰면, n초 후에 지정한 문서로 이동시킬 수 있습니다. n초 부분을 생략시, 바로 이동합니다.

ref

종별

블럭형 플러그 인

인라인형 플러그 인

중요도

★★★★☆

서식

#ref(
첨부파일 이름|
문서 이름/첨부파일 이름|
URL
[,문서 이름]
{,
[left|center|right],
[wrap|nowrap],
[around],
[noicon],
[noimg],
[nolink],
[zoom],
[999x999],
[999%]
}
[,제목]
)

&ref(
첨부 파일 이름|
문서 이름/첨부 파일 이름|
URL
[,문서 이름]
{,
[noicon],
[noimg],
[nolink],
[zoom],
[999x999],
[999%]
}
[,제목]
);

개요

'#attach'로 문서에 첨부된 파일을 지정 위치에 전개합니다. 첨부 파일이 그림인 경우 그림을 표시하고, 그 외 경우 다운로드용 링크를 표시합니다.

인수

첨부 파일 이름으로는 문서에 첨부한 파일 이름을 지정합니다(생략시 오류로 됩니다). 별도 문서 이름/첨부 파일 이름으로 하는 것으로 별도 문서의 첨부 파일도 지정할 수 있습니다.

문서 이름으로는 파일을 첨부한 문서를 WikiName이나 BracketName으로 지정합니다. 이 옵션는최초(첨부파일 이름 다음)로 기술하시기 바랍니다. 생략시 설치한 문서입니다.

변수로는 파일 전개 방법을 지정할 수 있습니다.

  • left|center|right – 표시시 위치를 지정합니다. 생략시 left(변경 가능)입니다.
  • wrap|nowrap – 테이블 태그로 묶음/묶지 않음을 지정합니다. 생략시 nowrap(변경 가능)입니다.
  • around − 글의 돌아 들어가기를 가능하게 합니다. 생략시 돌아 들어가기를 할 수 없습니다.
  • noicon − 파일이 그림 이외의 경우에 표시되는 아이콘을 표시하지 않습니다. 생략시 표시합니다.
  • noimg − 파일이 그림인 경우에 그림을 전개하지 않게 합니다. 생략시 전개합니다.
  • nolink – 원래 파일로의 링크를 뻗치지 않게 합니다. 생략시 링크합니다.
  • zoom – 종횡비를 보존 유지합니다. 생략시 크기 지정에 따릅니다.
  • 999x999 − 크기를 지정합니다(폭x높이). 생략시 확대율 아니면 대상 그림 크기에 따릅니다.
  • 999% − 크기를 지정(확대율)합니다. 생략시 100%입니다,
  • 제목 – 상기 이외 변수는 그림의 대체 문자열, 링크 제목 속성으로 사용됩니다. 문서 이름이나변수로 보이는 문자열을 사용할 때는, #ref(hoge.png,,zoom)처럼 제목 앞에 콤마를 여분에 넣습니다.
플러그 인 내 설정

  • PLUGIN_REF_USAGE 인수 미지정시 표시될 도움말
  • PLUGIN_REF_IMAGE 매치시 지정 파일을 그림으로 간주하는 정규 표현
  • FILE_ICON 아이콘 이미지 파일
  • PLUGIN_REF_DEFAULT_ALIGN left, center, right 생략시 표시 위치
  • PLUGIN_REF_WRAP_TABLE wrap, nowrap 생략시 테이블 태그로 묶을지 여부
  • PLUGIN_REF_URL_GET_IMAGE_SIZE URL 지정시 그림 크기를 취득할지 여부
  • PLUGIN_REF_DIRECT_ACCESS 첨부파일 그림 표시로 UPLOAD_DIR의 자료로 직접 접속할지 여부
비고

around로 일어난 돌아 들어가기 지정을 해제하시려면 clear 플러그 인, 아니면 img 플러그 인을사용하시기 바랍니다.

"호게"란 별도 문서의 첨부파일 "fuga.jpg"를 인라인 플러그 인 형식으로 참조할 경우, 다음두 가지의 기술 방법이 존재합니다.

(1) &ref(호게/fuga.jpg);
(2) &ref(fuga.jpg,[[호게]]);

상기 두 가지 기술 중, (2)의 기술 방식는 구 버전과 호환성을 유지하기 위해 준비된 것으로, 추천드리는 기술 방식은 (1)입니다.

어느 기술 방법으로든 일반적인 동작은 같지만, 이른바 배너 그림처럼 표시한 그림이 별도 문서로 가는 링크로 되도록 이하 지정을 한 경우,

(1)  [[&ref(호게/fuga.jpg,nolink,웹 이름);>웹 URL]] 
(2)  [[&ref(fuga.jpg,[[호게]],nolink,웹 이름);>웹 URL]] 
(1)의 기술 방법은 기대대로 동작을 하지만, (2)의 기술 방법으로는 링크가 잘 걸리지 않습니다.

또 , 호게란 문서에 된 그림을 그 문서 내에서 변수를 지정해(예를 들면 절반의 비율로)표시할 경우,
(3)  &ref(./fuga.jpg,50%);
(4)  &ref(넘어져라/fuga.jpg,50%);
(5)  &ref(fuga.jpg,[[넘어져라]],50%);
(6)  &ref(fuga.jpg,50%);
(3)〜(5)는 기대한 대로 같은 결과가 나오지만, (6)은 오류로 됩니다.
이것은 (6)의 서식이 (2)의 기술 방식이므로,
첨부파일 이름 fuga.jpg 다음 인수에 문서 이름을 기대하기 때문입니다.
(7)  &ref(fuga.jpg);
(7)은 (6)이랑 비슷한 기술이지만, 첨부파일 이름 다음 인수가 생략되어 있으므로, 오류로는 되지 않습니다.

referer

종별

커맨드

중요도

★★★☆☆

서식
?plugin=referer
[&page=문서 이름]
[&sort=
0d|0a|
1d|1a|
2d|2a|
3
]
개요

문서를 조회한 이용자의 참조지 URL(Referer) 일람을 표시합니다.

인수

문서 이름으로는 Referer를 표시할 문서 이름을 지정합니다. 문서 이름은 암호화될 필요가 있습니다. 생략시 Referer가 기록되어 있는 문서 일람을 표시합니다.

sort로 Referer 일람의 정렬 순서를 지정합니다.

  • 0d − 최종 변경 일시(새로 된 순)
  • 0a − 최종 변경 일시(날짜 순)
  • 1d – 첫 등록 일시(새로 된 순)
  • 1a – 첫 등록 일시(날짜 순)
  • 2d − 카운터(큰 순)
  • 2a − 카운터(작은 순)
  • 3 − Referer
플러그 인 내 설정

  • CONFIG_REFERER 무시할 URI를 지정한문서
비고

pukiwiki.ini.php 에서, Referer를 사용하는 설정($referer = 1로 지정)이 이루어질 필요가 있습니다.

region

종별

블럭형 커맨드

중요도

★★★☆☆

서식
#region

글 내용

#endregion
개요

Microsoftの .NET 프레임 워크에서 쓰이고 있는 #region 문법을 PukiWiki 상에서 실현해 본 플러그 인입니다.

#region 이란, 긴 문장이 거슬릴 때 축소해 둬서 보고 싶을 때만 펼칠 수 있게 하는 기능입니다. 사용 용도는 역시 프로그램의 소스 코드 용이려나요.

이 플러그 인은 まのたろう 님이 만드셨습니다.

?plugin=ref&page=%E8%87%AA%E4%BD%9C%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%2Fregion.inc.php&src=sample03.gif
↑이런 물건입니다. 그나저나 저건 VB.NET 화면.
스크린 샷
#region(표본)
~이 부분은 표시하거나 감추거나 할 수 있습니다.
~&color(red){내부에서 플러그 인을 부를 수도 있습니다.};
~음, 이건 사용 용도가 있으려나….
#endregion
~위와 같이 #region, #endregion 으로 문장을 에워 놓으면, 문장은 생략되어 한 줄로 작게 축소 표시됩니다.

+ 버튼을 누르면 #region 과 #endregion 으로 에운 문장이 펼쳐져 표시됩니다.

※ 단, JavaScript?가 유효하지 않으면 작동하지 않습니다.

related

종별

커맨드

의사 블럭형 플러그 인

중요도

★★★☆☆

서식

?plugin=related
[&page=문서 이름]

#related

개요

대상 문서를 참조하는 문서 일람을 표시합니다.

인수

블럭형으로 실행시, 설치한 문서가 대상으로 됩니다.

커맨드로 실행시, 문서 이름으로 대상이 되는 문서를 지정할 수 있습니다. 생략한 경우, 최상위문서가 지정된다고 간주합니다.

rename

종별

커맨드

중요도

★★★☆☆

서식
?plugin=rename
[&refer=문서 이름]
개요

기존 문서의 이름을 변경합니다. 실행하려면 관리자 권한이 필요합니다.

문서 본문 외, 지정된 문서 이름의 바뀐 점, 백업, 첨부 파일, 카운터의 이름을 한꺼번에 바꿉니다.

인수

문서 이름으로는 변경할 문서의 이름을 지정합니다. 생략시 문서 이름 선택 또는 정규 표현값 치환용 문자열 입력화면이 표시됩니다.

실행 결과는 변환 결과 문서(PLUGIN_RENAME_LOGPAGE 로 지정. 표준은 :RenameLog?)에 추가 기록됩니다.

플러그 인 내 설정

  • PLUGIN_RENAME_LOGPAGE 문서 이름 변환 결과를 출력할 문서 이름
비고

문서 내 링크는 고쳐써지지 않습니다. Yetlist 등을 써서 대처하시기 바랍니다.

TrackBack?이나 Referer 정보는 변경되지 않습니다.

이름 바꾸기 대상 문서가 동결되어 있는지 여부는 확인하지 않습니다.

관련 문서에 이름 바꾸기 대상 문자열이 복수로 포함되면 이상해집니다.

  • 예를 들면, hoge 및 hoge/hoge라는 두 문서가 있었을 때, hoge 문서를 fuga로 (관련 문서를 포함해) 바꾸면, hoge/hoge 문서의 이름이 fuga/fuga로 되어 버립니다.

rss

종별

커맨드

중요도

★☆☆☆☆

서식

?plugin=rss
[&ver=0.91|
1.0|
2.0]

개요

RecentChanges를 RSS로 변환해 출력합니다.

인수

ver로 출력할 RSS를 지정합니다. 생략시 0.91을 출력합니다.

비고

RSS는 사이트의 요약을 보내기 위해 쓰이는 XML 포맷입니다. RSS 1.0은 RDF(Resource Description Framework)에 뿌리를 둔 RSS 0.9의 후계 포맷입니다. RSS 0.91은 RDF에 뿌리를 두지 않는 RSS의 실장으로, RSS 2.0은 RSS 0.91 및 0.92의 후계 포맷입니다. RSS이란 머릿글자가 무엇의 준말인지, 각기 다릅니다.

RSS 0.9 및 1.0: RDF Site Summary

RSS 0.91 및 0.92: Rich Site Summary

RSS 2.0: Really Simple Syndication

rss10

종별

커맨드

중요도

★☆☆☆☆

서식

?cmd=rss10

개요

RecentChanges를 RSS(RDF Site Summary) 1.0으로 변환해 출력합니다.

비고

rss10 플러그 인 기능은 rss 플러그 인에 통합되었기에,
이 플러그 인은 과거와의 호환성을 위해서만 존재합니다.
(장차 삭제될 가능성이 있습니다)

이 플러그 인에 접속하면, HTTP 스테이터스 코드 301
(Moved Permanently)과 함께, ver=1.0 옵션을 지정한 rss 플러그 인
의 URI으로 재연결됩니다.

ruby

종별

인라인형 플러그 인

중요도

★☆☆☆☆

서식
&ruby(
루비
){
대상 문자열
};
개요

문자열에 루비를 붙입니다.

인수

루비로는 표시할 루비를 지정합니다.

대상 문자열로는 루비가 붙을 문자열을 지정합니다.

플러그 인 내 설정

  • PLUGIN_RUBY_USAGE 인수 미지정시 표시될 도움말
비고

XHTML 1.1의 루비에 대응한 브라우저가 아니면, 루비로 표시되지 않습니다. IE5.5/6에서는 표시할 수 있습니다. Netscape 7/Mozilla에서는 XHTML Ruby Support을 짜 넣으면 표시할 수 있습니다.

루비에 대응하지 않는 브라우저에서는 루비를 붙일 문자열 바로 뒤에 루비가 ( )에 들어간 채 표시됩니다.