DocumentCloud’s users are a diverse lot, to say the least. In some newsrooms skilled programmers are busy writing python wrappers for our API, while in other users are embedding documents with no programmers to be found.
If you’re trying to integrate DocumentCloud with blogging software like WordPress or Blogger, we can help. Below is a rundown of the software users have already asked for our help with — and our findings on how it went. If you’re using a different system, and embedding doesn’t seem to “just work,” let us know. We’ll see if we can help.
- Blogger / Blogspot: It is possible to embed documents in Blogger blogs. Blogger’s content column is quote narrow — just 410 pixels wide — so you’ll definitely want to use a fixed size viewer. Use the HTML tab, not the Compose tab to write your post. Blogger will manually add line breaks, even in the HTML tab, so when you paste the embed code, you’ll have to edit out all the line breaks. Your embed code should be one long string of text. It isn’t pretty, but it will work.
- Drupal users shouldn’t have trouble embedding DocumentCloud code, though your results will depend on the content filters you have enabled. Just be sure you aren’t pushing stories through any content filters that will add line breaks or otherwise corrupt the embed code. The good folks at Phase 2 wrote a Drupal module that uses our API, too. We haven’t tried it out but we’d love to know how its working out for you!
- WordPress:Embed DocumentCloud documents, sets, and notes in WordPress blogs by using the HTML tab. If you edit a post using the Visual tab, you’ll break embedded scripts, however. So stick to the HTML tab once you’ve successfully embedded DocumentCloud code.
- WordPress.com: Unfortunately, WordPress.com does not allow
<script>tags. You won’t be able to use DocumentCloud to embed documents on a WordPress blog hosted at WordPress.com. A decent number of modestly priced web hosts will host WordPress blogs, however, without the limitation on script tags. This blog is hosted on Dreamhost.
The blogging systems above are ones we’ve already helped our users troubleshoot. Don’t hesitate to contact us if you need help incorporating DocumentCloud into another content management system!