Dear Haskell community, It was kindly suggested to me by John Peterson that I might reach you here and tell you a little bit about Fram, a small Mediawiki extension. Fram lets you intersperse your explanation with actual code, and then Fram extracts and concatenates the code, giving you a file with code for download. This means anyone with access to Fram can improve your code, either by explaining it or by enhancing the code itself. It is released under the GNU GPL version 3 at no cost. Fram is now at version 0.2, and equals the Mediawiki extension RawFile 0.2, written by Belgian developer Philippe Teuwen. Phil and I are collaborating to improve Fram into a fully fledged literate programming tool like "noweb" written by Norman Ramsey. It was originally Ramsey who suggested to me that Fram may be interesting to the Haskell community wiki, so here we are. If this sounds useful, please have a look at http://far.no/fram/ or go below the main-deck into the cabins to explore the articles http://far.no/fram/index.php?title=Fram http://far.no/fram/index.php?title=Test http://far.no/fram/index.php?title=Usbpix and if these don't make sense, have a look at our help page http://far.no/fram/index.php?title=Help:Contents If you are curious about the name, "Fram" is also the name of a famous ship used by Norwegian polar explorers in the last century. It means "Forward". Yours sincerely, Haakon Meland Eriksen
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA512 On Wed, Dec 10, 2008 at 2:05 PM, Haakon Meland Eriksen wrote:
Dear Haskell community,
It was kindly suggested to me by John Peterson that I might reach you here and tell you a little bit about Fram, a small Mediawiki extension.
Fram lets you intersperse your explanation with actual code, and then Fram extracts and concatenates the code, giving you a file with code for download. This means anyone with access to Fram can improve your code, either by explaining it or by enhancing the code itself. It is released under the GNU GPL version 3 at no cost.
Fram is now at version 0.2, and equals the Mediawiki extension RawFile 0.2, written by Belgian developer Philippe Teuwen. Phil and I are collaborating to improve Fram into a fully fledged literate programming tool like "noweb" written by Norman Ramsey. It was originally Ramsey who suggested to me that Fram may be interesting to the Haskell community wiki, so here we are.
What advantages does Fram have over noweb? I've noodled around a little on the Literate Programs wiki ( http://en.literateprograms.org/ ) which uses noweb for providing the source files, and it seemed to work as it should.
Yours sincerely, Haakon Meland Eriksen
- -- gwern -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.9 (GNU/Linux) iEYEAREKAAYFAklAP0QACgkQvpDo5Pfl1oL8yQCdHfy0beCpMZ/+cnscxjKeiXnY LysAn216FhM2qZkN1Rh38hVjcO9EYTPT =mzaa -----END PGP SIGNATURE-----
What advantages does Fram have over noweb? I've noodled around a little on the Literate Programs wiki ( http://en.literateprograms.org/ ) which uses noweb for providing the source files, and it seemed to work as it should. I've put together a small introduction to Haskell using Fram based on YAHT by Hal Daumé III. It contains four simple exercises, but what may interest you is exercise 3 and 4, which contains source code for two modules interspersed with explanation. Each exercise contains a download
Gwern Branwen wrote: link, and when you hit it Fram will concatenate the source code into a downloadable file. I've just tried this on Microsoft Windows XP using Firefox 3.0.4 so your experience may differ somewhat from what I'm about to describe. When I hit the download link in Fram, Firefox prompts me to either open the module source code in GHCi or save the file. If I choose to open it in GHCi, the module will immediately be compiled and loaded. I find this quite efficient, and I hope you do to. Yours sincerely, Haakon Meland Eriksen
Here is a direct link http://far.no/fram/index.php?title=Introduction_to_Haskell Haakon http://far.no/fram
participants (2)
-
Gwern Branwen -
Haakon Meland Eriksen