# Dedicated Stan blog

**URL:** https://discourse.mc-stan.org/t/dedicated-stan-blog/3402
**Category:** General
**Tags:** blog
**Created:** [February 24, 2018, 10:56pm UTC](https://discourse.mc-stan.org/t/dedicated-stan-blog/3402 "2018-02-24T22:56:59Z")
**Posts on this page:** 19
**Page:** 1

<div class="post-metadata">

### Author: ![Bob\_Carpenter](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.mc-stan.org/bob_carpenter/32/9230_2.png) [@Bob\_Carpenter](https://discourse.mc-stan.org/u/Bob_Carpenter)
#### Post date: [February 24, 2018, 10:56pm UTC](https://discourse.mc-stan.org/t/dedicated-stan-blog/3402/1 "2018-02-24T22:56:59Z")

</div>

I’d like to start a dedicate Stan blog at `<blog-name>.mc-stan.org`.

_Question 1:_ What should we call it?

_Question 2._ Who oversees content?

For (1), I would prefer it not be too cute or obscure.

For (2), I think ultimate responsibility should rest with whoever oversees the web site, which is now Breck. Hopefully it’ll all stay civil and we can just trust people to post the same way we trust them to use the wiki.

_Question 3._ Where is it hosted?

- _WordPress_: nominal annual fee with domain mapping; supports MathJax; experience using WordPress among the team members; separate content and password management for blog; can’t edit comments (this drives me crazy they don’t let you do that yet).
- _GitHub_: free; content gets managed with rest of web site; no comments built-in, so we’d need external service like Disqus (anyone know others?); more control and more management required on our side to set up styles, etc.

If I had to do this tomorrow, I’d just go with WordPress because it seems easier. Though I’d feel bad about it because I like to do everything on GitHub.

---

<div class="post-metadata">

### Author: ![sakrejda](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.mc-stan.org/sakrejda/32/845_2.png) [@sakrejda](https://discourse.mc-stan.org/u/sakrejda)
#### Post date: [February 25, 2018, 2:39am UTC](https://discourse.mc-stan.org/t/dedicated-stan-blog/3402/2 "2018-02-25T02:39:00Z")

</div>

Question 4. Who has the time to write content?

---

<div class="post-metadata">

### Author: ![martinmodrak](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.mc-stan.org/martinmodrak/32/133_2.png) [@martinmodrak](https://discourse.mc-stan.org/u/martinmodrak)
#### Post date: [February 25, 2018, 8:22am UTC](https://discourse.mc-stan.org/t/dedicated-stan-blog/3402/3 "2018-02-25T08:22:07Z")

</div>

Just a thought: If the documentation was primarily a website (not primarily PDF as it is now), wouldn’t almost everything that could go on the official blog also belong to the docs? I think that between Discourse, wiki and the docs there is only a small room for content curated/created by the core team that is not covered by any of the three.

As for technology, I’ve had good experience setting up blog with blogdown (Rmd to blog), but that might need some tweaking if Python is to be supported.

As for name, `blog.mc-stan.org` is conservative, but IMHO conveys exactly what is going on.

---

<div class="post-metadata">

### Author: ![mike-lawrence](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.mc-stan.org/mike-lawrence/32/59_2.png) [@mike-lawrence](https://discourse.mc-stan.org/u/mike-lawrence)
#### Post date: [February 26, 2018, 12:44pm UTC](https://discourse.mc-stan.org/t/dedicated-stan-blog/3402/4 "2018-02-26T12:44:52Z")

</div>

> [@martinmodrak](#):
>
> As for name, [blog.mc-stan.org](http://blog.mc-stan.org) is conservative, but IMHO conveys exactly what is going on.

Agree on the URL. Name suggestion: “Samples”

---

<div class="post-metadata">

### Author: ![seantalts](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.mc-stan.org/seantalts/32/32_2.png) [@seantalts](https://discourse.mc-stan.org/u/seantalts)
#### Post date: [February 26, 2018, 3:28pm UTC](https://discourse.mc-stan.org/t/dedicated-stan-blog/3402/5 "2018-02-26T15:28:21Z")

</div>

I think you have good answers to all of those questions and I’m happy to go with your inclinations, especially as you are likely the one to do most of the blogging at first.

I’d like to second `blog.mc-stan.org` and a lofty goal of integrating / cross-linking more of our documentation (which seems to involve getting the manual into HTML).

---

<div class="post-metadata">

### Author: ![anon75146577](https://avatars.discourse-cdn.com/v4/letter/a/f07891/32.png) [@anon75146577](https://discourse.mc-stan.org/u/anon75146577)
#### Post date: [February 26, 2018, 4:52pm UTC](https://discourse.mc-stan.org/t/dedicated-stan-blog/3402/6 "2018-02-26T16:52:33Z")

</div>

Having never used GitHub for blogging, WP is fine. It has a bit of a laggy interface if you’re writing long posts with lots of equations/pictures, but it’s perfectly workable.

I’m not sure I see the advantage of a git interface unless you’re looking to allow external people to make PRs as a way to do occasionally “external contributor” blogs. Git would be _much_ better than the WP system if this is what you’re looking for (afaik).

---

<div class="post-metadata">

### Author: ![wds15](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.mc-stan.org/wds15/32/908_2.png) [@wds15](https://discourse.mc-stan.org/u/wds15)
#### Post date: [February 26, 2018, 5:39pm UTC](https://discourse.mc-stan.org/t/dedicated-stan-blog/3402/7 "2018-02-26T17:39:22Z")

</div>

+1 for [blog.mc-stan.org](http://blog.mc-stan.org)

---

<div class="post-metadata">

### Author: ![Bob\_Carpenter](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.mc-stan.org/bob_carpenter/32/9230_2.png) [@Bob\_Carpenter](https://discourse.mc-stan.org/u/Bob_Carpenter)
#### Post date: [February 27, 2018, 6:39am UTC](https://discourse.mc-stan.org/t/dedicated-stan-blog/3402/8 "2018-02-27T06:39:06Z")

</div>

> [@sakrejda](#):
>
> Who has the time to write content?

There’s a bunch of stuff going out that would be good to put there. I write things and Daniel wanted to write some things.

---

<div class="post-metadata">

### Author: ![Bob\_Carpenter](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.mc-stan.org/bob_carpenter/32/9230_2.png) [@Bob\_Carpenter](https://discourse.mc-stan.org/u/Bob_Carpenter)
#### Post date: [February 27, 2018, 6:41am UTC](https://discourse.mc-stan.org/t/dedicated-stan-blog/3402/9 "2018-02-27T06:41:12Z")

</div>

> [@martinmodrak](#):
>
> If the documentation was primarily a website

That’s on the to-do list. I want to convert it to bookdown.

> [@martinmodrak](#):
>
> As for name, [blog.mc-stan.org](http://blog.mc-stan.org) is conservative,

I think we can use the url `blog.mc-stan.org` and call it “The Stan Blog”.

> [@anon75146577](#):
>
> WP is fine. It has a bit of a laggy interface if you’re writing long posts

Have you tried their hosted version or just Andrew’s? I find Andrew’s gets bogged down and even hangs and won’t let me log in from time to time. I found the WordPress version better.

---

<div class="post-metadata">

### Author: ![syclik](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.mc-stan.org/syclik/32/6_2.png) [@syclik](https://discourse.mc-stan.org/u/syclik)
#### Post date: [February 27, 2018, 2:11pm UTC](https://discourse.mc-stan.org/t/dedicated-stan-blog/3402/10 "2018-02-27T14:11:06Z")

</div>

Just a couple points on running a blog on GitHub (cause my personal one is there and so is Generable’s and I manage both:

- it’s a bit clunky:
  - it’s not GitHub directly, but it’s actually run through [Jekyll](https://jekyllrb.com/)
  - they implement a version of Markdown that isn’t really that well documented, so you’ll run into gotchas
  - customization is fairly hard to do
  - running locally is actually trickier than they make it seem; once up, it works.

- it’s easy to set up:
  - should take me an hour or less to get up and running
  - if we never stray from their default styles, it’s simple

- comments need to be managed by something like Disqus: once set up, almost no maintenance. But even Disqus has a freemium model.
- overall: it’s just not a real blog-in-a-box platform, so will require maintenance.

WordPress:

- Andrew’s blog isn’t hosted by WordPress directly due to cost (at the time). It looks like their pricing changed since then. Back then, I remember it was in the multiple hundreds of dollars per month.
- For our purposes, I think we’re far from any of those limits, so we can run it for free or on the cheap.
- It’ll handle most of the things we need.

---

<div class="post-metadata">

### Author: ![avehtari](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.mc-stan.org/avehtari/32/5935_2.png) [@avehtari](https://discourse.mc-stan.org/u/avehtari)
#### Post date: [February 27, 2018, 2:57pm UTC](https://discourse.mc-stan.org/t/dedicated-stan-blog/3402/11 "2018-02-27T14:57:29Z")

</div>

How well Wordpress works with equations? I would assume more equations in The Stan Blog than in Andrew’s blog.

---

<div class="post-metadata">

### Author: ![anon75146577](https://avatars.discourse-cdn.com/v4/letter/a/f07891/32.png) [@anon75146577](https://discourse.mc-stan.org/u/anon75146577)
#### Post date: [February 27, 2018, 8:20pm UTC](https://discourse.mc-stan.org/t/dedicated-stan-blog/3402/12 "2018-02-27T20:20:49Z")

</div>

Andrew’s Wordpress has a slightly annoying latex markdown. You write $latex [expression]$ and it usually works (sometimes it takes a few goes). I’ve done some posts with quite a few equations and it hasn’t been too annoying.

---

<div class="post-metadata">

### Author: ![mages](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.mc-stan.org/mages/32/1907_2.png) [@mages](https://discourse.mc-stan.org/u/mages)
#### Post date: [February 27, 2018, 9:15pm UTC](https://discourse.mc-stan.org/t/dedicated-stan-blog/3402/13 "2018-02-27T21:15:44Z")

</div>

As an alternative to GitHub you may want to consider GitLab, which makes it straightforward to host and deploy a blog using Hugo: [https://gohugo.io/hosting-and-deployment/hosting-on-gitlab/](https://gohugo.io/hosting-and-deployment/hosting-on-gitlab/)

If you plan to write your posts in RMarkdown then the combination with RStudio and the blogdown package makes this a fairly slick setup.

---

<div class="post-metadata">

### Author: ![Bob\_Carpenter](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.mc-stan.org/bob_carpenter/32/9230_2.png) [@Bob\_Carpenter](https://discourse.mc-stan.org/u/Bob_Carpenter)
#### Post date: [February 28, 2018, 10:28pm UTC](https://discourse.mc-stan.org/t/dedicated-stan-blog/3402/14 "2018-02-28T22:28:12Z")

</div>

> [@avehtari](#):
>
> How well Wordpress works with equations?

Better than GitHub about of the box because it supports MathJax. Math goes in as `$latex e^x$`.

It’s fine for blog authors, even if the rendering requires web access.

It’s a pain for commenters because there’s no way for them to preview. I can’t believe they haven’t fixed this yet on WordPress.

---

<div class="post-metadata">

### Author: ![Bob\_Carpenter](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.mc-stan.org/bob_carpenter/32/9230_2.png) [@Bob\_Carpenter](https://discourse.mc-stan.org/u/Bob_Carpenter)
#### Post date: [February 28, 2018, 10:30pm UTC](https://discourse.mc-stan.org/t/dedicated-stan-blog/3402/15 "2018-02-28T22:30:45Z")

</div>

> [@mages](#):
>
> you may want to consider GitLab

Their site currently says:

> GitLab has temporarily turned off custom domains support because of a security issue. The plan is to re-enable it after the 20th of February.

> [@mages](#):
>
> If you plan to write your posts in RMarkdown

Probably not, though I suppose someone might be interested. At that point, we usually just publish case studies on the web, and that’s easy as things stand now with Jupyter or R markdown.

---

<div class="post-metadata">

### Author: ![Gianluca](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.mc-stan.org/gianluca/32/723_2.png) [@Gianluca](https://discourse.mc-stan.org/u/Gianluca)
#### Post date: [March 27, 2018, 1:59pm UTC](https://discourse.mc-stan.org/t/dedicated-stan-blog/3402/16 "2018-03-27T13:59:46Z")

</div>

I was able to add MathJax support in a Jekyll blog adding the following script inside the `_includes` folder in a file named `mathjax.html`.

```
<!-- https://cdn.mathjax.org/mathjax/latest/MathJax.js -->
<script type="text/x-mathjax-config">
      MathJax.Hub.Config({
        extensions: ["tex2jax.js"],
        jax: ["input/TeX", "output/HTML-CSS"],
        tex2jax: {
          inlineMath: [['$','$'], ["\\(","\\)"] ],
          displayMath: [['$$','$$'], ["\[","\]"], ["\\[","\\]"] ],
          processEscapes: true
        },
        messageStyle: "none",
        "HTML-CSS": { availableFonts: ["TeX"] }
      });
    </script>
    <script type="text/javascript" 
            src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML">
            
    </script>

```

You then need to add a `{% include mathjax.html %}` in the `default.html` template.

[Here](https://github.com/IamGianluca/iamgianluca.github.io) is how I did it for a blog I just started.

IMHO, if you use something like [Jekyll-now](https://github.com/barryclark/jekyll-now) as a starting point, you can set up the blog in no time. In addition to that, you have version control, it’s inexpensive to maintain, and is easy to render the blog locally (including drafts) when you want to check how the article would look like before publishing it.

Another advantage of Jekyll-now is that you can enable comments and Google Analytics in minutes.

---

<div class="post-metadata">

### Author: ![Bob\_Carpenter](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.mc-stan.org/bob_carpenter/32/9230_2.png) [@Bob\_Carpenter](https://discourse.mc-stan.org/u/Bob_Carpenter)
#### Post date: [March 27, 2018, 6:55pm UTC](https://discourse.mc-stan.org/t/dedicated-stan-blog/3402/17 "2018-03-27T18:55:49Z")

</div>

Thanks! @breckbaldwin are you still working on this? If not, someone else might want to do it so we can get started.

---

<div class="post-metadata">

### Author: ![spinkney](https://avatars.discourse-cdn.com/v4/letter/s/dec6dc/32.png) [@spinkney](https://discourse.mc-stan.org/u/spinkney)
#### Post date: [March 31, 2018, 10:33am UTC](https://discourse.mc-stan.org/t/dedicated-stan-blog/3402/18 "2018-03-31T10:33:45Z")

</div>

I was able to get a pretty good blog on [github.io](http://github.io) using RBlogdown, which is pretty impressive since I’m a web programmer dilettante. It supports math stuff,  
[https://bookdown.org/yihui/blogdown/templates.html](https://bookdown.org/yihui/blogdown/templates.html). The relevant bit is down on the page so I’ve reproduced below:

> Support math expressions through MathJax. Add the code below to foot\_custom.html.
> 
> ```no-highlight
> <script src="//yihui.name/js/math-code.js"></script>
> <script async
> src="//cdn.bootcss.com/mathjax/2.7.1/MathJax.js?config=TeX-MML-AM_CHTML">
> </script>
> 
> ```
> 
> This requires substantial knowledge of JavaScript and familiarity with MathJax to fully understand the code above, and we will leave the explanation of the code to Section B.3.
> 
> Note that [bootcss.com](http://bootcss.com) is only one possible CDN host of MathJax, and you are free to use other hosts.

---

<div class="post-metadata">

### Author: ![Bob\_Carpenter](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.mc-stan.org/bob_carpenter/32/9230_2.png) [@Bob\_Carpenter](https://discourse.mc-stan.org/u/Bob_Carpenter)
#### Post date: [April 1, 2018, 5:51pm UTC](https://discourse.mc-stan.org/t/dedicated-stan-blog/3402/19 "2018-04-01T17:51:30Z")

</div>

Here’s the blog from @spinkney:

> **[sp](https://spinkney.github.io)**
>
> an analysis laboratory

and here’s the repo: [https://github.com/spinkney/spinkney.github.io](https://github.com/spinkney/spinkney.github.io)

It has Disqus plugged in for comments.

@spinkney: are there other style options? Did this just pick up the style of your blog (which would be great for our blog). If so, would you be able to configure a Stan blog and make a pull request? In which case, we can just turn it on without having to figure out all the config.

For some reason, dead links from Disqus seem to go to random pages. Any idea if that’s something we can control?
