doc/todo/pagedown_plugin/discussion.mdwn

   1 (This conversation was moved from [[plugins/wmd/discussion]]. --[[anarcat]])
   2
   3 I've tried to retrieve the wmd-editor source tarball lately, but the site seems offline.
   4
   5 From what I've read on the Internet, wmd-editor is not (yet?) free software by itself, and its author has gone MIA.
   6 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/]].
   7
   8 Given all the above, what about upgrading this plugin to use pagedown instead of wmd? It seem a clear win to me...
   9
  10 > AFAICS, pagedown is a modified version of WMD. Let's
  11 > look at its license file: --[[Joey]]
  12 >
  13 >     A javascript port of Markdown, as used on Stack Overflow
  14 >     and the rest of Stack Exchange network.
  15 >
  16 >     Largely based on showdown.js by John Fraser (Attacklab).
  17 >
  18 >     Original Markdown Copyright (c) 2004-2005 John Gruber
  19 >       <http://daringfireball.net/projects/markdown/>
  20 >
  21 >
  22 >     Original Showdown code copyright (c) 2007 John Fraser
  23 >
  24 >     Modifications and bugfixes (c) 2009 Dana Robinson
  25 >     Modifications and bugfixes (c) 2009-2011 Stack Exchange Inc.
  26 >
  27 >     Permission is hereby granted, free of charge, to any person obtaining a
  28 >     copy [...]
  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
  64 >> Showdown has a pretty explicit [license.txt file](https://github.com/coreyti/showdown/blob/master/license.txt)
  65 >> and it basically looks like a BSD license. That license.txt file was imported into
  66 >> github directly from the upstream showdown source, so it seems credible. That zip file
  67 >> is still available [on archive.org](http://wayback.archive.org/web/20100612163302/http://attacklab.net/showdown/showdown-v0.9.zip),
  68 >> and does mention a BSD copyright.
  69 >>
  70 >> So Showdown itself is clean: it's free. Nowhere does it say it derives from WMD, or
  71 >> if it does, it doesn't matter *because* it was made by the same author **and then**
  72 >> released under that free license. But even then, it does *not* mention being a
  73 >> derivative of WMD.
  74 >>
  75 >> I agree the license behind WMD is murky. One the one hand, the [google code page](https://code.google.com/p/wmd/)
  76 >> mentions the code will be relicensed under MIT but "for now" we can "use it freely":
  77 >>
  78 >> > *I'm refactoring the code, and will be releasing WMD under the MIT license soon. For
  79 >> now you can download the most recent release (wmd-1.0.1.zip) and use it freely.*
  80 >>
  81 >> That zip file is again offline, but it's also [on archive.org](http://web.archive.org/web/20101226145228/http://wmd-editor.com/downloads/wmd-1.0.1.zip).
  82 >> Things get a little more murky there: the file doesn't actually mention any copyright
  83 >> statement, and the code is actually obfuscated, something that is mentionned on the aforementionned
  84 >> Stack Exchange thread. The [terms and conditions of WMD](http://web.archive.org/web/20100323043113/http://wmd-editor.com/terms)
  85 >> are pretty hostile however:
  86 >>
  87 >>> *All rights reserved. You may not duplicate, copy, or reuse any portion of the HTML/CSS, JavaScript, or visual design elements or concepts without express written permission from AttackLab.*
  88 >>
  89 >> But one could argue they apply only to WMD, and *not* showdown, which has been
  90 >> explicitely published under a different license. And maybe that was the whole
  91 >> point here: the stack exchange people were trying to negociate having the
  92 >> clear and free version of WMD for their own use, maybe showdown is actually
  93 >> what came out of this and what allows Stack exchange to do their thing...
  94 >>
  95 >> And besides: the point here is that we *can't actually use WMD safely*, but
  96 >> we **can use pagedown safely!**.
  97 >>
  98 >> So let's work on merging that pretty branch already shall we? :) --[[anarcat]]