-
Notifications
You must be signed in to change notification settings - Fork 1k
Use redcarpet (Github Flavored Markdown) because Maruku breaks pages #244
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
First off, thanks a lot for figuring all of this out. And thanks for generating/uploading a sample. I see the list of dependencies, jekyll 1.1.2, redcarpet 2.2.2., and Ruby 2.0.0. My only concern is that using redcarpet requires most folks to upgrade their ruby/jekyll/etc toolchain. I'm completely for folks upgrading ruby/jekyll/etc. The only thing I worry about is the potential burden upgrading might have on peoples' will to contribute. My experience trying to generate this redcarpet branch (without thinking too much about the versions I have of anything, except for jekyll), for example:
That's all fine and good and I can do all of this. Though I worry that using recarpet is going to cause most potential contributors to have to go through this laundry list of installations, when before it was a simple For example, after one installs RVM (via: WDYT? Am I being paranoid, or is this a valid concern? |
That's why I too wrote:
The page Google landed me recommended Rbenv, so I upgraded Xcode and its Command Line Tool yesterday, sitting in a waiting area of a hospital, just to reproduce the issue. If we were to take this route, we should specify exact route to upgrade to Ruby 2.0 on Mac. It's not just Martin, we're all annoyed. It's a valid concern. On the flip side, it's gh-pages that updated its Ruby/jekyll version, not me. It's like the production server has gone to Scala 2.10 and a library broke some code. Not taking actions would be equivalent of continuing to use Scala 2.9 locally because Apple installed it by default, and commenting out the code. Having the identical setup is the right thing to do, as long as we use gh-pages. At least, that's how I see it as a person who spent weekends translating. Given a valid technical solution, removing published documents that people have bookmarked, is not a viable course of action. 404 because Martin won't fly. |
Ok, so good news :-) We discussed upgrading the toolchain today at the Scala core meeting, and decided to go for it. So in the next week or two, I'll be updating the toolchain and also migrating away from Github Pages to a custom self-hosted Jenkins build. |
Thanks for making it happen! |
Thanks for taking an active role, testing it out, and pushing it :) If it wasn't for you, it'd probably not have happened for a while! |
I take it this PR has served its purpose, and we can close this now. |
@retronym This issue after nearly an year since the report is still on-going. I just got a report on twitter in Japanese that Seq page has "md.disabled" extension and it downloads the file on the user's browser. See "列トレイト Seq、IndexedSeq、および LinearSeq" link from http://docs.scala-lang.org/ja/overviews/collections/introduction.html. /cc @xuwei-k for scalajp#29. |
I closed this thinking of this recent change: 0354155 I'm not an expert with markdown and friends, so maybe I got that wrong. |
Understood. I also just realized master is using kramdown, which may have fixed the original Japanese issue. I'll asking the original reporter to send in a new pull req with md.disabled file rename. |
It have been disabled by markdown problem. It's working by just renaming in my local environment. Fixes scala#244.
background
what this changes
First, I am restoring the files to the original state.
Second, I'm changing the markdown processor to redcarpet (Github Flavored Markdown). The bug seems to be coming from Maruku's handling of non-latin characters, and this is not the only time I've seen it break. I pretty much avoid any use of list or tables because Maruku is so bad. (If you or @xeno-by was wondering why I'm always using html in the translations, this is the reason)
With GFM comes fensed code block and all the goodies that we're used to in the rest of github ecosystem.
If it's so happy and shiny, why isn't it turned on by default? I don't know, but maybe because they've been developing redcarpet in more recent Ruby environment, and you have to take a few steps to set it up locally.
github/pages-gem
You can see what gh-pages is using with github-pages.gemspec.
Or
gem install github-pages
says Using Jekyll with Pages.demo
I merged this into scalajp/scala.github.com's gh-pages branch to make sure it works:
Most of the links are broken since they assume toplevel
/
, but you can check the renderings by putting inscala.github.com/
manually.