Latest Updates: Our Blog

Frequently Answered Questions: Blogging Tools

Posted
May 30th, 2011

Tags
Workspace ,

Author
Amanda Hickman

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!
    • Tumblr wraps any javascript you embed in a post with CDATA tags. You won’t be able to embed documents, sets, or notes in Tumblr blogs. Sorry.
    • 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. UPDATE: We’re finding that some instances add paragraph tags in, even if you’re using the HTML tab, so you may need to strip the line breaks out of the embed 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!

5 Responses to 'Frequently Answered Questions: Blogging Tools'

Subscribe to comments with RSS

  1. How about a Joomla plugin? Do you know of any projects in the works to implement DocumentCloud for Joomla sites?

    Scott Koegler

    4 Jan 12 at 3:24 pm

  2. I don’t, actually. If you’ve tested it out, I’d love to know how it went!

    amanda

    11 Jan 12 at 6:34 pm

  3. There is now an addon that brings the power and beauty of DocumentCloud’s document viewer to Plone: http://pypi.python.org/pypi/collective.documentviewer/.

    Jon Stahl

    20 Apr 12 at 11:34 pm

  4. WordPress.com now fully supports oEmbed via their public api; any chance you guys are interested in making that option available via DocumentCloud?

    Charles Schultz

    11 Apr 14 at 1:36 pm

  5. Apologies for a long-delayed reply, but DocumentCloud now has an oEmbed API. You can read up on it via our Help docs at https://www.documentcloud.org/help/api.

    Even better, our WordPress plugin has seen a bunch of updates in the last year, so check it out if you haven’t already: https://wordpress.org/plugins/documentcloud/

    Anthony DeBarros

    21 Jan 16 at 3:28 pm

Leave a Reply