[racket] Getting started with Scribble

From: Mark Engelberg (mark.engelberg at gmail.com)
Date: Fri Mar 16 22:24:46 EDT 2012

This doesn't appear to do what I'm asking.

I tried this as per your suggestion:
#lang scribble/manual
@(require scribble/eval)

@title{My Scribblings}
I'm going to write a really amazing factorial function now.

(define (factorial n)
     [(zero? n) 1]          ;; The zero test
     [else (* n (factorial (sub1 n)))]))

But when I hit Run, it doesn't seem to recognize factorial in the
interactions window.

On Fri, Mar 16, 2012 at 6:41 PM, David Van Horn <dvanhorn at ccs.neu.edu>wrote:

> On 3/16/12 8:42 PM, Mark Engelberg wrote:
>> So I'm trying to figure out the simplest way to create a document that
>> is mostly text with a few Racket snippets.  When I hit Run, I want the
>> code to be evaluated for the interactions window.  When I hit the
>> scribble button, I want it to generate html that displays the formatted
>> text along with the Racket snippets.
>> First attempt:
>> Use scribble/base and put an @ in front of any Racket code.
>> Hitting run evaluates the Racket code, but scribblizing only shows the
>> formatted text -- the code remains invisible.
>> Second attempt:
>> Use scribble/manual and put @racketblock[] around any Racket code.
>> Looks great when you scribblize, but code doesn't evaluate.
>> Another nuisance: IDE auto-converts opening bracket after @racketblock
>> into a paren.
> Is this what you're looking for?  -- David
> #lang scribble/manual
> @(require scribble/eval)
> @title{My Scribblings}
> I don't always program, but when I do, I program in
> @interaction[(banner)]
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.racket-lang.org/users/archive/attachments/20120316/6e81dcef/attachment.html>

Posted on the users mailing list.