Eureka Wiki (易易维基)

您的足迹:

差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

两侧同时换到之前的修订记录 前一修订版
后一修订版
前一修订版
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|设置文件]] 中启用它。 ​HintIf 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>​
  
-目前支持的语言有:​ //​actionscriptadaapacheasmaspbashcaddclcadlisp, c, c_maccppcsharpcssdelphihtml4strictjavajavascriptlispluampasmnsisobjcoobasoracle8pascalperlphp-briefphppythonqbasicsmartysql, vb, vbnetvisualfoxproxml//+目前支持的语言有:​ //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~~