当前 wiki 使用 wikijs 框架搭建,有着易用的界面和简单的操作逻辑。
目前 wikijs 缺少批量操作的功能,如果需要导入或移动多个内容,推荐使用 git 操作。
1、内容主题没有限制,对使用deepin有所帮助的内容(包括但不限于个人经验、作品、教程、答疑等),都可以进行导入;
2、内容禁止含有任何广告、侮辱性词汇、敏感词汇;
3、任何内容不得违反法律法规。
/en/
wiki英文内容
/**
wiki中文内容
1、所有页面标题,力求通俗易懂, 最好能一眼看明白内容讲解了什么知识点
2、单个页面中,并不需要统一格式, 只要可读性好即可
3、如编辑内容为个人原创,则根据个人意愿在文末留下作者ID、编辑时间
4、如该内容转载至论坛,则可同时根据个人意愿在文末留下原帖地址。如:
1、建议图片格式为jpg、png,大小不超过150K;
2、为避免纠纷,请使用个人原创图片,或是遵循CC0协议的无版权图片;
3、导入的图片请统一存放于【图片存储】文件夹中,建议以图片相关的内容命名,不以数字和符号命名。
页面的移动和重命名可能会导致其它位置对页面的引用失效,故请尽可能在页面创建时拟定合适的标题并放置于恰当的位置,并尽可能避免重命名页面的标题。
wiki页面右上角点击增加按钮按提示即可添加页面
wiki页面右上角点击页面操作按钮可以找到下拉菜单中的删除功能
页面的移动和重命名可能会导致其它位置对页面的引用失效,请在进行此类操作前三思此类操作是否必要。
若确实必要,则请将其移动到恰当的位置,以尽可能避免再次移动/重命名页面。
wiki页面右上角点击页面操作按钮可以找到下拉菜单中的移动/重命名按钮, 点击可看到如下界面
目录名称可以选择已有的目录, 也可以按照想法随意命名(wiki自动创建新目录), 路径将自动按斜杠划分
当某个目录关联的页面全部被删除的时候此目录也将不再展示, 也就是自动删除
【文章类型】
原创 / 转载
【内容类型】
经验分享 / 教程 / 答疑
【内容关键词】(建议不少于2个)
比如: 操作系统;安装;双系统;
wiki.deepin.org 和 github.com/linuxdeepin/wiki.deepin.org 是 wiki.deepin.org 的内容同步仓库, 每五分钟执行一次双向同步。
同步包括wiki页面内容、页面信息、发布状态和媒体资源,不包括页面的脚本和样式。
不同于其它 Wiki 系统,受 wiki.js 限制,在编辑界面中添加页面间的引用暂时只能根据页面的完整路径进行添加。于是页面在修改路径或重命名标题时,可能导致其它页面或 Wiki 站点外的位置对 Wiki 页面的引用失效。因此,在页面的创建于移动时,请留意页面的标题和路径是否恰当,并尽可能避免对页面的标题或路径进行调整。
额外的,deepin wiki 支持通过页面的标题(https://wiki.deepin.org/页面标题
)进行页面重定向。例如,Wiki介绍 页面可以通过 https://wiki.deepin.org/Wiki介绍
进行链接,访问后会自动重定向到对应的页面。故如果您希望引用一些较为重要的页面时,可通过这种方式对页面进行引用来降低页面失效的风险。
Wiki.js 默认会对页面中的一级与二级标题进行导航,并在页面展示 ToC(目录大纲)。故在编写页面时,可以放心使用一级与二级标题对文章段落进行划分,不必规避一级标题的使用。