知道什么

• 定义要在浏览器中查看的PDF文件，但要记住Drupal版本、任何许可费和用户数量。
• 在Drupal.org上搜索PDF查看器模块页面，比较每个选项的优缺点。选择一些可能的选择。
• 评估每个PDF查看器模块，看看它能满足您的需求。

本文解释了如何选择Drupal7模块来查看PDF。它包括对几个潜在模块的评估。

定义你想要的

想象一下，一个客户要求您向公司的Drupal站点添加一个新功能：在浏览器中显示PDF文件。当你浏览drupal.org上的选项时，你会发现有很多选项供你选择。

第一步是定义你想要什么。一般来说，这些是您所期望的相当标准的需求。

• 在web浏览器中查看PDF文件的能力，类似于此示例。客户将上传公司时事通讯的PDF文件，访问者将能够轻松阅读这些文件。
• 该站点是Drupal7，因此该模块需要与该主要版本相匹配。（Drupal7已经推出一段时间了，所以如果模块开发人员还没有推出Drupal7版本，他们可能不会。）
• 您可能还希望避免依赖第三方服务。对于视频，您可能很乐意将内容发布到YouTube或Vimeo，然后将其嵌入Drupal网站，但对于PDF，我们认为可能的额外曝光不会超过潜在的麻烦、破损和费用。
• 您可能希望使模块尽可能轻量级和具体化。您可能正在寻找更像Colorbox的东西，它可以放大图像以便更好地查看，但与您选择如何管理图像文件完全无关。
• 与往常一样，我们希望遵循选择Drupal模块的一般准则。基本上，选择一个已经被几千人（如果可能的话）使用了一段时间的模块，具有最少的依赖性，它似乎由一个活跃的开发人员维护，该开发人员计划在将来继续支持该项目，并且不需要支付许可费。

在drupal.org上搜索

考虑到这些目标，下一步就是在Drupal.org上进行简单的搜索。是时候跳进模块善良的球坑了。

pdf模块的“比较”页面

我的第一站是（或者应该是）这个页面：PDF查看器模块的比较。Drupal.org有一个优秀的文档页面传统，在同一空间中概述各种模块的优缺点。有一个比较页面的中心列表，但它们也散布在整个网站上。

PDF比较页面包括四个PDF查看器模块。我们将在这里介绍他们，以及我们在搜索中发现的其他一些人。我们将从决定跳过的候选人开始。

现在，让我们深入了解为什么这些模块（或大部分模块）在这个项目中不起作用。

谷歌浏览器文件格式化程序

Google Viewer文件格式化程序就是它听起来的样子：一种使用Google文档在网页中嵌入文件显示的方法。尽管我们喜欢谷歌文档的多功能性，但我们的目标之一是保持独立于任何第三方服务。

此外，此模块的安装次数不到100次。

ajax文档查看器

虽然“AJAX”是一个通用的Javascript术语，但事实证明AJAX文档查看器依赖于特定的第三方服务。只有大约100次安装。继续。。。

烫伤pdf

滚烫PDF只有40个安装，但我们必须看一看，因为它显然是一个更大的项目（是的）滚烫的一部分。正如烫伤项目页面所解释的：“烫伤是关于如何在Drupal中处理媒体原子的创新。”

这句话引起了两个巨大的危险信号：“创新性”和“媒体”与“原子”的搭配“原子”显然是“事物”的一个改用词，这使它本身成为了一面红旗。Drupal喜欢使用这些空盒子类型的词：节点、实体、特征。。。这个词越笼统，变化就可能越广泛。

你会读到一些激动人心的言论，说烫伤将彻底改变你在网站上处理媒体的方式。

现在，事实是Drupal的媒体处理需要一些创新。烫伤不是这个领域唯一雄心勃勃的项目。

烫伤可能是下一个观点。那太棒了。但它也可能是废弃的，留下（一小部分）残破的痕迹让人哭泣。

暗箱

Shadowbox让我们大吃一惊：它声称是显示各种媒体的单一解决方案，从PDF到图像再到视频。这并不像烫伤那样彻底，因为它只关注于显示媒体，而没有引入“媒体原子”等全新概念。但正如前面提到的，我们已经喜欢Colorbox了。

然而，我们确实注意到（内心发出呻吟）在16000多个安装中，Shadowbox可能是同一空间中更强大的替代品。我们必须看一看。

Shadowbox Drupal模块基本上是连接Javascript库Shadowbox.js的桥梁，因此我们查看了该库的网站。在那里，我们发现了两个继续前进的理由：

• 图书馆的商业使用需要支付许可费。收费很合理，但我们尽量避免使用非免费的开源软件。
• 仔细搜索FAQ发现，与Drupal模块页面上的描述相反，Shadowbox库并不100%支持PDF。哎呀。

两位竞争者：“pdf”和“pdf阅读器”

在排除了其余部分之后，我们现在看到了两个明显的竞争者：PDF和PDF阅读器

这两个项目有着关键的相似之处：

• 两者都有近3000次安装，远远超过其他选择（除了Shadowbox）。
• 两者都使用相同的外部Javascript库pdf.js。

差异是什么？

PDF阅读器还可以选择Google文档集成。

同时，PDF被标记为“寻找共同维护者”。这可能是一个迹象，表明开发人员将很快放弃该项目，但另一方面，最近一次提交是在一周前，因此至少开发人员仍然活跃。

另一方面，PDF阅读器被标记为“积极维护”，但最近一次提交是在一年前。

没有一个明确的赢家，我们决定测试他们两个。

测试竞争者

我们在我们的实时站点副本上测试了这两个模块(无论一个模块看起来多么坚固和无害，千万不要先在一个活动的站点上尝试它。你可能会破坏整个网站。）

我们倾向于PDF阅读器，因为它似乎比PDF有更多的选项（比如谷歌文档）。所以我们决定先试试PDF，让它不碍事。

pdf失败：需要编译吗？

然而，当我们安装PDF并阅读“README.txt”时，我们发现了一个在项目页面上看到但被忽略的问题。出于某种原因，此模块似乎要求您手动编译pdf.js。尽管项目页面表明这不一定是必需的，但README.txt建议是必需的。

因为PDF阅读器将使用完全相同的库而不需要此步骤，所以我们决定先尝试一下。如果它不起作用，我们可以返回PDF并尝试手动编译PDF.js。

pdf阅读器：成功！某种程度上

所以，我们终于尝试了PDF阅读器。此模块提供了一个用于显示文件字段的新小部件。将文件字段添加到所需的内容类型，并将小部件类型设置为PDF Reader。然后，创建此类型的节点并上载PDF。PDF显示在页面的“框”中。

通过再次编辑内容类型并更改字段的显示设置，可以尝试不同的显示选项。

我们发现每个显示选项都有其优点和缺点：

• GoogleDocs阅读器作为一个嵌入式系统工作得很好，但是当我们点击它进入全屏时，我们看到了一个GoogleDocs页面，它向我们道歉说我们的费率限制被超过了。哎呀。如果我们把这个模块连接到一个付费的谷歌应用程序帐户上，也许这会更可靠，但我们没有费心去发现。
• js选项在Firefox和Chrome上运行得非常好。但是当我们启动InternetExplorer时，这个盒子看起来是空的。显然，这是pdf.js本身的问题，而不是pdf阅读器模块的问题。我们认为这是意料之中的，因为pdf.js是由Mozilla开发的，InternetExplorer本身就是。不过，令人失望的是，我们没有想到首先要确认pdf.js在所有浏览器中都能可靠地工作。
• 嵌入选项是最可靠的。这实际上是在网页上的一个框中运行Adobe Reader。Firefox仍然倾向于运行pdf.js，但我们认为这是一种浏览器设置。不管怎样，只要访问者有Firefox或Adobe Reader之类的PDF查看器，PDF就会显示出来。

因此，最终，我们的解决方案是使用带有嵌入显示选项的PDF阅读器。此选项将允许您将PDF附加到Drupal节点，并在Drupal网页上可靠地显示它。

不幸的是，有时“可靠”是不够的。