Browse Source

在基础语法文档中补充Superspan基本语法,并且修正了Superblock基本语法部分的不严谨细节

zry 8 years ago
parent
commit
dc4653f207
1 changed files with 14 additions and 52 deletions
  1. 14 52
      BasicSyntax/BasicSytax.md

+ 14 - 52
BasicSyntax/BasicSytax.md

@@ -63,77 +63,39 @@ Superblock控制语句用于指定该Superblock的类型和基本样式。如果
 	```
 ```
 
+**显示效果:**
+
+```code:python
+def foo():
+	return bar()
+```
+
+
 由于Superblock是可扩展的,所以不同的渲染器,或者在不同的使用场合,可能存在具体的区别,因为渲染器的开发者或者使用了某个渲染器的网站会自己定义一些类型的Superblock。
 关于具体的Superblock用法,可以参考本文档的以下部分:
 
 * 基本Superblock功能
 * 在swzry.com旗下网站支持的Superblock内容
 
+另外Superblock支持嵌套,但嵌套的语法大相径庭,请参阅: Superblock嵌套说明
+
 ### Superspan
 
-这是一种可扩展的行内高级元素,与Superblock不同的是,Superblock通常是块级元素。在ZumDown中,使用Markdown的链接语法`[链接名称](链接地址) "标题"`或者图片语法`![链接名称](链接地址) "标题"`来产生链接或图片时,协议头是受限的,例如链接仅允许http、https、ftp、ftps、git、svn、mailto,而图片仅允许http和https,如果一个链接或图片的协议头不符合该限制,则该链接按照Superspan来解析
+这是一种可扩展的行内高级元素,基本格式为`[内容]{Superspan控制语句}`,前后需加上空白符与文本隔开。Superspan控制语句语法方面和Superblock相同,也是`类型:样式参数`
 
 示例:
 
 ```code:zumdown
-	**这些是链接:**
-	[Z神社](http://www.z-touhou.org)
-	[ZRY's Git](https://git.swzry.com/)
-	[某个FTP服务器](ftp://example.com/)
-	[某个FTPS服务器](ftps://example.com/)
-	[某个E-mail地址](mailto:kishin@sagume.com)
-	[某个git仓库](git://example.com/)
-	[某个svn仓库](svn://example.com/)
-
-	**这些是图片:**
-	![这是本站的LOGO](http://static.swzry.com/img/logo_with_name.png)
-	![这个也是本站的LOGO](https://static.swzry.com/img/logo_with_name.png)
-
-	**而这些均是Superspan:**
-	![](glyphicon:plus)
-	![文字](color:#00ff00)
-	[](glyphicon:plus)
-	[文字](color:#00ff00)
-
-	**还有一些Superspan的结果也是链接:**
-	[小说平台测试词条](nswiki://test1/测试词条1/)
+	这是一段文字,其中这是 [红色的]{color:red} ,这是 [蓝色的]{color:blue} ,这是 [#9900CC色]{color:#9900CC} 。
 ```
 
 ```panel
 显示效果
-**这些是链接:**
-[Z神社](http://www.z-touhou.org)
-[ZRY's Git](https://git.swzry.com/)
-[某个FTP服务器](ftp://example.com/)
-[某个FTPS服务器](ftps://example.com/)
-[某个E-mail地址](mailto:kishin@sagume.com)
-[某个git仓库](git://example.com/)
-[某个svn仓库](svn://example.com/)
-
-**这些是图片:**
-![这是本站的LOGO](http://static.swzry.com/img/logo_with_name.png)
-![这个也是本站的LOGO](https://static.swzry.com/img/logo_with_name.png)
-
-**而这些均是Superspan:**
-![](glyphicon:plus)
-![文字](color:#00ff00)
-[](glyphicon:plus)
-[文字](color:#00ff00)
-
-**还有一些Superspan的结果也是链接:**
-[小说平台测试词条](nswiki://test1/测试词条1/)
-```
-
-```alert:info
-**友情提示1:** 对于大部分Superspan来说,使用图片或链接的语法来产生,是没有区别的。
-```
-
-```alert:info
-**友情提示2:** magnet虽然是标准的URL协议名,但在这里被当做Superspan处理,如果渲染器允许您使用magnet,则会渲染成一个magenet链接。其它标准URL协议名也同理,如果渲染器支持,会以Superspan的形式进行解析,然后输出正确的链接。
+这是一段文字,其中这是 [红色的]{color:red} ,这是 [蓝色的]{color:blue} ,这是 [#9900CC色]{color:#9900CC} 。
 ```
 
 和Superblock一样,由于Superspan是可扩展的,所以不同的渲染器,或者在不同的使用场合,可能存在具体的区别,因为渲染器的开发者或者使用了某个渲染器的网站会自己定义一些类型的Superspan。
-关于具体的Superblock用法,可以参考本文档的以下部分:
+关于具体的Superspan用法,可以参考本文档的以下部分:
 
 * 基本Superspan功能
 * 在swzry.com旗下网站支持的Superspan内容