差别

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

到此差别页面的链接

--- wiki:syntax [2025/07/26 16:34] – IndexZero
+++ wiki:syntax [2025/07/26 16:46] (当前版本) – IndexZero
@@ 行 516: / 行 516: @@
 | %%~~NOCACHE~~%% | DokuWiki 默认会缓存所有的输出。有时您并不希望内容被缓存（例如您使用了上述的%%<php>%%语法，页面会动态生成），便可使用这个控制宏，强制 DokuWiki 在每次访问时都重新生成页面。 |
-===== 扩展插件 =====
+===== 字体颜色 =====
+将以下代码示例放入您的运行环境：
+<code html>
+<color green>文本</color>
+<color blue/lightgrey>文本</color>
+<color #FF0000>文本</color>
+<color /#FFff00>文本</color>
+<color rgb(80%,0%,0%)/rgb(100%,80%,100%)>文本</color>
+<color hsl(120,100%,30%):hsl(180,50%,90%)>文本</color>
+</code>
+您将看到如下效果：
+<color green>文本</color>
+<color blue/lightgrey>文本</color>
+<color #FF0000>文本</color>
+<color /#FFff00>文本</color>
+<color rgb(80%,0%,0%)/rgb(100%,80%,100%)>文本</color>
+<color hsl(120,100%,30%):hsl(180,50%,90%)>文本</color>
+前景色或背景色的参数可以是任何有效的 CSS 颜色值。注意：某些旧版浏览器无法识别最新 CSS 标准中的所有颜色格式。
+**语法规范**
+方括号（''[]''）表示可选部分，使用时需移除实际括号：
+<code html>
+<color [⟨前景色⟩][/⟨背景色⟩]>⟨文本⟩</color>
+<color [⟨前景色⟩]:[⟨背景色⟩]>⟨文本⟩</color>
+</code>
+  * 若颜色值包含斜杠（''/''），**必须**使用冒号（''':'') 分隔前景色与背景色
+  * 若颜色值包含冒号，**必须**使用第一种语法格式
+  * 省略颜色参数时，将沿用当前上下文的前景/背景色
+**示例说明**（注意必须使用的冒号）：
+<code html>
+<color hwb(120 20% 30% / 50%):>半透明深绿色文本</color>
+</code>
+**技术限制**
+本插件允许使用任何不含单/双引号或 ''%%< > & ; %%'' 符号的颜色值（不验证 CSS 语法合法性），以兼容 CSS4 及未来标准。
+颜色值参考：
+[[https://developer.mozilla.org/en-US/docs/Web/CSS/color_value|MDN 颜色文档]]
+注意：
+  * 某些颜色值在部分浏览器中不可用
+  * 浏览器兼容性详见 [[https://caniuse.com/|Can I Use]]
+**使用约束**
+  - 通过生成带样式的 ''%%<span>%%'' 元素实现，故**不可包裹**标题/列表/表格等块级内容
+  - **不可用于**标题内部（标题内禁用 wiki 语法）
+  - 语法标签内使用多个分隔符（格式1的斜杠或格式2的冒号）会导致未定义行为
-使用[[doku>plugins|插件]]，可以扩充 DokuWiki 的语法。插件的的安装方法，请参见其他相应页面中的说明。

wiki/syntax.1753518853.txt.gz · 最后更改: 2025/07/26 16:34 由 IndexZero