[racket-dev] Tweaked doc pages

From: Matthias Felleisen (matthias at ccs.neu.edu)
Date: Tue Feb 26 10:37:10 EST 2013

Thank you Eli. Thanks for taking the initiative because all pages at racket-lang.org should have the same look and feel. 

Please roll back the change so that dev can discuss the changes before we commit to them. 

On Feb 26, 2013, at 9:53 AM, Eli Barzilay wrote:

> I have finally implemented a script that hacks the on-line doc pages.
> Currently, it does the following (and you can see the changes on the
> web now):
> 1. Slap the contents into a the usual template, so the doc pages
>   finally look like they belong to the site rather than a cheap copy
>   of what you have in your installation.
> 2. Add a "[PDF]" link in manual toplevel pages (under the version).
> 3. Remove the redundant "index.html" from URLs.  (In a hacky way.)
> It's not pretty, but there's no way that I see to make it less hacky
> without some serious revision to the documentation renderer so it can
> be parameterized for web presentation -- and that has a bunch of
> difficult problems, like the fact that the web-generating code is not
> distributed, or the fact that it should apply to older doc pages too.
> So I resorted to regexp tweaking.
> Things that would be nice to add now are turning the version number
> into a combo box to select different versions, and a google-based
> search box to get full-text search (which is probably easy using
> "in-url:" or the custom search thing that we had in the past, or a
> combination).  If anyone is interested, see the script for a
> description of how you run it.
> -- 
>          ((lambda (x) (x x)) (lambda (x) (x x)))          Eli Barzilay:
>                    http://barzilay.org/                   Maze is Life!
> _________________________
>  Racket Developers list:
>  http://lists.racket-lang.org/dev

Posted on the dev mailing list.