* 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
Also take a look at the [[doku>faq:lists|FAQ on list items]].
===== การแปลง Text =====
DokuWiki สามารถแปลง certain pre-defined characters หรือ strings ไปเป็นรูปภาพหรือ Text อื่นๆ หรือ HTML.
การแปลงจาก Text ไปเป็นรูปภาพโดยส่วนใหญ่ถูกใช้เพื่อทำ รูปยิ้ม (smileys). และการแปลงจาก Text ไปเป็น HTML ถูกใช้สำหรับการแทนที่ typography , แต่สามารถถูกตั้งค่า เพื่อใช้ HTML อื่นๆได้ด้วยเช่นกัน.
==== การแปลงจาก Text ไปเป็นรูปภาพ ====
DokuWiki แปลง [[wp>emoticon]] ที่ใช้บ่อยๆ ไปเป็น 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-O %% 8-O %%
* :-( %% :-( %%
* :-) %% :-) %%
* =) %% =) %%
* :-/ %% :-/ %%
* :-\ %% :-\ %%
* :-? %% :-? %%
* :-D %% :-D %%
* :-P %% :-P %%
* :-O %% :-O %%
* :-X %% :-X %%
* :-| %% :-| %%
* ;-) %% ;-) %%
* ^_^ %% ^_^ %%
* :?: %% :?: %%
* :!: %% :!: %%
* LOL %% LOL %%
* FIXME %% FIXME %%
* DELETEME %% DELETEME %%
==== การแปลง Text ไปเป็น HTML ====
Typography: [[DokuWiki]] สามารถแปลงรูปแบบ text characters ง่ายๆไปเป็น their typographically correct entities. นี่่เป็นตัวอย่างของตัวอักษรที่สามารถจดจำได้ .
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"He thought 'It's a man's world'..."
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"He thought 'It's a man's world'..."
The same can be done to produce any kind of HTML, it just needs to be เพิ่มไปยัง [[doku>entities|pattern file]].
มีข้อยกเว้นสามข้อ ซึ่งไม่ได้มาจาก pattern file: multiplication entity (640x480), 'single' และ "double quotes". ซึ่งมันสามารถถูกปิดได้โดยใช้ [[doku>config:typography|config option]].
===== Quoting =====
Some times you want to mark some text to show it's a reply or comment. You can use the following syntax:
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!
===== ตาราง =====
DokuWiki รองรับ syntax ง่ายๆ เพื่อการสร้างตาราง.
^ 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 |
แถวในตามรางต้องเริ่มและจบด้วย ''|'' สำหรับแถวปกติและ ''^'' สำหรับ header.
^ 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 |
เพื่อที่จะเชื่อม cell ในแนวนอน , ให้ทำโดยทำให้ cell ถัดไปเป็นค่าว่างดังที่แสดงด้านบน . ตรวจสอบให้แน่ใจว่ายังมีจำนวนcell separators เท่ากัน!
ส่วนหัวตารางในแนวตั้งก็สามารถทำได้ , ด้วย .
| ^ 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 |
As you can see, it's the cell separator before a cell which decides about the formatting:
| ^ 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 |
You can have rowspans (vertically connected cells) by adding '':::'' into the cells below the one to which they should connect.
^ 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 |
Apart from the rowspan syntax those cells should not contain anything else.
^ 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 |
You can align the table contents, too. Just add at least two whitespaces at the opposite end of your text: Add two spaces on the left to align right, two spaces on the right to align left and two spaces at least at both ends for centered text.
^ Table with alignment ^^^
| right| center |left |
|left | right| center |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
This is how it looks in the source:
^ Table with alignment ^^^
| right| center |left |
|left | right| center |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
Note: Vertical alignment is not supported.
===== การไม่ใส่รูปแบบ =====
หากคุณจำเป็นจะต้องแสดงผล text ให้เหมือนที่จะถูกพิมพ์จริงๆ (ไม่มีการกำหนดรูปแบบ), ให้ปิดพื้นที่ด้วยแท็ก ''%%%%'' or ''%%%%''.
This is text is indented by two spaces.
This is preformatted code all spaces are preserved: like <-this
This is pretty much the same, but you could use it to show that you quoted a file.
Those blocks were created by this source:
This is text is indented by two spaces.
This is preformatted code all spaces are preserved: like <-this
This is pretty much the same, but you could use it to show that you quoted a file.
==== แสดงสีตาม Syntax ====
[[wiki:DokuWiki]] สามารถเน้นสี sourcecode, ซึ่งทำให้อ่านง่ายขึ้น . โดยใช้ตัวแสดงแถบสีตามไวยกรณ์ทั่วไป ที่ชื่อว่า [[http://qbnz.com/highlighter/|GeSHi]] -- ดังนั้นภาษาโปรแกรมใดๆก็ตามซึ่งได้ได้รับการสนับสนุนโดย GeSHi จะได้รับการสนับสนุนเช่นกัน . The syntax uses the same code and file blocks described in the previous section, but this time ชื่อของไวยกรณ์ภาษาโปรแกรมมิงที่จะ ถูกไฮไลท์จะถูกวางไว้ภายใน tag, ตัวอย่างเช่น ''
'' และ '' ''.
/**
* 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.
}
}
string ที่ระบุชื่อภาษาโปรแกรมมิงดังต่อไปนี้ เป็นสิ่งที่สามารถจดจำได้โดย Dokuwiki : //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//
==== บล้อกของ Source Code ที่ดาวน์โหลดได้ ====
When you use the ''%%%%'' or ''%%%%'' 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:
If you don't want any highlighting but want a downloadable file, specify a dash (''-'') as the language code: ''%%%%''.
===== การแทรก HTML และ PHP =====
คุณสามารถแทรก raw โค้ด HTML หรือ PHP ลงไปในเอกสารของคุณโดยใช้ tag ''%%%%'' หรือ ''%%%%'' . (ใช้แท็กที่เป็นตัวอักษรตัวใหญ่ถ้าคุณจำเป็นต้อง enclose block level elements.)
HTML ตัวอย่าง:
This is some inline HTML
And this is some block HTML
This is some inline HTML
And this is some block HTML
PHP ตัวอย่าง:
echo 'A logo generated by PHP:';
echo '
';
echo '(generated inline HTML)';
echo 'The same, but inside a block level element: ';
echo '![PHP Logo !](' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . ')
';
echo '
';
echo 'A logo generated by PHP:';
echo '
';
echo '(inline HTML)';
echo 'The same, but inside a block level element: ';
echo '![PHP Logo !](' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . ')
';
echo '
';
**Please Note**: การแทรก HTML และ PHP ถูกปิดการใช้งานไว้ในการตั้งค่าเริ่มต้น. ถ้าถูกปิดไว้ , โค้ดของคุณจะถูกแสดงแทนการประมวลผล .
===== 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:
^ Parameter ^ Description ^
| any number | will be used as maximum number items to show, defaults to 8 |
| reverse | display the last items in the feed first |
| author | show item authors names |
| date | show item dates |
| description| show the item description. If [[doku>config:htmlok|HTML]] is disabled all tags will be stripped |
| //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.
**Example:**
{{rss>http://slashdot.org/index.rss 5 author date 1h }}
{{rss>http://slashdot.org/index.rss 5 author date 1h }}
===== Control Macros =====
Some syntax influences how DokuWiki renders a page without creating any output it self. The following control macros are availble:
^ 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 %%%% syntax above is used), adding this macro will force DokuWiki to rerender a page on every call |
===== Syntax Plugins =====
ไวยกรณ์ของ DokuWiki'สามารถถูกขยายได้โดยใช้ [[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~~