ED,IHCRSS

Help On Macros

No older revisions available

No older revisions available



1. 매크로

매크로는 위키 페이지에 특수한 기능을 집어넣는 확장입니다. 대부분의 위키페이지는 매크로기능을 사용하지 않고 있지만 경우에 따라서 이러한 특수한 기능이 필요할 때가 있습니다. 예를 들어 RecentChanges 페이지에는 RecentChanges매크로를 사용하고 있고, SystemInfo 페이지에는 SystemInfo 매크로를 사용하고 있습니다. 각 페이지를 편집하거나 I를 눌러 이전 정보로부터 페이지 소스를 보시면 매크로를 어떻게 사용하고 있는지를 보실 수 있습니다.
매크로는 [[MacroName]]과 같은 문법을 사용합니다. 매크로에 대한 인자가 필요한 경우가 있는데 각 매크로에 대한 자세한 설명은 해당 페이지에서 확인하실 수 있습니다.
위키 문법이 궁금하시면 HelpOnEditing 페이지를 참조하세요.

2. 매크로 문법

[[MacroName]] 혹은 인자가 필요한 경우에는 [[MacroName(arg1,arg2,arg3...)]]처럼 사용합니다.
매크로의 구현에 따라 인자는 다양한 방식으로 들어갈 수 있습니다. ---- <!> 모니위키 확장 주의사항
  • 원래 모인모인 문법에서 매크로 이름은 반드시 대문자로 시작하는 이름이어야 했습니다. 모니위키에서는 이러한 제한이 없습니다.
  • 매크로 문법은 [[페이지 이름]]문법과 충돌을 일으킬 수 있습니다. 예를 들어 DateTime 페이지가 있을 때에 [[DateTime]]이라는 식으로 DateTime을 연결할 수 없습니다. 이 경우 2024-12-22 15:44:34이라고 나오게 됩니다. 이런 경우에는 [["DateTime"]]이라고 하면 DateTime이라고 링크가 걸립니다.
  • 모니위키 1.1.5 부터는 매크로에 대한 별명을 지원합니다. [[각주]]라는 식으로 써서 [[FootNote]]의 별명으로 사용하실 수 있습니다. 이렇게 사용하려면 다음과 같은 설정을 config.php에 넣어주셔야 합니다.
$myplugins=array("각주"=>"FootNote",...); # ...는 생략을 뜻합니다. 다른 내용이 없으면 쓰지 않으셔야 합니다.
  • 이경우 대소문자 구분이 중요한데, 반드시 plugin/파일이름.php에 대응하는 파일이름을 "각주"=>"매크로파일이름"식으로 지정해야 합니다.

2.1. 검색 매크로

매크로설명사용례
[[TitleSearch]] 페이지 제목/별명 찾기 [1] FindPage
[[FullSearch]] 페이지 내용 찾기 FindPage
[[GoTo]] 페이지 바로가기 FindPage
[[PageList(regex)]] 정규식에 해당하는 페이지이름 찾기 HelpIndex

2.2. 네비게이션

매크로설명사용례
[[RecentChanges]] 최근에 변경된 페이지 목록 RecentChanges
[[TitleIndex]] 모든 페이지에 대한 제목 목차 TitleIndex
[[WordIndex]] 페이지 이름으로 구성된 단어 목차 WordIndex
[[RandomPage]] 랜덤페이지 윤유정
[[RandomPage(#)]] 여러개의 랜덤 페이지. 인자는 숫자
[[TableOfContents]] 목차 매크로 현재 보고계신 페이지에서 사용중입니다.

2.3. 시스템 정보

매크로설명사용례
[[InterWiki]] 등록된 인터위키 이름 InterWiki
[[SystemInfo]] 현재 위키의 사양 SystemInfo
[[PageCount]] 전체 페이지 개수 880 페이지
[[PageHits]] 페이지를 본 회수 PageHits

2.4. 기타

매크로설명사용례
[[Icon(image)]] 시스템 아이콘 보여주기 HelpOnNavigation
[[UserPreferences]] 사용자 환경설정 UserPreferences
[[BR]] 강제 줄바꿈 첫번째 줄
다음 줄
[[Include(HelloWorld[,heading[,level]])]] 다른 페이지를 읽어옴 HelloWorld
[[Comment]] 댓글창 [[Comment]]

3. 사용례

각각의 매크로에 대한 예제는 각 매크로 해당 페이지에서 보실 수 있습니다. 간단한 예로 SystemInfo페이지에서 사용하는 [[SystemInfo]]매크로입니다. [[SystemInfo]]를 임의의 페이지에 집어넣으면 다음과 같이 보여집니다:
PHP Version 7.3.x (Linux 4.18.0-513.18.1.lve.2.el8.x86_64 SMP)
MoniWiki Version Release 1.2.5p2 [Revision: 1.2000 ]
HTTP Server Version Apache
Number of Pages 880
----
----
  • [1] 모니위키 1.1.5부터 페이지 별명도 찾아줍니다