[Exchange and share] DTK开发文档,只有文字、参数描述,没有实际的图片代码示例展示
Tofloor
poster avatar
deepin
2022-09-07 08:23
Author

在查看DTK开发文档时,发现开发文档中的一些控件、事件只有文字描述、没有详细的图片、代码案例展示,有时自己不得不去github、gitee或者QT开发框架的官网去重复查找,希望后期能加入详细的展示内容,比如窗体、控件、事件代码的图片,让刚入门的开发者在查阅参考时更加直观一些。

13AD1A28B3A1337B9652ECCBC30C35DC.jpg

既然官网已经上线DTK开发套件的参考内容,就不应该向以前的github、gitee开源代码仓那样让开发的案例过于文字化,而应该是更加直观的图文并貌。

Reply Favorite View the author
All Replies
deepin
2022-09-07 08:26
#1

实际上很多刚入门的Linux开源软件开发者,更喜欢“图片+代码案例”的方式,而不是存文字的形式。

Reply View the author
deepin
2022-09-07 08:33
#2

实际上,deepin官网有别于以往的gitee、githu开源代码社区,deepin官网提供的DTK开发文档,更具有面相入门级DTK 开发者的性质。

Reply View the author
寂静的羽夏
deepin
2022-09-07 17:00
#3

这个文档目前来说的确很不友好,例子太少(文档其实也不太完整好看),目前如果想用它开发学习的话,我的建议是看用 DTK 开发的软件应用代码,clone 一下,看看到底是咋写的。

最好把 DTK 的源码也拉下来,毕竟有时候你查文档也不知道提供的函数是啥,还是 DTK 特有的,不是从 QT 直接继承过来的。

不过做好这件事情真是个比较重的体力活……

sweat

Reply View the author
BLumia
deepin
2022-09-07 17:26
#4

你截图的这个页面列出的其实都是 Qt 的文档的中文(部分)译文,比如你当前截图所在的页面对应到的是这里

现在 DTK 文档确实不太全,不过如果详细而言的话, DTK 里比较需要图片描述的应该就是 dtkwidget 里各种组件的样式预览了,我们其实有准备对应的图片的,但文档网站上的版本还需要更新。以及我们下一步的计划是像 Qt 一样提供文档包,可以让开发者在 QtCreator 里直接看到和查到相关的文档,并在文档网站提供一样的内容,不过这次文档包的更新错过了 20.7 的版本发布,可能会晚一些才能提供了。

(顺带一提,现在其实有个非官方性质的在线文档,在 这里看到你提到图片我才发现最近的修改好像 break 掉了文档里的图片展示,我稍等修一下... 编辑:是有图的,更新链接到了个有图的页面)

顺便,能参与到这个讨论的一定是开发着了,也欢迎 DTK 开发者加入 Telegram / Matrix (注:这俩渠道是互通的,只需加其中一个)等讨论群来摸鱼like

Reply View the author
神末shenmo
deepin
Spark-App
Q&A Team
2022-09-07 17:44
#5

dtkwidget项目中有一个dtk example,中有各种widget的用例,可能会有帮助

Reply View the author
depend
deepin
2022-09-07 19:10
#6

其本身是基于默认qt扩展的,大部分使用和qt无差别,不过在使用dtk之前你要考虑到这个程序可能以后只在deepin和uos上兼容性好了,其他平台就不太好运行了

Reply View the author
BLumia
deepin
2022-09-07 19:25
#7
depend

其本身是基于默认qt扩展的,大部分使用和qt无差别,不过在使用dtk之前你要考虑到这个程序可能以后只在deepin和uos上兼容性好了,其他平台就不太好运行了

目前情况确实是这样,不过提升可移植性,确保在其它环境下正常工作也是后面的目标。如果有意向一起提高可移植性的话可以考虑来 dde-porting 小组一起玩(

Reply View the author
ljq790615
deepin
2022-09-08 15:14
#8

其实用久了也就习惯了,开源世界的软件简介,好多都不上界面图,对于新手来说就是痛苦的看文字。

Reply View the author
deepin
2022-09-09 01:34
#9
ljq790615

其实用久了也就习惯了,开源世界的软件简介,好多都不上界面图,对于新手来说就是痛苦的看文字。

deepin官方的DTK开发文档,一般是开发者入门的文档,如果全部都是文字,确实体验不太友好。而github、gitee等开源代码仓则是有一定QT、DTK开发经验的程序员,才可以参与。

Reply View the author
deepin
2022-09-09 01:35
#10
ljq790615

其实用久了也就习惯了,开源世界的软件简介,好多都不上界面图,对于新手来说就是痛苦的看文字。

deepin官方的DTK开发文档,一般是开发者入门的文档,如果全部都是文字,确实体验不太友好。而github、gitee等开源代码仓则是有一定QT、DTK开发经验的程序员,才可以参与。

Reply View the author
deepin
2022-09-09 01:35
#11

deepin官方的DTK开发文档,一般是开发者入门的文档,如果全部都是文字,确实体验不太友好。而github、gitee等开源代码仓则是有一定QT、DTK开发经验的程序员,才可以参与。

Reply View the author