racket/pkgs/racket-doc/scribblings/getting-started/getting-started.scrbl
Matthew Flatt 710320e3dc "Mac OS X" -> "Mac OS"
Although "macOS" is the correct name for Apple's current desktop OS,
we've decided to go with "Mac OS" to cover all of Apple's Unix-like
desktop OS versions. The label "Mac OS" is more readable, clear in
context (i.e., unlikely to be confused with the Mac OSes that
proceeded Mac OS X), and as likely to match Apple's future OS names
as anything.
2016-12-23 12:18:36 -07:00

71 lines
2.8 KiB
Racket

#lang scribble/doc
@(require scribble/manual)
@title{Getting Started}
To get started with Racket,
@link["http://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, 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.