search

JuliaLang / www.julialang.org

Julia Project website
https://julialang.org
Other
356 stars 436 forks source link

Conversion issues in blog posts #549

Closed cormullion closed 4 years ago

cormullion commented 4 years ago

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

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 commented 4 years ago

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

logankilpatrick commented 4 years ago

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

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

cormullion commented 4 years ago

A few items I spotted -

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

abhishalya commented 4 years ago

@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 commented 4 years ago

@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 commented 4 years ago

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

Anyway, well done! Impressive piece of work already!

abhishalya commented 4 years ago

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 commented 4 years ago

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.

abhishalya commented 4 years ago

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

cormullion commented 4 years ago

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 commented 4 years ago

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 commented 4 years ago

@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 commented 4 years ago

This should be completely fixed with JuDoc implementation.

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