일괄 처리 함수 도움말

일괄 처리 함수는 'Macro'를 번역한 말이며, 이 도움말은 HelpOnMacros를 번역한 것 입니다.

일괄 처리 함수

일괄 처리 함수는 일반적으로 파이¹(확장자 .py)으로 씌어진 함수로서 위키 글월에 새로운 기능을 더해 줍니다. 예를 들어 RecentChanges나 SystemInfo와 같은 글을 바꾸려고 해서 그 내용을 보면 무슨 말인지 금방 알아차릴 수 있을 겁니다.

더 많은 글월 멋내기에 대한 정보는 글월 쓰기 도움말을 참고하십시오.

간단히 말해서...

꺽쇄 두개로 둘러싸인 특별한 이름을 일괄 처리 함수라고 합니다. 즉, <<Macro>>와 같은 꼴 입니다.

• 2009.4.11일 현재 일괄 처리 함수는 로마자로만 가능합니다. 모든 .py의 언어 처리를 utf-8로 하고, RecentChanges를 "차림판"으로 바꾸고 불렀을 때 다음과 같은 오류가 났습니다. 오류가 난 함수는 getattr() 이었습니다. 몇 군데 찾아 보았는지 쉬 해결책을 구하기가 쉽지 않았습니다. - 김 민수

  • UnicodeEncodeError

    'ascii' codec can't encode characters in position 6-8: ordinal not in range(128)

다음은 직지 위키에서 쓸 수 있는 일괄 처리 함수를 영어 글자 순서대로 늘어놓고 설명을 덧붙인 것 입니다.

모인모인에서 기본으로 깔아놓은 일괄 처리 함수

AbandonedPages

• 사용법: <<AbandonedPages()>>, 또는 <<AbandonedPages>>

• 넘겨주는 인자: 없음.
• 쓰임: 글이 변경이 되지 않은 채로 오래된 글월(들)을 보여 줍니다. 사용을 권장하지는 않습니다.

• 원전: AbandonedPages.py

Action

• 원전: Action.py

AdvancedSearch

• 사용법: <<AdvancedSearch()>>, 또는 <<AdvancedSearch>> 실제 쓰인 예를 보시려면 찾아 보기를 보십시오.

• 넘겨주는 인자: 없음.
• 쓰임: 똑똑한 찾기 기능을 위해서 사용자로 부터 선택 사항을 입력받는 창을 띄웁니다.

• 원전: AdvancedSearch.py

AttachInfo

• 사용법: <<AttachInfo(pagename)>>, 또는 <<AttachInfo>>

• 넘겨 주는 인자: pagename. 아무 것도 보내지 않으면 현재 글월에 있는 덧붙임 문서가 몇 개 인지 보여 줍니다.
• 쓰임: 글월에 다 해서 몇 개의 덧붙임 문서가 있는지 알려 줍니다.

• 원전: AttachInfo.py

AttachList

• 사용법: <<AttachList([pagename,mime_type])>>, 또는 <<AttachList>>

• 넘겨 주는 인자: pagename과 mime_type, 아무 것도 보내지 않으면 현재 글월에 있는 모든 형식의 덧붙임 문서를 보여 줍니다.
• 쓰임: 글월에 있는 덧붙임 문서 목록을 보여 줍니다.

• 원전: AttachList.py

BR

• 사용법: <<BR()>>, 또는 <<BR>>

• 넘겨 주는 인자: 없음. - 저는 <BR(숫자)>처럼 해서 원하는 숫자만큼 새 줄을 넣어 줄 수 있었으면 좋겠습니다.

• 쓰임: 강제로 새 줄을 넣어 줍니다. 자세한 내용은 http://www.w3.org/를 참조 하십시오.

• 원전: BR.py

EditTemplates

• 사용법: <<EditTemplates()>>, 또는 <<EditTemplates>>

• 넘겨 주는 인자: 없음.
• 쓰임: 글월 이름 중에 'Template'가 들어가는 모든 글월들을 보여 줍니다.

• 원전: EditTemplates.py

EditedSystemPages

• 사용법: <<EditedSystemPages()>>, 또는 <<EditedSystemPages>>

• 넘겨 주는 인자: 없음.

• 쓰임: 모인 모인 설치시에 깔아준 중요한 글월 중에서 설치 이후에 그 내용이 바뀐 글월을 보여 줍니다. 여기에서 말하는 SystemPages는 FreeBSD 기준으로 /usr/local/share/moin/underlay, 또는 /to/wiki/dir/underlay 에 깔린 글월들을 말합니다. 기본으로 깔린 글월 들 위에 누리터 주인장이 새로 심어서 만들어 줄 수도 있습니다.

• 원전: EditedSystemPages.py

EmbedObject

• 사용법: <<EmbedObject(attachment[,width=width][,height=height][,alt=alternative text])>>

• 넘겨 주는 인자: 위키 글월에 담을 응용 문서 이름(필수), 그리고 선택 항목으로 크기와 설명.

  • Keyword Parameters:

    • 응용 문서 꼴에 따라 넘겨 주는 매개 변수가 달라지게 됩니다:

      •   width = None, float
          height = None, float
          pagename = None, unicode
          align = middle
          alt = ''
          play = False
          loop = False
          quality = high
          op = True
          repeat = False
          autostart = False
          menu = True
          hidden = False

    모든 응용 문서 꼴이 width 와 height는 매개 변수로 받아 들입니다.

    • 모인 모인 1.7 이상에서는 단위를 처리합니다. width와 height에서 알아먹는 단위는 px, em, pt, in, mm, 그리고 %입니다. 아무런 단위도 정해주지 않으면 기본값인 px가 쓰입니다.

• 쓰임: 이 일괄 처리 함수는 위키 글월안에 응용 문서를 담아서 내부 처리기에 의해서 다루어 지게끔 합니다. 주로 음악, 그림, 영화 같은 것들을 예로 들 수 있겠습니다.

• 원전: EmbedObject.py

응용 문서를 위키 글월 안에 담기에 대한 도움 말

이 글은 응용 문서를 위키 글월 안에 담기는 EmbedObject를 번역한 말이며, 이 도움말은 HelpOnMacros/EmbedObject를 번역한 것 입니다.

이 일괄 처리 함수는 위키 글월안에 응용 문서를 담아서 내부 처리기에 의해서 다루어 지게끔 합니다. 주로 음악, 그림, 영화 같은 것들을 예로 들 수 있겠습니다. 그리고 선택사항으로 화면에 보여 주는 크기와 설명을 달아 줄 수 있으며, 그 밖에 매개 변수는 어떤 종류의 응용 문서를 담았느냐에 따라 달라지게 됩니다.

그리고, 담을 덧붙임 문서가 아직 없다면 새로 올릴 수 있도록 attachment 줄이 나타납니다.

1.6x 이상에서 있는 기능: 모인 모인은 새로운 글본으로 {{target|desc|params}}를 쓰기 때문에, 비록 몇 응용 문서 꼴은 시험적이라고 하더라도, <<EmbedObject>>를 쓰지 않고서 용용 문서를 위키 글꼴 안에 넣어주는 것을 흉내낼 수 있습니다.

기능 켜기

EmbedObject는 기본적으로 깔린 일괄 처리 함수 이지만, 보안상의 이유로 환경 설정을 제대로 하지 않으면 돌아가지 않게 되어 있습니다. 따라서, 이 기능을 사용하고 싶다면 wikiconfig.py에 다음과 같이 설정을 해 주어야 합니다.

1. wikiconfig.py 문서의 "Content options" 이라서 써진 곳 아래에 다음과 같은 내용을 더합니다.:

       mimetypes_xss_protect = ['text/html', 'application/x-shockwave-flash', 'application/xhtml+xml',] 
   
       mimetypes_embed = ['application/x-dvi', 'application/postscript', 'application/pdf', 'application/ogg', 'application/vnd.visio', 'image/x-ms-bmp', 'image/svg+xml', 'image/tiff', 'image/x-photoshop', 'audio/mpeg', 'audio/midi', 'audio/x-wav', 'video/fli', 'video/mpeg', 'video/quicktime', 'video/x-msvideo', 'chemical/x-pdb', 'x-world/x-vrml',] 

2. 어떤 형식의 응용 문서를 허용하고 말고 하는 설정은 해당 문서의 꼴을 mimetypes_embed에 더해 주거나 빼 줌으써 해 줄 수 있습니다. 예를 들어 플래쉬²를 허용하고 싶다면 'application/x-shockwave-flash'라는 줄을 mimetypes_xss_protect에서 빼서 mimetypes_embed으로 옮겨주면 됩니다.

더 자세한 내용은 환경 설정 도움말을 보십시오.

지원되는 용응 문서 꼴:

• application/x-shockwave-flash
• application/x-dvi
• application/postscript
• application/pdf
• application/ogg
• application/vnd.visio
• image/x-ms-bmp
• image/svg+xml
• image/tiff
• image/x-photoshop
• audio/mpeg
• audio/midi
• audio/x-wav
• video/fli
• video/mpeg
• video/quicktime
• video/x-msvideo
• chemical/x-pdb
• x-world/x-vrml

Additionally:

• 'video'는  repeat, autostart, menu, op 의 매개 변수를 알아서 처리할 수 있습니다.

• 'audio'는  play, repeat, autostart, op, hidden 의 매개 변수를 알아서 처리할 수 있습니다.

  • 화면에 보여주는 기본 크기는 폭 60, 그리고 높이 20입니다.

• 'application'는 play, menu, autostart 의 매개 변수를 알아서 처리할 수 있습니다.

보기

기본 보기:

<<EmbedObject(example.swf)>>
<<EmbedObject(example.pdf)>>
<<EmbedObject(example.svg)>>

실제 쓰이는 보기:

<<EmbedObject(testpdf.pdf,width=100%,height=600px)>>
<<EmbedObject(example.swf,width=637px,height=392px,play=true,loop=true)>>

FootNote

• 사용법: <<FootNote(덧설명 내용)>>, 또는 <<FootNote>>

• 넘겨 주는 인자: 덧설명 내용.

• 쓰임: 설명 없이 <<FootNote>>만 쓰면 글월에 달린 덧설명을 다 보여 줍니다.

• 원전: FootNote.py

보통 글월을 쓸 때, 각주³나 미주⁴를 쓰는 경우가 있습니다. 보통 주석이라고 합니다. 누리터 글월에서는 사실 각주, 미주 구별이 없어졌습니다. 글월을 일일이 하나의 쪽으로 나누지 않는 한, 모두 다 미주가 되어 버렸습니다.

아래에 <<FootNote>>로 이 글에 있는 덧설명을 보여 주었습니다.

• 1. python (1)

  2. Flash (2)

  3. 덧설명을 그 해당 쪽 바로 아래에 보여줍니다 (3)

  4. 덧설명을 그 글월 제일 마지막에 몰아서 보여 줍니다 (4)

FullSearch

• 사용법: <<FullSearch()>>, <<FullSearch(찾을 낱말)>>, 또는 <<FullSearch>>

• 넘겨 주는 인자: 찾을 낱말(선택 사항).
• 쓰임: 찾아 보기 할 때 씁니다.

• 원전: FullSearch.py

설명 없이 <<FullSearch()>>만 쓰면 이 일괄 처리 함수를 실행한 글월의 제목으로 찾아보기를 하여 그 결과를 보여 줍니다. 이렇게 쓰인 예는 갈래 나누기, 그리고 도움말 같은 글월에서 보실 수 있습니다. 그리고 <<FullSearch>>로 하면, 다음과 같이 찾아보기에 필요한 정보를 요구하는 대화 상자를 보여 줍니다.

• 
  Display context of search results
  Case-sensitive searching

FullSearchCached

• 사용법: <<FullSearchCached()>>, <<FullSearchCached(찾을 낱말)>>, 또는 <<FullSearchCached>>

• 넘겨 주는 인자: 찾을 낱말(선택 사항).
• 쓰임: 찾아 보기 할 때 씁니다.

• 원전: FullSearchCached.py

사용법은 <<FullSearch>>와 같습니다. 다만 이 일괄 처리 함수는 이미 저장되어 있는 검색 결과를 가져다가 보여줍니다. 글월이 많아질 수록 찾아 보기 하는데 시간이 오래 걸리기 때문에 그 이전 <<FullSearch>> 실행 결과의 내용을 임시로 저장했다가 그 내용을 빨리 보여주는 기능입니다.

GetText

• 사용법: <<GetText(영어낱말)>>

• 넘겨 주는 인자: 영어낱말.
• 쓰임: 해당 영어 낱말이 사용자가 설정한 언어로 어떻게 번역되었는지 화면에 보여 줍니다.

• 원전: GetText.py

보기로, <<GetText(FrontPage)>>라고 하고, 사용자 설정에서 기본 언어가 한글로 되어 있으면 그 보여주는 결과는 "대문"이 됩니다.

여기에서 어떻게 번역되었는지는 ko.MoinMoin.po를 보십시오.

GetText2

• 사용법: <<GetText2(,message, argument1, argument2, ...)>>

• 넘겨 주는 인자: message, argument1
• 쓰임: 해당 영어 낱말이 사용자가 설정한 언어로 어떻게 번역되었는지 화면에 보여 줍니다.

• 원전: GetText2.py

예를 들어, <<GetText2(, [You may not read %s], FrontPage>>라고 하고, 사용자 설정에서 기본 언어가 한글로 되어 있으면 그 보여주는 결과는 "[FrontPage를(을) 읽을 수 없음]"이 됩니다.

여기에서 어떻게 번역되었는지는 ko.MoinMoin.po를 보십시오.

Hits

• 사용법: <<Hits([all=(0,1)],[event_type=(VIEWPAGE,SAVEPAGE)>>, 또는 <<Hits()>>

• 넘겨 주는 인자: 아무 것도 없이 그냥 <<Hits()>>로 쓸 것을 권장합니다.

• 쓰임: 이 일괄 처리 함수를 호출한 글월이 몇 번이나 읽혀졌는지를 표시합니다.

• 원전: Hits.py

Include

• 사용법: <<Include(pagename, heading, level, from="regex", to="regex", sort=ascending|descending, items=n, skipitems=n, titlesonly, editlink)>>

• 넘겨 주는 인자: 아래의 설명을 참조하십시오.

• 쓰임: 같은 누리터에 있는 위키글월을 가져다가 이 일괄 처리 함수를 호출한 글월에 넣어 줍니다.

• 원전: Include.py

이 아래는 HelpOnMacro/Include를 그냥 옮겨 놓은 것 입니다.

이 일괄 처리 함수는 같은 누리터에 있는 위키 글월을 가져다가 넣어줍니다. 만약에 넣어 주려는 글월에도 <<Include>>가 있다면 이 또한 재귀적으로 가져다가 넣어 줍니다. 그리고 두 글월이 서로가 서로를 넣으려 할 때에는 이를 방지합니다.

쓰는 법:

• <<Include(pagename, heading, level, from="regex", to="regex", sort=ascending|descending, items=n, skipitems=n, titlesonly, editlink)>>

pagename

넣어 줄 글월의 이름. 만약에 윗꺽쇄(^)로 시작하면 정규식으로 처리하여 해당하는 모든 글월을 넣어줍니다.

heading
글월을 넣어 준 다음에 이 머리글로 연결 고리를 달아 줍니다. 머리글은 따옴표(")로 묶어야 합니다.
level
넣어 줄 글의 몇 번 째 머리글(1..5)부터 of the generated heading (optional).
from
Partial include start marker (optional).
to
Partial include end marker (optional).
sort
Sorting order when pagename is a regex, i.e. starts with a caret (optional).
items
최대 몇 개의 글월까지 넣어줄지를 알려줍니다.
skipitems
최초 몇 개의 글월까지 무시할지를 알려줍니다.
titlesonly
제목만 넣어주고 그 내용은 넣지 않습니다.
editlink
add a footer with links to the included page, both normal and edit (optional).

글월 이름(pagename)을 제외한 모든 변수는 선택 사항입니다. 그러나, 선택 사항을 쓰고 싶다면 반드시 위에서 보여준 순서를 따라야 합니다.

from 과 to 는 주석 구문도 알아보기 때문에 원하지 않는 곳에서부터 시작해서 원하지 않는 곳까지의 내용을 넣지 않도록 조심해서 사용해야 합니다.

보기:

• <<Include(WikiSandBox)>> -- WikiSandBox 글월에 있는 내용을 넣어 줍니다.

• <<Include(WikiSandBox,"모래 상자" )>> -- '모래 상자'라는 머리글로 WikiSandBox를 향하는 연결 고리를 달아줍니다.

• <<Include(WikiSandBox, , 2)>> -- add a H2 of 'Foo Bar'

• <<Include(WikiSandBox, 'All about SandBox', 2)>> -- add a H2 of 'All about SandBox'

• <<Include(WikiSandBox, , from="^----$")>> -- 처음 보이는 가로줄 이후의 내용만 넣습니다.

• <<Include(WikiSandBox, , to="^----$")>> -- 처음 보이는 가로줄 이전의 내용만 넣습니다.

• <<Include(^WikiSandBox/.*, , sort=descending)>> -- 글월 이름을 내림차순으로 하여 넣어 줍니다.

• <<Include(^WikiSandBox/.*, , items=3)>> -- 최대 세 개의 글월만 넣어 줍니다.

• <<Include(^BlogBase/.*,, to="^----$", sort=descending, items=7)>> -- 최대 일주일간의 누리적이를 넣어 줍니다.

• <<Include(^BlogBase/.*,, to="^----$", sort=descending, items=7, skipitems=7, titlesonly)>> -- 그 이전 주의 누리적이에서 제목만 보여줍니다.

• You can use these with MonthCalendar for blogging:

  • <<Include(^FirstnameLastname/20..-..-..,,to="^----",sort=descending,items=3)>> -- show 3 items out of a month calendar

  • <<Include(^FirstnameLastname/20..-..-..,,to="^----",sort=descending,items=4,skipitems=3,titlesonly)>> -- show next 4 items only with titles

InterWiki

• 사용법:
• 넘겨 주는 인자:
• 쓰임:

• 원전: InterWiki.py

LikePages

• 사용법:
• 넘겨 주는 인자:
• 쓰임:

• 원전: LikePages.py

MonthCalendar

• 사용법:
• 넘겨 주는 인자:
• 쓰임:

• 원전: MonthCalendar.py

Navigation

• 사용법:
• 넘겨 주는 인자:
• 쓰임:

• 원전: Navigation.py

NewPage

• 사용법:
• 넘겨 주는 인자:
• 쓰임:

• 원전: NewPage.py

OrphanedPages

• 사용법:
• 넘겨 주는 인자:
• 쓰임:

• 원전: OrphanedPages.py

PageCount

• 사용법:
• 넘겨 주는 인자:
• 쓰임:

• 원전: PageCount.py

PageHits

• 사용법:
• 넘겨 주는 인자:
• 쓰임:

• 원전: PageHits.py

PageList

• 사용법:
• 넘겨 주는 인자:
• 쓰임:

• 원전: PageList.py

PageSize

• 사용법:
• 넘겨 주는 인자:
• 쓰임:

• 원전: PageSize.py

RandomPage

• 사용법:
• 넘겨 주는 인자:
• 쓰임:

• 원전: RandomPage.py

RandomQuote

• 사용법:
• 넘겨 주는 인자:
• 쓰임:

• 원전: RandomQuote.py

RecentChanges

• 사용법:
• 넘겨 주는 인자:
• 쓰임:

• 원전: RecentChanges.py

ShowSmileys

• 사용법:
• 넘겨 주는 인자:
• 쓰임:

• 원전: ShowSmileys.py

StatsChart

• 사용법:
• 넘겨 주는 인자:
• 쓰임:

• 원전: StatsChart.py

SystemAdmin

• 사용법:
• 넘겨 주는 인자:
• 쓰임:

• 원전: SystemAdmin.py

SystemInfo

• 사용법:
• 넘겨 주는 인자:
• 쓰임:

• 원전: SystemInfo.py

TableOfContents

• 사용법:
• 넘겨 주는 인자:
• 쓰임:

• 원전: TableOfContents.py

TeudView

• 사용법:
• 넘겨 주는 인자:
• 쓰임:

• 원전: TeudView.py

Verbatim

• 사용법:
• 넘겨 주는 인자:
• 쓰임:

• 원전: Verbatim.py

WantedPages

• 사용법:
• 넘겨 주는 인자:
• 쓰임:

• 원전: WantedPages.py

도움말_갈래