@@ -0,0 +1,10 @@ | ||
Contributing to Sundown | ||
======================= | ||
|
||
Do not. | ||
|
||
Unfortunately, Sundown is currently frozen as we're working with the Reddit, StackOverflow and Meteor developers to design a formal Markdown standard and parser that will supersede Sundown in all these websites (and in GitHub, of course). Our goal is to deprecate Sundown altogether before the end of the year. | ||
|
||
The new parser will be smaller, faster, safer and most importantly, more consistent. | ||
|
||
Please stay tuned. | ||
This comment has been minimized.
This comment has been minimized.
This comment has been minimized. |
80 comments
on commit 37728fb
This comment has been minimized.
This comment has been minimized.
The world is ending! |
This comment has been minimized.
This comment has been minimized.
Uniformity?! With Markdown?! Across websites?! |
This comment has been minimized.
This comment has been minimized.
I hope the new markdown parser will be github flavored. Is there a public project anywhere? |
This comment has been minimized.
This comment has been minimized.
@FSX 10 days left. |
This comment has been minimized.
This comment has been minimized.
@vmg Looks like a good initiative. It's super hard to get around with so many so-called flavors of the Markdown format. I think the source of the problem for end users is that people call their slight modifications "flavors" of something pre-existing, instead of naming it with a different name clearly indicating that it implements a different (though similar) wiki syntax. I also hope you guys can find time to write down a quick reference or some documentation of the sundown/redcarpet flavor of Markdown. Have a look at the one in the kramdown site, it's really good. |
This comment has been minimized.
This comment has been minimized.
Damn it, I should have read this earlier. |
This comment has been minimized.
This comment has been minimized.
@vmg is there a collaborative site available? A repo or something? To follow the development? |
This comment has been minimized.
This comment has been minimized.
Nope. I'm on holidays! Happy holidays everybody! Now go party! |
This comment has been minimized.
This comment has been minimized.
No, i go code. |
This comment has been minimized.
This comment has been minimized.
Well, according to the root NTP server, you now have exactly* 12 hours left.
* Yes, I know that's actually less than 12 hours. |
This comment has been minimized.
This comment has been minimized.
lol! |
This comment has been minimized.
This comment has been minimized.
time is up, where is the code |
This comment has been minimized.
This comment has been minimized.
@txdv okay, let's calm down everybo... |
This comment has been minimized.
This comment has been minimized.
I've been checking out this page every 5 minutes, |
This comment has been minimized.
This comment has been minimized.
However why so many people focus on this project? |
This comment has been minimized.
This comment has been minimized.
Because having a solid, flexible, secure Markdown parser is a must-to |
This comment has been minimized.
This comment has been minimized.
So sad |
This comment has been minimized.
This comment has been minimized.
@ibigbug Why? Markdown is a nice |
This comment has been minimized.
This comment has been minimized.
OK, we all know that @vmg's work in LibGit2 is awesome, My Hubot is pretty tired of checking this repo one time and another, |
This comment has been minimized.
This comment has been minimized.
I'm sorry guys, I'm not webscale. The new parser will come on its own schedule, when I find time to dedicate to it. It used to be a priority, but now I've got things on my plate that are more important. Keep using Sundown meanwhile. It's still fast and secure. |
This comment has been minimized.
This comment has been minimized.
Oh, thanks for the quick reply. |
This comment has been minimized.
This comment has been minimized.
any news on the new parser? |
This comment has been minimized.
This comment has been minimized.
Is this happening at all @vmg ? Seems like everybody still relies on sundown and its bindings. |
This comment has been minimized.
This comment has been minimized.
Can we all help in some way towards this newer standard? Hope to see it soon! |
This comment has been minimized.
This comment has been minimized.
@vmg, is the new parser (we don't even know his name) coming at all? |
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
I'm not sure it would be of any use to anyone, but just in case, the original library from which Sundown has been forked is still maintained, and has recently been copied to github at https://github.com/faelys/libsoldout |
This comment has been minimized.
This comment has been minimized.
Cool. :) |
This comment has been minimized.
This comment has been minimized.
Waiting. |
This comment has been minimized.
This comment has been minimized.
I'm seriously thinking we should agree on a fork
and continue development there.
2013/8/5 Honghe notifications@github.com
… Waiting.
—
Reply to this email directly or view it on GitHubhttps://github.com/vmg/sundown/commit/37728fb2d7137ff7c37d0a474cb827a8d6d846d8#commitcomment-3788047
.
|
This comment has been minimized.
This comment has been minimized.
Can we un-deprecate Sundown somewhere? |
This comment has been minimized.
This comment has been minimized.
@delvinus Yeah, that's what I was suggesting. |
This comment has been minimized.
This comment has been minimized.
@jmendeth I will fork Sundown later today and begin merging PRs that are worthy. Fork name suggestions would be appreciated. |
This comment has been minimized.
This comment has been minimized.
Sunrise. |
This comment has been minimized.
This comment has been minimized.
@FSX |
This comment has been minimized.
This comment has been minimized.
@FSX Taken: https://github.com/gampleman/Sunrise I was thinking either Sunup, Sunset, Moonrise, or Moonset. |
This comment has been minimized.
This comment has been minimized.
But... but... heart broken |
This comment has been minimized.
This comment has been minimized.
Phoenix. |
This comment has been minimized.
This comment has been minimized.
rising from the ashes of sundown? awesome. |
This comment has been minimized.
This comment has been minimized.
To all interested: https://github.com/devinus/hoedown I have applied PRs that match current Redcarpet functionality but have been languishing in the queue for Sundown and added the official Markdown test suite. The next steps are:
|
This comment has been minimized.
This comment has been minimized.
Hoedown looking great! I'm forking it.
I'll do that. Then I'll update Robotskirt to use
So Redcarpet has been keeping his own version of Sundown? PS. the first thing I'd do is to enable Issues on hoedown. |
This comment has been minimized.
This comment has been minimized.
@jmendeth Issues have been enabled. I'd like to hold off renaming API functions until I finish backporting all the improvements made in Redcarpet, Houdini, and Rinku. It makes generating and applying edited patches possible. |
This comment has been minimized.
This comment has been minimized.
@devinus Will there be a hoedown organization on GitHub? |
This comment has been minimized.
This comment has been minimized.
That indeed makes sense. |
This comment has been minimized.
This comment has been minimized.
@nathany I've created a hoedown org which will host hoedown at some point before we announce. Then we can get binding authors that have switched to hoedown to keep a fork of their bindings on the hoedown org. |
This comment has been minimized.
This comment has been minimized.
@delvinus, can you let me do the backporting as well? :) |
This comment has been minimized.
This comment has been minimized.
@jmendeth I have no qualms, but I spent a considerable amount of time last night making a mental map of the things we need to backport. Also, I am trying to keep the original authors attached to the improvements. We need 2 changes from Houdini, 1 from Rinku, and quite a few improvements from Redcarpet. I may also be interested in a few more PRs from Sundown still. I can go into it more later today, or you can try your hand at it. My process is creating |
This comment has been minimized.
This comment has been minimized.
Houdini has different buffers now ( |
This comment has been minimized.
This comment has been minimized.
@FSX I don't think replacing buffer.h and buffer.c would be appropriate for two reasons:
|
This comment has been minimized.
This comment has been minimized.
You stole my words. So, if |
This comment has been minimized.
This comment has been minimized.
Then I guess you're better at this task. ;) |
This comment has been minimized.
This comment has been minimized.
Then you'd have to modify Houdini. The buffer API changed a bit. I just wanted to notify you. :) |
This comment has been minimized.
This comment has been minimized.
I'd keep a file listing the project and the commit we backported changes from. |
This comment has been minimized.
This comment has been minimized.
I am running my fork of sundown that adds additional hooks in order to build a Markdown Abstract Syntax Tree (AST). It also includes some preliminary support for source maps. So my "features request" for a new Markdown parser is:
If this would be on the roadmap of the "new parser" I would definitely love to contribute. |
This comment has been minimized.
This comment has been minimized.
@zdne I think that a good practise, but I don't think it fits in Sundown's However, you could still implement an AST renderer. |
This comment has been minimized.
This comment has been minimized.
Nothing is definitive, however--what do you think about it, @devinus? |
This comment has been minimized.
This comment has been minimized.
@jmendeth That is exactly what I have done. I am using the original rendering hooks plus some additional ones I have had to add to build a Markdown AST. |
This comment has been minimized.
This comment has been minimized.
@jmendeth The backporting is complete. These are the bugs I actually discovered in Redcarpet during the process: https://gist.github.com/devinus/30b6df78d96eb9f06d33 Next step is a code reorganization. This is what I'm going to do:
|
This comment has been minimized.
This comment has been minimized.
Whoa! That's a lot of changes. Great work!
|
This comment has been minimized.
This comment has been minimized.
@devinus Are all existing licenses (that is, the preambles and license at README) |
This comment has been minimized.
This comment has been minimized.
@jmendeth Yes. |
This comment has been minimized.
This comment has been minimized.
@devinus Also, why don't we include the whole Houdini set of functions? |
This comment has been minimized.
This comment has been minimized.
@jmendeth Sundown/Hoedown only uses |
This comment has been minimized.
This comment has been minimized.
But if we're gonna include and backport improvements from Houdini, They can be very useful, especially when writing custom renderers. |
This comment has been minimized.
This comment has been minimized.
@jmendeth: I investigated it, and we can't backport any improvements from Houdini. (There was potentially one, but it requires using Houdini's buffer classes). My gut tells me that if somebody wants another function from Houdini to use in their custom renderer, then they can depend on Houdini |
This comment has been minimized.
This comment has been minimized.
What if we ported Houdini to use our buffer classes? I guess that wouldn't be difficult. |
This comment has been minimized.
This comment has been minimized.
@jmendeth: The one improvement was branch prediction that only applied when using libgit2's buffer class which doesn't apply to Hoedown at all. I may investigate applying some branch prediction around it later. |
This comment has been minimized.
This comment has been minimized.
Hmm... do tell us about that. :) |
This comment has been minimized.
This comment has been minimized.
@zdne Can I ask what static analyzers you used on your fork? |
This comment has been minimized.
This comment has been minimized.
@devinus standard clang static analyzer shipped with Xcode 5. Let me know should you have further questions. |
This comment has been minimized.
This comment has been minimized.
@zdne Thanks, I was looking into using the standalone tool version of it: http://clang-analyzer.llvm.org/scan-build.html |
This comment has been minimized.
This comment has been minimized.
To all those interested: Announcing Hoedown 1.0.0, a revived fork of Sundown: https://github.com/hoedown/hoedown I hope to see some of you there! |
This comment has been minimized.
This comment has been minimized.
Any news? :) |
This comment has been minimized.
This comment has been minimized.
There is a community test suite here https://github.com/karlcow/markdown-testsuite |
This comment has been minimized.
This comment has been minimized.
Is https://github.com/jgm/stmd/ the expected heir to the throne? |
This comment has been minimized.
This comment has been minimized.
It should be called now Common Markdown. |
This comment has been minimized.
This comment has been minimized.
@txdv see the footer at the end of the article. It's now CommonMark. |
This comment has been minimized.
This comment has been minimized.
@asgh That's just a spec. They do provide a C99 reference implementation, but I don't think it's meant to be used in production (or maybe it is?). I want Hoedown to support CommonMark around v4 if possible. |
This comment has been minimized.
This comment has been minimized.
@asgh @jmendeth It is exciting to see all the activity and effort going into CommonMark. |
This comment has been minimized.
This comment has been minimized.
Agreed. |
new line