차이

문서의 선택한 두 판 사이의 차이를 보여줍니다.

차이 보기로 링크

다음 판
이전 판
wiki:syntax [2018/06/17 02:05]
127.0.0.1 바깥 편집
wiki:syntax [2018/07/05 01:15]
jangi 만듦
줄 1: 줄 1:
-====== ​Formatting Syntax ​======+====== ​개괄 ​======
  
-[[doku>​DokuWiki]] ​supports some simple markup language, which tries to make the datafiles to be as readable as possibleThis page contains all possible syntax you may use when editing the pagesSimply have a look at the source of this page by pressing "Edit this page". If you want to try something, just use the [[playground:​playground|playground]] pageThe simpler markup is easily accessible via [[doku>toolbar|quickbuttons]], too.+[[doku>​DokuWiki]]에서 사용하는 몇 가지 문법입니다문서를 보기 좋게 꾸밀 수 있습니다아시다시피 ​[[wiki:​playground|연습장]] 에서 연습해 보실 수 있습니다문법을 몰라도 위의 편집툴바를 이용하면 조금 꾸밀 수 있습니다. 툴바에 대한 설명은 ​[[https://​www.dokuwiki.org/​start?​id=ko:​toolbar|quickbuttons]] ​를 참고 하세요.
  
-===== Basic Text Formatting ​=====+===== 기본 꾸미기 ​=====
  
-DokuWiki supports ​**bold**, //italic//, __underlined__ and ''​monospaced'' ​textsOf course you can **__//''​combine''//​__** ​all these.+**진하게**, //기울임//, __밑줄__, ​''​글상자''​, <​del>​취소선</​del>​ 기능. 물론 중복 사용됩니다. **__//''​<​del>​글상자 속에 진하고 밑줄 친 기울인 글자들에 취소선 긋기</​del>​''//​__**
  
-  ​DokuWiki supports ​**bold**, //italic//, __underlined__ and ''​monospaced''​ texts. +  ​사용법: ​**진하게**, //기울임//, __밑줄__ ​ 
-  Of course you can **__//''​combine''/​/__** all these.+          ''​글상자(작은따옴표 두 개 사용)''​, <​del>​취소선<​/del>
  
-You can use <sub>subscript</​sub>​ and <sup>superscript</​sup>​, too.+<sub>아래 첨자</​sub>​ and <sup>위첨자</​sup> ​기능.
  
-  ​You can use <sub>subscript</​sub> ​and <sup>superscript</​sup>​, too.+  ​아래 첨자는 ​<sub>아래 첨자</​sub>​, 위첨자는 ​<sup>위 첨자</​sup> ​처럼 기호를 사용
  
-You can mark something as <​del>​deleted</​del>​ as well.+산문에서 **문단**은 한줄을 비우면 됩니다(엔터 두 번). 엔터 한 번으로는 줄바꿈 기능이 없습니다. 운문에서 행을 바꾸려면 백슬래시를 두 개(\\) 쓰면 됩니다. 운문에서 연을 바꾸려면 산문처럼 엔터를 두 번 치면 됩니다. 아래에서 비교해 보세요.
  
-  ​You can mark something as <​del>​deleted</​del>​ as well.+  ​나 보기가 역겨워 (엔터) 가실 때에는 
 +   
 +  나 보기가 역겨워\\ 
 +  가실 때에는
  
-**Paragraphs** are created from blank lines. If you want to **force a newline** without a paragraph, you can use two backslashes followed by a whitespace or the end of line.+===== 링크 =====
  
-This is some text with some linebreaks\\ Note that the +글 속에 링크를 걸 수 있습니다. 툴바를 이용해서 링크를 걸 수도 있지만 위키 문법을 쓰면 더 편리합니다
-two backslashes are only recognized at the end of a line\\ +
-or followed by\\ a whitespace \\this happens without it.+
  
-  This is some text with some linebreaks\\ Note that the +외부 링크는 www.google.com 주소를 쓰면 바로 링크가 걸립니다. 만약 [[http://​www.google.com|구글]] 이런 식으로 멋지게 걸고 싶으면 아래처럼 쓰세요.
-  two backslashes are only recognized at the end of a line\\ +
-  or followed by\\ a whitespace \\this happens without it.+
  
-You should use forced newlines only if really needed.+  [[http://​www.google.com|구글]]
  
-===== Links =====+위키위키를 쓰는 가장 큰 목적. 내부 문서 링크는 다음과 같습니다. 우선, 내부 문서의 제목을 쓴 후 대괄호 두 개로 그 제목을 감싸면 됩니다. [[playground]] 이렇게요.
  
-DokuWiki supports multiple ways of creating links.+문서 제목을 그대로 거는 게 재미 없거나, 다른 이름을 통해 내부 문서로 연결하려면 외부 링크와 마찬가지로 노출하고 싶은 말을 뒤에 붙여 주세요. [[playground|아무 말이나 적었다가 지우는 곳. 영어로 Sandbox]] 이렇게요.
  
-==== External ==== 
  
-External links are recognized automagically:​ http://​www.google.com or simply www.google.com - You can set the link text as well: [[http://www.google.com|This Link points to google]]. Email addresses like this one: <​andi@splitbrain.org>​ are recognized, too.+  ​[[playground]] 
 +  [[playground|아무 말이나 적었다가 지우는 곳영어로 Sandbox]]
  
-  DokuWiki supports multiple ways of creating links. External links are recognized +카테고리 등을 이용해 하위분류를 만들고 싶으면 ​:을 찍고 왼쪽에 카테고리명오른쪽에 문서 제목을 쓰면 됩니다.
-  automagicallyhttp://​www.google.com or simply www.google.com - You can set +
-  link text as well: [[http://​www.google.com|This Link points to google]]. Email +
-  addresses like this one: <​andi@splitbrain.org>​ are recognizedtoo.+
  
-==== Internal ====+  [[카테고리:​문서 제목]] 
 +  [[wiki:​playground]]
  
-Internal links are created by using square bracketsYou can either just give a [[pagename]] or use an additional [[pagename|link text]].+문서의 특정 영역으로 링크를 걸 수도 있습니다. [[syntax#​목록 만들기|목록 만들기]] 이때는 문서 제목 뒤에 #를 쓰고 그 뒤에 섹션명을 쓰면 됩니다.
  
-  ​Internal links are created by using square brackets. You can either just give +  [[syntax#목록 만들기|목록 만들기]] 이렇게요
-  a [[pagename]] or use an additional [[pagename|link text]]. +  ​하지만 문서는 자주 편집되고 섹션도 바뀌므로 섹션 링크에 너무 의존하지 마시고 문서 자체를 링크하는 것이 더 낫습니다
- +   
-[[doku>​pagename|Wiki pagenames]] are converted to lowercase automatically,​ special characters are not allowed. +지금 이 문서도 섹션으로 나뉘어 있습니다섹션별로 편집도 가능합니다섹션은 다음과 같이 만듭니다.
- +
-You can use [[some:​namespaces]] by using a colon in the pagename. +
- +
-  You can use [[some:​namespaces]] by using a colon in the pagename. +
- +
-For details about namespaces see [[doku>​namespaces]]. +
- +
-Linking to a specific section is possible, too. Just add the section name behind a hash character as known from HTML. This links to [[syntax#internal|this Section]]. +
- +
-  ​This links to [[syntax#​internal|this Section]]. +
- +
-Notes: +
- +
-  ​* Links to [[syntax|existing pages]] are shown in a different style from [[nonexisting]] ones. +
-  * DokuWiki does not use [[wp>​CamelCase]] to automatically create links by default, but this behavior can be enabled in the [[doku>​config]] fileHint: If DokuWiki is a link, then it's enabled. +
-  * When a section'​s heading is changed, its bookmark changes, too. So don't rely on section linking too much. +
- +
-==== Interwiki ==== +
- +
-DokuWiki supports [[doku>​Interwiki]] links. These are quick links to other Wikis. For example this is a link to Wikipedia'​s page about Wikis: [[wp>​Wiki]]. +
- +
-  DokuWiki supports [[doku>​Interwiki]] links. These are quick links to other Wikis. +
-  For example this is a link to Wikipedia'​s page about Wikis: [[wp>​Wiki]]. +
- +
-==== Windows Shares ==== +
- +
-Windows shares like [[\\server\share|this]] are recognized, too. Please note that these only make sense in a homogeneous user group like a corporate [[wp>​Intranet]]. +
- +
-  Windows Shares like [[\\server\share|this]] are recognized, too. +
- +
-Notes: +
- +
-  * For security reasons direct browsing of windows shares only works in Microsoft Internet Explorer per default (and only in the "local zone"​). +
-  * For Mozilla and Firefox it can be enabled through different workaround mentioned in the [[http://​kb.mozillazine.org/​Links_to_local_pages_do_not_work|Mozilla Knowledge Base]]. However, there will still be a JavaScript warning about trying to open a Windows Share. To remove this warning (for all users), put the following line in ''​conf/​userscript.js'':​ +
- +
-  LANG.nosmblinks = '';​ +
- +
-==== Image Links ==== +
- +
-You can also use an image to link to another internal or external page by combining the syntax for links and [[#​images_and_other_files|images]] (see below) like this: +
- +
-  [[http://​www.php.net|{{wiki:​dokuwiki-128.png}}]] +
- +
-[[http://​www.php.net|{{wiki:​dokuwiki-128.png}}]] +
- +
-Please note: The image formatting is the only formatting syntax accepted in link names. +
- +
-The whole [[#​images_and_other_files|image]] and [[#​links|link]] syntax is supported (including image resizing, internal and external images and URLs and interwiki links).+
  
-===== Footnotes ​=====+  ​===== 섹션 제목 ​=====
  
-You can add footnotes ((This is a footnote)) by using double parentheses.+다른 위키위키 사이트의 문서를 연결할 때는 좀 더 쉽습니다. 위키페디아 한글판에 연결하시려면 [[wp>​동남_방언|위키페디아의 동남 방언 항목]] 이렇게, **나무위키**에 연결하시려면 [[nw>​동남 방언|나무위키의 동남 방언 항목]] 이렇게.
  
-  ​You can add footnotes ((This is a footnote)) by using double parentheses.+  ​다른 위키위키 사이트의 문서를 연결할 때는 좀 더 쉽습니다.  
 +  위키페디아 한글판에 연결하시려면 [[wp>​동남_방언|위키페디아의 동남 방언 항목]] 이렇게,  
 +  **나무위키**에 연결하시려면 [[nw>​동남 방언|나무위키의 동남 방언 항목]] 이렇게.
  
-===== Sectioning =====+문서에 주석을 달 수도 있습니다((맨 아래에서 만나요)). 당연히 주석은 여러 개 달 수 있습니다.((두번째 주석))
  
-You can use up to five different levels of headlines to structure your contentIf you have more than three headlines, a table of contents is generated automatically -- this can be disabled by including the string ''<​nowiki>​~~NOTOC~~</​nowiki>''​ in the document.+  문장((주석 내용)) 이렇게 괄호 두 개를 씁니다번호는 자동으로 매겨집니다.
  
-==== Headline Level 3 ==== +섹션 만드는 법을 좀 더 소개합니다. 섹션은 글에 구조를 부여합니다. 섹션이 세 개 이상이면 목차가 자동 생성됩니다. 만약 섹션이 세 개 이상인데 목차가 없는 것을 원하면 ''<​nowiki>​~~NOTOC~~</​nowiki>''​ 라고 문서의 맨 위에 쓰세요.
-=== Headline Level 4 === +
-== Headline Level 5 ==+
  
-  ​==== Headline Level 3 ==== +==== 장 ==== 
-  === Headline Level 4 === +=== 절 === 
-  == Headline Level 5 ==+== 그 아래 ​==
  
-By using four or more dashes, you can make a horizontal line:+  ==== 장 ==== 
 +  === 절 === 
 +  == 그 아래 ==
  
 +이걸 쓸 일이 있을까 싶지만 - 기호를 네 번 이어 쓰면 ''​----''​ 가로줄이 생깁니다. 뭔가를 구분하기 좋겠지요?​
 ---- ----
 +  ​
  
-===== Media Files ===== +===== 그림, 소리, 동영상 ​=====
- +
-You can include external and internal [[doku>​images|images,​ videos and audio files]] with curly brackets. Optionally you can specify the size of them.+
  
 Real size:                        {{wiki:​dokuwiki-128.png}} Real size:                        {{wiki:​dokuwiki-128.png}}
줄 130: 줄 81:
 Resize to given width: ​           {{wiki:​dokuwiki-128.png?​50}} Resize to given width: ​           {{wiki:​dokuwiki-128.png?​50}}
  
-Resize to given width and height((when the aspect ratio of the given width and height doesn'​t match that of the image, it will be cropped to the new ratio before resizing)): {{wiki:​dokuwiki-128.png?​200x50}}+Resize to given width and height: {{wiki:​dokuwiki-128.png?​200x50}}
  
 Resized external image: ​          ​{{http://​de3.php.net/​images/​php.gif?​200x50}} Resized external image: ​          ​{{http://​de3.php.net/​images/​php.gif?​200x50}}
줄 140: 줄 91:
  
  
-By using left or right whitespaces you can choose the alignment.+빈칸을 하나씩 넣어주면 문서 속에서 그림을 좌우정렬할 수 있습니다직관적이지 않습니까?​
  
 {{ wiki:​dokuwiki-128.png}} {{ wiki:​dokuwiki-128.png}}
줄 148: 줄 99:
 {{ 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 }}
  
-Of course, you can add a title (displayed as a tooltip by most browsers), too.+그림에 캡션을 넣을 수 있습니다. 링크를 걸 때처럼 | 표시 뒤에 써 줍니다.
  
-{{ wiki:​dokuwiki-128.png |This is the caption}}+{{ wiki:​dokuwiki-128.png |이 그림에 대한 설명}}
  
-  {{ wiki:​dokuwiki-128.png |This is the caption}}+  {{ wiki:​dokuwiki-128.png |이 그림은 가운데 정렬되었습니다.}}
  
-For linking an image to another page see [[#Image Links]] above. 
  
-==== Supported Media Formats ​====+==== 지원하는 매체 ​====
  
-DokuWiki can embed the following media formats directly.+이것들은 파일명만 잘 적으면 자동으로 문서에서 보여집니다
  
 | Image | ''​gif'',​ ''​jpg'',​ ''​png'' ​ | | Image | ''​gif'',​ ''​jpg'',​ ''​png'' ​ |
줄 169: 줄 119:
 | Flash | ''​swf'' ​                   | | Flash | ''​swf'' ​                   |
  
-If you specify a filename that is not a supported media format, then it will be displayed as a link instead. 
  
-==== Fallback Formats ====+동영상 파일을 올리고 다음과 같이 적어주시면 됩니다.
  
-Unfortunately not all browsers understand all video and audio formats. To mitigate the problem, you can upload your file in different formats for maximum browser compatibility.+  {{video.mp4|동기 유발 자료}}
  
-For example consider this embedded mp4 video:+만약 동영상 파일과 같은 이름의 .jpg 나 .png 파일을 같은 폴더에 올려 두시면 동영상이 재생되기 전에 늘 그 이미지가 보일 것입니다. 일종의 포스터지요.
  
-  {{video.mp4|A funny video}}+===== 목록 만들기 =====
  
-When you upload a ''​video.webm''​ and ''​video.ogv''​ next to the referenced ''​video.mp4'',​ DokuWiki will automatically add them as alternatives so that one of the three files is understood by your browser.+두 칸을 띄우고 * 를 적어 주시면 목록이 만들어집니다하위 목록은 두 칸 더 띄우고 *를 적어 주시면 됩니다.
  
-Additionally DokuWiki supports a "​poster"​ image which will be shown before the video has started. That image needs to have the same filename as the video and be either a jpg or png file. In the example above a ''​video.jpg''​ file would work.+  * 서론 
 +  * 본론 
 +    * 본론1 
 +    * 본론2 
 +  * 결론
  
-===== Lists =====+숫자 목록도 만들 수 있습니다. 두 칸을 띄우고 - 를 적어 주면 됩니다. 하위 목록은 두 칸 더 띄우고 -를 적어 주시면 됩니다.
  
-Dokuwiki supports ordered and unordered lists. To create a list item, indent your text by two spaces and use a ''​*''​ for unordered lists or a ''​-''​ for ordered ones.+  ​서론 
 +  - 본론 
 +    - 본론1 
 +    - 본론2 
 +  - 결론
  
-  ​This is a list +<​code>​ 
-  * The second item +  ​서론 
-    * You may have different levels +  * 본론 
-  * Another item+    * 본론1 
 +    * 본론2 
 +  * 결론
  
-  - The same list but ordered +  - 서론 
-  - Another item +  - 본론 
-    - Just use indention for deeper levels +    - 본론1 
-  - That's it+    - 본론2 
 +  - 결론
  
-<​code>​ 
-  * This is a list 
-  * The second item 
-    * You may have different levels 
-  * Another item 
- 
-  - The same list but ordered 
-  - Another item 
-    - Just use indention for deeper levels 
-  - That's it 
 </​code>​ </​code>​
  
 Also take a look at the [[doku>​faq:​lists|FAQ on list items]]. Also take a look at the [[doku>​faq:​lists|FAQ on list items]].
  
-===== Text Conversions ===== +==== 이모티콘 또는 이모지 ​====
- +
-DokuWiki can convert certain pre-defined characters or strings into images or other text or HTML. +
- +
-The text to image conversion is mainly done for smileys. And the text to HTML conversion is used for typography replacements,​ but can be configured to use other HTML as well. +
- +
-==== Text to Image Conversions ​====+
  
-DokuWiki converts commonly used [[wp>​emoticon]]s to their graphical equivalents. Those [[doku>​Smileys]] and other images can be configured and extended. Here is an overview of Smileys included in DokuWiki:+아래 그림 옆의 기호를 기억하세요 ^^
  
   * 8-) %%  8-)  %%   * 8-) %%  8-)  %%
줄 242: 줄 186:
   * DELETEME %% DELETEME %%   * DELETEME %% DELETEME %%
  
-==== Text to HTML Conversions ​====+==== 특수기호 ​====
  
-Typography: [[DokuWiki]] can convert simple text characters to their typographically correct entities. Here is an example of recognized characters.+아래와 같은 특수 기호를 연습해 보세요.
  
 -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
줄 254: 줄 198:
 </​code>​ </​code>​
  
-The same can be done to produce any kind of HTML, it just needs to be added to the [[doku>​entities|pattern file]].+===== 인용하여 대댓글처럼 달기 =====
  
-There are three exceptions which do not come from that pattern file: multiplication entity (640x480)'​single'​ and "​double quotes"​. They can be turned off through a [[doku>config:​typography|config option]].+아래처럼 층위를 표현할 수 있으나보통은 ​하나를 넣어서 인용구임을 보여주는 정도로 사용됩니다.
  
-===== Quoting ===== +  우린 아마 안 될 거야.
- +
-Some times you want to mark some text to show it's a reply or commentYou can use the following syntax: +
- +
-  I think we should do it+
   ​   ​
-  > No we shouldn'​t+  > 할 수 있어.
   ​   ​
-  >> ​WellI say we should+  >> ​아냐안 될 거 같은데.
   ​   ​
-  > Really?+  > 맞아, 안 될 거야.
   ​   ​
-  >> ​Yes!+  >> ​할 수 있다니까
   ​   ​
-  >>> ​Then lets do it! +  >>> ​그럼 한 번 해 보자.
- +
-I think we should do it +
- +
-> No we shouldn'​t +
- +
->> Well, I say we should +
- +
-> Really? +
- +
->> Yes!+
  
->>> ​Then lets do it!+우린 아마 안 될 거야.\\ 
 +할 수 있어.\\ 
 +>> ​아냐, 안 될 거 같은데.\\ 
 +> 맞아, 안 될 거야.\\ 
 +>> 할 수 있다니까\\ 
 +>>>​ 그럼 한 번 해 보자.\\
  
-===== Tables ​=====+===== 표 만들기 ​=====
  
 DokuWiki supports a simple syntax to create tables. DokuWiki supports a simple syntax to create tables.
줄 348: 줄 283:
 Note: Vertical alignment is not supported. Note: Vertical alignment is not supported.
  
-===== No Formatting ​=====+===== 위키 문법 무시하기 ​===== 
 + 
 +'나 *같은 위키 문법 기호를 문장에서 막 쓰다 보면 이게 문법으로 먹혀 버려서 곤란합니다. 그럴 때는 ''​%%<​nowiki>​%%''​ 로 글의 앞뒤를 감싸거나 ''<​nowiki>​%%</​nowiki>''​. 를 글의 앞뒤로 감싸면 됩니다. 지금 % 두 개를 표현하기 위해((%를 두 번 써 버리면 또 문법으로 먹혀버리니까) % 를 한 번 사용한 부분이 함정. 
  
-If you need to display text exactly like it is typed (without any formatting),​ enclose the area either with ''​%%<​nowiki>​%%''​ tags or even simpler, with double percent signs ''<​nowiki>​%%</​nowiki>''​. 
  
 <​nowiki>​ <​nowiki>​
-This is some text which contains addresses like this: http://​www.splitbrain.org ​and **formatting**, but nothing is done with it.+지금 ​http://​www.splitbrain.org ​에 자동 링크가 걸리지 않았고  ​**formatting** ​이 글자가 진해지지 않은 이유.
 </​nowiki>​ </​nowiki>​
-The same is true for %%//__this__ text// with a smiley ​;-)%%.+%%//__밑줄도__ 기울임도// 이모티콘도 안 먹힘 ​;-)%%.
  
   <​nowiki>​   <​nowiki>​
-  ​This is some text which contains addresses like this: http://​www.splitbrain.org ​and **formatting**, but nothing is done with it.+  ​지금 ​http://​www.splitbrain.org ​에 자동 링크가 걸리지 않았고  ​**formatting** ​이 글자가 진해지지 않은 이유.
   </​nowiki>​   </​nowiki>​
-  ​The same is true for %%//__this__ text// with a smiley ​;-)%%. +  %%//__밑줄도__ 기울임도// 이모티콘도 안 먹힘 ​;-)%%. 
- +   
-===== Code Blocks ​=====+  ​ 
 +===== 이 아래는 참고만. ​=====
  
 You can include code blocks into your documents by either indenting them by at least two spaces (like used for the previous examples) or by using the tags ''​%%<​code>​%%''​ or ''​%%<​file>​%%''​. You can include code blocks into your documents by either indenting them by at least two spaces (like used for the previous examples) or by using the tags ''​%%<​code>​%%''​ or ''​%%<​file>​%%''​.
줄 474: 줄 412:
  
 ===== RSS/ATOM Feed Aggregation ===== ===== RSS/ATOM Feed Aggregation =====
-[[DokuWiki]] can integrate data from external XML feeds. For parsing the XML feeds, [[http://​simplepie.org/​|SimplePie]] is used. All formats understood by SimplePie can be used in DokuWiki as well. You can influence the rendering by multiple additional space separated parameters:+[[doku>DokuWiki]] can integrate data from external XML feeds. For parsing the XML feeds, [[http://​simplepie.org/​|SimplePie]] is used. All formats understood by SimplePie can be used in DokuWiki as well. You can influence the rendering by multiple additional space separated parameters:
  
 ^ Parameter ​ ^ Description ^ ^ Parameter ​ ^ Description ^
줄 484: 줄 422:
 | //n//[dhm] | refresh period, where d=days, h=hours, m=minutes. (e.g. 12h = 12 hours). | | //n//[dhm] | refresh period, where d=days, h=hours, m=minutes. (e.g. 12h = 12 hours). |
  
-The refresh period defaults to 4 hours. Any value below 10 minutes will be treated as 10 minutes. [[wiki:DokuWiki]] will generally try to supply a cached version of a page, obviously this is inappropriate when the page contains dynamic external content. The parameter tells [[wiki:DokuWiki]] to re-render the page if it is more than //refresh period// since the page was last rendered.+The refresh period defaults to 4 hours. Any value below 10 minutes will be treated as 10 minutes. [[doku>DokuWiki]] will generally try to supply a cached version of a page, obviously this is inappropriate when the page contains dynamic external content. The parameter tells [[doku>DokuWiki]] to re-render the page if it is more than //refresh period// since the page was last rendered.
  
 **Example:​** **Example:​**