17

我目前正在为Redmine开发一些插件,我必须说,我对这个主题缺乏文档感到有点失望。编写Redmine插件的好文档

通常情况下,如果我正在寻找有关类/方法的解释,我需要花费一定的时间浏览核心类,并努力理解写在那里的代码(似乎有些人忘记记录它们代码,不幸)。

我检查了他们的论坛http://www.redmine.org/projects/redmine/boards,它似乎需要永久才能回答问题。

这就是为什么我想就这个问题提供一些关于API文档/书籍/论坛的建议。

+0

在freenode.net IRC频道#redmine可以是更快的周转在答案更加有用。 – GuruM

+0

如果我的答案有帮助,请接受您的问题的答案。 – GuruM

回答

9

更好的文档是codesource。 Redmine的主要用户几乎都在Redmine的插件github上。

你可以选择任何插件,看看是什么样子。主要是它是关于元编程和alias_method_in_chain使用

+0

这似乎不是答案,但为自己节省很多头痛,并相信我们是这样。插件实际上并不难写。脱离已经写好的内容,你应该能够找出如何做大部分事情。 – Milimetric

+1

是的,我也无法找到一个好的'文本'文档如何为Redmine编写插件。如果你能找到它,你可以让我知道吗? – Anatoly

+0

我正在考虑编写一些教程来帮助其他人比我更快地开始工作,一旦我获得了更多的经验。如果我成功了,我可能会在这里发布链接。感谢您的答案 –

6

由于在redmine wiki page about plugin hooks说:

有有效挂钩的列表。但找到它们的最佳方式是只需查看代码即可找到您想要扩展的位置并搜索附近的挂接电话。

看来浏览过的核心类以及寻找其他的插件是要走的路。

我假设你已经发现了所有的相关插件维基文件:

至于论坛上的反应性,你可以试着在forum of chiliproject上提问,最近redmine的分支。不知道它有多少已经改变。

+2

Redmine和ChiliProject 1.x非常接近,我们试图尽可能保持兼容性。 ChiliProject 2.x有一些重大变化,尤其是在期刊(问题注释)方面。旧代码仍然可以工作,但需要进行测试和移植。我的插件中大约50%没有任何更改,40%使用Gemfile for bundler,其余的需要更新。 –

12

我知道这可能对于原始问题海报来说太迟了,但可能会帮助处于类似情况的其他人。下面的链接是一个新手(像我一样)到RubyOnRails,但是之前编程过的人。你可以根据你的技能水平选择和选择相关的。

了解管理平台(功能):
如果你不熟悉的管理平台或其他管理问题跟踪软件Mastering Redmine本书是一个好的开端。它不是非常密集的,所以它只会帮助我们作为一个结构化的信息组织。如果你想要更密集的信息,而不是通过文档。

了解管理平台插件:
"Redmine Plugin Extension and Development" by Alex Bevilacqua刚刚发布(2014年3月)。它可以从packtpub以印刷和电子书格式获得。

我正在阅读本书,因为我需要自定义/重写Redmine的插件。 我是Rails/Ruby/Redmine的新手。尽管我来自Unix/C++背景,但仍然通过以下书籍了解Ruby,Rails和Redmine的知识。

了解Rails的:
我发现这本书Agile Web Development with Rails是一个足够好的介绍到Rails从其他语言的程序员。
注意:目标受众似乎是Rails开发人员,但应该可以通过浏览github redmine插件库来获得该学习曲线。

理解红宝石:
Programming Ruby (the PickAxe Book)

了解Ruby的元编程成语(Rails中使用):
表面上红宝石看起来像大多数脚本语言是使用元编程和Ruby的动态特性对象模型允许复杂的内部体操对新手不可见。

单行Rails代码包含足够的这种技巧来填充一本小书。
幸运的是,这样的一本书已经被编写 - Ruby MetaProgramming本书在Pragmatic Programmers系列中。掌握基于Mixin的Dynamic MetaProgramming是非常棒的。 Rails和Redmine使用大量的这些技巧作为钩子等来完成工作。

Excellent Video on Ruby Object Model by Dave Thomas
Video on Ruby Object Model and Meta Programming