b57ef40571253a1e4af997bdbfd64eb5fd861a3e
[ikiwiki.git] / doc / plugins / wmd / 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 <pre>
12 A javascript port of Markdown, as used on Stack Overflow
13 and the rest of Stack Exchange network.
14
15 Largely based on showdown.js by John Fraser (Attacklab).
16
17 Original Markdown Copyright (c) 2004-2005 John Gruber
18   <http://daringfireball.net/projects/markdown/>
19
20
21 Original Showdown code copyright (c) 2007 John Fraser
22
23 Modifications and bugfixes (c) 2009 Dana Robinson
24 Modifications and bugfixes (c) 2009-2011 Stack Exchange Inc.
25
26 Permission is hereby granted, free of charge, to any person obtaining a
27 copy [...]
28 </pre>
29
30 > Ok, so it says it's based on showdown. John Fraser wrote showdown and also 
31 > WMD, which IIRC was built on top of showdown. (Showdown converts the
32 > markdown to html, and WMD adds the editor UI.)
33
34 > I can nowhere find a actual statement of the copyright of showdown or
35 > WMD. <http://code.google.com/p/wmd/> has a "MIT License" notice on it,
36 > but this is clearly just the license chosen when signing up at google
37 > code for the repo that would be used for a rewrite of the code, and the only thing 
38 > said about the previous 1.0 release of WMD is "use it freely", which is not
39 > specific enough to be a grant of license, and is moreover not a free
40 > software license, as it does not cover distribution or modification.
41
42 > Which was all covered in the thread here, 
43 > when StackOverflow decided to start working on pagedown.
44 > <http://blog.stackoverflow.com/2008/12/reverse-engineering-the-wmd-editor/>
45 > This thread does not give any indication that they ever managed to get
46 > a license grant for WMD/showdown. It frankly, does not inspire confidence
47 > that the people working on this care about the license.
48
49 > It would probably be pretty easy to adapt the ikiwiki wmd plugin 
50 > to use pagedown. But without a clear and credible license, why?
51
52 > (Note that I have a wmd-new branch in my ikiwiki git repo that
53 > uses <https://github.com/derobins/wmd>, which was an earlier
54 > version of pagedown (probably, not entirely clear).)
55
56 > An alternate alternative is markitup: <http://markitup.jaysalvat.com/>
57 > It has a clear history and a credible license (MIT or GPL dual license).
58 > It's also easily extensible to other formats so could handle rst etc.
59 > It does not, however, have a markdown to html converter -- for 
60 > previewing it has to talk to the server with AJAX.
61 > --[[Joey]] 
62
63 >> I've got pagedown working on my personal site (simon.kisikew.org) but I'm not sure how
64 >> I can inject the relevant &lt;div&gt;'s in the right place. They need to go **above**
65 >> the editing &lt;textarea&gt; . (Too bad about the licensing, it's rather nice.)
66 >> I had to do one minor change to it to have it inject itself into the page properly,
67 >> and that was to make this change in `Markdown.Editor.js`:
68 >>
69 >> `this.input = doc.getElementById("editcontent" + postfix);`
70 >>
71 >> on line 247.  --[[simonraven]]
72
73 >>> Well, I re-figured out that I needed a TMPL_VAR FOO in the template(s). --[[simonraven]]