>이 도움말은 [[doku>wiki:syntax|이 문서]]의 번역본입니다. >본 위키의 실정에 맞게 다소 변경되었습니다. - 관리자 ====== 문법 ====== [[doku>DokuWiki|도쿠위키]]는 가독성이 높은 간편한 마크업 언어를 사용합니다. 이 문서는 도쿠위키 내에서 문서를 편집하기 위해 필요한 모든 문법을 담고 있습니다. 아니면 말고요 이 문서의 원본을 보면 여러 다채로운 문법을 한눈에 볼 수 있으니, 한번 시도해 보는 것도 나쁘지 않은 생각입니다.\\ \\ 만약 그냥 문법 연습을 좀 해보고 싶으시다면, [[playground:playground|연습장]]에 가서 마음껏 놀다 오시기 바랍니다. ===== 기본적인 문법 ===== 도쿠위키는 **굵은 글꼴**, //기울임꼴//, __밑줄__, ''고정 너비 글꼴'' 등의 문법을 지원합니다. 물론 이 모두를 **__//''섞어서''//__** 쓸 수도 있습니다. 도쿠위키는 **굵은 글꼴**, //기울임꼴//, __밑줄__, ''고정 너비 글꼴'' 등의 문법을 지원합니다. 물론 이 모두를 **__//''섞어서''//__** 쓸 수도 있습니다. 아래첨자와 윗첨자도 사용하실 수 있습니다. 아래첨자와 윗첨자도 사용하실 수 있습니다. 취소선도 쉽게 그을 수 있습니다. 문장을 취소선에 싸서 드셔보세요. 취소선도 쉽게 그을 수 있습니다. 문장을 취소선에 싸서 드셔보세요. **문단**은 빈 행을 통해서 생성됩니다. 만약 문단을 생성하지 않고 **빈 행을 강제로 만들고** 싶다면, 행 끝에 백래쉬(Backlash,\)를 **두 번** 삽입하여 주시기 바랍니다. **두 번** 삽입하여 주시기 바랍니다. 이것은 행바꿈이 있는 텍스트입니다.\\ 단언컨대, 백래쉬 두개는 오직 행 끝에서만 인식됩니다.\\ 혹은 반드시\\ 띄어쓰기가 따라붙어야 합니다.\\띄어쓰기가 없으면 이런 꼴이 나죠. 이것은 행바꿈이 있는 텍스트입니다.\\ 단언컨대, 백래쉬 두개는 오직 행 끝에서만 인식됩니다.\\ 혹은 반드시\\ 띄어쓰기가 따라붙어야 합니다.\\띄어쓰기가 없으면 이런 꼴이 나죠. 빈 행을 강제로 만들 때는 이게 꼭 필요한 일인지 다시 한 번 생각하던가 말던가. 사실 관리자놈도 별로 생각 안하고 막 질러댑니다. ===== 링크 ===== 도쿠위키는 여러 가지 링크를 생성할 수 있는 기능을 제공합니다. ==== 외부 링크 ==== 외부 링크는 자동적으로 인식됩니다. http://kalaheim.egloos.com 처럼 말이죠. 중요한 건 http(s)://을 붙이는 겁니다. 물론 일반 [[#내부_링크|내부 링크]]처럼 링크해도 상관은 없습니다. [[http://kalaheim.egloos.com]]이나 [[http://kalaheim.egloos.com|이 링크는 완전 좋은 곳으로 통합니다.]]처럼. 이메일 주소는 나 [[dontsend@spams.net|스팸 보내면 죽여버린다]] 정도로 쓰시면 됩니다. 외부 링크는 자동적으로 인식됩니다. http://kalaheim.egloos.com 처럼 말이죠. 중요한 건 http(s)://을 붙이는 겁니다. 물론 일반 [[#내부_링크|내부 링크]]처럼 링크해도 상관은 없습니다. [[http://kalaheim.egloos.com]]이나 [[http://kalaheim.egloos.com|이 링크는 완전 좋은 곳으로 통합니다.]]처럼. 이메일 주소는 나 [[dontsend@spams.net|스팸 보내면 죽여버린다]] 정도로 쓰시면 됩니다. ==== 내부 링크 ==== 내부 링크는 대괄호를 사용하여 생성할 수 있습니다. 간단히 [[:frontpage]]라고 쓰거나, 좀 더 고급스럽게 [[:frontpage|대문]]으로 생성하세요. 내부 링크는 대괄호를 사용하여 생성할 수 있습니다. 간단히 [[FrontPage]]라고 쓰거나, 좀 더 고급스럽게 [[FrontPage|대문]]으로 생성하세요. [[네임스페이스:네임스페이스]]를 이용하고 싶다면 콜론을 넣어주세요. [[네임스페이스:네임스페이스]]를 이용하고 싶다면 콜론을 넣어주세요. 네임스페이스에 대한 자세한 사항이 궁금하면 500원 [[doku>namespaces|이 문서]]를 읽어주시기 바랍니다. 문서의 특정 부분으로 링크를 하는 것도 가능합니다. 그냥 #을 넣고, 그 뒤에 문단 제목을 넣어주세요. 예를 들어 이 문단으로 가는 링크는 [[문법_도움말#내부_링크|이렇게]]. 예를 들어 이 문단으로 가는 링크는 [[문법_도움말#내부_링크|이렇게]]. 주의사항: * [[:frontpage|존재하는 항목]]으로의 링크는 [[:존재하지_않는_항목]]으로 가는 링크와 다르게 표시됩니다. 힌트는 색깔. * 도쿠위키는 [[wp>Principality_of_Sealand]] 같은 인터위키 링크를 기본적으로 생성하지 않지만, [[doku>config]] 파일을 고치면 자동으로 생성하게 됩니다. 물론 이건 여러분과는 관계가 없으니, 인터위키 링크를 지원했으면 하는 조흔 위키 사이트가 있다면 관리자에게 문의하세요. * 아마 귀찮아서 안해줄 겁니다. * 문단 제목이 바뀌면 이전에 만들어둔 문단 링크는 쓸모없게 됩니다. 너무 이쪽에 의지하지는 마세요. ==== 리다이렉트 ==== 본 위키에는 리다이렉트 플러그인이 설치되어 있습니다. 리다이렉트 문서를 생성하고 싶은 경우, #Redirect 문서이름 로 작성해 주시면 됩니다. 문서 이름에서 띄어쓰기는 언더바(_)로 지정되고 있습니다. ==== 인터위키 ==== 도쿠위키는 [[doku>Interwiki|인터위키]] 링크를 지원합니다. 인터위키 링크는 다른 위키로 빠르게 갈 수 있는 좋은 수단입니다. 예를 들어 영문 위키피디아 페이지로 링크하고 싶다면 [[wp>Wiki]] 같은 식으로. 도쿠위키는 [[doku>Interwiki|인터위키]] 링크를 지원합니다. 인터위키 링크는 다른 위키로 빠르게 갈 수 있는 좋은 수단입니다. 예를 들어 영문 위키피디아 페이지로 링크하고 싶다면 [[wp>Wiki]] 같은 식으로. ==== 이미지 링크 ==== 이미지를 사용해서 다른 내부 혹은 외부 페이지로 링크를 걸 수도 있습니다. 방법은 간단해요. 링크와 [[#미디어_파일|이미지]]의 문법을 섞으면 됩니다. 바로 이렇게: [[http://kalaheim.egloos.com|{{wiki:dokuwiki-128.png}}]] [[http://kalaheim.egloos.com|{{wiki:dokuwiki-128.png}}]] **어때요, 참 쉽죠?** 또한 이미지를 넣기 위해 쓸 수 있는 다른 문법 구문도 섞어서 쓸 수 있습니다. ===== 각주 ===== 소괄호를 두 번씩 중첩해서 쓰면 각주((이것은 각주입니다.))를 추가할 수 있습니다. 소괄호를 두 번씩 중첩해서 쓰면 각주((이것은 각주입니다.))를 추가할 수 있습니다. ===== 문단 제목, 수평선 ===== 등호를 2개부터 6개까지 사용하면 다섯 가지 다른 크기의 문단 제목을 생성할 수 있습니다. 만약 3개 이상의 문단 제목이 있다면 문서의 시작 부분에 **목차**가 자동으로 생성됩니다. 만약 목차가 생기는 게 싫다면 아주 간단히 **~~NOTOC~~**를 삽입해 주면 됩니다. ====== 1단계 헤드라인 ====== ===== 2단계 헤드라인 ===== ==== 3단계 헤드라인 ==== === 4단계 헤드라인 === == 5단계 헤드라인 == ====== 1단계 헤드라인 ====== ===== 2단계 헤드라인 ===== ==== 3단계 헤드라인 ==== === 4단계 헤드라인 === == 5단계 헤드라인 == 수평선은 하이픈(-)을 4개 이상 넣어서 만들 수 있습니다. ---- ----- ---- ----- ===== 미디어 파일 ===== 중괄호를 두 번씩 중첩해서 쓰면 외부 혹은 내부에서 [[doku>images|이미지, 비디오 등 미디어 파일들]]을 끌어올 수 있습니다. 만약 원한다면 크기도 지정해 줄 수 있습니다. 원본 크기: {{wiki:dokuwiki-128.png}} 주어진 너비로 리사이즈: {{wiki:dokuwiki-128.png?50}} 주어진 너비와 높이로 리사이즈((만약 비율이 맞지 않는다면, 비율에 맞도록 잘라낸 다음에 리사이즈됩니다.)): {{wiki:dokuwiki-128.png?200x50}} 외부 이미지: {{https://www.dokuwiki.org/lib/tpl/dokuwiki/images/logo.png}} 원본 크기: {{wiki:dokuwiki-128.png}} 주어진 너비로 리사이즈: {{wiki:dokuwiki-128.png?50}} 주어진 너비와 높이로 리사이즈: {{wiki:dokuwiki-128.png?200x50}} 외부 이미지: {{https://www.dokuwiki.org/lib/tpl/dokuwiki/images/logo.png}} 왼쪽이나 오른쪽에 빈칸을 두면 정렬 방향을 정할 수 있습니다. {{ wiki:dokuwiki-128.png}} {{wiki:dokuwiki-128.png }} {{ wiki:dokuwiki-128.png }} {{ wiki:dokuwiki-128.png}} {{wiki:dokuwiki-128.png }} {{ wiki:dokuwiki-128.png }} 아참, 이미지 위에 마우스를 올리면 캡션이 나오게 할 수도 있습니다. {{ wiki:dokuwiki-128.png |이거슨 캡션입니다.}} {{ wiki:dokuwiki-128.png |이거슨 캡션입니다.}} 이미지 아래에 뭔가 연관성 있는 서술을 예쁘게 적고 싶다면, 표 기능을 응용해도 됩니다. 표 기능은 [[#표|아래쪽]]에서 설명할게요. |{{ wiki:dokuwiki-128.png }}| | 이거슨 설명입니다 | |{{ wiki:dokuwiki-128.png }}| | 이거슨 설명입니다 | 만약 이미지를 이용해서 링크를 만들고 싶다면, [[#이미지_링크|위쪽]]으로 가세요. ==== 지원하는 미디어 형식 ==== 도쿠위키는 다음 형식의 미디어를 지원합니다. | 이미지 | ''gif'', ''jpg'', ''png'' | | 비디오 | ''webm'', ''ogv'', ''mp4'' | | 오디오 | ''ogg'', ''mp3'', ''wav'' | | 플래시 | ''swf'' | 만약 지원하지 않는 형식의 미디어 파일을 지정할 경우, 링크 형태로 나타납니다. 지원하는 형식의 미디어일지라도 **?linkonly** 구문을 덧붙이면 미디어가 본문 내에 바로 나오지 않고 링크 형태로 나타납니다. {{wiki:dokuwiki-128.png?linkonly}} {{wiki:dokuwiki-128.png?linkonly}} 이렇게요. ==== 호환성 ==== 안타깝게도 어떤 브라우저는 도쿠위키가 지원하는 비디오, 오디오 포맷 중 일부 혹은 전부를 지원하지 못할 수도 있습니다. 이 문제점을 해결하려면 비디오나 오디오를 서로 다른 포맷으로 저장해서 최대한의 호환성을 끌어내야 합니다.\\ \\ **이건 그냥 쌩까세요.** 지원하건 말건 알 게 뭐야. 이 호스팅 계정은 노예계약이라서 중간에 증설 못한다고요. 그러니까 유튜브 ㄱㄱ, ㅇㅋ? ===== 목록 ===== 도쿠위키는 순번이 있거나 없는 목록 생성을 지원합니다. 만약 목록을 생성하고 싶으시다면 일단 두 칸 띄고 시작하세요. 그 후에 *이나 -을 덧붙이면 됩니다. *은 순번이 없는 목록이고, -은 순번이 있는 목록입니다. * 이거슨 목록입니다. * 두 번째 항목 * 깊이도 다르게 만들 수 있어욤. * 아옳옳옳! - 이거슨 순번 있는 목록 - 두 번째 항목 - 깊이도 다르게 만들 수 있어욤. - 아옳옳옳! * 이거슨 목록입니다. * 두 번째 항목 * 깊이도 다르게 만들 수 있어욤. * 아옳옳옳! - 이거슨 순번 있는 목록 - 두 번째 항목 - 깊이도 다르게 만들 수 있어욤. - 아옳옳옳! 더 자세한 사항은 [[doku>faq:lists|목록 FAQ]]를 참고하세요. ===== 문자열 변환 ===== 도쿠위키는 미리 지정되어 있는 문자열을 이미지, 이모티콘, 다른 문자열이나 HTML 등으로 변환할 수 있습니다. 이 기능은 대체로 스마일리 이모티콘을 만드는 데 쓰입니다. 또한 쓰기 어려운 특수한 문자열을 대체하기 위해서도 쓰이지만, 다른 목적으로도 역시 전용이 가능합니다. ==== 문자열-이미지 변환 ==== 도쿠위키는 서양권에서 많이 쓰이는 [[wp>emoticon|이모티콘]]을 미리 기억해 두고 있습니다. 이 이모티콘을 입력하면 적절한 스마일리 이모티콘으로 변경됩니다. 아래는 도쿠위키에 포함되어 있는 이모티콘의 목록입니다. * 8-) %% 8-) %% * 8-O %% 8-O %% * :-( %% :-( %% * :-) %% :-) %% * =) %% =) %% * :-/ %% :-/ %% * :-\ %% :-\ %% * :-? %% :-? %% * :-D %% :-D %% * :-P %% :-P %% * :-O %% :-O %% * :-X %% :-X %% * :-| %% :-| %% * ;-) %% ;-) %% * ^_^ %% ^_^ %% * :?: %% :?: %% * :!: %% :!: %% * LOL %% LOL %% * FIXME %% FIXME %% * DELETEME %% DELETEME %% 한국에서는 잘 안 쓰이는 이모티콘들이니 신경 꺼도 괜찮아요. ==== 문자열-HTML 변환 ==== 입력하기 다소 어려운 몇몇 특수문자를 간단하게 입력할 수 있습니다. -> <- <-> => <= <=> >> << -- --- (c) (tm) (r) -> <- <-> => <= <=> >> << -- --- (c) (tm) (r) 다른 것들도 추가할 수는 있습니다. [[doku>entities|pattern file]]을 고치기만 하면요. 하지만 관리자는 나태하고 귀차니즘 쩌는 사람이니까 그런 거 없습니다. ===== 인용구 ===== 가끔 위키질을 하다 보면 인용구를 넣어서 이게 코멘트나 답변, 실제로 한 발언 등등이라는 것을 표시할 필요성이 있습니다. 그렇다면 다음 문법을 사용해 보세요. 아, 아들아. > 더 이상 백성을 위해 희생하실 필요 없습니다. 왕관의 무게를 감당할 필요도 없습니다. 제가 모든 걸 책임질 테니까요. >> 무슨 일이냐? 뭐 하는 게냐, 아들아? > 왕위를 물려받는 겁니다, 아버지. >> 이 왕국은 멸망할 것이다 >>> 그리고 잿더미에서 새로운 질서가 탄생해 세상의 기반을 모조리 흔들어놓을 것이다!" 아, 아들아. > 더 이상 백성을 위해 희생하실 필요 없습니다. 왕관의 무게를 감당할 필요도 없습니다. 제가 모든 걸 책임질 테니까요. >> 무슨 일이냐? 뭐 하는 게냐, 아들아? > 왕위를 물려받는 겁니다, 아버지. >> 이 왕국은 멸망할 것이다 >>> 그리고 잿더미에서 새로운 질서가 탄생해 세상의 기반을 모조리 흔들어놓을 것이다!" ===== 표 ===== 도쿠위키의 표 문법을 이용하면 아주 간단하게 세련된 표를 생성할 수 있습니다. ^ 제목 하나 ^ 제목 두울 ^ 제목 세엣 ^ | 11 | 12 | 13 | | 21 | 셀 합치기 || | 셀 합치기 | 32 | 33 | | ::: | 42 | 43 | 표는 **|**로 시작하고 끝납니다. 범례, 제목, 기타 중요한 칸이라서 강조하고 싶은 칸은 **^**으로 시작하면 됩니다. ^ 제목 하나 ^ 제목 두울 ^ 제목 세엣 ^ | 11 | 12 | 13 | | 21 | 셀 합치기 || | 셀 합치기 | 32 | 33 | | ::: | 42 | 43 | 양 옆에 있는 칸을 합치려면 그냥 그 다음 칸을 완전히 비워주세요. 만약 위아래로 있는 칸을 합치고자 한다면, 위쪽 칸에만 내용을 쓰고 아래쪽 칸엔 **:::**을 쓰면 됩니다. 기억해야 할 점은, 각 줄마다 코드 기준으로 모두 같은 양의 셀이 존재해야 한다는 겁니다. 또한, 셀의 내용을 원하는 방향으로 정렬할 수도 있습니다. 아래쪽을 참고하세요. ^ 표 정렬하기 ^^^ | 오른쪽| 가운데 |왼쪽 | ^ 표 정렬하기 ^^^ | 오른쪽| 가운데 |왼쪽 | ===== 위키문법 적용하지 않기 ===== 만약 위키문법을 적용하지 않고, 타이핑한 코드 그 자체를 보여주고 싶다면 텍스트를 %%로 감싸거나 구문을 사용하면 됩니다. http://warning.or.kr 쿵쿵따리 쿵쿵따 **신나는** //워닝소리// %%__워닝워닝 워닝소리 워닝일레븐__%% http://warning.or.kr 쿵쿵따리 쿵쿵따 **신나는** //워닝소리// %%__워닝워닝 워닝소리 워닝일레븐__%% ===== 코드 블록 ===== 문서에 코드 블록을 넣고 싶다면 , 구문을 사용하거나, 그냥 단순히 각 줄마다 맨 앞에 두 칸씩 빈칸을 넣어주세요. 10 PRINT "Hello, World!" 20 END main( ) { puts("Hello, world!"); return 0; program Print *, "Hello, world!" End 위쪽에 있는 세 개의 코드 블록은 이렇게 탄생했습니다: 10 PRINT "Hello, World!" 20 END main( ) { puts("Hello, world!"); return 0; program Print *, "Hello, world!" End ===== HTML과 PHP 코드 넣기 ===== HTML과 PHP 코드를 그대로 문서에 넣고 싶다면 , 구문을 쓰면 됩니다.\\ \\ **하지만 이 위키는 레드위키잖아요?** 그딴 게 무슨 소용이에요. 그냥 잊어버리세요. 따, 딱히 귀찮아서 번역 안한 건 아니야! 사실 맞아요