Www.julialang.org: Conversion issues in blog posts

[cormullion]

When I did this job recently, the most trouble I had was with the maths. So:

• https://julialang.org/blog/2013/04/distributed-numerical-optimization/
• https://julialang.org/blog/2017/09/gsoc-2017-project-hamiltonian-indirect-inference/

were the first two I looked at, and the math problems are familiar - all those unconverted $ signs. Before going through all the blog posts again†, is there some general setting that you can throw that does the maths right...? Is it a KATEX/MathJAX thing? For Julia, the maths has to be good...

† Don't do it more than once, that way madness lies... :)

[abhishalya]

Thanks for reporting this, I'll get this fixed asap.

[logankilpatrick]

Check out: https://deploy-preview-16--hugo-julialang.netlify.com

The issue described above should be resolved now. Great work @abhishalya

[cormullion]

A few items I spotted -

• 05 October 2017 has gone missing
• the title of my only blog post (Some π-ography) needs fixing
• naked LATEX in https://deploy-preview-16--hugo-julialang.netlify.com/blog/2017/09/gsoc-2017-efficient-discretizations-of-pde-operators/
• trackbacks in earliest blog posts

Probably a good idea to have another pass through them visually to spot minor glitches ...

[abhishalya]

@cormullion Thanks for the feedback, I'll get these fixed today. Also just to let you know, we'll be moving the site from here back to the www.julialang.org repo. So you can create further issues there.

[abhishalya]

@cormullion It would be really nice if you could review https://switch_hugo--julialang-preview.netlify.com/ -> https://github.com/JuliaLang/www.julialang.org/pull/544

[cormullion]

@abhishalya Happy to, although it won't be till tomorrow, since the weekend has arrived... :)

Anyway, well done! Impressive piece of work already!

[abhishalya]

Happy to, although it won't be till tomorrow, since the weekend has arrived... :)

No problem, we're in no hurry. :)

Anyway, well done! Impressive piece of work already!

Thanks ;)

[cormullion]

link to #544

I had a quick look through and noted things I spotted. Mostly missing images. Occasionally the syntax highlighting has gone (I think people like having it...). And there are a few math-y glitches.

• [x] https://switch_hugo--julialang-preview.netlify.com/blog/2012/02/为什么我们要创造julia-simplified-chinese/
  missing last paragraph and trackbacks

• [x] https://switch_hugo--julialang-preview.netlify.com/blog/2012/02/why-we-created-julia/
  missing trackbacks

• [x] https://switch_hugo--julialang-preview.netlify.com/blog/2012/02/stanford-talk-announcement/
  link in first paragraph is missing

• [x] https://switch_hugo--julialang-preview.netlify.com/blog/2012/03/shelling-out-sucks/
  syntax colouring missing

• [x] https://switch_hugo--julialang-preview.netlify.com/blog/2013/03/videos-from-the-julia-tutorial-at-mit/
  pictures/video previews missing

• [x] https://switch_hugo--julialang-preview.netlify.com/blog/2013/04/distributed-numerical-optimization/
  all hyperlinks gone ? table missing

• [x] https://switch_hugo--julialang-preview.netlify.com/blog/2014/08/juliacon-2014-optimization-presentations/
  video previews missing

• [x] https://switch_hugo--julialang-preview.netlify.com/blog/2014/08/juliacon-2014-opening-session-presentations/
  video previews missing

• [x] https://switch_hugo--julialang-preview.netlify.com/blog/2015/05/juliacon-2015-preview-deep-learning-3d-printing-parallel-computing-and-so-much-more/
  graphics missing (and need fixing in the original too)

• [x] https://switch_hugo--julialang-preview.netlify.com/blog/2015/10/jsoc-2015-project-interactive-3d-graphics-in-the-browser-with-compose3d/
  video link missing

• [x] https://switch_hugo--julialang-preview.netlify.com/blog/2015/10/jsoc-2015-project-automatic-differentiation-in-julia-with-forwarddiff.jl/
  maths in "How ForwardDiff works" should be inline rather than paragraphs?

• [x] https://switch_hugo--julialang-preview.netlify.com/blog/2016/01/julia-ide-work-in-atom/
  image/animation missing

• [x] https://switch_hugo--julialang-preview.netlify.com/blog/2016/04/biojulia-project-in-2016/
  video link missing

• [ ] https://switch_hugo--julialang-preview.netlify.com/blog/2017/03/some-fun-with-pi-in-julia/
  post is OK, but link in contents page should be π rather than π

• [x] https://switch_hugo--julialang-preview.netlify.com/blog/2017/03/some-fun-with-pi-in-julia/
  diagrams missing in "Calculating an area"

• [x] https://switch_hugo--julialang-preview.netlify.com/blog/2017/09/gsoc-2017-efficient-discretizations-of-pde-operators/
  matrix in MOTIVATION isn't right

• [x] https://switch_hugo--julialang-preview.netlify.com/blog/2017/12/on-machine-learning-and-programming-languages/
  authors missing ; all images missing

• [x] https://switch_hugo--julialang-preview.netlify.com/blog/2017/12/机器学习与编程语言-simplified-chinese/
  same issues as above english version

• [x] https://switch_hugo--julialang-preview.netlify.com/blog/2017/12/機器學習以及程式語言traditional-chinese/
  same issues as above english version

• [ ] https://switch_hugo--julialang-preview.netlify.com/blog/2018/03/some-pi-ography/
  post is OK, but link in contents page should be π rather than π

• [x] https://switch_hugo--julialang-preview.netlify.com/blog/2018/04/tetris-coming-to-julia-language-for-v1.0/
  image missing

• [x] https://switch_hugo--julialang-preview.netlify.com/blog/2018/08/gsoc-2018-reinforcement-learning-and-generative-models-using-flux/
  all images missing

• [x] https://switch_hugo--julialang-preview.netlify.com/blog/2018/08/julia-1.0/
  links to translations are missing

• [x] https://switch_hugo--julialang-preview.netlify.com/blog/2018/08/gsoc-2018-adding-newer-features-and-speeding-up-convolutions-in-flux/
  images are missing

• [ ] https://switch_hugo--julialang-preview.netlify.com/blog/2018/08/gsoc-2018-and-speech-recognition-for-the-flux-model-zoo-the-conclusion/
  maths is weird in this one, and the code fragments are in quotes? The original is weird too... :)

• [x] https://switch_hugo--julialang-preview.netlify.com/blog/2018/09/how-to-get-started-with-julia-1.0s-package-manager/
  image/video link missing

• [ ] https://switch_hugo--julialang-preview.netlify.com/blog/2019/01/diffeqflux.jl-a-julia-library-for-neural-differential-equations/
  translation needs linking; LATEX maths has gone wrong;

• [ ] https://switch_hugo--julialang-preview.netlify.com/blog/2019/04/diffeqflux.jl-julia-的神經微分方程套件/
  as above, LATEX maths has gone wrong

• [x] https://switch_hugo--julialang-preview.netlify.com/blog/2019/05/beyond-machine-learning-pipelines-with-mlj/
  images missing

• [x] https://switch_hugo--julialang-preview.netlify.com/blog/2019/06/hello-diffeqbot/
  images missing

• [x] https://switch_hugo--julialang-preview.netlify.com/blog/2019/07/announcing-composable-multi-threaded-parallelism-in-julia/
  syntax highlighting lost?

• [x] https://switch_hugo--julialang-preview.netlify.com/blog/2019/08/julia-user-developer-survey-2019/
  pdf/image link missing

• [x] https://switch_hugo--julialang-preview.netlify.com/blog/2019/12/yao.jl-differentiable-quantum-programming-in-julia/
  Yao logo missing

[abhishalya]

Thank you @cormullion. This is very helpful. Will get these fixed soon. :)

[cormullion]

I'm not sure if I'm looking at the latest version, but there are more math errors now than there were before...

... eg

https://switch_hugo--julialang-preview.netlify.com/blog/2015/10/jsoc-2015-project-automatic-differentiation-in-julia-with-forwarddiff.jl/

https://switch_hugo--julialang-preview.netlify.com/blog/2013/04/distributed-numerical-optimization/

[abhishalya]

Hmm, we need to use shortcodes. I already have one to include math. But, we should then aim to switch all html to proper markdown.

[logankilpatrick]

@cormullion the issue was/is that Netlfiy was/is working its dirty magic. In the preview's it looks fine and then once it gets deployed things break.

[abhishalya]

This should be completely fixed with JuDoc implementation.

For Hugo, math is just not easy to include, its hacky as it was with Jekyll.