制作我的第一颗宝石 - 我从哪里开始？

Question

所以我有一个RubyGem的想法，我认为这将是一个很棒的经验，可以了解更多关于Ruby和Rails但是......我不知道从哪里开始。

我的想法是生成一个文件夹“articles”，您可以在其中放置markdown文件。在此文件夹中，主博客页面仅显示标题作为文章本身的链接。

听起来很简单，但老实说我不知道​​从哪里开始。如果我想在routes.rb中插入行，生成一个文件夹并在Rails中显示markdown，你建议我阅读哪些文章？

Answer 1

我会推荐其中一个用于创建宝石的教程：

• http://net.tutsplus.com/tutorials/ruby/gem-creation-with-bundler/
• http://railscasts.com/episodes/245-new-gem-with-bundler

要修改routes.rb文件，您只需要File.open来读取行。使用正则表达式确定要插入行的位置，然后将文件写回。

要创建文件夹，请查看Dir.new

的文档

对于Ruby / Rails中的Markdown，我喜欢rdiscount gem：https://github.com/rtomayko/rdiscount

铁路提供了一种很好的方式来做这样的事情。您可能会使用http://api.rubyonrails.org相当多。该网站上有一些Railtie文档：http://api.rubyonrails.org/classes/Rails/Railtie.html。

Answer 2

我建议您阅读RubyGems guides - 尤其是What is a gem?，Make your own gem和Patterns。

由于您可能已经在使用Bundler，因此可以运行bundle gem <name>来生成包含已有内容的gem项目。它确实可以节省工作量，但如果您不理解某些内容，请参阅指南。

另外，观看一些open source projects on GitHub - 观察其他开发人员并注意他们如何做事确实有帮助。

Answer 3

最简单的方法可能是阅读其他与你想要完成的事情类似的宝石。从他们的.gemspec文件开始，这些文件将列出gem工作所需的所有其他文件，以及gem依赖项列表。

Answer 4

更多地回应如何开始创建宝石，以下是两个可以帮助您的流行的，有文档记录的宝石。

1. https://github.com/seattlerb/hoe
2. https://github.com/technicalpickles/jeweler

此外，尽管它比您尝试使用gem （它是一个静态网站生成器）更多，但https://github.com/mojombo/jekyll是一个非常受欢迎的宝石{{1将文件放入.markdown目录，通过rake转换为静态HTML页面。我想你至少可以找到一些你在那之后的功能。