차이

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

--- wiki:syntax [2025/12/22 19:36] – [No Formatting] 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|퀵버튼 툴바]]를 통해서도 쉽게 사용할 수 있습니다.
 ===== 기본 텍스트 서식 =====
@@ 줄 355: / 줄 355: @@
   </nowiki>
   스마일리 ;-)가 포함된 %%//__이__ 텍스트//%%의 경우도 마찬가지입니다.
-===== 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>%%''.
+최소 두 개의 공백으로 들여쓰거나(이전 예시들에서 사용된 방식), ''%%<code>%%'' 또는 ''%%<file>%%'' 태그를 사용하여 문서에 코드 블록을 포함할 수 있습니다.
-  This is text is indented by two spaces.
+  이 텍스트는 두 개의 공백으로 들여쓰기 되었습니다.
 <code>
-This is preformatted code all spaces are preserved: like              <-this
+이것은 서식이 지정된 코드이며 모든 공백이 유지됩니다: 예시              <-이렇게
 </code>
 <file>
-This is pretty much the same, but you could use it to show that you quoted a file.
+이것도 거의 동일하지만, 파일을 인용했음을 나타낼 때 사용할 수 있습니다.
 </file>
-Those blocks were created by this source:
+위의 블록들은 다음과 같은 소스로 생성되었습니다:
-    This is text is indented by two spaces.
+    이 텍스트는 두 개의 공백으로 들여쓰기 되었습니다.
   <code>
-  This is preformatted code all spaces are preserved: like              <-this
+  이것은 서식이 지정된 코드이며 모든 공백이 유지됩니다: 예시              <-이렇게
   </code>
   <file>
-  This is pretty much the same, but you could use it to show that you quoted a file.
+  이것도 거의 동일하지만, 파일을 인용했음을 나타낼 때 사용할 수 있습니다.
   </file>
+==== 구문 강조 ====
-==== Syntax Highlighting ====
+[[wiki:DokuWiki]]는 소스코드를 읽기 쉽게 강조(Highlighting)할 수 있습니다. 이는 [[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter를 사용하므로, GeSHi가 지원하는 모든 언어를 지원합니다. 이전 섹션에서 설명한 코드 및 파일 블록과 동일한 문법을 사용하지만, 이번에는 강조할 언어 이름을 태그 안에 포함합니다. 예: ''<nowiki><code java></nowiki>'' 또는 ''<nowiki><file java></nowiki>''.
-[[wiki:DokuWiki]] can highlight sourcecode, which makes it easier to read. It uses the [[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter -- so any language supported by GeSHi is supported. The syntax uses the same code and file blocks described in the previous section, but this time the name of the language syntax to be highlighted is included inside the tag, e.g. ''<nowiki><code java></nowiki>'' or ''<nowiki><file java></nowiki>''.
 <code java>
 /**
- * The HelloWorldApp class implements an application that
+ * HelloWorldApp 클래스는 표준 출력에
- * simply displays "Hello World!" to the standard output.
+ * "Hello World!"를 표시하는 애플리케이션을 구현합니다.
  */
 class HelloWorldApp {
     public static void main(String[] args) {
-        System.out.println("Hello World!"); //Display the string.
+        System.out.println("Hello World!"); // 문자열을 표시합니다.
     }
 }
 </code>
-The following language strings are currently recognized: //4cs 6502acme 6502kickass 6502tasm 68000devpac abap actionscript3 actionscript ada aimms algol68 apache applescript apt_sources arm asm asp asymptote autoconf autohotkey autoit avisynth awk bascomavr bash basic4gl batch bf biblatex bibtex blitzbasic bnf boo caddcl cadlisp ceylon cfdg cfm chaiscript chapel cil c_loadrunner clojure c_mac cmake cobol coffeescript c cpp cpp-qt cpp-winapi csharp css cuesheet c_winapi dart dcl dcpu16 dcs delphi diff div dos dot d ecmascript eiffel email epc e erlang euphoria ezt f1 falcon fo fortran freebasic freeswitch fsharp gambas gdb genero genie gettext glsl gml gnuplot go groovy gwbasic haskell haxe hicest hq9plus html html4strict html5 icon idl ini inno intercal io ispfpanel java5 java javascript jcl j jquery julia kixtart klonec klonecpp kotlin latex lb ldif lisp llvm locobasic logtalk lolcode lotusformulas lotusscript lscript lsl2 lua m68k magiksf make mapbasic mathematica matlab mercury metapost mirc mk-61 mmix modula2 modula3 mpasm mxml mysql nagios netrexx newlisp nginx nimrod nsis oberon2 objc objeck ocaml-brief ocaml octave oobas oorexx oracle11 oracle8 oxygene oz parasail parigp pascal pcre perl6 perl per pf phix php-brief php pic16 pike pixelbender pli plsql postgresql postscript povray powerbuilder powershell proftpd progress prolog properties providex purebasic pycon pys60 python qbasic qml q racket rails rbs rebol reg rexx robots roff rpmspec rsplus ruby rust sas sass scala scheme scilab scl sdlbasic smalltalk smarty spark sparql sql sshconfig standardml stonescript swift systemverilog tclegg tcl teraterm texgraph text thinbasic tsql twig typoscript unicon upc urbi uscript vala vbnet vb vbscript vedit verilog vhdl vim visualfoxpro visualprolog whitespace whois winbatch wolfram xbasic xml xojo xorg_conf xpp yaml z80 zxbasic//
+현재 다음 언어들이 인식됩니다: //4cs 6502acme 6502kickass 6502tasm 68000devpac abap actionscript3 actionscript ada aimms algol68 apache applescript apt_sources arm asm asp asymptote autoconf autohotkey autoit avisynth awk bascomavr bash basic4gl batch bf biblatex bibtex blitzbasic bnf boo caddcl cadlisp ceylon cfdg cfm chaiscript chapel cil c_loadrunner clojure c_mac cmake cobol coffeescript c cpp cpp-qt cpp-winapi csharp css cuesheet c_winapi dart dcl dcpu16 dcs delphi diff div dos dot d ecmascript eiffel email epc e erlang euphoria ezt f1 falcon fo fortran freebasic freeswitch fsharp gambas gdb genero genie gettext glsl gml gnuplot go groovy gwbasic haskell haxe hicest hq9plus html html4strict html5 icon idl ini inno intercal io ispfpanel java5 java javascript jcl j jquery julia kixtart klonec klonecpp kotlin latex lb ldif lisp llvm locobasic logtalk lolcode lotusformulas lotusscript lscript lsl2 lua m68k magiksf make mapbasic mathematica matlab mercury metapost mirc mk-61 mmix modula2 modula3 mpasm mxml mysql nagios netrexx newlisp nginx nimrod nsis oberon2 objc objeck ocaml-brief ocaml octave oobas oorexx oracle11 oracle8 oxygene oz parasail parigp pascal pcre perl6 perl per pf phix php-brief php pic16 pike pixelbender pli plsql postgresql postscript povray powerbuilder powershell proftpd progress prolog properties providex purebasic pycon pys60 python qbasic qml q racket rails rbs rebol reg rexx robots roff rpmspec rsplus ruby rust sas sass scala scheme scilab scl sdlbasic smalltalk smarty spark sparql sql sshconfig standardml stonescript swift systemverilog tclegg tcl teraterm texgraph text thinbasic tsql twig typoscript unicon upc urbi uscript vala vbnet vb vbscript vedit verilog vhdl vim visualfoxpro visualprolog whitespace whois winbatch wolfram xbasic xml xojo xorg_conf xpp yaml z80 zxbasic//
-There are additional [[doku>syntax_highlighting|advanced options]] available for syntax highlighting, such as highlighting lines or adding line numbers.
+특정 줄을 강조하거나 줄 번호를 추가하는 것과 같은 추가적인 [[doku>syntax_highlighting|고급 옵션]]들을 구문 강조에 사용할 수 있습니다.
+==== 다운로드 가능한 코드 블록 ====
-==== Downloadable Code Blocks ====
+위에서 설명한 ''%%<code>%%'' 또는 ''%%<file>%%'' 문법을 사용할 때, 표시된 코드를 다운로드할 수 있도록 만들고 싶을 수 있습니다. 다음과 같이 언어 코드 뒤에 파일 이름을 지정하면 됩니다:
-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>
@@ 줄 415: / 줄 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~~