b2e2f0cb9f4d6ea394cc9153d6705a93047be375
[ikiwiki.git] / doc / todo / pagedown_plugin / discussion.mdwn
1 I've tried to retrieve the wmd-editor source tarball lately, but the site seems offline.
2
3 From what I've read on the Internet, wmd-editor is not (yet?) free software by itself, and its author has gone MIA.
4 But it looks like somebody recently took the step to rewrite a wmd-clone under a saner license, see [[pagedown|http://code.google.com/p/pagedown/source/browse/]].
5
6 Given all the above, what about upgrading this plugin to use pagedown instead of wmd? It seem a clear win to me...
7
8 > AFAICS, pagedown is a modified version of WMD. Let's 
9 > look at its license file: --[[Joey]] 
10
11 >     A javascript port of Markdown, as used on Stack Overflow
12 >     and the rest of Stack Exchange network.
13 >     
14 >     Largely based on showdown.js by John Fraser (Attacklab).
15 >     
16 >     Original Markdown Copyright (c) 2004-2005 John Gruber
17 >       <http://daringfireball.net/projects/markdown/>
18 >     
19 >     
20 >     Original Showdown code copyright (c) 2007 John Fraser
21 >     
22 >     Modifications and bugfixes (c) 2009 Dana Robinson
23 >     Modifications and bugfixes (c) 2009-2011 Stack Exchange Inc.
24 >     
25 >     Permission is hereby granted, free of charge, to any person obtaining a
26 >     copy [...]
27 >     
28 > Ok, so it says it's based on showdown. John Fraser wrote showdown and also 
29 > WMD, which IIRC was built on top of showdown. (Showdown converts the
30 > markdown to html, and WMD adds the editor UI.)
31
32 > I can nowhere find a actual statement of the copyright of showdown or
33 > WMD. <http://code.google.com/p/wmd/> has a "MIT License" notice on it,
34 > but this is clearly just the license chosen when signing up at google
35 > code for the repo that would be used for a rewrite of the code, and the only thing 
36 > said about the previous 1.0 release of WMD is "use it freely", which is not
37 > specific enough to be a grant of license, and is moreover not a free
38 > software license, as it does not cover distribution or modification.
39
40 > Which was all covered in the thread here, 
41 > when StackOverflow decided to start working on pagedown.
42 > <http://blog.stackoverflow.com/2008/12/reverse-engineering-the-wmd-editor/>
43 > This thread does not give any indication that they ever managed to get
44 > a license grant for WMD/showdown. It frankly, does not inspire confidence
45 > that the people working on this care about the license.
46
47 > It would probably be pretty easy to adapt the ikiwiki wmd plugin 
48 > to use pagedown. But without a clear and credible license, why?
49
50 > (Note that I have a wmd-new branch in my ikiwiki git repo that
51 > uses <https://github.com/derobins/wmd>, which was an earlier
52 > version of pagedown (probably, not entirely clear).)
53
54 > An alternate alternative is markitup: <http://markitup.jaysalvat.com/>
55 > It has a clear history and a credible license (MIT or GPL dual license).
56 > It's also easily extensible to other formats so could handle rst etc.
57 > It does not, however, have a markdown to html converter -- for 
58 > previewing it has to talk to the server with AJAX.
59 > --[[Joey]]