差别

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

--- wiki:xiewendang [2025/04/24 20:40] – [一、技巧提示💡] lanshizi
+++ wiki:xiewendang [2025/05/23 01:21] (当前版本) – [二、Wiki思维] lanshizi
@@ 行 1: / 行 1: @@
 ====== 如何用 wiki 写一份漂亮的文档 ======
 作者：[[jsb:lanshizi_home|蓝狮子]] \\
-版本：V0.1.0 \\
+版本：V0.2.0 \\
-时间：2025.4.24\\
+时间：2025.5.23\\
 说明：看这篇文章之前，你需要了解基本的 wiki 的语法，懂得[[csz:wikiyufa|基本 wiki 操作]]。
@@ 行 11: / 行 11: @@
 本文就介绍这种，如何用 wiki 写一份专业的文档。主要是介绍蓝狮子自己写 wiki 文档的经验。
-===== 一、技巧提示💡 =====
+===== 一、基本技巧💡 =====
 蓝狮子用 wiki 写文档常用的一些排版技巧：
@@ 行 17: / 行 17: @@
 . <color blue>吸引人的文档标题</color>。文档标题很重要，一个好标题吸引大家点击查看，也可以让读者了解文档的主题，还方便大家用搜索功能，搜索到相关的文档。
 . <color blue>简洁的小标题</color>。wiki 会根据小标题会自动生成目录。所以小标题，最好有序号，整个长度不超过 7个汉字。这样文档目录会很整齐。
-. <color blue>版本更新记录</color>。【非必须】。有版本号，和版本更新记录，主要是为了方便大家查看更新记录。本文最后有【版本号说明】
+. <color blue>版本更新记录</color>。【非必须】。有版本号，和版本更新记录，主要是为了方便大家查看更新记录。也方便自己查看记录，会很有成就感的。本文最后有【版本号说明】
 . <color blue>使用额外颜色</color>。文字颜色非常有助于读者抓住重点。蓝狮子一般用最简单的`<color blue> 蓝色</color>`<color blue> 蓝色</color>。
 . <color blue>相关文档链接</color>。可以在文档中增加相关文档链接，可以返回主页，可以是其他类似说明文档链接，这样方便大家直接从这个文档查看。
@@ 行 23: / 行 23: @@
 . <color blue>偶尔用长横线</color>。【非必须】。长横线可以把文档内容分割，让内容有明显的模块。用这个语法：单独一行`-----`。大家看看本文档最开始的作者、版本、时间、说明之后，就是一个长横线。
-其他技巧：
+===== 二、Wiki思维 =====
+Thinking in Wiki。
+wiki 是一个系统，但也是一种思维方式。要尽量习惯这种思维方式。
 . 自然增长。如果没有想好文档整体该如何写，也可以先开始，然后每天增加一点。这点很有意思的，你可以试试。若更新内容较多，可以升级版本号，写版本更新记录。
-. 边看边写。当文档写到一定程度（完成主题），就可以发给其他同学阅读，以后定期更新后，再发链接给大家。
+. 边传播边完善。当文档写到一定程度（完成主题），就可以发给其他同学阅读，以后定期更新后，再发链接给大家。
-. 降低要求。一开始也不用做过多的优化和检查，错别字，文字不够简洁，问题都不大，多看几次，就修改了。
+. 降低要求。一开始也不用做过多的优化和检查，错别字，文字不够简洁，排版不够漂亮，问题都不大，多看几次，就修改好了。总之，不用一开始就想得很完美，而是一点点完善。
 . 多人协作。其他同学查看 wiki 文档时，若有想法，也可以直接在文档中写明。所有修改记录，都能查到，也有备份，不用担心文档被破坏。
+. 多加链接，少复制内容。当你的wiki 文档要大量引用其他文档内容时，可以采用增加链接的方式，而<color red>**不是复制**</color>其内容到自己页面。这样做的好处有：1)保持引用内容是最新的；2)避免浪费 wiki 存储空间；3)尊重他人的劳动成果。
+===== 三、参考链接 =====
-===== 二、参考链接 =====
    * [[target=_blank|csz:wikiyufa|基本 wiki 语法]] 熟悉 wiki 入门语法。
    * [[target=_blank|csz:lanshizi:studywiki|从入门到精通： wiki 闯关]] 学习 wiki 入门。
@@ 行 37: / 行 40: @@
    * [[target=_blank|csz:lanshizi:dianping | 作业点评的指导建议]] 这个文档的排版，可以参考。
-===== 三、更新记录 =====
+===== 四、更新记录 =====
+. **V0.2.0** 2025.5.23 增加了其他技巧
 . **V0.1.0** 2025.4.24开始写草案。