This weekend I made the ambitious move to using Discourse.org for my blog and also upgrading Octopress to the latest version which supports Jekyll 2.0. Here’s my notes, so that you can evaluate if you want to do either of these, as well as how to do this efficiently.
What motivated me to migrate comments to Discourse?
- I already wanted to create a forum for my website, so integrating blog comments seemed worth pursuing. This is what BoingBoing uses for its blog articles. Click on the “Discuss” link below any BoingBoing article and get taken to the Discourse topic for that article.
- I wanted to be able to have more engaging conversations with my programmer friends on the topics which I’m blogging about.
What’s super cool about doing the conversion?
- Discourse will automatically create topics for each of your blog posts. You can see that here: http://forum.railsonmaui.com/category/blog
- Discourse can import the Disqus comments from your blog!
What this looks like on the blog, http://www.railsonmaui.com
What this looks like on the forum, http://forum.railsonmaui.com:
I ran into one difficult issue with the upgrade. The issue was the very frustrating:
bin/ruby_executable_hooks:15: stack level too deep (SystemStackError)
How did I solve the problem?
Naturally the first thing to do is to google the error message. That was not particularly helpful.
Since I assumed that this problem would be pretty specific to my Octopress site, I guessed that the issue was related to a rogue Jekyll plugin.
I moved all my plugins that were not part of standard Octopress into a
/plugins_removed directory, and then added back my plugins one at a time. That
helped me narrow down the issue to the
jekyll_alias_generator plugin, which
sets up redirects when you change the URL of a published blog articles.
And here’s the solution: Stack level too deep error #14, which is to replace
lines 73-75 in
alias_generator.rb with this code:
1 2 3
Update: rather than using the AliasGenerator plugin, use: jekyll/jekyll-redirect-from
Another issue I hit was that I had a few template files that were using
This results in errors like:
Build Warning: Layout 'nil' requested in atom.xml does not exist.
This got changed in the recent version of Jekyll to use
null, like this:
So grep your files for
layout: nil and change those to
Installing Discourse for Blog Comments
This is well described in the following articles. I’ll give you my specific steps below.
- Setting up discourse on Docker: github: discourse/docker and discourse/docs/INSTALL-digital-ocean.md. You can probably do fine on a $10/month plan. The trickiest parts is to be sure that you do every step very carefully. It’s very easy to make one typo and to then slow the process down!
- Embedding Discourse in Static Sites is the primary source of information on converting from Disqus to Discourse for your blog comments.
- Discourse plugin for static site generators like Jekyll or Octopress: Specifics for Octopress and Jekyll.
Once you configure your Discourse site to import your blog articles, you’ll have to wait a bit for the rake task to run. It’s great being able to kickstart the content of the forum with one’s blog articles!
The configuration of Discourse for blogging is super easy.
- Configure the following settings, taking note that:
- The urls are to your blog and include the subdomain, like
- The embeddable host does not include
- The feed polling URL does include
- The urls are to your blog and include the subdomain, like
- I added a category called “Blog”.
- I created a user called “disqus” for users not found in the Disqus comment import.
Octopress Discourse Comments Setup
- Remove or comment out your Disqus setup in your
1 2 3 4
# Disqus Comments # Removed as support for Discourse comments added # disqus_short_name: railsonmaui # disqus_show_comment_count: true
Note, I first commented it out, because I toggled this on and off as I was ensuring that the comment migration worked correctly, and none were missed.
- Add the plugin contained in discourse_comments.rb to your
/pluginsdirectory. This plugin will append a DIV to your posts like this:
1 2 3 4 5 6 7 8 9 10 11id="discourse-comments">
- Note that the display of comments only works on your live website, due the fact that the Discourse server checks the source of the request for the comments (per the above image of the configuration).
Detailed instructions for importing your Disqus comments into Discourse
The following instructions will allow you to import the comments from Disqus, along with creating associated users for those comments. This is a GREAT way to kickstart the forum.
- Download an XML backup of your Disqus comments by logging into your Disqus dashboard. The URL is like https://youraccount.disqus.com/admin/discussions/.
- That should bring you to the Discussions tab. Then click the Export sub-tab.
It should look like this:
- Ssh to your docker instance
- Get into your docker instance.
root@forum:~# cd /var/discourse/ root@forum:/var/discourse# ./launcher ssh app
You’ll see this message:
Welcome to Discourse Docker Use: rails, rake or discourse to execute commands in production
- Sudo to discourse:
root@forum:~# sudo -iu discourse discourse@forum:~$ cd /var/www/discourse discourse@forum:/var/www/discourse$ bundle exec thor list
- Then you need to copy the XML file you downloaded from Disqus that contains
an archive of your comments. The easiest way to do this is to
scpthe file from some place accessible on the Internet. What I did was to
scpthe file from my local machine to my Digital Ocean machine, and then from my Digital Ocean machine to the Docker container. Here’s an example:
On your local machine, with the XML file (XXX.XXX.XXX.XXX is the ip of your droplet):
scp ~/Downloads/railsonmaui-disqus.xml root@XXX.XXX.XXX.XXX
Then inside of your docker container:
discourse@forum:/var/www/discourse$ scp root@XXX.XXX.XXX.XXX:railsonmaui-disqus.xml .
That puts the file
railsonmaui-disqus.xmlin the current directory.
- Run the thor command:
discourse@forum:/var/www/discourse$ bundle exec thor disqus:import --file=railsonmaui-disqus.xml --post-as=disqus --dry-run /var/www/discourse/vendor/bundle/ruby/2.0.0/gems/activerecord-4.1.6/lib/active_record/connection_adapters/postgresql_adapter.rb:898:in `rescue in connect': FATAL: database "discourse_development" does not exist (ActiveRecord::NoDatabaseError) Run `$ bin/rake db:create db:migrate` to create your database from /var/www/discourse/vendor/bundle/ruby/2.0.0/gems/activerecord-4.1.6/lib/active_record/connection_adapters/postgresql_adapter.rb:888:in `connect'
The problem is that we need to specify the environment, as is standard with Rails apps:
RAILS_ENV=production bundle exec thor disqus:import --file=railsonmaui-disqus.xml --post-as=disqus --dry-run
That command does the trick and gives you a nice message indicating what it will do once you remove the
discourse@forum:/var/www/discourse$ RAILS_ENV=production bundle exec thor disqus:import --file=railsonmaui-disqus.xml --post-as=disqus --dry-run Creating Favorite RubyMine Tips - Rails on Maui... (8 posts) Creating Octopress Setup with Github, Org Mode, and LiveReload - Rails on Maui... (3 posts)
Once you verify, run:
RAILS_ENV=production bundle exec thor disqus:import --file=railsonmaui-disqus.xml --post-as=disqus
This creates the comments and the users. Creating the users surprised me as I didn’t know that the Disqus export contained the users’ email addresses. So this script ends up triggering activation emails to all those users!
This is all pretty neat! Not only did I get my new forum populated with some content, but I also created users who commented on my posts in the past. I’m hoping I can engage in more meaningful discussions regarding the technologies that I blog about with my own forum. Please do sign-up for the forum so you can comment and receive periodic updates of what gets posted! Or just sign up when you want to post a comment. :-)
This is a companion discussion topic for the original entry at http://www.railsonmaui.com//blog/2014/09/27/updating-to-jekyll-2-and-discourse-for-comments/