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

PukiWiki/1.4/Manual/Plugin/S-U

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



S

search

종별

커맨드

블럭형 플러그 인

중요도

★★★★★

서식
?cmd=search{
[&word=검색 문자열]
[&type=OR]
[&base=추출 조건 ]
}

#search(
[추출 조건 1
[[,추출 조건 2]
[,추출 조건 n]]]
)

개요

검색 문자열 입력 양식을 표시하고,
지정한 문자열을 포함한 문서의 검색을 실시합니다.

인수

커맨드:

변수로는 검색 조건을 지정합니다.

  • word − 검색할 문자열을 지정합니다. 생략시 검색 조건을 입력할 문서를 표시합니다.
  • type − 'OR' 지정시, OR 검색을 실시합니다. 생략시 AND 검색을 실시합니다.
블럭형 플러그 인:

변수로는 검색 조건양식으로 표시할 검색 대상 문서의 추출 조건을 지정합니다.

  • 추출 조건 1,2,…n − 입력 양식 추출 조건의 선택지를 표시 순으로 지정합니다.
    추출 조건 선택시, 선택한 어구로 시작하는 문서군에 대해서만, 검색을 실행합니다.
    특정 문서군만을 검색하고 싶은 경우, 검색 처리가 보다 빨리 끝납니다.
    추출 조건을 선택하지 않은 경우 전 문서가 대상으로 됩니다.
    생략시 선택란이 표시되지 않고, 항상 전 문서가 검색대상으로 됩니다.
플러그 인 내 설정

  • PLUGIN_SEARCH_DISABLE_GET_ACCESS GET 메서드에 의한 검색을 금지하기 (DoS 공격, SPAMbot, 웜 대책)
  • PLUGIN_SEARCH_MAX_LENGTH 검색할 문자열로 지정 가능한 최대 문자 수 (상동)
  • PLUGIN_SEARCH_MAX_BASE 추출 조건으로 지정 가능한 건수의 최대값

server

종별

블럭형 플러그 인

중요도

★☆☆☆☆

서식
#server
개요

서버 정보(서버 이름, 서버 소프트웨어, 서버 관리자)를 표시합니다.

setlinebreak

종별

블럭형 플러그 인

중요도

★☆☆☆☆

서식
#setlinebreak(
[on|off|default]
)
개요

입력 문장 내 줄바꿈을 줄바꿈으로 간주할지 여부에 대한 설정을 실시합니다.

PukiWiki가 입력 문장 내 줄바꿈을 어떻게 취급할지는 pukiwiki.ini 내 $line_break의 설정 내용에 따라 달라집니다.(아래 참조).

입력 문장$line_break=0;$line_break=1;
문장1
문장2
문장1 문장2문장1
문장2

setlinebreak 플러그 인은 해당 문서 이후 줄에 관해서,
$line_break 설정에 관계 없이 줄바꿈을 어떻게 취급할지를 지정할 수 있게 됩니다.

인수

변수로는 이후의 줄바꿈의 취급을 지정합니다.
변수가 생략된 경우, 줄바꿈으로 간주할지 여부에 대한 설정을 뒤집습니다.

  • on − 이후의 문장에서 단락 내 줄바꿈을 줄바꿈으로 간주합니다($line_break=1과 같이).
  • off − 이후의 문장에서 줄바꿈을 무시합니다($line_break=0과 같이).
    줄바꿈을 하기 위해서는 줄 끝에 칠더를 기술할지,
    줄 안에서 br플러그 인을 사용할 필요가 있습니다.
  • default − 줄바꿈의 취급을 그 사이트의 $line_break 설정으로 돌립니다.

showrss

종별

블럭형 플러그 인

중요도

★☆☆☆☆

서식
#showrss(
RSS로의 패스
[,[default|menubar|recent]
[,[ 캐시 생존 시간]
[,1
]]]
)
개요

지정된 RSS를 취득해, 일람 표시합니다.

문서 해석시마다 RSS의 취득을 하기 위해, 빈번히 참조되는 문서로 showrss를 사용할 경우 캐시 기능을 쓰시는 것을 권해 드립니다. 상대 사이트의 변경 빈도에 따라 캐시 생존 시간을 적절히 설정하시기 바랍니다.

인수

RSS로의 패스로는 RSS로의 파일 패스나 URL을 지정합니다.

틀 이름으로는 취득한 RSS의 표시 방법을 지정합니다. 생략시 default 로 됩니다.

  • default − 단순히 문서를 열거합니다.
  • menubar − 문서 이름 앞에 검은 동그라미를 붙입니다. MenuBar 등, 가로 폭에 제한이 있는 경우 편리합니다.
  • recent − recent 플러그 인 출력처럼, 문서 이름 앞에 검은 동그라미를 붙여 변경 날짜가 바뀔 때마다 변경 날짜를 출력합니다.

캐시 생존 시간은 캐시를 지울 기간(1시간 단위)입니다. 생략시, 캐시 기능은 무효로 됩니다.

제4 인수는 RSS를 취득한 날짜를 표시할지 어쩔지를 지정합니다. 1을 지정한 경우 표시합니다. 생략시 표시하지 않습니다.

플러그 인 내 설정

  • PLUGIN_SHOWRSS_USAGE 오류시 표시될 사용 방법
비고

작동시키기 위해서는 PHP의 xml extension 이 필요합니다.

size

종별

인라인형 플러그 인

중요도

★★★☆☆

서식
&size(
픽셀 수치
){
문자열
};
개요

문자 크기를 지정합니다.

인수

픽셀 수치로는 문자 크기를 지정합니다.

문자열은 문자 크기를 변경할 문자열을 지정합니다.

플러그 인 내 설정

  • PLUGIN_SIZE_MAX 인수로 지정 가능한 최대 문자 크기
  • PLUGIN_SIZE_MIN 인수로 지정 가능한 최소 문자 크기
  • PLUGIN_SIZE_USAGE 인수 미지정시 표시될 도움말

source

종별

커맨드

중요도

★☆☆☆☆

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

지정한 문서를 꾸미기 전의 소스를 표시합니다.

인수

문서 이름으로는 소스를 표시할 문서 이름을 지정합니다. 문서 이름은 암호화될 필요가 있습니다.

stationary

종별

커맨드

블럭형 플러그 인

인라인형 플러그 인

중요도

★☆☆☆☆

서식

?plugin=stationary

#stationary

개요

stationary 플러그 인은 플러그 인 작성을 시험하는 사람을 위한 초기 형태로 작성되었습니다.

stationary 플러그 인은 단순한 문자열을 표시할 이외는 아무것도 하지 않습니다.

플러그 인 내 설정

  • PLUGIN_STATIONARY_MAX 플러그 인 내에서 정수 정의를 하는 샘플

T

tb

종별

커맨드

중요도

★☆☆☆☆

서식
?plugin=tb
&tb_id=TrackBackID
&__mode=
view|
rss
개요

TrackBack? 일람을 표시합니다.

POST된 경우 다른 사이트로부터의 TrackBack?에 반응합니다.

인수

&tb_id로는 표시 대상 문서의 TrackBackID를 지정합니다.

&__mode로는 일람 표시 방법을 지정합니다.

  • view − 사람이 보기 쉬운 형식으로 표시합니다.
  • rss − RSS 형식으로 표시합니다.
플러그 인 내 설정

  • PLUGIN_TB_LANGUAGE TrackBack?의 RSS로 출력할 언어
  • PLUGIN_TB_ERROR 오류 발생시 반환값
  • PLUGIN_TB_NOERROR 오류 미발생시 반환값
비고

pukiwiki.ini.php 로, TrackBack?을 사용할 설정($trackback = 1을 지정)이 이루어질 필요가 있습니다.

template

종별

커맨드

중요도

★★★★☆

서식
?plugin=template
&refer=틀 문서
개요

기존 문서를 틀로써 문서를 신규 작성합니다.

문서 신규 작성시 초기 형태로 하는 문서 읽어들이기 기능과의 차이는, 틀 플러그 인은 초기 형태로 하는 범위(줄 단위)로 선택할 수 있는 반면, 문서 신규 작성으로 읽어들이는 틀은 전문을 글 영역에 복사해야 하는 점에 있습니다.

인수

틀 문서로는 초기 형태로 할 문서를 지정합니다. 문서 이름은 암호화될 필요가 있습니다.

플러그 인 내 설정

  • MAX_LEN 초기 형태 시작/종료 위치를 지정할 란에 표시될 최대 문자 수

topicpath

종별

인라인형 플러그 인

블럭형 플러그 인

중요도

★☆☆☆☆

서식

&topicpath
;

#topicpath

개요

빵 조각 목록(topicpath)라 일컫는, 현재 참조하고 있는 웹 문서의 계층을 표현할 유저 인터페이스를 제공하는 플러그 인입니다.

예를 들면

[[PukiWiki/투어]]
란 문서에 #topicpath를 쓰면, 다음과 같은 표기로 바뀝니다.
[[Top>FrontPage]] / [[PukiWiki>PukiWiki]] / [[투어>PukiWiki/투어]]

기본적으로는 두 가지 사용 방법을 상정하고 있습니다.

  1. 「호게/후가/게호」등, 2〜3계층 이상 깊은 문서로 문서의 왕래를 쉬이 만들기 위해 표시하기
  2. 스킨에 짜들여, 문서 제목 아래 URL 대신 모든 문서에서 표시하기
플러그 인 내 설정

  • PLUGIN_TOPICPATH_TOP_DISPLAY defaultpage를 가장 먼저 표시할지 여부.
  • PLUGIN_TOPICPATH_TOP_LABEL $defaultpage에 대한 표지
  • PLUGIN_TOPICPATH_TOP_SEPARATOR 계층을 나눌 분리자
  • PLUGIN_TOPICPATH_THIS_PAGE_DISPLAY 현재 표시 중인 문서에 대한 링크를 표시할지 여부
  • PLUGIN_TOPICPATH_THIS_PAGE_LINK 현재 표시 중인 문서에 대해 링크할지 여부
비고

스킨에 짜들일 경우, pukiwiki.skin.php 의 SKIN_DEFAULT_DISABLE_TOPICPATH 에 0을 지정하시기 바랍니다.

touchgraph

종별

커맨드

중요도

★☆☆☆☆

서식
?plugin=touchgraph
개요

TouchGraphWikiBrowser 용 인덱스를 만듭니다.

tracker

종별

(커맨드)

블럭형 플러그 인

중요도

★★★★☆

서식

#tracker(
[정의 이름]
[,기본 문서 이름]
)

개요

bugtrack플러그 인처럼, 정형화된 항목을 가진 문서를 만들기 위한 입력 양식을 표시합니다.

입력 항목이 고정되어 있는 bugtrack 플러그 인과 기능은 비슷하지만, 입력 항목을 간단히 변경할 수 있는 점이 다릅니다. FAQ, BBS, 서평, TODO 목록 등을 쓰는 길은 아이디어를 따라가기 나름입니다.

입력 항목 정의는 :config/plugin/tracker/ 이하에 소정의 서식으로 틀을 작성하는 것으로 설정할 수 있습니다. bugtrack 플러그 인 호환 입력 항목 틀이 :config/plugin/tracker/default 에 준비되어 있으므로 참고하시기 바랍니다.

인수

정의 이름은 #tracker(hoge)처럼 tracker의 틀 이름을 지정합니다. 생략시 :config/plugin/tracker/default 가 지정된 것으로 간주합니다.

틀 이름에 이어 양식 이름 / 목록 이름을 지정할 수 있습니다. 하나의 틀에 복수의 양식 형식 / 목록포맷을 준비하고 싶을 때 편리합니다. 예를 들면, #tracker(hoge/form_alternative) 으로 한다면 :config/plugin/tracker/hoge/form_alternative 의 내용을 양식 표시에 사용하실테고, #tracker_list(hoge/list_alternative) 으로 한다면 :config/plugin/tracker/hoge/list_alternative 의 내용을 레이아웃에 사용합니다.

기본 문서 이름은 양식에서 작성된 문서의 상위 계층이 되는 문서 이름을 지정합니다. 생략시 설치한 문서로 됩니다.

플러그 인 내 설정

  • TRACKER_LIST_EXCLUDE_PATTERN tracker_list에서 표시하지 않을 문서 이름을 정규 표현으로 지정하기
  • TRACKER_LIST_SHOW_ERROR_PAGE 항목 추출에 실패한 문서를 문서 일람에 표시할지 여부

틀은 기본적으로 설치할 tracker마다 1묶음(4문서) 작성합니다.

  • :config/plugin/tracker/hoge

    hoge 틀 항목의 내용을 기술합니다.

  • :config/plugin/tracker/hoge/form

    입력 양식의 항목과 레이아웃을 기술합니다.

  • :config/plugin/tracker/default/page

    입력한 내용을 문서화할 때의 포맷을 기술합니다.

  • :config/plugin/tracker/hoge/list

    tracker_list에서 표시할 목록의 레이아웃을 기술합니다. 테이블(|〜|)의 서식 지정(c) / 헤더(h) / 풋터(f) 줄은 특별 취급합니다.

예약 항목

  • form에서 사용할 수 있는 예약 항목
    • [_name] : 기사를 기록할 문서 이름을 입력할 자리를 표시. 생략 가능.
    • [_submit] : [추가]버튼을 표시.
  • page / list 에서 사용할 수 있는 예약 항목
    • [_date] : 투고 일시.
    • [_page] : 실제로 생성한 문서 이름. 괄호가 붙습니다.
    • [_refer] : #tracker를 둔 문서.
    • [_base] : 문서의 접두사. tracker()/tracker_list() 의 제2 인수가 생략된 경우 [_refer] 와 같은 내용.
    • [_name] : form의 [_name] 의 내용 그 자체. 기사를 기록할 문서 이름의 일부로 사용합니다.
    • [_real] : 실제 생성한 문서 이름에서, [_refer] + '/'를 뺀 이름. 기본은 [_name] 과 같은 내용. 다음 몇 가지 조건에 해당할 때는, tracker 플러그 인이 [_real]로 연번을 부여해, 기사를 기록할 문서 이름을 결정합니다.

      ・form에 [_name] 자리가 없는 경우.

      ・[_name] 이 비어 있거나, 문서 이름으로 무효한 문자를 포함한 경우.

      ・[_refer] / [_name] 이란 이름의 문서가 이미 존재하는 경우.
  • list 로 사용할 수 있는 예약 항목
    • [_update] : 문서의 최종 변경 일시.
    • [_past] : 최종 변경 일시로부터의 경과 시간.

tracker_list

종별

(커맨드)

블럭형 플러그 인

중요도

★★★★☆

서식
#tracker_list(
[정의 이름]
[,[기본 문서 이름]
[,[[정렬 항목]
:[정렬순]]
[,표시 상한]
]]]
)
개요

tracker플러그 인에서 작성한 문서를 일람 표시합니다.

인수

정의 이름은 tracker플러그 인에서 지정한 틀 이름과 같은 것을 지정합니다. 생략시 :config/plugin/tracker/default 가 지정되었다고 간주합니다.

기본 문서 이름은 tracker플러그 인으로 지정한 기본 문서 이름과 같은 것을 지정합니다. tracker플러그 인으로 기본 문서 이름을 지정하진 않은 경우tracker플러그 인을 설치한 문서를 지정합니다. 생략시 설치한 문서로 됩니다.

제3 항목으로는 일람 표시 정렬에 쓸 항목 및 정렬순을 지정합니다. 정렬 항목은 :config/plugin/tracker/틀 이름 의 field 항목 내 항목에서 선택하시기 바랍니다. 생략시 문서 이름으로 됩니다. 정렬 순은 , ASC*1, DESC*2, SORT_ASC*3, SORT_DESC*4 을 콜론(:) 뒤에 지정하시기 바랍니다. 또, 세미콜론(;)으로 나누는 것에 따라, 복수의 정렬 항목, 정렬순을 지정할 수 있습니다. 예를 들면, #tracker_list(,,state:SORT_ASC;priority:SORT_ASC;_real:SORT_DESC) 라고 지정한 경우, 항목마다 (1) [state]를 오름차순 -> (2) [priority]를 오름차순 -> (3) [_real](실제 문서 이름)을 내림차순…의 우선 순위로 정렬합니다.

표시상한은 일람 표시할 문서 수의 상한을 지정합니다. 생략시 전부 표시됩니다.


U

unfreeze

종별

커맨드

중요도

★★★☆☆

서식
?plugin=unfreeze
&page=문서 이름
개요

문서의 동결을 해제합니다.

인수

문서 이름으로는 해제할 문서 이름을 지정합니다. 문서 이름은 암호화될 필요가 있습니다.

플러그 인 내 설정

  • PLUGIN_UNFREEZE_EDIT 동결해제시 문서의 편집 양식 을 표시할지 여부

update_entities

종별

커맨드

중요도

★☆☆☆☆

서식
?plugin=update_entities
개요

CACHE_DIR/entities.dat 을 생성합니다.

entities.dat은 HTML의 실체 참조를 판정하기 위해 쓰이는 테이블을 저장한 파일입니다. 보통, 이용자나 관리자가 의식할 기회는 없습니다.

플러그 인 내 설정

  • W3C_XHTML_DTD_LOCATION DTD의 장소
비고

배포 파일에 생성이 끝난 entities.dat이 부속되기 때문에, 보통 사용할 기회는 없습니다.



*1 오름차순 고정
*2 내림차순 고정
*3 오름차순(열람자가 변경 가능)
*4 내림차순(열람자가 변경 가능)