-
Notifications
You must be signed in to change notification settings - Fork 219
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
Needs to support Markdown READMEs for Sinatra 1.4.0 #97
Comments
Can you elaborate a bit? I'm not sure what exactly you're asking for here. If you elaborate a bit and I know enough to do it, I'll take it. :) |
intro-.html files are currently generated from README..rdoc files from the sinatra/sinatra repo. Howerver, in master, the upcoming Sinatra 1.4.0 release, most of these are now *.md files. |
The (not that nice) code is in Rakefile. |
Ah, gotcha. I'll start poking around tomorrow after I get some sleep! If you've got any tidbits that you think would be of help, just dump them here and I'll read them before getting started in the morning. |
First one would be to remove the rdoc_to_html generation and add-in a markdown to html parser like maruku. |
If we remove it, we need to convert all the outstanding rdoc files to markdown, too. |
That is true. I forgot there are still some Readmes pending. |
rdoc 4 parses markdown and rdoc just fine. |
@rkh I was actually really looking forward to working on this, but I'm gonna have to back out. Short version is "family issues." Github's not the place to discuss it further than that. Sorry I didn't get back to you quicker this morning about that. |
I've been fiddling with the Rakefile. Trying out the various Markdown parsers to get proper code-block parsing but failing miserably. Will update soon. @burningTyger The Rdoc 4 Markdown parser doesn't support fenced codeblocks I think :/ Having trouble "requiring" the right file while using it but wasn't lucky in my attempts. |
I think you can use redcarpet plus some option to get it working. |
Tried that. The parsing happens well but the table of contents is being On Tuesday, February 26, 2013, Konstantin Haase wrote:
Kashyap KMBC |
I also added a ToC to the README.md, not sure if we wanna reuse that or remove that. |
Oh! I think that needs to be removed (especially if Redcarpet is to be On Tue, Feb 26, 2013 at 7:40 PM, Konstantin Haase
Kashyap KMBC |
This works with the current snapshot of the Sinatra repo: kgrz@1b77777 (except the inline ToC which can be enabled if needed) This is a hack at best. This checks for each of the languages where the READMEs are still in RDoc and, depending on the list, parse the README either using the RDoc parser or the Redcarpet markdown parser. This will break if the main Sinatra repo gets updated with a new README. However, I think this can server the purpose if this is what holding back the 1.4.0 release. @rkh The ToC gets generated twice in the english README section. Either this should be removed entirely from the README or a |
All Markdown now! |
See #100 |
@kgrz I gave you commit access. |
No description provided.
The text was updated successfully, but these errors were encountered: