DokuWiki

It's better when it's simple

用户工具

站点工具


zh:tips:good_style

差别

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

到此差别页面的链接

两侧同时换到之前的修订记录前一修订版
后一修订版
前一修订版
zh:tips:good_style [2021-05-18 04:20] – [语言] hflzh:tips:good_style [2021-05-18 05:13] (当前版本) – [图像和其他多媒体] hfl
行 20: 行 20:
   * 坚持使用通过按钮或者菜单方式选择一种带有格式的屏幕文本输出。对于格式输出要附有说明。   * 坚持使用通过按钮或者菜单方式选择一种带有格式的屏幕文本输出。对于格式输出要附有说明。
   * 对于关联性不强的几点使用[[:wiki:syntax#列表|无序列表]],如果你在描述一个思考过程,那么就要使用一个连续的相互联系的过程来描写。   * 对于关联性不强的几点使用[[:wiki:syntax#列表|无序列表]],如果你在描述一个思考过程,那么就要使用一个连续的相互联系的过程来描写。
-  * 慎用[[:wiki:syntax#脚注|脚注]],限简短说明。对于需要大篇幅说明的注释可以单独开一维基文章。如果想要将说明指向外部信息源,使用[[:wiki:syntax#链接|链接]]即可。+  * 慎用[[:wiki:syntax#脚注|脚注]],限简短说明。对于需要大篇幅说明的注释可以单独开一维基页面。如果想要将说明指向外部信息源,使用[[:wiki:syntax#链接|链接]]即可。
   * 表格可大幅度提高数据的可读性和结构性。使用表格要确保有意义明确的表头和表述清晰的表名。(例如. "表格 1.2: 行星间平均距离")。   * 表格可大幅度提高数据的可读性和结构性。使用表格要确保有意义明确的表头和表述清晰的表名。(例如. "表格 1.2: 行星间平均距离")。
   * 大表不易修改。可以考虑使用嵌套的列表。   * 大表不易修改。可以考虑使用嵌套的列表。
行 26: 行 26:
 ===== 语言 ===== ===== 语言 =====
  
-  * 文章中使用恰当的句,必要时使用名词。+  * 使用恰当的句,必要时使用名词。
   * 句子开始使用大写字母((中文不适用)),结束使用句号或者其他标点。   * 句子开始使用大写字母((中文不适用)),结束使用句号或者其他标点。
-  * 多用简洁明了的短句,少用复杂的从句。文章完成后,要重新阅读并修改不合适句子。 +  * 多用简洁明了的短句,少用复杂的从句。内容完成后,要重新阅读并修改不恰当地方。 
-  * 确定读者定位。DokuWiki 适用于写文档,所以需要引导读者阅读。可以使用//祈使句//形式(“//干//就完了!”),//我们/你们//格式(“然后//我们/你//点击……”)或者//我//格式(“//我//然后吃饭……”)。切忌不要混淆了格式。 +  * 确定读者定位。DokuWiki 适用于写文档,所以需要引导读者阅读。可以使用//祈使句//形式(“//干//就完了!”),//我们/你们//格式(“然后//我们/你//点击……”)或者//我//格式(“//我//然后吃饭……”)。切忌不要混淆称谓。 
-  * 发布前检查语法或者拼写错误。如果文章出现错误,不管文章多牛都会降低可信度。 +  * 发布前检查语法或者拼写错误。如果内容出现错误,不管内容多牛都会降低可信度。 
-  * 养成自己的风格。不要强迫自己使用不喜欢的风格,否则可能会导致不伦不类。+  * 养成自己的写作风格。不要强迫自己使用不喜欢和不擅长的风格,否则可能会导致不伦不类。
  
 ===== 参考文献 ===== ===== 参考文献 =====
行 41: 行 41:
   * 在页面结尾添加"参见:"行。提供与页面主题//密切相关//的维基页面的链接。   * 在页面结尾添加"参见:"行。提供与页面主题//密切相关//的维基页面的链接。
   * 如果想提供有关主题或有益于编写页面的外部资源,请在文末添加一个名为“参考”或“延伸阅读”的部分,并提供相关资源链接或清单(例如ISBN号)。 如果没有这么做,请说明原因。   * 如果想提供有关主题或有益于编写页面的外部资源,请在文末添加一个名为“参考”或“延伸阅读”的部分,并提供相关资源链接或清单(例如ISBN号)。 如果没有这么做,请说明原因。
-  * 配置[[:interwiki]]快捷方式可以帮助快速链接到共同资源。+  * 配置[[:interwiki|维基间链接]]快捷方式可以帮助快速链接到共同资源。
  
 ===== 图像和其他多媒体 ===== ===== 图像和其他多媒体 =====
  
-  * “有真相。” 甚至可能//超出你想像//。((Also, you can not express this quote as a picture, can you?)) 人们往往对图像的真实性的质疑要比对语言的真实性的质疑少。简短的文字说明比不准确的图片更好。+  * “胜万言甚至//超乎您想像//。((那么,您能用一张图替代这个引用吗?)) 人们往往对图像的真实性的质疑要比对语言的真实性的质疑少。简短的文字说明比不准确的图片更好。
   * 如同表格一样,图像也可以添加标题,来说明图像的使用意图。   * 如同表格一样,图像也可以添加标题,来说明图像的使用意图。
   * 如果不是原创,请注明出处(可使用链接)和版权声明。   * 如果不是原创,请注明出处(可使用链接)和版权声明。
   * 除非明确允许,否则不要链接外部站点图像。首先是因为版权问题,其次是因为盗用带宽流量而将[[config:fetchsize|缓存外部图像]]关闭问题。   * 除非明确允许,否则不要链接外部站点图像。首先是因为版权问题,其次是因为盗用带宽流量而将[[config:fetchsize|缓存外部图像]]关闭问题。
   * 如果图像大于屏幕的三分之一,使用[[:wiki:syntax#多媒体文件|链接重置大小说明]]来插入一个缩略图。   * 如果图像大于屏幕的三分之一,使用[[:wiki:syntax#多媒体文件|链接重置大小说明]]来插入一个缩略图。
zh/tips/good_style.1621304407.txt.gz · 最后更改: 2021-05-18 04:20 由 hfl

除额外注明的地方外,本维基上的内容按下列许可协议发布: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki