* Đây là một mục trong danh sách.
* Đây là mục thứ 2
* Bạn có thể tạo thêm các mục con
* Một mục "cháu"
* Một mục khác
- Đây cũng là một mục trong danh sách, nhưng nó được đánh số
- Đây là mục thứ 2
- Thụt đầu dòng bằng 4 cách trống để có mục con
- Thụt đầu dòng 6 cách trống để có mục "cháu"
- Mục này được thụt đầu dòng 8 cách trống
- Và có thể trở lại danh sách mục cấp cao hơn như thế này.
Bạn có thể xem thêm tại [[doku>faq:lists|Những câu hỏi thường gặp về danh sách các mục]].
===== Hoán chuyển văn bản =====
DokuWiki có thể chuyển đổi một số ký tự được xác định trước hoặc các chuỗi thành hình ảnh hoặc văn bản khác hoặc HTML.
Các văn bản để chuyển đổi hình ảnh chủ yếu được thực hiện cho biểu tượng mặt cười. Và các văn bản để chuyển đổi HTML được sử dụng để thay thế kiểu chữ, nhưng có thể được cấu hình để sử dụng HTML khác.
==== Hoán chuyển chữ thành ảnh ====
DokuWiki thường được sử dụng chuyển đổi [[wp>emoticon]] (các biểu tượng cảm xúc) thành những hình đồ họa tương đương. Những [[doku>Smileys]] (mặt cười) và hình ảnh khác có thể được cấu hình và mở rộng. Dưới đây là một danh sách đầy đủ về Smileys được sử dụng trong DokuWiki:
* 8-) %% 8-) %%
* 8-O %% 8-O %%
* :-( %% :-( %%
* :-) %% :-) %%
* =) %% =) %%
* :-/ %% :-/ %%
* :-\ %% :-\ %%
* :-? %% :-? %%
* :-D %% :-D %%
* :-P %% :-P %%
* :-O %% :-O %%
* :-X %% :-X %%
* :-| %% :-| %%
* ;-) %% ;-) %%
* ^_^ %% ^_^ %%
* :?: %% :?: %%
* :!: %% :!: %%
* LOL %% LOL %%
* FIXME %% FIXME %%
* DELETEME %% DELETEME %%
==== Hoán chuyển chữ thành HTML ====
Typography: [[wiki:dokuwiki|DokuWiki]] có thể chuyển các ký tự đơn giản thành các ký tự đặc trưng trong in ấn.
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"He thought 'It's a man's world'..."
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"He thought 'It's a man's world'..."
Tương tự có thể sử dụng cách này để thể hiện bất kỳ loại biểu tượng nào trong HTML, chỉ cần được thêm vào [[doku>entities|pattern file]].
Có ba trường hợp ngoại lệ mà không đến từ đó mô hình tập tin: phép nhân (640x480), 'nháy đơn' và "nháy kép". Có thể tắt nó thông qua [[doku>config:typography|tùy chọn cấu hình]].
===== Trích dẫn =====
Một số lần bạn muốn đánh dấu một số văn bản để hiển thị nó là một trả lời hoặc nhận xét. Bạn có thể sử dụng cú pháp sau đây:
I think we should do it
> No we shouldn't
>> Well, I 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!
===== Bảng =====
DokuWiki hỗ trợ một cú pháp đơn giản để tạo ra các bảng.
^ Heading 1 ^ Heading 2 ^ Heading 3 ^
| Row 1 Col 1 | Row 1 Col 2 | Row 1 Col 3 |
| Row 2 Col 1 | some colspan (note the double pipe) ||
| Row 3 Col 1 | Row 3 Col 2 | Row 3 Col 3 |
Hàng bảng có bắt đầu và kết thúc với một ký tự ''|'' cho hàng bình thường hoặc một ký tự ''^'' cho hàng tiêu đề (hàng đầu tiên của bảng).
^ Heading 1 ^ Heading 2 ^ Heading 3 ^
| Row 1 Col 1 | Row 1 Col 2 | Row 1 Col 3 |
| Row 2 Col 1 | some colspan (note the double pipe) ||
| Row 3 Col 1 | Row 3 Col 2 | Row 3 Col 3 |
Để nhập chung các ô trong bảng theo chiều ngang, chỉ cần làm cho các ô tiếp theo hoàn toàn trống rỗng, như được hiển thị ở trên. Hãy chắc chắn để luôn luôn có cùng một số lượng phân cách ô!
Bạn cũng có thể trình bày cột tiêu đề của bảng theo chiều dọc (cột đầu tiên của bảng), như sau:
| ^ Heading 1 ^ Heading 2 ^
^ Heading 3 | Row 1 Col 2 | Row 1 Col 3 |
^ Heading 4 | no colspan this time | |
^ Heading 5 | Row 2 Col 2 | Row 2 Col 3 |
Như bạn có thể thấy, có 1 ô trống trước những ô được định dạng:
| ^ Heading 1 ^ Heading 2 ^
^ Heading 3 | Row 1 Col 2 | Row 1 Col 3 |
^ Heading 4 | no colspan this time | |
^ Heading 5 | Row 2 Col 2 | Row 2 Col 3 |
Bạn có thể kéo dài hàng (nhập chung các ô theo chiều dọc) bằng cách thêm '':::'' vào các ô còn lại, bên dưới ô đầu tiên mà bạn muốn nhập chung.
^ Heading 1 ^ Heading 2 ^ Heading 3 ^
| Row 1 Col 1 | this cell spans vertically | Row 1 Col 3 |
| Row 2 Col 1 | ::: | Row 2 Col 3 |
| Row 3 Col 1 | ::: | Row 2 Col 3 |
Ngoài cú pháp, bên trong của ô mà bạn muốn nhập chung không được phép chứa bất cứ nội dung gì. Đây là đoạn mã đã trình bày bảng trên:
^ Heading 1 ^ Heading 2 ^ Heading 3 ^
| Row 1 Col 1 | this cell spans vertically | Row 1 Col 3 |
| Row 2 Col 1 | ::: | Row 2 Col 3 |
| Row 3 Col 1 | ::: | Row 2 Col 3 |
Bạn cũng có thể căn chỉnh các nội dung trong ô. Chỉ việc thêm 2 ký tự cách trống vào phía đối diện của văn bản nếu muốn căn nó theo chiều còn lại: Thêm 2 cách trống bên trái nếu muốn căn phải, 2 cách trống bên phải nếu muốn căn trái, 2 cách trống ở cả 2 bên nếu muốn căn giữa.
^ Table with alignment ^^^
| right| center |left |
|left | right| center |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
Dưới đây là cú pháp trình bày bảng trên:
^ Table with alignment ^^^
| right| center |left |
|left | right| center |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
Ghi chú: Không hỗ trợ căn theo chiều dọc.
===== Không định dạng văn bản =====
Nếu bạn muốn hiển thị văn bản chính xác như những gì nó được gõ (bỏ qua mọi định dạng), hãy đặt nó trong cặp thẻ ''%%%%'' hoặc ''%%%%''.
Đây là văn bản được thụt vào hai khoảng trắng.
Tất các các cách trống trong đoạn mã đều được bảo tồn: giống như <-thế này.
Bạn có thể sử dụng những cứ pháp này để trích dẫn một tập tin hoặc làm những thứ tương tự.
Đây là mã gốc đã tạo ra những khối dữ liệu mà chúng tôi đã thể hiện ở trên:
Đây là văn bản được thụt vào hai khoảng trắng.
Tất các các cách trống trong đoạn mã đều được bảo tồn: giống như <-thế này.
Bạn có thể sử dụng những cứ pháp này để trích dẫn một tập tin hoặc làm những thứ tương tự.
==== Tô màu cú pháp ====
[[wiki:DokuWiki]] có thể làm nổi bật mã nguồn, điều này làm cho mã nguồn trở lên dễ đọc hơn. Nó sử dụng [[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter -- do đó, bất kỳ ngôn ngữ nào được hỗ trợ bởi GeSHi thì đều được DokuWiki hỗ trợ. Cú pháp là tương tự như cú pháp sử dụng để định nghĩa các khối mã và các tập tin trong phần trước, nhưng ở đây, tên của ngôn ngữ được sử dụng được đưa vào bên trong thẻ. Ví dụ: ''
/**
* The HelloWorldApp class implements an application that
* simply displays "Hello World!" to the standard output.
*/
class HelloWorldApp {
public static void main(String[] args) {
System.out.println("Hello World!"); //Display the string.
}
}
Đây là các loại ngôn ngữ được hỗ trợ: //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//
==== Khối mã nguồn có thể tải về ====
Khi bạn sử dụng cú pháp ''%%%%'' hoặc ''%%%%'' như ở trên, bạn có thể giúp người xem có thể dễ dàng tải về. Bằng cách đặt tên cho tệp tin chứa đoạn mã nguồn đó:
Nó sẽ hiển thị như sau:
Nếu bạn không muốn làm nổi bật văn bản nhưng vấn muốn sử dụng tính năng tải về, bạn chỉ việc chèn vào ký tự gạch ngang (''-'') thay cho mã ngôn ngữ, ví dụ: ''%%%%''. Ví dụ:
===== Nhúng HTML và PHP =====
Bạn có thể nhúng mã HTML hoặc mã PHP vào tài liệu của bạn bằng cách sử dụng thẻ ''%%%%'' hoặc ''%%%%''. (Sử dụng các thẻ chữ hoa nếu bạn muốn trình bày dữ liệu được nhúng trong một khối.)
Ví dụ HTML:
This is some inline HTML
And this is some block HTML
This is some inline HTML
And this is some block HTML
Ví dụ PHP:
echo 'A logo generated by PHP:';
echo ' . ')
';
echo '(generated inline HTML)';
echo 'The same, but inside a block level element: ';
echo '
';
echo 'A logo generated by PHP:';
echo '';
echo '(inline HTML)';
echo 'The same, but inside a block level element: ';
echo '
';
**Chú ý**: Việc nhúng HTML và PHP mặc định được tắt trong phần cấu hình. Nếu nó được tắt, các mã được hiển thị thay vì được nhúng để chạy.
===== Tập hợp nguồn cấp RSS/ATOM =====
[[wiki:DokuWiki]] có thể tích hợp dữ liệu từ các nguồn cấp dữ liệu XML bên ngoài. [[http://simplepie.org/|SimplePie]] được sử dụng để phân tích cú pháp XML. Do đó tất cả định dạng XML mà SimplePie hỗ trợ đều có thể sử dụng ở DokuWiki. Bạn có thể thay đổi bằng nhiều thông số kết hợp:
AAA Đối với phân tích các nguồn cấp dữ liệu XML, SimplePie được sử dụng. Tất cả các định dạng được hiểu SimplePie có thể được sử dụng trong DokuWiki là tốt. Bạn có thể ảnh hưởng đến vẽ nhiều các thông số không gian thêm tách:
^ Thông số ^ Mô tả ^
| số nguyên | số lượng tối đa các mục hiển thị, mặc định là 8 |
| reverse | hiển thị mục cũ lên trên |
| author | hiện tên tác giả (nếu có) |
| date | hiện ngày đăng |
| description| hiện mô tả. Nếu [[doku>config:htmlok|HTML]] tất cả các thẻ bị vô hiệu hóa sẽ được lọc bỏ |
| //n//[dhm] | chu kỳ cập nhật lại dữ liệu, với d=ngày, h=giờ, m=phút. (Ví dụ: 12h = 12 giờ). |
Chu kỳ làm mới mặc định là 4 giờ. chu kỳ này cũng không nhỏ hơn 10 phút. [[wiki:DokuWiki]] sẽ cố gắng tạo cache cho trang, điều này không thích hợp cho những nguồn cấp thay đổi quá nhanh. Tham số này báo cho [[wiki:DokuWiki]] tạo lại trang nếu nó lớn hơn //chu kỳ cập nhật lại dữ liệu// kể từ lần cuối nguồn cấp dữ liệu được cập nhật mới.
**Ví dụ:**
{{rss>http://nukeviet.vn/vi/news/rss/ 5 author date 1h }}
{{rss>http://nukeviet.vn/vi/news/rss/ 5 author date 1h }}
===== Điều khiển Macros =====
Một vài cú pháp có tác động đến các thức mà DokuWiki tạo trang, nó nằm ngoài nội dung trình bày của tài liệu. Dưới đây là một vài macros có thể sử dụng:
^ Macro ^ Mô tả |
| %%~~NOTOC~~%% | Nếu macro này được tìm thấy trên trang, mục lục tự động sẽ không được hiện ra |
| %%~~NOCACHE~~%% | Mặc định DokuWiki sẽ tạo cache cho tất cả các trang. Thỉnh thoảng việc này không được như ý (Ví dụ: Khi chèn mã thực thi %%%% vào trang), việc đưa Macro này vào sẽ yêu cầu DokuWiki không tạo cache mà phải tạo lại trang mỗi lần nó được gọi |
===== Cú pháp bổ trợ =====
DokuWiki có thể mở rộng các cú pháp mới bằng cách cài thêm [[doku>plugins|Plugins]]. Cách cài đặt các plugin được mô tả trên các trang mô tả của chúng. Các plugin cú pháp sau đây có sẵn trong từng phần cài đặt DokuWiki:
~~INFO:syntaxplugins~~
==== Chèn Video ====
Bạn có thể chèn video vào bài viết bằng cú pháp:
{{videosite>videoid?size|title}}
**Các thông số như sau:**
* ''videosite'': Tên của một trong các site chứa video, ví dụ: youtube, slideshare, veoh, dailymotion. Danh sách đầy đủ có tại đây: http://www.dokuwiki.org/plugin:vshare#supported_services
* ''videoid'': ID của video trên site đó.
* ''size'': thông số tùy chọn, định nghĩa kích thước video. Bạn có thể cố định nó bằng kích thước rộngxcao (ví dụ 560×315), hoặc sử dụng một trong 3 từ khóa: small, medium, large.
==== Đánh số thứ tự theo ý muốn====
Ngoài chức năng đánh số thứ tự tự động có sẵn, hệ thống cho phép đánh số thứ tự theo ý muốn.
=== Đánh số thứ tự cơ bản ===
Cú pháp như sau:
~~#~~
Hệ thống sẽ đếm tất cả các ký tự được chèn trong bài viết và chèn số lần lượt từ 1 đến hết.
Ví dụ:
* Số ~~#~~
* Số ~~#~~
* Số ~~#~~
* Số ~~#~~
Sẽ được trình bày như sau:
* Số ~~#~~
* Số ~~#~~
* Số ~~#~~
* Số ~~#~~
=== Định nghĩa các nhóm số bằng ID===
Cú pháp như sau:
~~#@COUNTERID~~
Ví dụ
First counter = ~~#@ctr_ONE~~
First counter = ~~#@ctr_ONE~~
Second counter = ~~#@ctr_TWO~~
Second counter = ~~#@ctr_TWO~~
First counter = ~~#@ctr_ONE~~
Sẽ được trình bày thành
First counter = ~~#@ctr_ONE~~
First counter = ~~#@ctr_ONE~~
Second counter = ~~#@ctr_TWO~~
Second counter = ~~#@ctr_TWO~~
First counter = ~~#@ctr_ONE~~
=== Đánh số cưỡng bức ===
Cú pháp như sau:
~~#NUM~~
Ví dụ
Counter = ~~#1~~
Counter = ~~#2~~
Counter = ~~#4~~
Sẽ được trình bày thành
Counter = ~~#1~~
Counter = ~~#2~~
Counter = ~~#4~~
=== Đánh số đa cấp===
Cú pháp như sau:
~~#.#~~
Trong đó mỗi cấp được thể hiện bằng 2 ký tự .#, có thể lặp lại vô hạn.
Ví dụ
Level = ~~#~~
Level = ~~#.#~~
Level = ~~#.#.#~~
Level = ~~#.#.#~~
Level = ~~#~~
Sẽ được trình bày thành
Level = ~~#~~
Level = ~~#.#~~
Level = ~~#.#.#~~
Level = ~~#.#.#~~
Level = ~~#~~
=== Đánh số chèn chữ===
Cú pháp như sau:
~~TEXT.#~~
Trong đó TEXT có thể là ký tự bất kỳ.
Ví dụ
~~Kung.Fu.#~~
~~Kung.Fu.#~~
~~Kung.Fu.#~~
Sẽ được trình bày thành
~~Kung.Fu.#~~
~~Kung.Fu.#~~
~~Kung.Fu.#~~