[racket] Scribble HTML preview tool

Thanks for this package. A couple of notes from a day of using it: 

1. I had two small problems with the installation: 

-- the first one is about mismatched compiled code 

> raco setup: 7 making: <pkgs>/describe/describe/scribblings
> get-doc-info error: /Users/matthias/Library/Racket/6.0.1.11/pkgs/pollen/doc/pollen/in.sxref::0: read (compiled): wrong version for compiled code


-- the second one is about an undefined tag in the docs: 

> raco setup: WARNING: undefined tag in <pkgs>/pollen/scribblings/pollen.scrbl:
> raco setup:  ((lib "pollen/decode.rkt") wrap-hanging-quotes)


raco setup: WARNING: undefined tag in <pkgs>/pollen/scribblings/pollen.scrbl:
raco setup:  ((lib "pollen/decode.rkt") wrap-hanging-quotes)


2. I had a minor problem with the pollen 'server'. I run scribble to document code with for-label imports. I get this right with roughly this script, a poor man's pollen: 

> scribble --html ++xref-in setup/xref load-collections-xref \
>           --dest Tmp/ \
>           $1.scrbl 
> open ~/0Unison/0Web/OnHtDP/Source/Tmp/$1.html

But with raco pollen I get cross references underlined in red. Is there a file (.pollenrc?) where I can specify scribble options? 

My quick read of the pollen docs didn't get me an answer. 

Thanks again -- Matthias








On May 14, 2014, at 1:12 PM, Matthew Butterick <mb at mbtype.com> wrote:

> Maybe there was already a way to do this, but I didn't come across it. I like to be able to preview my Scribble HTML as I'm working on the source. So I built this capability into my Pollen package:
> 
> raco pkg install pollen
> cd /path/to/scribble/sources
> raco pollen start
> 
> Then, when you visit http://localhost:8080/index.ptree in your web browser, you'll see a list of your Scribble sources and can click on them to preview. As you edit the source, you can reload the browser and it will update the HTML.
> 
> One limitation: this tool only provides single-page previews, and certain formatting will change (e.g., titles) when the source is rendered in multi-page mode.
> ____________________
>  Racket Users list:
>  http://lists.racket-lang.org/users

-------------- next part --------------
A non-text attachment was scrubbed...
Name: smime.p7s
Type: application/pkcs7-signature
Size: 4463 bytes
Desc: not available
URL: <http://lists.racket-lang.org/users/archive/attachments/20140609/a8ae074a/attachment.p7s>