GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Down­load and install Racket
  • raco
  • setting the Mac OS PATH
  • setting the Windows PATH

This view

  • Original page
  • New address

GeezerVison is showing beautifulracket.com — Beautiful Racket: Setup

Thank you for your comment

Beau­tiful Racket



Setup



You need to install Racket and the beautiful-racket package to complete the tuto­rials in this book. They’ll run on Mac OS, Linux, or Windows.



You need an internet connec­tion to complete this setup. Once installed, you don’t need a connec­tion to use Racket or its docu­men­ta­tion.



If you already have Racket v.6.7 or later installed, you can just install the beautiful-racket package.



Quick setup



This easy but minimal setup will get you through the first set of tuto­rials: stacker, funstacker, stackerizer, and most of bf. You can also try any of the exam­ples in the explainers. After that, you’ll have to complete the full setup shown below.

  • 

    Down­load and install Racket, which includes DrRacket. (Though you can edit source files using any text editor, the tuto­rials will assume you’re using DrRacket.)

  • 

    Launch DrRacket. Use the File → Install Package ... command to install beautiful-racket.



Full setup



The terminal commands you’ll be using in this book are simple. But if you haven’t used your terminal window before, this is the moment to learn where it is. (On Mac OS, your terminal window is called Terminal; on Windows 7 it’s called the Windows Command Processor; on Windows 10, the Windows Command Prompt.)

  • 

    Down­load and install Racket, which includes DrRacket. (Of course, you’re welcome to use your preferred text editor, but the tuto­rials will assume you’re using DrRacket.)

  • 

    Update the PATH envi­ron­ment vari­able on your system to include the direc­tory that holds the racket appli­ca­tion. On Mac OS and Linux, this path will be some­thing like "/path/to/racket/bin". On Windows, it’ll be some­thing like "C:\Program Files\Racket". Then, from the terminal, you’ll be able to run racket and raco.

  • 

    Mac OS users who haven’t altered your PATH before: don’t panic. Follow the instruc­tions in setting the Mac OS PATH.

  • 

    Windows users who haven’t altered your PATH before: don’t panic. Follow the instruc­tions in setting the Windows PATH.

  • 

    From the command line, install beautiful-racket:

    raco pkg install --auto beautiful-racket
    1
    sh$ raco pkg install --auto beautiful-racket
    copy to clipboard
  • 

    To check that it worked, try this on the command line (the -l switch tells racket to start with a partic­ular module):

    racket -l br/test
    1
    sh$ racket -l br/test
    copy to clipboard
    

    You should see this:

    You installed beautiful-racket v1.6 correctly.
    1
    You installed beautiful-racket v1.6 correctly.
    copy to clipboard
    

    But if you see this:

    open-input-file: cannot open module file
      module path: (lib "br/test")
      path: ···
      system error: no such file or directory; rktio_err=3
    1
2
3
4
    open-input-file: cannot open module file
  module path: (lib "br/test")
  path: ···
  system error: no such file or directory; rktio_err=3
    copy to clipboard
    

    Then beautiful-racket was not installed correctly. You’ll need to fix the problem before proceeding, most likely by rein­stalling beautiful-racket.

  • 

    If Racket is still running, type ctrl+D or (exit) to quit.



Setting br as the default language



Except where other­wise noted, all code samples in the book rely on #lang br. But after instal­la­tion, DrRacket will use #lang racket as the default language in new docu­ments.



To change this setting, select Language → Choose Language in DrRacket. Make sure The Racket Language is selected, and then click the Show Details button at the bottom. In the section called Auto­matic #lang line, in the field labeled Always use the same #lang line, put #lang br as the value.



After that, new windows in DrRacket will start with #lang br already at the top.



Updates



In the future, I will release improve­ments to the beautiful-racket soft­ware. When that happens, you can update your copy of beautiful-racket from the command line:


raco pkg update --update-deps beautiful-racket
1
sh$ raco pkg update --update-deps beautiful-racket
copy to clipboard


Reporting prob­lems



For anything related to #lang br or the br libraries, please use the issue tracker for the beautiful-racket source repos­i­tory.



For anything related to #lang brag, please use the issue tracker for the brag source repos­i­tory.

← prev next →
You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.