Lots of improvements to the front page source.
This commit is contained in:
parent
9639b9ccd1
commit
5835605fe8
|
@ -82,7 +82,7 @@
|
|||
}
|
||||
.helpiconcell {
|
||||
text-align: right;
|
||||
text-vertical-align: top;
|
||||
vertical-align: top;
|
||||
}
|
||||
.helpicon {
|
||||
font-weight: bold;
|
||||
|
|
|
@ -13,8 +13,13 @@
|
|||
|
||||
(define (code . strs)
|
||||
(let* ([str (apply string-append strs)]
|
||||
[bstr (string->bytes/utf-8
|
||||
(regexp-replace* #rx"(?m:^$)" str "\xA0"))]
|
||||
[str (let ([N (- 6 (length (regexp-match-positions* "\n" str)))])
|
||||
(cond [(N . > . 0) (string-append str (make-string
|
||||
N #\newline))]
|
||||
[(N . < . 0) (error 'code "too many lines in example: ~e"
|
||||
str)]
|
||||
[else str]))]
|
||||
[bstr (string->bytes/utf-8 (regexp-replace* #rx"(?m:^$)" str "\xA0"))]
|
||||
[in (open-input-bytes bstr)])
|
||||
(let* ([tokens
|
||||
(let loop ([mode #f])
|
||||
|
|
|
@ -10,410 +10,300 @@
|
|||
(define-struct (scribble-example example) ())
|
||||
(define-struct (graphical-example example) ())
|
||||
|
||||
(define (desc . strs) (apply div strs))
|
||||
(define desc div)
|
||||
(define (elemcode . strs) (apply tt strs))
|
||||
|
||||
(define-values (add-example get-examples)
|
||||
(let ([inits (box '())] [additionals (box '())])
|
||||
(define (add-example code #:maker (maker example) #:initial? [initial? #t]
|
||||
. desc)
|
||||
(let ([b (if initial? inits additionals)])
|
||||
(set-box! b (cons (maker code desc) (unbox b)))))
|
||||
(define (get-examples)
|
||||
(values (reverse (unbox inits)) (reverse (unbox additionals))))
|
||||
(values add-example get-examples)))
|
||||
|
||||
(define (examples)
|
||||
@; --- Each example here should at most 7 lines long ---
|
||||
(alts-panel
|
||||
@; Candidates for initial example: ------------------------
|
||||
(list
|
||||
(example ; -----------------------------------------------
|
||||
@code{#lang racket
|
||||
;; Finds Racket sources in all subdirs
|
||||
(for ([path (in-directory)])
|
||||
(when (regexp-match? #rx"[.]rkt$" path)
|
||||
(printf "source file: ~a\n" path)))}
|
||||
@desc{The @elemcode{in-directory} function constructs a sequence that
|
||||
walks a directory tree (starting with the current directory, by default)
|
||||
and generates paths in the tree. The @elemcode{for} form binds
|
||||
@elemcode{p} to each path in the sequence, and @elemcode{regexp-match?}
|
||||
applies a pattern to the path.})
|
||||
(example ; -----------------------------------------------
|
||||
@code{#lang web-server/insta
|
||||
;; A "hello world" web server
|
||||
(define (start request)
|
||||
'(html
|
||||
(body "Hello World")))}
|
||||
@desc{This example implements a web server using the
|
||||
@elemcode{web-server/insta} language. Each time a connection is made to
|
||||
the server, the @elemcode{start} function is called to get the HTML to
|
||||
send back to the client.})
|
||||
(example ; -----------------------------------------------
|
||||
@code{#lang racket ; An echo server
|
||||
(define listener (tcp-listen 12345))
|
||||
(let echo-server ()
|
||||
(define-values (in out) (tcp-accept listener))
|
||||
(thread (lambda () (copy-port in out)
|
||||
(close-output-port out)))
|
||||
(echo-server))}
|
||||
@desc{Racket makes it easy to use TCP sockets and spawn threads to handle
|
||||
them. This program starts a server at TCP port 12345 that echos
|
||||
anything a client sends back to the client.})
|
||||
(example ; -----------------------------------------------
|
||||
@code{#lang racket
|
||||
;; Report each unique line from stdin
|
||||
(let ([saw (make-hash)])
|
||||
(for ([line (in-lines)])
|
||||
(unless (hash-ref saw line #f)
|
||||
(displayln line))
|
||||
(hash-set! saw line #t)))}
|
||||
@desc{Uses a hash table to record previously seen lines. You can run this
|
||||
program in DrRacket, but it makes more sense from the command line.}))
|
||||
@; Additional examples: -----------------------------------
|
||||
(list
|
||||
(graphical-example ; -------------------------------------
|
||||
@code{#lang racket ; A picture
|
||||
(require 2htdp/image)
|
||||
(let sierpinski ([n 6])
|
||||
(if (zero? n)
|
||||
(triangle 2 'solid 'red)
|
||||
(let ([next (sierpinski (- n 1))])
|
||||
(above next (beside next next)))))}
|
||||
@desc{The @elemcode{2htdp/image} library provides easy-to-use functions
|
||||
for constructing images, and DrRacket can display an image result as
|
||||
easily as it can display a number result. In this case, a
|
||||
@elemcode{sierpinski} function is defined and called (at the same time)
|
||||
to generate a Sierpinski triangle of depth 6.})
|
||||
(graphical-example ; -------------------------------------
|
||||
@code{#lang racket/gui ; A GUI guessing game
|
||||
(define f (new frame% [label "Guess"]))
|
||||
(define n (random 5)) (send f show #t)
|
||||
(define ((check i) btn evt)
|
||||
(message-box "." (if (= i n) "Yes" "No")))
|
||||
(for ([i (in-range 5)])
|
||||
(make-object button% (format "~a" i) f (check i)))}
|
||||
@desc{This simple guesing game demonstates Racket's class-based GUI
|
||||
toolkit. The @elemcode{frame%} class implements a top-level window, and
|
||||
@elemcode{button%} obviously implements a button. The @elemcode{check}
|
||||
function defined here produces an function that is used for the button's
|
||||
callback action.})
|
||||
(example ; -----------------------------------------------
|
||||
@code{#lang racket ; Simple web scraper
|
||||
(require net/url net/uri-codec)
|
||||
(define (let-me-google-that-for-you str)
|
||||
(let* ([g "http://www.google.com/search?q="]
|
||||
[u (string-append g (uri-encode str))]
|
||||
[rx #rx"(?<=<h3 class=\"r\">).*?(?=</h3>)"])
|
||||
(regexp-match* rx (get-pure-port (string->url u)))))}
|
||||
@desc{Add a call to @elemcode{let-me-google-that-for-you} to get a list of
|
||||
search results.})
|
||||
(cmdline-example ; ---------------------------------------
|
||||
@code{#lang racket
|
||||
;; A dice-rolling command-line utility
|
||||
(command-line
|
||||
#:args (dice sides)
|
||||
(for ([i (in-range (string->number dice))])
|
||||
(displayln
|
||||
(+ 1 (random (string->number sides))))))}
|
||||
@desc{Playing a game but no dice on hand? Let Racket roll for you. The
|
||||
@elemcode{command-line} form makes sure that the right number of
|
||||
arguments are provided and automatically implements the @tt{--help}
|
||||
switch.})
|
||||
(example ; -----------------------------------------------
|
||||
@code{#lang racket
|
||||
;; Print the Greek alphabet
|
||||
(for ([i (in-range 25)])
|
||||
(displayln
|
||||
(integer->char
|
||||
(+ i (char->integer #\u3B1)))))}
|
||||
@desc{The only reason we use the encoded form of a character
|
||||
@elemcode{#\u3B1} instead of the more direct form @elemcode{#\α} is that
|
||||
we don't trust your browser to render it correctly. DrRacket is
|
||||
perfectly happy with @elemcode{#\α}.})
|
||||
(graphical-example ; -------------------------------------
|
||||
@code{#lang htdp/bsl ; Any key inflates the balloon
|
||||
(require 2htdp/image) (require 2htdp/universe)
|
||||
(define (balloon b) (circle b "solid" "red"))
|
||||
(define (blow-up b k) (+ b 5))
|
||||
(define (deflate b) (max (- b 1) 1))
|
||||
(big-bang 50 (on-key blow-up) (on-tick deflate)
|
||||
(to-draw balloon 200 200))}
|
||||
@desc{Racket's mission includes education at all levels. This program
|
||||
uses the @elemcode{htdp/bsl} teaching language, the
|
||||
@elemcode{2htdp/image} library for creating pictures in the teaching
|
||||
languages, and the @elemcode{2htdp/universe} library for interactive
|
||||
animations.})
|
||||
(example ; -----------------------------------------------
|
||||
@code{#lang lazy
|
||||
;; An infinite list:
|
||||
(define fibs
|
||||
(list* 1 1 (map + fibs (cdr fibs))))
|
||||
@||
|
||||
;; Print the 1000th Fibonacci number:
|
||||
(print (list-ref fibs 1000))}
|
||||
@desc{And now for something completely different. The @elemcode{lazy}
|
||||
language is more like Haskell than Lisp, so feel free to build an
|
||||
infinite list and look at only part of it.})
|
||||
(example ; -----------------------------------------------
|
||||
@code{#lang typed/racket
|
||||
;; Using higher-order occurrence typing
|
||||
(define-type SrN (U String Number))
|
||||
(: tog ((Listof SrN) -> String))
|
||||
(define (tog l)
|
||||
(apply string-append (filter string? l)))
|
||||
(tog (list 5 "hello " 1/2 "world" (sqrt -1)))}
|
||||
@desc{Racket's type system is designed to let you add types after you've
|
||||
worked for a while in untyped mode @|ndash| even if your untyped program
|
||||
wouldn't fit nicely in a conventional type system.})
|
||||
(scribble-example ; --------------------------------------
|
||||
@code|{#lang scribble/base
|
||||
@; Generate a PDF or HTML document
|
||||
@title{Bottles --- @italic{Abridged}}
|
||||
@(apply itemlist
|
||||
(for/list ([n (in-range 100 0 -1)])
|
||||
@item{@(format "~a" n) bottles.}))}|
|
||||
@desc{This program uses the @elemcode{scribble/base} language for
|
||||
generating documents using a prose-friendly syntax.}))))
|
||||
|
||||
(provide index)
|
||||
(define index
|
||||
(page #:link-title "About" #:window-title "Racket"
|
||||
#:extra-headers (delay more.css)
|
||||
(div class: 'whatpane
|
||||
@span{@span[class: 'whatb]{Racket} is a programming language.})
|
||||
@div[class: 'whatpane]{
|
||||
@span{@span[class: 'whatb]{Racket} is a programming language.}}
|
||||
(div class: 'aboutpane
|
||||
(div class: 'panetitle "Start Quickly")
|
||||
(div class: 'downloadbutton download-button)
|
||||
(alts-panel
|
||||
@; --- Each example here should be exactly 7 lines long ---
|
||||
@; Candidates for initial example: ------------------------
|
||||
(list
|
||||
(example
|
||||
@code{
|
||||
#lang racket
|
||||
;; Finds Racket sources in all subdirs
|
||||
(for ([path (in-directory)])
|
||||
(when (regexp-match? #rx"[.]rkt$" path)
|
||||
(printf "source file: ~a\n" path)))
|
||||
|
||||
|
||||
}
|
||||
@desc{
|
||||
The @elemcode{in-directory} function constructs
|
||||
a sequence that walks a directory tree (starting with
|
||||
the current directory, by default) and generates
|
||||
paths in the tree. The @elemcode{for}
|
||||
form binds @elemcode{p} to each path in the sequence,
|
||||
and @elemcode{regexp-match?} applies a pattern to
|
||||
the path.})
|
||||
(example
|
||||
@code{
|
||||
#lang web-server/insta
|
||||
;; A "hello world" web server
|
||||
(define (start request)
|
||||
'(html
|
||||
(body "Hello World")))
|
||||
|
||||
|
||||
}
|
||||
@desc{
|
||||
This example implements a web server using the
|
||||
@elemcode{web-server/insta} language. Each time a connection
|
||||
is made to the server, the @elemcode{start} function is
|
||||
called to get the HTML to send back to the client.
|
||||
})
|
||||
(example
|
||||
@code{
|
||||
#lang racket ; An echo server
|
||||
(define listener (tcp-listen 12345))
|
||||
(let echo-server ()
|
||||
(define-values (in out) (tcp-accept listener))
|
||||
(thread (lambda () (copy-port in out)
|
||||
(close-output-port out)))
|
||||
(echo-server))
|
||||
}
|
||||
@desc{
|
||||
Racket makes it easy to use TCP sockets and spawn
|
||||
threads to handle them. This program starts a server
|
||||
at TCP port 12345 that echos anything a client sends
|
||||
back to the client.
|
||||
})
|
||||
(example
|
||||
@code{
|
||||
#lang racket
|
||||
;; Report each unique line from stdin
|
||||
(let ([saw (make-hash)])
|
||||
(for ([line (in-lines)])
|
||||
(unless (hash-ref saw line #f)
|
||||
(displayln line))
|
||||
(hash-set! saw line #t)))
|
||||
}
|
||||
@desc{
|
||||
Uses a hash table to record previously seen lines.
|
||||
You can run this program in DrRacket, but it makes more
|
||||
sense from the command line.
|
||||
})
|
||||
)
|
||||
@; Additional examples: --------------------------
|
||||
(list
|
||||
(graphical-example
|
||||
@code{
|
||||
#lang racket ; A picture
|
||||
(require 2htdp/image)
|
||||
(let sierpinski ([n 6])
|
||||
(if (zero? n)
|
||||
(triangle 2 'solid 'red)
|
||||
(let ([next (sierpinski (- n 1))])
|
||||
(above next (beside next next)))))
|
||||
}
|
||||
@desc{
|
||||
The @elemcode{2htdp/image} library provides easy-to-use
|
||||
functions for constructing images, and DrRacket can display
|
||||
an image result as easily as it can display a number result.
|
||||
In this case, a @elemcode{sierpinski} function is defined and
|
||||
called (at the same time) to generate a Sierpinski triangle
|
||||
of depth 6.
|
||||
})
|
||||
(graphical-example
|
||||
@code{
|
||||
#lang racket/gui ; A GUI guessing game
|
||||
(define f (new frame% [label "Guess"]))
|
||||
(define n (random 5)) (send f show #t)
|
||||
(define ((check i) btn evt)
|
||||
(message-box "." (if (= i n) "Yes" "No")))
|
||||
(for ([i (in-range 5)])
|
||||
(make-object button% (format "~a" i) f (check i)))
|
||||
}
|
||||
@desc{
|
||||
This simple guesing game demonstates Racket's
|
||||
class-based GUI toolkit. The
|
||||
@elemcode{frame%} class implements a
|
||||
top-level window, and @elemcode{button%} obviously
|
||||
implements a button. The @elemcode{check} function
|
||||
defined here produces an function that is used
|
||||
for the button's callback action.
|
||||
})
|
||||
(example
|
||||
@code{
|
||||
#lang racket ; Simple web scraper
|
||||
(require net/url net/uri-codec)
|
||||
(define (let-me-google-that-for-you str)
|
||||
(let* ([g "http://www.google.com/search?q="]
|
||||
[u (string-append g (uri-encode str))]
|
||||
[rx #rx"(?<=<h3 class=\"r\">).*?(?=</h3>)"])
|
||||
(regexp-match* rx (get-pure-port (string->url u)))))
|
||||
}
|
||||
@desc{
|
||||
Add a call to @elemcode{let-me-google-that-for-you} to
|
||||
get a list of search results.
|
||||
})
|
||||
(cmdline-example
|
||||
@code{
|
||||
#lang racket
|
||||
;; A dice-rolling command-line utility
|
||||
(command-line
|
||||
#:args (dice sides)
|
||||
(for ([i (in-range (string->number dice))])
|
||||
(displayln
|
||||
(+ 1 (random (string->number sides))))))
|
||||
}
|
||||
@desc{
|
||||
Playing a game but no dice on hand?
|
||||
Let Racket roll for you. The @elemcode{command-line}
|
||||
form makes sure that the right number of
|
||||
arguments are provided and automatically
|
||||
implements the @tt{--help} switch.
|
||||
})
|
||||
(example
|
||||
@code{
|
||||
#lang racket
|
||||
;; Print the Greek alphabet
|
||||
(for ([i (in-range 25)])
|
||||
(displayln
|
||||
(integer->char
|
||||
(+ i (char->integer #\u3B1)))))
|
||||
|
||||
}
|
||||
@desc{
|
||||
The only reason we use the encoded form of a
|
||||
character @elemcode{#\u3B1}
|
||||
instead of the more direct form @elemcode{#\α} is that we
|
||||
don't trust your browser to render it correctly. DrRacket
|
||||
is perfectly happy with @elemcode{#\α}.
|
||||
})
|
||||
(graphical-example
|
||||
@code{
|
||||
#lang htdp/bsl ; Any key inflates the balloon
|
||||
(require 2htdp/image) (require 2htdp/universe)
|
||||
(define (balloon b) (circle b "solid" "red"))
|
||||
(define (blow-up b k) (+ b 5))
|
||||
(define (deflate b) (max (- b 1) 1))
|
||||
(big-bang 50 (on-key blow-up) (on-tick deflate)
|
||||
(to-draw balloon 200 200))
|
||||
}
|
||||
@desc{
|
||||
Racket's mission includes education at all levels.
|
||||
This program uses the @elemcode{htdp/bsl} teaching
|
||||
language, the @elemcode{2htdp/image} library for
|
||||
creating pictures in the teaching languages, and the
|
||||
@elemcode{2htdp/universe} library for interactive
|
||||
animations.
|
||||
})
|
||||
(example
|
||||
@code{
|
||||
#lang lazy
|
||||
;; An infinite list:
|
||||
(define fibs
|
||||
(list* 1 1 (map + fibs (cdr fibs))))
|
||||
|
||||
;; Print the 1000th Fibonacci number:
|
||||
(print (list-ref fibs 1000))
|
||||
}
|
||||
@desc{
|
||||
And now for something completely different.
|
||||
The @elemcode{lazy} language is more like Haskell
|
||||
than Lisp, so feel free to build an infinite list
|
||||
and look at only part of it.
|
||||
})
|
||||
(example
|
||||
@code{
|
||||
#lang typed/racket
|
||||
;; Using higher-order occurrence typing
|
||||
(define-type SrN (U String Number))
|
||||
(: tog ((Listof SrN) -> String))
|
||||
(define (tog l)
|
||||
(apply string-append (filter string? l)))
|
||||
(tog (list 5 "hello " 1/2 "world" (sqrt -1)))
|
||||
}
|
||||
@desc{
|
||||
Racket's type system is designed to let you
|
||||
add types after you've worked for a while
|
||||
in untyped mode @|ndash| even if your untyped program
|
||||
wouldn't fit nicely in a conventional type system.
|
||||
})
|
||||
(scribble-example
|
||||
@code|{
|
||||
#lang scribble/base
|
||||
@; Generate a PDF or HTML document
|
||||
@title{Bottles --- @italic{Abridged}}
|
||||
|
||||
@(apply itemlist
|
||||
(for/list ([n (in-range 100 0 -1)])
|
||||
@item{@(format "~a" n) bottles.}))
|
||||
}|
|
||||
@desc{
|
||||
This program uses the @elemcode{scribble/base} language for
|
||||
generating documents using a prose-friendly syntax.
|
||||
})
|
||||
))
|
||||
@p{@a[href: (doc "quick/")]{Draw more pictures} or
|
||||
@a[href: (doc "more/")]{build a web server from scratch}.
|
||||
Racket includes both @a[href: (doc "")]{batteries}
|
||||
and a @a[href: (doc "drracket/")]{programming environment},
|
||||
so @a[href: (doc "getting-started/index.html")]{get started}!})
|
||||
(table class: 'threepanes
|
||||
(tr
|
||||
(td
|
||||
(div class: 'panetitle "Grow your Program")
|
||||
@p{Racket's
|
||||
@a[href: (doc "guide/intro.html#(part._.Interacting_with_.Racket)")]{interactive mode}
|
||||
encourages experimentation,
|
||||
and quick scripts easily compose into larger systems. Small scripts
|
||||
and large systems both benefit from @a[href:
|
||||
(doc "guide/performance.html")]{native-code JIT compilation}. When
|
||||
a system gets too big to keep in your head, you can add
|
||||
@a[href: (doc "ts-guide/index.html")]{static types}.})
|
||||
(td
|
||||
(div class: 'panetitle "Grow your Language")
|
||||
@p{@a[href: (doc "guide/languages.html")]{Extend Racket} whenever
|
||||
you need to. Mold it to better suit your tasks without
|
||||
sacrificing
|
||||
@a[href: (doc "guide/dialects.html")]{interoperability} with
|
||||
existing libraries and without having to modify the
|
||||
@a[href: (doc "guide/intro.html")]{tool chain}.
|
||||
When less is more, you can remove parts of a language
|
||||
or start over and build a new one.})
|
||||
(td
|
||||
(div class: 'panetitle "Grow your Skills")
|
||||
@p{Whether you're just @-htdp{starting out}, want to know more
|
||||
about programming language @-plai{applications} or
|
||||
@-redex{models}, looking to @continue{expand your horizons},
|
||||
or ready to dive into @outreach+research{research}, Racket can
|
||||
help you become a better programmer and system builder.})))))
|
||||
@div[class: 'panetitle]{Start Quickly}
|
||||
@div[class: 'downloadbutton]{@download-button}
|
||||
@examples
|
||||
@p{@a[href: (doc "quick/")]{Draw more pictures} or
|
||||
@a[href: (doc "more/")]{build a web server from scratch}.
|
||||
Racket includes both @a[href: (doc "")]{batteries}
|
||||
and a @a[href: (doc "drracket/")]{programming environment},
|
||||
so @a[href: (doc "getting-started/index.html")]{get started}!})
|
||||
@((lambda xs
|
||||
(table class: 'threepanes
|
||||
(tr (map (lambda (x) (td (div class: 'panetitle (car x)) (cdr x)))
|
||||
xs))))
|
||||
(list "Grow your Program"
|
||||
@p{Racket's
|
||||
@a[href: (doc "guide/intro.html#(part._.Interacting_with_.Racket)")]{interactive mode}
|
||||
encourages experimentation, and quick scripts easily compose into
|
||||
larger systems. Small scripts and large systems both benefit from
|
||||
@a[href: (doc "guide/performance.html")]{native-code JIT compilation}.
|
||||
When a system gets too big to keep in your head, you can add
|
||||
@a[href: (doc "ts-guide/index.html")]{static types}.})
|
||||
(list "Grow your Language"
|
||||
@p{@a[href: (doc "guide/languages.html")]{Extend Racket} whenever you
|
||||
need to. Mold it to better suit your tasks without sacrificing
|
||||
@a[href: (doc "guide/dialects.html")]{interoperability} with
|
||||
existing libraries and without having to modify the
|
||||
@a[href: (doc "guide/intro.html")]{tool chain}. When less is more,
|
||||
you can remove parts of a language or start over and build a new
|
||||
one.})
|
||||
(list "Grow your Skills"
|
||||
@p{Whether you're just @-htdp{starting out}, want to know more about
|
||||
programming language @-plai{applications} or @-redex{models},
|
||||
looking to @continue{expand your horizons}, or ready to dive into
|
||||
@outreach+research{research}, Racket can help you become a better
|
||||
programmer and system builder.}))))
|
||||
|
||||
(define (alts-panel l1 l2)
|
||||
(define l (append l1 l2))
|
||||
(define (mk-button txt tip id onclick)
|
||||
(a href: "#" id: id onclick: (list onclick "; return false;") title: tip
|
||||
txt))
|
||||
(div class: 'slideshow
|
||||
@script/inline[type: "text/javascript"]{
|
||||
var showing = 0;
|
||||
var help_showing = false;
|
||||
var kind = [ @(string-join (for/list ([i (in-list l)])
|
||||
(cond
|
||||
[(cmdline-example? i) "\"cmd\""]
|
||||
[(scribble-example? i) "\"scrib\""]
|
||||
[(graphical-example? i) "\"dr\""]
|
||||
[else "\"any\""]))
|
||||
",") ];
|
||||
function change_show_to(new_showing) {
|
||||
elem = document.getElementById("frame" + showing);
|
||||
elem.style.display = "none";
|
||||
elem = document.getElementById("helpframe" + showing);
|
||||
elem.style.display = "none";
|
||||
elem = document.getElementById("howto" + kind[showing]);
|
||||
elem.style.display = "none";
|
||||
showing = new_showing;
|
||||
elem = document.getElementById("frame" + showing);
|
||||
elem.style.display = "block";
|
||||
elem = document.getElementById("helpframe" + showing);
|
||||
elem.style.display = "block";
|
||||
elem = document.getElementById("howto" + kind[showing]);
|
||||
elem.style.display = "block";
|
||||
elem = document.getElementById("rewindbutton");
|
||||
elem.style.color = ((showing == 0) ? "#aaa" : "#444");
|
||||
elem = document.getElementById("advancebutton");
|
||||
elem.style.color = ((showing == @(sub1 (length l))) ? "#aaa" : "#444");
|
||||
}
|
||||
function change_show(amt) {
|
||||
change_show_to((showing + amt + @(length l)) % @(length l));
|
||||
}
|
||||
function advance_show() {
|
||||
if (showing < @(sub1 (length l))) change_show(1);
|
||||
return false;
|
||||
}
|
||||
function rewind_show() {
|
||||
if (showing > 0) change_show(-1);
|
||||
return false;
|
||||
}
|
||||
function show_help() {
|
||||
elem = document.getElementById("helppanel");
|
||||
elem.style.display = "block";
|
||||
help_showing = true;
|
||||
return false;
|
||||
}
|
||||
function hide_help() {
|
||||
elem = document.getElementById("helppanel");
|
||||
elem.style.display = "none";
|
||||
help_showing = false;
|
||||
return false;
|
||||
}
|
||||
function toggle_help() {
|
||||
if (help_showing)
|
||||
return hide_help();
|
||||
else
|
||||
return show_help();
|
||||
}
|
||||
}
|
||||
(div
|
||||
class: 'buttonpanel
|
||||
(a href: "#"
|
||||
id: "rewindbutton"
|
||||
class: 'slideshowbutton
|
||||
onclick: "return rewind_show()"
|
||||
style: "color: #aaa;"
|
||||
"<")
|
||||
(a href: "#"
|
||||
id: "advancebutton"
|
||||
class: 'slideshowbutton
|
||||
onclick: "return advance_show()"
|
||||
">")
|
||||
(a href: "#"
|
||||
class: 'slideshowhbutton
|
||||
onclick: "return toggle_help()"
|
||||
"?")
|
||||
(div class: 'hiddenhelp
|
||||
id: "helppanel"
|
||||
style: "display: none"
|
||||
(div class: 'helpcontent
|
||||
(a href: "#"
|
||||
class: 'closebutton
|
||||
onclick: "return hide_help()"
|
||||
"close")
|
||||
(apply div class: 'helpdesc
|
||||
(for/list ([elem l]
|
||||
[pos (in-naturals)])
|
||||
(div class: 'helpdeskframe
|
||||
id: (format "helpframe~a" pos)
|
||||
style: "display: none"
|
||||
(example-desc elem))))
|
||||
@div[class: 'helptext]{Form and function names in the code
|
||||
are hyperlinked to documentation, so click on them
|
||||
for more information.}
|
||||
@div[class: 'helptext
|
||||
id: "howtoany"]{To run the example, install Racket,
|
||||
start DrRacket, paste the example program
|
||||
into the top area in DrRacket,
|
||||
and click the Run button. Alternatively, save the
|
||||
program to a file and run @tt{racket} on the file.}
|
||||
@div[class: 'helptext
|
||||
style: "display: none"
|
||||
id: "howtodr"]{To run the example, install Racket,
|
||||
start DrRacket, paste the example program
|
||||
into the top area in DrRacket,
|
||||
and click the Run button.}
|
||||
@div[class: 'helptext
|
||||
id: "howtoscrib"]{To run the example, install Racket,
|
||||
start DrRacket, and paste the example program
|
||||
into the top area in DrRacket.
|
||||
When a program in a Scribble
|
||||
language is opened in DrRacket, a @b{Scribble HTML}
|
||||
button appears for rendering the document to HTML.
|
||||
Click it.}
|
||||
@div[class: 'helptext
|
||||
style: "display: none"
|
||||
id: "howtocmd"]{This example is a command-line script.
|
||||
To run the example, install Racket,
|
||||
paste the example program into a file, and
|
||||
run @tt{racket} on the file with command-line arguments
|
||||
after the filename. Alternatively, for a Unix installation, you can
|
||||
add @tt{#!/usr/bin/env racket} at the top and make the
|
||||
file executable, and then you can run the file directly.})))
|
||||
(for/list ([elem l]
|
||||
[pos (in-naturals)])
|
||||
(div class: 'slideshowframe
|
||||
id: (format "frame~a" pos)
|
||||
style: (format "display: ~a" (if (zero? pos) "block" "none"))
|
||||
(example-code elem)))
|
||||
@script/inline[type: "text/javascript"]{
|
||||
change_show_to(Math.floor(Math.random()* @(length l1)));
|
||||
}))
|
||||
(div class: 'buttonpanel
|
||||
@mk-button["<" "Previous example" 'rewindbutton "rewind_show()"]
|
||||
@mk-button[">" "Next example" 'advancebutton "advance_show()"]
|
||||
@mk-button["?" "Explain this code" 'helpbutton "set_help(!help_showing)"]
|
||||
(div class: 'hiddenhelp id: "helppanel" style: "display: none;"
|
||||
(div class: 'helpcontent
|
||||
@mk-button["close" "Close help" 'closebutton "set_help(false)"]
|
||||
(div class: 'helpdesc
|
||||
(for/list ([elem (in-list l)] [pos (in-naturals)])
|
||||
@div[id: @list{helpframe@pos} style: "display: none;"]{
|
||||
@(example-desc elem)}))
|
||||
@div[class: 'helptext]{
|
||||
Form and function names in the code are hyperlinked to
|
||||
documentation, so click on them for more information.}
|
||||
@div[class: 'helptext id: "howtoany"]{
|
||||
To run the example, install Racket, start DrRacket, paste the
|
||||
example program into the top area in DrRacket, and click the Run
|
||||
button. Alternatively, save the program to a file and run
|
||||
@tt{racket} on the file.}
|
||||
@div[class: 'helptext style: "display: none;" id: "howtodr"]{
|
||||
To run the example, install Racket, start DrRacket, paste the
|
||||
example program into the top area in DrRacket, and click the Run
|
||||
button.}
|
||||
@div[class: 'helptext style: "display: none;" id: "howtoscrib"]{
|
||||
To run the example, install Racket, start DrRacket, and paste the
|
||||
example program into the top area in DrRacket. When a program in
|
||||
a Scribble language is opened in DrRacket, a @b{Scribble HTML}
|
||||
button appears for rendering the document to HTML. Click it.}
|
||||
@div[class: 'helptext id: "howtocmd" style: "display: none;"]{
|
||||
This example is a command-line script. To run the example, install
|
||||
Racket, paste the example program into a file, and run @tt{racket}
|
||||
on the file with command-line arguments after the filename.
|
||||
Alternatively, for a Unix installation, you can add
|
||||
@tt{#!/usr/bin/env racket} at the top and make the file executable,
|
||||
and then you can run the file directly.})))
|
||||
(for/list ([elem (in-list l)] [pos (in-naturals)])
|
||||
@div[class: 'slideshowframe id: @list{frame@pos}
|
||||
style: @list{display: @(if (zero? pos) "block" "none")@";"}]{
|
||||
@(example-code elem)})
|
||||
@script/inline[type: "text/javascript"]{
|
||||
var showing = 0, help_showing = false;
|
||||
var kind = [@(string-join (for/list ([i (in-list l)])
|
||||
(cond [(cmdline-example? i) "\"cmd\""]
|
||||
[(scribble-example? i) "\"scrib\""]
|
||||
[(graphical-example? i) "\"dr\""]
|
||||
[else "\"any\""]))
|
||||
",")];
|
||||
var frame_s=new Array(), helpframe_s=new Array(), howto_s=new Array();
|
||||
for (var i=0@";" i<@(length l)@";" i++) {
|
||||
frame_s[i] = document.getElementById("frame" + i).style;
|
||||
helpframe_s[i] = document.getElementById("helpframe" + i).style;
|
||||
howto_s[i] = document.getElementById("howto" + kind[i]).style;
|
||||
}
|
||||
var advbutton_s = document.getElementById("advancebutton").style;
|
||||
var rewbutton_s = document.getElementById("rewindbutton").style;
|
||||
function set_display(disp) {
|
||||
frame_s[showing].display = disp;
|
||||
helpframe_s[showing].display = disp;
|
||||
howto_s[showing].display = disp;
|
||||
}
|
||||
function change_show_to(new_showing) {
|
||||
set_display("none");
|
||||
showing = new_showing;
|
||||
set_display("block");
|
||||
rewbutton_s.color = (showing==0) ? "#aaa" : "#444";
|
||||
advbutton_s.color = (showing==@(sub1 (length l))) ? "#aaa" : "#444";
|
||||
}
|
||||
function advance_show() {
|
||||
if (showing < @(sub1 (length l))) change_show_to(showing+1);
|
||||
}
|
||||
function rewind_show() {
|
||||
if (showing > 0) change_show_to(showing-1);
|
||||
}
|
||||
var help_panel_s = document.getElementById("helppanel").style;
|
||||
function set_help(show) {
|
||||
help_panel_s.display = show ? "block" : "none";
|
||||
help_showing = show;
|
||||
}
|
||||
change_show_to(Math.floor(Math.random() * @(length l1)));
|
||||
}))
|
||||
|
||||
;; TODO
|
||||
;; (define screenshots
|
||||
|
@ -467,14 +357,14 @@
|
|||
width: 100%;
|
||||
font-size: large;
|
||||
font-weight: bold;
|
||||
color: #D00;
|
||||
color: #d00;
|
||||
}
|
||||
.threepanes {
|
||||
width: 100%;
|
||||
}
|
||||
.threepanes td {
|
||||
vertical-align: top;
|
||||
align: center;
|
||||
margin: auto;
|
||||
width: 30%;
|
||||
padding: 0.5em;
|
||||
}
|
||||
|
@ -489,17 +379,18 @@
|
|||
width: 3em;
|
||||
margin: 0em 0em 0em -5em;
|
||||
}
|
||||
.slideshowbutton, .slideshowhbutton {
|
||||
#advancebutton, #rewindbutton, #helpbutton, #closebutton {
|
||||
text-decoration: none;
|
||||
border: 1px solid #ddd;
|
||||
font-weight: bold;
|
||||
color: #444;
|
||||
background-color: #eee;
|
||||
padding: 0px 1px 0px 1px;
|
||||
}
|
||||
.slideshowbutton {
|
||||
#advancebutton, #rewindbutton {
|
||||
margin: 0px 1px 0px 1px;
|
||||
}
|
||||
.slideshowhbutton {
|
||||
#helpbutton {
|
||||
margin: 0px 1px 0px 10px;
|
||||
}
|
||||
.hiddenhelp {
|
||||
|
@ -508,12 +399,12 @@
|
|||
}
|
||||
.helpcontent {
|
||||
width: 20em;
|
||||
background-color: #FFE;
|
||||
background-color: #ffe;
|
||||
padding: 10px;
|
||||
margin-top: 3px;
|
||||
border: 1px solid black;
|
||||
}
|
||||
.closebutton {
|
||||
#closebutton {
|
||||
font-size: small;
|
||||
margin-bottom: 1em;
|
||||
}
|
||||
|
|
Loading…
Reference in New Issue
Block a user