| Phiên bản trước của cả hai bênPhiên bản trướcPhiên bản sau | Phiên bản trướcPhiên bản cuốiPhiên bản sau của cả hai bên |
| wiki:syntax [2012/02/29 23:12] – Dịch lần đầu laser | wiki:syntax [2012/12/11 02:38] – laser |
|---|
| ====== Cú pháp định dạng văn bản Wiki ====== | ====== Formatting Syntax ====== |
| | **__Select language__**: English | [[wiki:syntax:vi|Tiếng Việt]] |
| |
| [[doku>DokuWiki]] hỗ trợ một số ngôn ngữ đánh dấu đơn giản, điều này giúp cho các trường dữ liệu có thể dễ đọc nhất. Trang này có tất cả cú pháp có thể bạn có thể sử dụng khi chỉnh sửa các trang. Đơn giản chỉ cần nhấn nút //Chỉnh sửa trang này// (nút này nằm ở trên cùng hoặc dưới cùng của trang) là bạn có thể xem mã nguồn của trang. Nếu bạn muốn thử nghiệm, hãy tới trang [[playground:playground|playground]] để thử. Cách đánh dấu đơn giản nhất là sử dụng [[doku>toolbar|nút định dạng]]. | [[doku>DokuWiki]] supports some simple markup language, which tries to make the datafiles to be as readable as possible. This page contains all possible syntax you may use when editing the pages. Simply 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]] page. The simpler markup is easily accessible via [[doku>toolbar|quickbuttons]], too. |
| |
| ===== Định dạng Văn bản cơ bản ===== | ===== Basic Text Formatting ===== |
| |
| DokuWiki hỗ trợ **đậm**, //nghiêng//, __gạch chân__ và ''kéo giãn'' văn bản. Dĩ nhiên bạn cũng có thể **__//''nén''//__** chúng. | DokuWiki supports **bold**, //italic//, __underlined__ and ''monospaced'' texts. Of course you can **__//''combine''//__** all these. |
| |
| DokuWiki hỗ trợ **đậm**, //nghiêng//, __gạch chân__ và ''kéo giãn'' văn bản. | DokuWiki supports **bold**, //italic//, __underlined__ and ''monospaced'' texts. |
| Dĩ nhiên bạn cũng có thể **__//''nén''//__** chúng. | Of course you can **__//''combine''//__** all these. |
| |
| Bạn có thể sử dụng <sub>chỉ số dưới</sub> và <sup>chỉ số trên</sup>. | You can use <sub>subscript</sub> and <sup>superscript</sup>, too. |
| |
| Bạn có thể sử dụng <sub>chỉ số dưới</sub> và <sup>chỉ số trên</sup>. | You can use <sub>subscript</sub> and <sup>superscript</sup>, too. |
| |
| Bạn cũng có thể đánh dấu văn bản bị xóa bằng cách <del>gạch ngang</del> chúng. | You can mark something as <del>deleted</del> as well. |
| |
| Bạn cũng có thể đánh dấu văn bản bị xóa bằng cách <del>gạch ngang</del> chúng. | You can mark something as <del>deleted</del> as well. |
| |
| **Các đoạn văn bản** được phân cách bởi 1 dòng trống. Nếu bạn muốn **xuống dòng** mà không phân đoạn, bạn có thể sử dụng hai dấu chéo ngược, tiếp đó là một khoảng trắng hoặc kết thúc dòng. | **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. |
| |
| Đây là một số văn bản với một số linebreaks\\ Lưu ý rằng | This is some text with some linebreaks\\ Note that the |
| hai dấu chéo ngược chỉ được chấp nhận nếu nó đứng ở cuối dòng chữ\\ | two backslashes are only recognized at the end of a line\\ |
| hoặc sau\\ một khoảng trắng (cách trống). \\Nếu không đúng bạn sẽ thấy nó thế này. | or followed by\\ a whitespace \\this happens without it. |
| |
| Đây là một số văn bản với một số linebreaks\\ Lưu ý rằng | This is some text with some linebreaks\\ Note that the |
| hai dấu chéo ngược chỉ được chấp nhận nếu nó đứng ở cuối dòng chữ\\ | two backslashes are only recognized at the end of a line\\ |
| hoặc sau\\ một khoảng trắng (cách trống). \\Nếu không được trình bày đúng bạn sẽ thấy nó thế này. | or followed by\\ a whitespace \\this happens without it. |
| |
| Bạn chỉ nên sử dụng dòng mới khi thực sự cần thiết. | You should use forced newlines only if really needed. |
| |
| ===== Liên kết/Link===== | ===== Links ===== |
| |
| DokuWiki hỗ trợ nhiều cách tạo liên kết. | DokuWiki supports multiple ways of creating links. |
| |
| ==== Liên kết bên ngoài ==== | ==== 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. | 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. |
| addresses like this one: <andi@splitbrain.org> are recognized, too. | addresses like this one: <andi@splitbrain.org> are recognized, too. |
| |
| ==== Liên kết nội bộ ==== | ==== Internal ==== |
| |
| Internal links are created by using square brackets. You can either just give a [[pagename]] or use an additional [[pagename|link text]]. | Internal links are created by using square brackets. You can either just give a [[pagename]] or use an additional [[pagename|link text]]. |
| This links to [[syntax#internal|this Section]]. | This links to [[syntax#internal|this Section]]. |
| |
| Lưu ý: | Notes: |
| |
| * Links to [[syntax|existing pages]] are shown in a different style from [[nonexisting]] ones. | * Links to [[syntax|existing pages]] are shown in a different style from [[nonexisting]] ones. |
| * When a section's heading is changed, its bookmark changes, too. So don't rely on section linking too much. | * When a section's heading is changed, its bookmark changes, too. So don't rely on section linking too much. |
| |
| ==== Giữa các wiki/Interwiki ==== | ==== Interwiki ==== |
| |
| DokuWiki hỗ trợ liên kết [[doku>Interwiki]] (dạng liên kết giữa các wiki). 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]]. |
| |
| DokuWiki supports [[doku>Interwiki]] links. These are quick links to other Wikis. | 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]]. | For example this is a link to Wikipedia's page about Wikis: [[wp>Wiki]]. |
| |
| ==== Thư mục chia sẻ trên windows ==== | ==== 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. 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. | Windows Shares like [[\\server\share|this]] are recognized, too. |
| |
| Lưu ý: | Notes: |
| |
| * For security reasons direct browsing of windows shares only works in Microsoft Internet Explorer per default (and only in the "local zone"). | * For security reasons direct browsing of windows shares only works in Microsoft Internet Explorer per default (and only in the "local zone"). |
| $lang['js']['nosmblinks'] = ''; | $lang['js']['nosmblinks'] = ''; |
| |
| ==== Liên kết tới ảnh ==== | ==== 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: | 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}}]] |
| |
| Lưu ý: The image formatting is the only formatting syntax accepted in link names. | 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). | 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). |
| |
| ===== Chú thích cuối trang ===== | ===== Footnotes ===== |
| |
| You can add footnotes ((This is a footnote)) by using double parentheses. | You can add footnotes ((This is a footnote)) by using double parentheses. |
| You can add footnotes ((This is a footnote)) by using double parentheses. | You can add footnotes ((This is a footnote)) by using double parentheses. |
| |
| ===== Đề mục ===== | ===== Sectioning ===== |
| |
| You can use up to five different levels of headlines to structure your content. If 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. | You can use up to five different levels of headlines to structure your content. If 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. |
| ---- | ---- |
| |
| ===== Ảnh và các loại tệp tin khác ===== | ===== Images and Other Files ===== |
| |
| You can include external and internal [[doku>images]] with curly brackets. Optionally you can specify the size of them. | You can include external and internal [[doku>images]] with curly brackets. Optionally you can specify the size of them. |
| For linking an image to another page see [[#Image Links]] above. | For linking an image to another page see [[#Image Links]] above. |
| |
| ===== Danh sách ===== | ===== 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. | 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. |
| 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]]. |
| |
| ===== Hoán chuyển văn bản ===== | ===== Text Conversions ===== |
| |
| DokuWiki can convert certain pre-defined characters or strings into images or other text or HTML. | 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. | 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. |
| |
| ==== Hoán chuyển chữ thành ảnh ==== | ==== 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: | 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: |
| * DELETEME %% DELETEME %% | * DELETEME %% DELETEME %% |
| |
| ==== Hoán chuyển chữ thành HTML ==== | ==== Text to HTML Conversions ==== |
| |
| Typography: [[DokuWiki]] can convert simple text characters to their typographically correct entities. Here is an example of recognized characters. | Typography: [[DokuWiki]] can convert simple text characters to their typographically correct entities. Here is an example of recognized characters. |
| 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]]. | 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]]. |
| |
| ===== Trích dẫn ===== | ===== Quoting ===== |
| |
| Some times you want to mark some text to show it's a reply or comment. You can use the following syntax: | Some times you want to mark some text to show it's a reply or comment. You can use the following syntax: |
| >>> Then lets do it! | >>> Then lets do it! |
| |
| ===== Bảng ===== | ===== Tables ===== |
| |
| DokuWiki supports a simple syntax to create tables. | DokuWiki supports a simple syntax to create tables. |
| Note: Vertical alignment is not supported. | Note: Vertical alignment is not supported. |
| |
| ===== Không định dạng văn bản ===== | ===== No Formatting ===== |
| |
| 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>''. | 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>''. |
| The same is true for %%//__this__ text// with a smiley ;-)%%. | The same is true for %%//__this__ text// with a smiley ;-)%%. |
| |
| ===== Khối mã nguồn ===== | ===== 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>%%''. |
| </file> | </file> |
| |
| ==== Tô màu cú pháp ==== | ==== Syntax Highlighting ==== |
| |
| [[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 is the same like in the code and file blocks in the previous section, but this time the name of the used language is inserted inside the tag. Eg. ''<nowiki><code java></nowiki>'' or ''<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> | <code java> |
| </code> | </code> |
| |
| The following language strings are currently recognized: //4cs, abap, actionscript-french, actionscript, actionscript3, ada, apache, applescript, asm, asp, autoconf, autohotkey, autoit, avisynth, awk, bash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, c, c_mac, caddcl, cadlisp, cfdg, cfm, chaiscript, cil, clojure, cmake, cobol, cpp, cpp-qt, csharp, css, cuesheet, d, dcs, delphi, diff, div, dos, dot, ecmascript, eiffel, email, erlang, fo, fortran, freebasic, fsharp, gambas, genero, genie, gdb, glsl, gml, gnuplot, groovy, gettext, gwbasic, haskell, hicest, hq9plus, html, icon, idl, ini, inno, intercal, io, j, java5, java, javascript, jquery, kixtart, klonec, klonecpp, latex, lisp, locobasic, logtalk, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, m68k, magiksf, make, mapbasic, matlab, mirc, modula2, modula3, mmix, mpasm, mxml, mysql, newlisp, nsis, oberon2, objc, ocaml-brief, ocaml, oobas, oracle8, oracle11, oxygene, oz, pascal, pcre, perl, perl6, per, pf, php-brief, php, pike, pic16, pixelbender, plsql, postgresql, povray, powerbuilder, powershell, progress, prolog, properties, providex, purebasic, python, q, qbasic, rails, rebol, reg, robots, rpmspec, rsplus, ruby, sas, scala, scheme, scilab, sdlbasic, smalltalk, smarty, sql, systemverilog, tcl, teraterm, text, thinbasic, tsql, typoscript, unicon, vala, vbnet, vb, verilog, vhdl, vim, visualfoxpro, visualprolog, whitespace, winbatch, whois, xbasic, xml, xorg_conf, xpp, z80// | The following language strings are currently recognized: //4cs, 6502acme, 6502kickass, 6502tasm, 68000devpac, abap, actionscript-french, actionscript, actionscript3, ada, algol68, apache, applescript, asm, asp, autoconf, autohotkey, autoit, avisynth, awk, bascomavr, bash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, c, c_loadrunner, c_mac, caddcl, cadlisp, cfdg, cfm, chaiscript, cil, clojure, cmake, cobol, coffeescript, cpp, cpp-qt, csharp, css, cuesheet, d, dcs, delphi, diff, div, dos, dot, e, epc, ecmascript, eiffel, email, erlang, euphoria, f1, falcon, fo, fortran, freebasic, fsharp, gambas, genero, genie, gdb, glsl, gml, gnuplot, go, groovy, gettext, gwbasic, haskell, hicest, hq9plus, html, html5, icon, idl, ini, inno, intercal, io, j, java5, java, javascript, jquery, kixtart, klonec, klonecpp, latex, lb, lisp, llvm, locobasic, logtalk, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, m68k, magiksf, make, mapbasic, matlab, mirc, modula2, modula3, mmix, mpasm, mxml, mysql, newlisp, nsis, oberon2, objc, objeck, ocaml-brief, ocaml, oobas, oracle8, oracle11, oxygene, oz, pascal, pcre, perl, perl6, per, pf, php-brief, php, pike, pic16, pixelbender, pli, plsql, postgresql, povray, powerbuilder, powershell, proftpd, progress, prolog, properties, providex, purebasic, pycon, python, q, qbasic, rails, rebol, reg, robots, rpmspec, rsplus, ruby, sas, scala, scheme, scilab, sdlbasic, smalltalk, smarty, sql, systemverilog, tcl, teraterm, text, thinbasic, tsql, typoscript, unicon, uscript, vala, vbnet, vb, verilog, vhdl, vim, visualfoxpro, visualprolog, whitespace, winbatch, whois, xbasic, xml, xorg_conf, xpp, yaml, z80, zxbasic// |
| |
| ==== Khối mã nguồn có thể tải về ==== | ==== 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 to this by specifying a file name after language code like this: | 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> | <code> |
| |
| |
| ===== Nhúng HTML và PHP ===== | ===== Embedding HTML and PHP ===== |
| |
| You can embed raw HTML or PHP code into your documents by using the ''%%<html>%%'' or ''%%<php>%%'' tags. (Use uppercase tags if you need to enclose block level elements.) | You can embed raw HTML or PHP code into your documents by using the ''%%<html>%%'' or ''%%<php>%%'' tags. (Use uppercase tags if you need to enclose block level elements.) |
| **Please Note**: HTML and PHP embedding is disabled by default in the configuration. If disabled, the code is displayed instead of executed. | **Please Note**: HTML and PHP embedding is disabled by default in the configuration. If disabled, the code is displayed instead of executed. |
| |
| ===== Tập hợp nguồn cấp RSS/ATOM ===== | ===== 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: | [[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: |
| |
| |
| |
| ===== Điều khiển Macros ===== | ===== Control Macros ===== |
| |
| Some syntax influences how DokuWiki renders a page without creating any output it self. The following control macros are availble: | Some syntax influences how DokuWiki renders a page without creating any output it self. The following control macros are availble: |
| | %%~~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 | | | %%~~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 | |
| |
| ===== Cú pháp bổ trợ ===== | ===== 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: | 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: |
