racket/collects/scribblings/main/getting-started.scrbl
Matthew Flatt 1f8370d2d6 revise README and "Getting Started" info
Addresses PR 13356
2013-01-01 15:55:44 -07:00

71 lines
2.8 KiB
Racket

#lang scribble/doc
@(require scribble/manual)
@title{Getting Started with Racket}
To get started with Racket,
@link["http://www.racket-lang.org/download/"]{download it} from the web page and
install it. If you are a beginner or would like to use a graphical environment
to run programs, run the @exec{DrRacket} executable. Otherwise, the @exec{racket}
executable will run a command-line Read-Eval-Print-Loop
(@tech[#:doc '(lib "scribblings/guide/guide.scrbl")]{REPL}).
On Windows, you can start DrRacket from the @onscreen{Racket} entry in the
Start menu. In Windows Vista or newer, you can just type @exec{DrRacket}. You can
also run it from its folder, which you can find in @onscreen{Program Files}
@onscreen{Racket} @onscreen{DrRacket}.
On Mac OS X, double click on the @onscreen{DrRacket} icon. It is probably in a
@onscreen{Racket} folder that you dragged into your
@onscreen{Applications} folder. If you want to use command-line tools, instead,
Racket executables are in the @filepath{bin} directory of the @onscreen{Racket}
folder (and if you want to set your @envvar{PATH} environment variable, you'll
need to do that manually).
On Unix (including Linux), the @exec{drracket} executable can be run directly from the
command-line if it is in your path, which is probably the case if you chose a
Unix-style distribution when installing. Otherwise, navigate to the directory
where the Racket distribution is installed, and the @exec{drracket} executable will be
in the @filepath{bin} subdirectory.
If you are new to programming or if you have the patience to work
through a textbook:
@itemize[
@item{@italic{@link["http://htdp.org/"]{How to Design Programs}}
is the best place to start. Whenever the book says ``Scheme,''
you can read it as ``Racket.''}
@item{@other-manual['(lib "web-server/scribblings/tutorial/continue.scrbl")]
introduces you to modules and building web applications.}
@item{@other-manual['(lib "scribblings/guide/guide.scrbl")] describes
the rest of the Racket language, which is much bigger than
the learning-oriented languages of the textbook. Since you
learned functional programming from the textbook, you'll be
able to skim chapters 1 and 2 of the Guide.}
]
If you're already a programmer and you're in more of a hurry:
@itemize[
@item{@other-manual['(lib "scribblings/quick/quick.scrbl")] gives you
a taste of Racket.}
@item{@other-manual['(lib "scribblings/more/more.scrbl")] dives much
deeper and much faster. If it's too much, just skip to the
Guide.}
@item{@other-manual['(lib "scribblings/guide/guide.scrbl")] starts
with a tutorial on Racket basics, and then it describes the rest
of the Racket language.}
]
Of course, you should feel free to mix and match the above two tracks,
since there is information in each that is not in the other.