首页 文章

DotNetNuke文档在很大程度上是无效的,还是仅在商业版中提供?

提问于
浏览
8

只有当您支付2000美元或更高的专业或更高的许可证时才能使用a statement on the DotNetNuke pages about the documentation . 尽管DNN社区努力跟上需求,但论坛上充斥着许多问题,其中很多都是重复的 . [3019467_]

我已经尝试了这些书,但他们没有提供我所寻找的答案,虽然作家的热情很明显,但大型锅炉板示例的冗长印刷以及新引入的关键词缺乏信息或覆盖范围并没有让我更深刻地理解我作为模块开发人员所渴望的 .

一方面我觉得DotNetNuke是一个很棒的地方,但另一方面,每当我需要一个方法的单行信息时,我最终会寻找它多年,并逐步完成代码和逆向工程是我最好的朋友 .

我很好奇,为什么一款产品已经存在了这么长时间,因此对API的数量记录不足?毕竟,它背后有一个相当大的商业公司,它因产品的可扩展性而蓬勃发展 . 我是否理解您只有付出高昂代价才能获得此文件?或模块开发公司有特殊访问权限吗?

7 回答

  • 1

    我相信他们不会故意公开记录核心代码,因为他们只希望您在他们为创建模块提供的系统的约束下工作,因为他们在模块创建指南中记录 . 因此,他们鼓励您将核心代码视为私有代码 . 我以前用其他CMS软件看过这个 .

  • 5

    我在这里发布第二个答案,因为修改后的问题有一个完全不同的方式来看待事物 .

    关于DotNetNuke专业版用户手册,我认为您完全理解手册是非常重要的 . 它不是开发人员指南或API文档,而是用户界面文档 . 如何添加页面,如何将模块添加到页面,如何安装皮肤,这种性质的东西 . 是的,那本书是一个“PE功能”,对错或者无动于衷,它不会帮助开发人员了解DotNetNuke平台 .

    我认为这是一个重要的区别,因为PE功能集实际上是推动业务实现,而不一定是开发人员实现 . 改善开发人员文档和开发人员功能的整个过程由社区推动,而不一定是PE客户 .

    还有其他原因,PE附带了一些最近被DotNetNuke公司收购的模块,这些模块也必须有文档,我猜测是UI文档的另一部分,由你的链接引用这篇文章 .

    至于论坛,是的,我同意他们可能会感到沮丧 . 这是我的网站上的论坛(http://www.mitchelsellers.com)经常光顾的原因之一,因为它们的曝光度更高一些 . 另一个可能对社区有用的项目是我最近提出的DotNetNuke StackExchange site . 如果你没有't done so already, I' d出去表示你的支持!

    总的来说,虽然我确实感受到了你的痛苦,但我已经成为DotNetNuke社区的活跃成员已有4年多了,而且有时可能很难,但最终总是值得的 .

  • 1

    目前,我将避免使用最有可能推动我书籍写作风格的论证语气,并给出一些指示 .

    • API文档可用,但从真正的API角度来看,文档还不是100% . DotNetNuke参考团队正致力于提高本文档的质量,但正如您所想象的那样,需要很长时间才能获得没有太多(如果有的话)API文档需要完整记录的内容,但这就是最终目标 .

    • 现在的书籍是关于DNN开发的最好的整体文档,但它们只涵盖了流程的某个部分 . 例如,我的书中有一个记录新DNN 5.x清单格式的唯一项目,但由于该书已经超过一年,因此已在清单中添加了本书未涵盖的项目 .

    • DotNetNuke公司正在尝试通过创建新的Wiki项目并获得API文档来提高文档的质量和可用性,但这是一个循序渐进的过程 .

    但是为了完成这个,让我快速给你一个建议,我们在DotNetNuke社区中有很多人为了帮助其他人了解DNN并在StackOverflow,DotNetNuke上花费我们所有的时间来帮助他人 . .com,甚至我们自己的个人论坛 . 如果你采取一些较少的议论方法,你可能会得到一些更好的答案,至少你不会冒着激怒真正可以为你回答问题的人的风险 .

  • 3

    虽然缺乏易于获得的文档,可以详细解释API,可以满足您的直接需求和标准,因为Mitchel声称DNN拥有设计师和开发人员最好的“社区”之一,他们竭尽全力帮助每个人其他的 .

    有很多书都是为了让一个程序员或有思想的人与DNN一起工作,尽管他们可能没有给你在特定领域寻找的细节我相信没有一个作者会如果您联系他们,请尽量回答在阅读本书后未回答的问题 . 有许多博客和网站充满了信息和论坛,人们愿意与那些想要学习的人分享他们的知识 . 我从一开始就按小时为基础聘请了一些与DNN合作的人员进行定制培训(就像在我问问题时他们回答的不是一个带有“预先设计”课程的课堂) . 大多数销售模块的网站也都有论坛,这些开发人员也会帮助其他人学习 .

    在短时间内,持久性将与任何其他框架或语言一样得到回报 . 正如米切尔所说'你可以用蜂蜜捕获更多的苍蝇而不是用醋'

    顺便问一下,你有什么特别需要的吗?

  • 0

    DotNetNuke用户手册现已在线提供here . 我相信5.5.0的更新即将推出 .

    作为DotNetNuke Corp.开发团队的最新成员(现在大约2个月),我可以向您保证,没有秘密的API文档 . 我有一份在codeplex上的相同API文档的副本 . 毫无疑问,API文档是有限的,绝大多数DNN是由志愿开发人员编写的,他们宁愿编写代码而不是编写注释,这个问题在开源项目中并不罕见 . 我对DNN开发者社区其他成员的唯一优势是可以轻松访问一些知道事情如何工作的长期核心团队成员 .

    有一个项目正在扩展API文档,DNN公司正在参与,并且一如既往地鼓励社区贡献 . 最近,Ernst Peter Tamminga正在写博客文章here .

  • 0

    一年前我注意到了这一点(正如我的SO历史可能证明的那样) .

    部分是为了填补这个空白,我阅读了大红色书籍并观看了许多很多培训视频 . 我现在正处于一个相当大的项目的第二年; ~50个自定义DNN模块和两个DNN Core更改:Speedy URL重写系统(超出URLMaster的容量)和自定义404/301处理程序 .

    在我看来,阅读书籍,找一些你喜欢的培训视频,你很快就会上路 . 花了几个月的时间来安装DNN模块(针对一个客户端)并修改DNN核心 . 话虽如此,几周后我确实有一些粗略的模块正在运行 .

    如果这些都听起来不错,那么就在这里问你的问题 - 这里有足够的社区,这是一个非常好的资源 .

  • 1

    当我在DotNetNuke中寻找公共API调用时,我使用.NET Reflector . 如果您之前没有使用它,我认为它可能正是您正在寻找的(或更多) . 它允许您搜索类,方法和属性 . 你可以用DotNetNuke作为搜索前序来过滤掉非DNN的东西 . 当您找到看起来正确的内容时,它可以让您查看确切的代码 . 它是免费的,你永远不必担心它会过时,因为你总是可以参考最新的DNN dll .

相关问题