차이

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

--- wiki:syntax [2025/12/22 19:39] – [Syntax Highlighting] devany
+++ wiki:syntax [2025/12/22 19:45] (현재) – [서식 문법 (Formatting Syntax)] devany
@@ 줄 1: / 줄 1: @@
-====== 서식 문법 (Formatting Syntax) ======
+====== 서식 문법 ======
-[[doku>DokuWiki|도쿠위키]]는 데이터 파일을 최대한 읽기 쉽게 유지하기 위해 간단한 마크업 언어를 지원합니다. 이 페이지는 페이지 편집 시 사용할 수 있는 모든 가능한 문법을 포함하고 있습니다. "이 페이지 편집하기" 버튼을 눌러 이 페이지의 소스를 직접 확인해 보세요. 무언가 테스트해보고 싶다면 [[playground:playground|연습장(playground)]] 페이지를 이용하세요. 간단한 마크업은 [[doku>toolbar|퀵버튼 툴바]]를 통해서도 쉽게 사용할 수 있습니다.
+[[doku>DokuWiki|도쿠위키]]는 데이터 파일을 최대한 읽기 쉽게 유지하기 위해 간단한 마크업 언어를 지원합니다. 이 페이지는 페이지 편집 시 사용할 수 있는 모든 가능한 문법을 포함하고 있습니다. "이 페이지 편집하기" 버튼을 눌러 이 페이지의 소스를 직접 확인해 보세요. 무언가 테스트해보고 싶다면 [[playground:playground|연습장]] 페이지를 이용하세요. 간단한 마크업은 [[doku>toolbar|퀵버튼 툴바]]를 통해서도 쉽게 사용할 수 있습니다.
 ===== 기본 텍스트 서식 =====
@@ 줄 399: / 줄 399: @@
 특정 줄을 강조하거나 줄 번호를 추가하는 것과 같은 추가적인 [[doku>syntax_highlighting|고급 옵션]]들을 구문 강조에 사용할 수 있습니다.
-==== Downloadable Code Blocks ====
+==== 다운로드 가능한 코드 블록 ====
-When you use the ''%%<code>%%'' or ''%%<file>%%'' syntax as above, you might want to make the shown code available for download as well. You can do this by specifying a file name after language code like this:
+위에서 설명한 ''%%<code>%%'' 또는 ''%%<file>%%'' 문법을 사용할 때, 표시된 코드를 다운로드할 수 있도록 만들고 싶을 수 있습니다. 다음과 같이 언어 코드 뒤에 파일 이름을 지정하면 됩니다:
 <code>
@@ 줄 413: / 줄 413: @@
 </file>
-If you don't want any highlighting but want a downloadable file, specify a dash (''-'') as the language code: ''%%<code - myfile.foo>%%''.
+구문 강조를 원하지 않지만 다운로드 가능한 파일을 만들고 싶다면, 언어 코드 자리에 대시(''-'')를 넣으십시오: ''%%<code - myfile.foo>%%''.
+===== RSS/ATOM 피드 통합 =====
-===== RSS/ATOM Feed Aggregation =====
+[[DokuWiki]]는 외부 XML 피드의 데이터를 통합할 수 있습니다. XML 피드 분석에는 [[http://simplepie.org/|SimplePie]]가 사용됩니다. SimplePie가 인식하는 모든 형식은 도쿠위키에서도 사용할 수 있습니다. 공백으로 구분된 여러 추가 매개변수를 통해 렌더링 방식을 조정할 수 있습니다:
-[[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 ^
+^ 매개변수 ^ 설명 ^
-| any number | will be used as maximum number items to show, defaults to 8 |
+| 숫자 | 표시할 항목의 최대 개수이며, 기본값은 8입니다 |
-| reverse    | display the last items in the feed first |
+| reverse | 피드의 마지막 항목을 먼저 표시합니다 |
-| author     | show item authors names |
+| author | 항목 작성자 이름을 표시합니다 |
-| date       | show item dates |
+| date | 항목 날짜를 표시합니다 |
-| description| show the item description. All HTML tags will be stripped |
+| description | 항목 설명을 표시합니다. 모든 HTML 태그는 제거됩니다 |
-| nosort     | do not sort the items in the feed |
+| nosort | 피드의 항목을 정렬하지 않습니다 |
-| //n//[dhm] | refresh period, where d=days, h=hours, m=minutes. (e.g. 12h = 12 hours). |
+| //n//[dhm] | 새로고침 주기이며 d=일, h=시간, m=분입니다. (예: 12h = 12시간). |
-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.
+새로고침 주기의 기본값은 4시간입니다. 10분 미만의 값은 모두 10분으로 취급됩니다. [[wiki:DokuWiki]]는 일반적으로 페이지의 캐시된 버전을 제공하려고 하지만, 페이지에 동적인 외부 콘텐츠가 포함된 경우에는 적절하지 않습니다. 이 매개변수는 페이지가 마지막으로 렌더링된 후 //새로고침 주기//보다 더 많은 시간이 지났을 경우 페이지를 다시 렌더링하도록 [[wiki:DokuWiki]]에 지시합니다.
-By default the feed will be sorted by date, newest items first. You can sort it by oldest first using the ''reverse'' parameter, or display the feed as is with ''nosort''.
+기본적으로 피드는 날짜별로 정렬되어 최신 항목이 먼저 표시됩니다. ''reverse'' 매개변수를 사용하여 오래된 항목을 먼저 정렬하거나, ''nosort''를 사용하여 피드 그대로 표시할 수 있습니다.
-**Example:**
+**예시:**
   {{rss>http://slashdot.org/index.rss 5 author date 1h }}
 {{rss>http://slashdot.org/index.rss 5 author date 1h }}
+===== 제어 매크로 =====
+일부 문법은 스스로 출력을 생성하지 않으면서 도쿠위키가 페이지를 렌더링하는 방식에 영향을 줍니다. 다음과 같은 제어 매크로를 사용할 수 있습니다:
-===== Control Macros =====
+^ 매개변수 ^ 설명 |
+| %%~~NOTOC~~%%   | 페이지 내에 이 매크로가 있으면 목차를 생성하지 않습니다 |
+| %%~~NOCACHE~~%% | 도쿠위키는 기본적으로 모든 출력을 캐시합니다. 때때로 이를 원하지 않을 경우(예: 위에서 설명한 %%<php>%% 문법을 사용한 경우), 이 매크로를 추가하여 호출할 때마다 도쿠위키가 페이지를 다시 렌더링하도록 강제할 수 있습니다 |
+===== 문법 플러그인 =====
-Some syntax influences how DokuWiki renders a page without creating any output it self. The following control macros are availble:
+도쿠위키의 문법은 [[doku>plugins|플러그인]]을 통해 확장될 수 있습니다. 설치된 플러그인의 사용법은 해당 플러그인의 설명 페이지에 기술되어 있습니다. 현재 이 도쿠위키 설치본에서 사용할 수 있는 문법 플러그인은 다음과 같습니다:
-^ Macro           ^ Description |
-| %%~~NOTOC~~%%   | If this macro is found on the page, no table of contents will be created |
-| %%~~NOCACHE~~%% | DokuWiki caches all output by default. Sometimes this might not be wanted (eg. when the %%<php>%% syntax above is used), adding this macro will force DokuWiki to rerender a page on every call |
-===== Syntax Plugins =====
-DokuWiki's syntax can be extended by [[doku>plugins|Plugins]]. How the installed plugins are used is described on their appropriate description pages. The following syntax plugins are available in this particular DokuWiki installation:
 ~~INFO:syntaxplugins~~