您的足迹:
差别
这里会显示出您选择的修订版和当前版本之间的差别。
两侧同时换到之前的修订记录 前一修订版 后一修订版 | 前一修订版 | ||
wiki:syntax [2018/05/20 08:12] eureka dokuwiki官网中文翻译 |
wiki:syntax [2020/04/28 15:11] (当前版本) eureka [文本到图牌转换] |
||
---|---|---|---|
行 1: | 行 1: | ||
====== DokuWiki格式语法说明 ====== | ====== DokuWiki格式语法说明 ====== | ||
- | [[doku>DokuWiki]] 支持一些简单的标记语言, 以尽最大可能使文档看上去更友好。本页面包含了所有你在编辑页面时可能用到的语法的说明。如果需要查看本页源码,只需要点击页面顶部或者底部的 **编辑本页** 按钮即可。 I如果您是初尝Wiki,那么可以使用 [[playground:playground|Wiki砂箱]] 来尽情挥洒。通过[[doku>toolbar|快捷按钮]],您可以更方便地使用这些标记。 | + | [[doku>DokuWiki]] 支持一些简单的标记语言, 以尽最大可能使文档看上去更友好。本页面包含了所有你在编辑页面时可能用到的语法说明。如果需要查看本页源码,只需要点击页面顶部或者底部的 **编辑本页** 按钮即可。 如果您是初尝Wiki,那么可以使用 [[playground:playground|Wiki砂箱]] 来尽情挥洒。通过[[doku>toolbar|快捷按钮]],您可以更方便地使用这些标记。 |
===== 基本文本格式 ===== | ===== 基本文本格式 ===== | ||
行 66: | 行 66: | ||
* 到 [[syntax|已存在页面]] 的链接和到 [[nonexisting|未存在页面]] 的链接,其外观是不同的。 | * 到 [[syntax|已存在页面]] 的链接和到 [[nonexisting|未存在页面]] 的链接,其外观是不同的。 | ||
- | * 默认情况下,DokuWiki不使用 [[wp>CamelCase]] 来自动建立链接,(CamelCase类似于PmWiki中的WikiWord)。但是也可以在 [[doku>config|设置文件]] 中启用它。 Hint: If DokuWiki is a link, then it’s enabled. | + | * 默认情况下,DokuWiki不使用 [[wp>CamelCase]] 来自动建立链接,(CamelCase类似于PmWiki中的WikiWord)。但是也可以在 [[doku>config|设置文件]] 中启用它。 提示: 如果DokuWiki是连接,则被激活。 |
* 当一节的标题改变时,该节的书签也会改变,因此,请不要太依靠网页内的链接。 | * 当一节的标题改变时,该节的书签也会改变,因此,请不要太依靠网页内的链接。 | ||
行 75: | 行 75: | ||
DokuWiki支持 [[interwiki|Wiki间链接]] ,即到其他wiki的链接。 | DokuWiki支持 [[interwiki|Wiki间链接]] ,即到其他wiki的链接。 | ||
例如,这是一个到Wikipedia上关于Wiki的一个页面的的链接: [[wp>Wiki]] 。 | 例如,这是一个到Wikipedia上关于Wiki的一个页面的的链接: [[wp>Wiki]] 。 | ||
+ | | ||
==== Windows共享文件夹 ==== | ==== Windows共享文件夹 ==== | ||
行 82: | 行 83: | ||
注: | 注: | ||
- | |||
* 出于安全原因,只有在微软IE浏览器上才能够直接访问Windows共享文件夹。 (且只适用于局域网内部环境). | * 出于安全原因,只有在微软IE浏览器上才能够直接访问Windows共享文件夹。 (且只适用于局域网内部环境). | ||
- | * Mozilla和Firefox可采用 [[http://kb.mozillazine.org/Links_to_local_pages_do_not_work|Mozilla知识库]] 中提到的方法实现此功能. 但是,在打开Windows共享时仍然弹出JavaScript警告。如需为所有用户删除这个警告, 请将本行代码加入 ''conf/lang/en/lang.php''中 (详情见 [[doku>localization#changing_some_localized_texts_and_strings_in_your_installation|localization]]): <code - conf/lang/en/lang.php> | + | * Mozilla和Firefox可采用 [[http://kb.mozillazine.org/Links_to_local_pages_do_not_work|Mozilla知识库]] 中提到的方法实现此功能. 但是,在打开Windows共享时仍然弹出JavaScript警告。如需为所有用户删除这个警告, 请将本行代码加入 ''conf/lang/en/lang.php''中 (详情见 [[doku>localization#changing_some_localized_texts_and_strings_in_your_installation|localization]]): |
+ | <code - conf/lang/en/lang.php> | ||
<?php | <?php | ||
/** | /** | ||
行 97: | 行 98: | ||
您也可以用图像来作为一个内部或者外部的链接,只需同时使用链接和[[#images_and_other_files|图像]]的语法,如下所示: | 您也可以用图像来作为一个内部或者外部的链接,只需同时使用链接和[[#images_and_other_files|图像]]的语法,如下所示: | ||
- | [[http://www.php.net|{{wiki:dokuwiki-128.png}}]] | + | [[http://www.php.net|{{wiki:logo.png}}]] |
- | [[http://php.net|{{wiki:dokuwiki-128.png}}]] | + | [[http://php.net|{{wiki:logo.png}}]] |
- | 请注意:在链接名中使用语法,只有显示图像的语法会被识别,请不要使用其它语法。 | + | 请注意:图像格式仅在格式化语法中接受链接名称。。 |
DokuWiki支持完整的[[#images_and_other_files|图像]]及[#links|链接]]预发,包括调整图像大小、内部和外部的图像链接,以及wiki内链接。 | DokuWiki支持完整的[[#images_and_other_files|图像]]及[#links|链接]]预发,包括调整图像大小、内部和外部的图像链接,以及wiki内链接。 | ||
行 183: | 行 184: | ||
{{wiki:dokuwiki-128.png?linkonly}} 这是一个图片的链接。 | {{wiki:dokuwiki-128.png?linkonly}} 这是一个图片的链接。 | ||
- | ==== 备用的文件格式 ==== | + | ==== 回退格式 ==== |
并非所有浏览器都支持所有的视频和音频格式,要解决这个问题,你可以上传不同的文件格式,以获得最大的浏览器兼容性。 | 并非所有浏览器都支持所有的视频和音频格式,要解决这个问题,你可以上传不同的文件格式,以获得最大的浏览器兼容性。 | ||
行 228: | 行 229: | ||
文本到图片的转换,主要用作表情符号。文本到HTML的转换,多用於显示符号替换,但也可以配置为使用其他HTML。 | 文本到图片的转换,主要用作表情符号。文本到HTML的转换,多用於显示符号替换,但也可以配置为使用其他HTML。 | ||
- | ==== 表情符号 ==== | + | |
+ | ==== 文本到图片转换 ==== | ||
DokuWiki会将一些常用的 [[wp>emoticon|表情符号]] 转换为图像。除了默认的表情符号以外,您也可以在 [[doku>Smileys]] 文件夹中放入更多的表情图,然后在 ''conf/smileys.conf'' 中设置它们即可。下面是Dokuwiki包含了的表情图像: | DokuWiki会将一些常用的 [[wp>emoticon|表情符号]] 转换为图像。除了默认的表情符号以外,您也可以在 [[doku>Smileys]] 文件夹中放入更多的表情图,然后在 ''conf/smileys.conf'' 中设置它们即可。下面是Dokuwiki包含了的表情图像: | ||
行 267: | 行 269: | ||
请注意:在配置文件中可以禁用这类自动转换。 | 请注意:在配置文件中可以禁用这类自动转换。 | ||
- | ===== 层次显示 ===== | + | ===== 引用 ===== |
- | 有时候(特别是讨论时)您想把某些文字(尤为各次的回复)标示作不同的层次,您可以使用下列的语法: | + | 有时候,你想把有些文字标记为它的回复或评论,您可以使用下列的语法: |
<code> | <code> | ||
行 358: | 行 360: | ||
注意:不支持垂直对齐 | 注意:不支持垂直对齐 | ||
- | ===== 无格式区块 ===== | + | ===== 无格式 ===== |
若要略过某段内含 WIKI 语法,不对该段文字作任何处理, 可以使用 %%<nowiki>%% 标签或更简单一点用 2 个 <nowiki>%%</nowiki> 放在该段文字的前后,请参考下面例子: | 若要略过某段内含 WIKI 语法,不对该段文字作任何处理, 可以使用 %%<nowiki>%% 标签或更简单一点用 2 个 <nowiki>%%</nowiki> 放在该段文字的前后,请参考下面例子: | ||
行 379: | 行 381: | ||
<code> | <code> | ||
- | 就像 <-这个 | + | 这里预格式为code所有空格都保留,就像 <-这个 |
</code> | </code> | ||
行 400: | 行 402: | ||
<code> | <code> | ||
- | 就像 <-这个 | + | 这里预格式为code所有空格都保留 <-这个 |
</code> | </code> | ||
行 433: | 行 435: | ||
</code> | </code> | ||
- | 目前支持的语言有: //actionscript, ada, apache, asm, asp, bash, caddcl, cadlisp, c, c_mac, cpp, csharp, css, delphi, html4strict, java, javascript, lisp, lua, mpasm, nsis, objc, oobas, oracle8, pascal, perl, php-brief, php, python, qbasic, smarty, sql, vb, vbnet, visualfoxpro, xml// | + | 目前支持的语言有: //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 rpmspec rsplus ruby rust sas sass scala scheme scilab scl sdlbasic smalltalk smarty spark sparql sql 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 xbasic xml xojo xorg_conf xpp yaml z80 zxbasic// |
+ | |||
+ | 还有附加的 [[doku>syntax_highlighting|高级选项]]作为语法高亮,例如高亮行或添加行号。 | ||
==== 可下载的代码块 ==== | ==== 可下载的代码块 ==== | ||
行 454: | 行 458: | ||
===== 在内容中嵌入HTML或PHP语法 ===== | ===== 在内容中嵌入HTML或PHP语法 ===== | ||
- | 可以在文件里透过加入 ''%%<%%html%%>%%'' or ''%%<%%php%%>%%'' 标签来使用HTML或PHP,比如: | + | 可以在文件里通过加入 ''%%<%%html%%>%%'' or ''%%<%%php%%>%%'' 标签来使用HTML或PHP。(如果需要包括块级元素,可使用大写标签)。 |
- | <html> | + | HTML 盒子: |
- | 这是一段用 <font color="red" size="+1">HTML 写的红色字(size=+1)</font> | + | |
- | </html> | + | |
<code> | <code> | ||
<html> | <html> | ||
- | 这是一段用 <font color="red" size="+1">HTML 写的红色字(size=+1)</font> | + | This is some <span style="color:red;font-size:150%;">inline HTML</span> |
</html> | </html> | ||
+ | <HTML> | ||
+ | <p style="border:2px dashed red;">And this is some block HTML</p> | ||
+ | </HTML> | ||
</code> | </code> | ||
- | 22 | + | |
- | <php> | + | <html> |
- | echo '由 PHP 所产生 Logo:'; | + | This is some <span style="color:red;font-size:150%;">inline HTML</span> |
- | echo '<img src="' . $_SERVER['PHP_SELF'] . '?= | + | </html> |
- | ' . php_logo_guid() . '" | + | <HTML> |
- | alt="PHP Logo !" />'; | + | <p style="border:2px dashed red;">And this is some block HTML</p> |
- | </php> | + | </HTML> |
+ | |||
+ | PHP 例子: | ||
<code> | <code> | ||
<php> | <php> | ||
- | echo '由 PHP 所产生 Logo:'; | + | echo 'The PHP version: '; |
- | echo '<img src="' . $_SERVER['PHP_SELF'] . '?= | + | echo phpversion(); |
- | ' . php_logo_guid() . '" | + | echo ' (generated inline HTML)'; |
- | alt="PHP Logo !" />'; | + | |
</php> | </php> | ||
+ | <PHP> | ||
+ | echo '<table class="inline"><tr><td>The same, but inside a block level element:</td>'; | ||
+ | echo '<td>'.phpversion().'</td>'; | ||
+ | echo '</tr></table>'; | ||
+ | </PHP> | ||
</code> | </code> | ||
+ | <php> | ||
+ | echo 'The PHP version: '; | ||
+ | echo phpversion(); | ||
+ | echo ' (inline HTML)'; | ||
+ | </php> | ||
+ | <PHP> | ||
+ | echo '<table class="inline"><tr><td>The same, but inside a block level element:</td>'; | ||
+ | echo '<td>'.phpversion().'</td>'; | ||
+ | echo '</tr></table>'; | ||
+ | </PHP> | ||
- | + | **请特别注意**:HTML及PHP语法可以在配置中设定支持与否。若您的DokuWiki设定不打开这两项功能(可单独打开两者之一功能)那么上面的例子就不会被执行,而是直接显示出来原始写法。 | |
- | **请特别注意**:HTML及PHP语法可以在[[config|设定选项]]中决定支持与否。若您的DokuWiki设定不打开这两项功能(可单独打开两者之一功能)那么上面的例子就不会被执行,而是直接显示出来原始写法。 | + | |
===== RSS/ATOM Feed聚合 ===== | ===== RSS/ATOM Feed聚合 ===== | ||
- | DokuWiki能從外部XML feed中聚合數據。為分析這些XML feed,DokuWiki使用了[[http://simplepie.org/|SimplePie]]。凡是SimplePie能理解的格式,都可用於DokuWiki中。您可以更改不同的參數,以改變其渲染。參數之間請用空格隔開: | + | DokuWiki能从外部XML feed中聚合数据。为分析這些XML feed,DokuWiki使用了[[http://simplepie.org/|SimplePie]]。凡是SimplePie能理解的格式,都可用於DokuWiki中。您可以更改不同的参数,以改变其渲染。参数之间请用空格隔开: |
- | ^ 參數 ^ 描述 ^ | + | ^ 数数 ^ 描述 ^ |
- | | any number | 最多顯示多少項內容;預設值是8。 | | + | | any number | 最多显示多少项內容;预設值是8。 | |
- | | reverse | 將最新條目顯示在前面。 | | + | | reverse | 将最新條目显示在前面。 | |
- | | author | 顯示條目的作者名字。 | | + | | author | 显示条目的作者名字。 | |
- | | date | 顯示條目數據。 | | + | | date | 显示條目日期。 | |
- | | description| 顯示條目的描述;如果[[doku>config:htmlok|HTML]]被禁用,所有標籤將被過濾掉 | | + | | description| 显示條目的描述;如果[[doku>config:htmlok|HTML]]被禁用,所有标签將被过滤掉 | |
| //n//[dhm] | 刷新周期,其中,d=日數,h=小時數,m=分。例如,12h=12小時。 | | | //n//[dhm] | 刷新周期,其中,d=日數,h=小時數,m=分。例如,12h=12小時。 | | ||
- | 預設的刷新周期是4小時。小於10分鐘者亦視為10分鐘。DokuWiki通常會提供頁面的暫存版,但這做法不適用於包含動態外部內容的頁面。上面的參數則告訴DokuWiki:若對上一次渲染時間已經過了//刷新周期//,就要重新渲染頁面。 | + | 预设的刷新周期是4小時。小於10分钟者亦当作10分钟。DokuWiki通常会提供面面的暂存版,但这做法不适用於包含动太外部內容的頁面。上面的参数则告诉DokuWiki:若对上一次渲染時间已经过了//刷新周期//,就要重新渲染頁面。 |
- | **範例:** | + | **范例:** |
{{rss>http://slashdot.org/index.rss 5 author date 1h }} | {{rss>http://slashdot.org/index.rss 5 author date 1h }} | ||
行 518: | 行 538: | ||
使用[[doku>plugins|插件]],可以扩充DokuWiki的语法。插件的的安装方法,请参见其他相应页面中的说明。 | 使用[[doku>plugins|插件]],可以扩充DokuWiki的语法。插件的的安装方法,请参见其他相应页面中的说明。 | ||
+ | |||
+ | ~~INFO:syntaxplugins~~ |