[Share Experiences] 新建了Wiki页面“快速入门导航”,欢迎讨论和建议
Tofloor
poster avatar
pzm9012
Moderator
2023-01-09 06:26
Author

感谢高手们的贡献,目前deepin Wiki已经有一定规模了。但是我觉得(可能)还有一个问题,就是现有的目录层次确实很清晰,但不是特别直观,比如下图,只从第一级目录来看,我不知道该从哪里打开安装系统有关的教程……而重新规划页面的分类是个大工程,我连自己在教室的课桌抽屉都整理不好,还做这样的事……sad

图片.png

除此以外,deepin Wiki的首页只是对深度的介绍,而openSUSE Wiki、Arch Wiki的首页还有重定向到Wiki中重要文章的作用。基于以上情况,我自己新建了一个页面作为导航,打算完善之后放到根目录下,对安装、配置等比较频繁用到的知识做个汇总/指引,方便大家游览。

链接:https://wiki.deepin.org/zh/%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98FAQ/%E5%BF%AB%E9%80%9F%E5%85%A5%E9%97%A8%E5%AF%BC%E8%88%AA

目前这个页面还缺很多内容,以后我有时间再慢慢补充。大家有建议可以提出来,有Wiki编辑权限的人也可以直接编辑。


顺便让教室的UOS家庭版露个脸吧。
505C6511-501A-4129-915C-59DC3F22AD26.jpeg

Reply Favorite View the author
All Replies
‌量子巡游者
Moderator
2023-01-09 06:46
#1

我这也有个问题,就是好多人当时发帖子只是为了解决自己的问题,部分人是处于分享经验!!!

可是吧这些帖子都是原主人发的,是否删除是看发帖板主心情的,有些觉得我为啥要分享给大家,我只想我自己看,然后就把帖子删了,这样别人再遇到同样问题,也知道有人分享了解决方法,可是发帖人早就删除了帖子,这样就会出现很尴尬的局面!!!

我的建议是给超级版主开一些特权,比如:超级版主锁定帖子功能,当帖子内容被选中时,不经过超级版主同意不能删除,发帖人在删除帖子时会先给超级版主发个删除帖子的信息,超级版主同意后发帖人再删除!!!

同样也给维护人员一些时间将帖子内容复制到自己的语雀账号中,这样后期别人不会因为删除,找不到解决方法而重复问!!!

更暴力的方法: 维护人员提前把所有的选中帖子内容全部复制到自己建立的语雀中(复制内容不是标题个链接哈!!!),这样是即耗时间又耗费精力!!!

不然能看到的只有帖子标题和链接,发帖人是否删除 维护人员和看帖子的人只有单条单条点进去才能知道帖子是否还存在!!!!!!

任重道远啊兄弟……

Reply View the author
hanzn-zzx
deepin
2023-01-09 07:15
#2

你们老师这么好的吗,让你在教室电脑装uos

想想我们班主任,我就是(手欠作死)给我们班希沃升了个win11,因为我们老师用不习惯,所以……

Reply View the author
jjcui8595
deepin
2023-01-09 14:47
#3

like

Reply View the author
Amber
deepin
2023-01-09 17:15
#4
hanzn-zzx

你们老师这么好的吗,让你在教室电脑装uos

想想我们班主任,我就是(手欠作死)给我们班希沃升了个win11,因为我们老师用不习惯,所以……

可以看看作者个人主页,之前给这件事发过帖,是因为他教室本来的win系统有问题好像tail

Reply View the author
xuqi
deepin testing team
2023-01-09 17:32
#5

like

Reply View the author
blue_whale
deepin
2023-01-09 17:54
#6

之前目录更复杂, 后来我抽时间整理成现在的大致结构, 当时还为了是否要重构目录发起了一次投票, 地址:

https://bbs.deepin.org/post/244211

整理前还在wiki官方群内说明了此事, 说实话, 整理目录页面美化相对来说还算简单的, 就是重复这个过程比较麻烦.

重点在于当前的目录里面的内容五花八门, 天上飞的地上跑的水里游的各种资料, 我进行整理目录的时候也是仅仅只对大致目录进行了分类, 有些内容涉及系统底层, 涉及软件开发,涉及各种专业方面的知识, 仅凭一人之力根本无法归类或者说我无法辨别内容的真伪, 更无法确定这个内容适应的系统范围, 某些文章是从网上找的, 内容仅适合部分系统, 对最新稳定版本的系统没有任何用处. 某些内容我自己读起来都不通顺, 但鉴于上述原因, 我还不敢修改, 怕改错了.

术业有专攻, 这个真没办法

有些内容看起来很简单标题有明显阅读不通顺, 我试着改成自认为理想的标题, 后来有人在群里问是不是有人动了某篇文章, 导致github上很多指向那篇文章的链接失效了, 这也是不能轻易动的原因之一.

wiki维护要考虑兼容性

还有一点, 我们需要认识到, wiki当中很多文章实际上是对某些版本的底层适配修复, 这些内容本不需要对用户呈现的, 但由于之前系统的不完整性, 很多极客为了找到解决方案做了很多工作(我很佩服), 并将自己的做法发布出来, 但这些内容并不系统也不适合普通人使用, 稍微一个语法的理解错误对于用户的系统而言则是致命的二次伤害.

内容也是分等级的

wiki文档在按照上述投票帖子的方式进行分级后, 我将大部分零散的文档进行了细致的分类, 但还是有些硬性问题, 比如目录分级过多导致无法查看, 这需要wiki开发者将目录和内容中间的横线加一个可以拖动的功能, 当时我开发了一个油猴插件, 进行了过渡:

油猴: https://www.tampermonkey.net/index.php

插件: https://greasyfork.org/zh-CN/scripts/453397-deepin-wiki-pc%E9%A1%B5%E9%9D%A2%E7%9B%AE%E5%BD%95%E6%BB%91%E5%9D%97
图片.png

这件事我也通过bbs的私信和wiki微信群告知过相关管理人员和共同维护者.

还有一个是文档分享的问题, 文档默认显示链接是很长的, 而且一旦修改文章标题则链接也同时失效.

链接可以通过下面的方式缩短, 比如:
图片.png

可以缩短为:
图片.png 这是wiki群里面的一个维护者为文档开发的一个自动解析的功能

但是修改标题则失效的问题还是无解. 除非后期给每个新文章生成一个唯一id, 有一个分享按钮就行

合作的基础是规则统一

现有的很多wiki内容有很多之前的样式, 里面在文档开头或末尾添加了编辑者的名单, 很多页面也保持同样的风格, 这本身没有问题, 但这需要有专人来维护来保持统一. 随着越来越多的wiki编辑者的加入, 很多文章并没有遵循这些规则, 页面内容风格也并不统一. 这时候审核人员和文档矫正人员就有需要了, 有些内容废话连篇是否要保留是否符合政治正确这是审核人员才能做的事, 文档格式不规范, 不美观, 读起来不通顺, 这是文档矫正人员才能做的事, 他们都介于上传后和公开前之间.

如果没有底线, 就会有人不断试探

当前的wiki还有两个主目录我没有划分到新目录里面, 一个 关于deepin, 一个是 常见问题FAQ

关于deepin 里面很多内容涉及到deepin官方的介绍说明, 我不方便整理(毕竟不是官方), 所以留给官方维护人员,
常见问题FAQ则是内容过于复杂, 整不了.

当时整理成现在的样子后说是过段时间deepin有官方人员负责维护此wiki, 我就不在动了. 现阶段基本上只有发现文档内容有明显错别字或显示特别难看的时候小改一下, 其他的不动.

最后回复一下楼主提到不直观的问题, 这个没办法, 经济基础决定上层建筑, 只要我们还在使用这个展示框架就要受限于这个框架的各种特性. 还有就是上述所有问题deepin官方肯定是知晓的, 但是他们有自己的工作, 必须要等到他们将系统完善到一定程度或者人员足够多的时候, 才能在文档这里分出一批人来专职管理.

Reply View the author
pzm9012
Moderator
2023-01-09 18:17
#7
‌量子巡游者

我这也有个问题,就是好多人当时发帖子只是为了解决自己的问题,部分人是处于分享经验!!!

可是吧这些帖子都是原主人发的,是否删除是看发帖板主心情的,有些觉得我为啥要分享给大家,我只想我自己看,然后就把帖子删了,这样别人再遇到同样问题,也知道有人分享了解决方法,可是发帖人早就删除了帖子,这样就会出现很尴尬的局面!!!

我的建议是给超级版主开一些特权,比如:超级版主锁定帖子功能,当帖子内容被选中时,不经过超级版主同意不能删除,发帖人在删除帖子时会先给超级版主发个删除帖子的信息,超级版主同意后发帖人再删除!!!

同样也给维护人员一些时间将帖子内容复制到自己的语雀账号中,这样后期别人不会因为删除,找不到解决方法而重复问!!!

更暴力的方法: 维护人员提前把所有的选中帖子内容全部复制到自己建立的语雀中(复制内容不是标题个链接哈!!!),这样是即耗时间又耗费精力!!!

不然能看到的只有帖子标题和链接,发帖人是否删除 维护人员和看帖子的人只有单条单条点进去才能知道帖子是否还存在!!!!!!

任重道远啊兄弟……

保存原帖的完整内容是工作量比较大的事,我没有精力顾及,只能先把对资源帖的导航做好。

Reply View the author
pzm9012
Moderator
2023-01-09 18:21
#8
hanzn-zzx

你们老师这么好的吗,让你在教室电脑装uos

想想我们班主任,我就是(手欠作死)给我们班希沃升了个win11,因为我们老师用不习惯,所以……

是的,因为之前Win 7问题太多,老师自己用都很不爽。班主任对我装UOS的提议也没有反对。目前来看这个UOS的体验还是不错的,就是有点卡(机械硬盘),以及触控没有反馈。不习惯肯定是难免的,但至少UOS有一些触屏手势,Win 7未更新版一个都没有。

像白板这种配置低的电脑,最好还是别上Win 11吧……

Reply View the author
pzm9012
Moderator
2023-01-09 18:27
#9
blue_whale

之前目录更复杂, 后来我抽时间整理成现在的大致结构, 当时还为了是否要重构目录发起了一次投票, 地址:

https://bbs.deepin.org/post/244211

整理前还在wiki官方群内说明了此事, 说实话, 整理目录页面美化相对来说还算简单的, 就是重复这个过程比较麻烦.

重点在于当前的目录里面的内容五花八门, 天上飞的地上跑的水里游的各种资料, 我进行整理目录的时候也是仅仅只对大致目录进行了分类, 有些内容涉及系统底层, 涉及软件开发,涉及各种专业方面的知识, 仅凭一人之力根本无法归类或者说我无法辨别内容的真伪, 更无法确定这个内容适应的系统范围, 某些文章是从网上找的, 内容仅适合部分系统, 对最新稳定版本的系统没有任何用处. 某些内容我自己读起来都不通顺, 但鉴于上述原因, 我还不敢修改, 怕改错了.

术业有专攻, 这个真没办法

有些内容看起来很简单标题有明显阅读不通顺, 我试着改成自认为理想的标题, 后来有人在群里问是不是有人动了某篇文章, 导致github上很多指向那篇文章的链接失效了, 这也是不能轻易动的原因之一.

wiki维护要考虑兼容性

还有一点, 我们需要认识到, wiki当中很多文章实际上是对某些版本的底层适配修复, 这些内容本不需要对用户呈现的, 但由于之前系统的不完整性, 很多极客为了找到解决方案做了很多工作(我很佩服), 并将自己的做法发布出来, 但这些内容并不系统也不适合普通人使用, 稍微一个语法的理解错误对于用户的系统而言则是致命的二次伤害.

内容也是分等级的

wiki文档在按照上述投票帖子的方式进行分级后, 我将大部分零散的文档进行了细致的分类, 但还是有些硬性问题, 比如目录分级过多导致无法查看, 这需要wiki开发者将目录和内容中间的横线加一个可以拖动的功能, 当时我开发了一个油猴插件, 进行了过渡:

油猴: https://www.tampermonkey.net/index.php

插件: https://greasyfork.org/zh-CN/scripts/453397-deepin-wiki-pc%E9%A1%B5%E9%9D%A2%E7%9B%AE%E5%BD%95%E6%BB%91%E5%9D%97
图片.png

这件事我也通过bbs的私信和wiki微信群告知过相关管理人员和共同维护者.

还有一个是文档分享的问题, 文档默认显示链接是很长的, 而且一旦修改文章标题则链接也同时失效.

链接可以通过下面的方式缩短, 比如:
图片.png

可以缩短为:
图片.png 这是wiki群里面的一个维护者为文档开发的一个自动解析的功能

但是修改标题则失效的问题还是无解. 除非后期给每个新文章生成一个唯一id, 有一个分享按钮就行

合作的基础是规则统一

现有的很多wiki内容有很多之前的样式, 里面在文档开头或末尾添加了编辑者的名单, 很多页面也保持同样的风格, 这本身没有问题, 但这需要有专人来维护来保持统一. 随着越来越多的wiki编辑者的加入, 很多文章并没有遵循这些规则, 页面内容风格也并不统一. 这时候审核人员和文档矫正人员就有需要了, 有些内容废话连篇是否要保留是否符合政治正确这是审核人员才能做的事, 文档格式不规范, 不美观, 读起来不通顺, 这是文档矫正人员才能做的事, 他们都介于上传后和公开前之间.

如果没有底线, 就会有人不断试探

当前的wiki还有两个主目录我没有划分到新目录里面, 一个 关于deepin, 一个是 常见问题FAQ

关于deepin 里面很多内容涉及到deepin官方的介绍说明, 我不方便整理(毕竟不是官方), 所以留给官方维护人员,
常见问题FAQ则是内容过于复杂, 整不了.

当时整理成现在的样子后说是过段时间deepin有官方人员负责维护此wiki, 我就不在动了. 现阶段基本上只有发现文档内容有明显错别字或显示特别难看的时候小改一下, 其他的不动.

最后回复一下楼主提到不直观的问题, 这个没办法, 经济基础决定上层建筑, 只要我们还在使用这个展示框架就要受限于这个框架的各种特性. 还有就是上述所有问题deepin官方肯定是知晓的, 但是他们有自己的工作, 必须要等到他们将系统完善到一定程度或者人员足够多的时候, 才能在文档这里分出一批人来专职管理.

是的,感谢你对目录的翻新。我应该是不会大动这个了的,就照搬我做资源整理的思路搞个导航。

等等,咋感觉搞成了资源整理 Lite Wiki版了呢……

Reply View the author
hanzn-zzx
deepin
2023-01-09 18:43
#10
pzm9012

是的,因为之前Win 7问题太多,老师自己用都很不爽。班主任对我装UOS的提议也没有反对。目前来看这个UOS的体验还是不错的,就是有点卡(机械硬盘),以及触控没有反馈。不习惯肯定是难免的,但至少UOS有一些触屏手势,Win 7未更新版一个都没有。

像白板这种配置低的电脑,最好还是别上Win 11吧……

啊,我也在我们希沃机子上用LTG的形式跑过deepin20.4,结果有些驱动不适配

目前我们希沃上的win11还是很流畅的

Reply View the author
魔法师
deepin
2023-11-22 01:06
#11

不得不说,你确实是引入了不错的 wiki 系统,但你整合的 wiki 缺少像论坛一样的分区,这类需求虽然比较少见,但 wiki 词条不限于:

  • 软件安装区
  • 应用投递区
  • 历史预览区
  • 或者,你有一样的想法,那可以参考如下 wiki

https://wiki.sipeed.com/soft/Lichee/zh/Zero-Doc/Drive/GPIO_file.html

注:wiki 不是以 wiki 而 wiki,不管是何种形式,都可以称之为 wiki

又如:https://www.bilibili.com/video/BV1o34y1h76N
这也是我自称之为一种的 wiki 形式,由于历史原因,该项目并不是特别明确为一个 wiki ,而是一种易于检索的信息存储

Reply View the author
pzm9012
Moderator
2023-11-22 03:16
#12
魔法师

不得不说,你确实是引入了不错的 wiki 系统,但你整合的 wiki 缺少像论坛一样的分区,这类需求虽然比较少见,但 wiki 词条不限于:

  • 软件安装区
  • 应用投递区
  • 历史预览区
  • 或者,你有一样的想法,那可以参考如下 wiki

https://wiki.sipeed.com/soft/Lichee/zh/Zero-Doc/Drive/GPIO_file.html

注:wiki 不是以 wiki 而 wiki,不管是何种形式,都可以称之为 wiki

又如:https://www.bilibili.com/video/BV1o34y1h76N
这也是我自称之为一种的 wiki 形式,由于历史原因,该项目并不是特别明确为一个 wiki ,而是一种易于检索的信息存储

我其实都弃坑了joy

Reply View the author