User Manual

• The IGS client
• The game window
• The SGF editor
• Play with GnuGo
• Solving problems
• The RubyGo printing system
• Customizing RubyGo
• Changes from last version
• Troubles with Ruby

Rubygo uses TeX/LaTeX to print diagrams along with texts that are stored in the sgf file. in the menu 'File' choose 'Print'. A window will stay opened, allowing the addition of several diagrams and texts in the same print operation. The right part of the window defines pathnames to tools used by RubyGo.

Installing tools:

• Linux: you should already have latex installed, and a postscript compatible printer or ghostscript installed.
• Windows: You have to install latex AND ghostscript. Here are the links to the packages I use:
  • MiKTeX (latex distribution for windows) http://www.miktex.org/2.1/index.html
  • ghostscript & ghostview http://www.cs.wisc.edu/~ghost/doc/AFPL/get704.htm

Rubygo will produce a latex source file (/tmp/diagram.tex). Then it uses the 'latex' command on it to produce a DVI file (DeVice Independant). This file can be transformed to many formats. But Rubygo (using TK) produces diagrams in the 'Encapsulated Postscript' format. So it will use 'dvips' to produce a postcript (PS) file ready to be printed by a postscript printer. If you don't have one, it will use ghostcscript to print your file in the appropriate format. All this may seem complicated, but it is automatic. If you have the commands (latex, dvips, etc ...) in your PATH, just put the command names in the fields, otherwise to be more complete use the full path. In the defaults I have the working full path example as used on my WinNT system.

Windows: Miktex includes a dvi viewer named 'yap' (Yet Another Previewer) That you can use to view the DVI file, AND to print it directly, using the 'print postscript' button. (yap will use ghostscript). Normally you only have to choose 'make DVI' and 'view DVI' to produce and print your file. (In that case, only the fields 'latex program' and 'dvi viewer' need to be set).

The five buttons correspond to launch the five commands in the fields. The left part of the 'print' window correspond to the LaTeX options used to produce the '.tex' file:

• File: by default '/tmp/diagram.tex' or 'c:\Temp\diagram.tex'
• mode : color or mono: for the diagram . (the color option make a very nice woodboard with postscript color printer)
• paper: I know only A4 and letter but ask me for add others.
• diagram width : a decimal number from 0 to 1 (1 fit the full text width on the page)
• float figures: If you have many texts and figures, you may have better page layout results by using the 'figure' configuration:
  • If not set, you are guaranteed to have diagrams and texts in the proper order but there can be some blanks in the pages.
  • With 'figure' set the diagrams and texts are always numbered, and they are arranged by LaTeX to have nicer page layout.(i.e. no blanks in the pages)

Go to the first diagram you want to print. Press the 'add to list' button. Go to the next diagram and add it to the list as well, if you so desire. Once you have have added all the diagrams, click on 'make output', and then the tools you have selected in the right window will be used. At a minimum you must at least produce the DVI file. If you close the 'print' window, the list is lost. If you know latex, you can directly edit the tex file, and then write your go book ;-) note that in the text of the nodes, you can directly insert latex code as in the following snipet: this text is in \textbf{bold font} and this one in \textit{italic}.
see a LaTeX manual for more information.

example of how to print a game with rubygo:

1. open the game.
2. select menu item: "Game" - "move number" - "show"
3. you can de-select "Game" - "FIgure" - "Remove captured stones" which is useful for diagrams printed like in a book.
4. go to move 100
5. select menu item: "File"-"Print".
6. Press 'add to list' to add the current board diagram.
7. Go to other move positions as in the 3rd step, and 'add to list' if so desired.
8. Select 'make dvi' and 'view dvi', then press 'make output' to print your list of selected diagrams.

if you are satisfied,
windows: press 'print postscript' for the miktex yap viewer or
windows and linux:

• deselect 'view dvi'
• checkmark 'make Postscript' and 'print Postscript'.
• press 'make output' and look towards your printer for the results :)

For further information, send me a mail