Re: [Boost-users] Boost cookbook site (alpha)

From: Kirit Sælensminde (kirit.saelensminde_at_[hidden])
Date: 2007-09-25 12:41:26

Edd Dawson wrote:
> Is there a syntax reference anywhere? I'm unsure as to whether I can link to 
> other libraries that aren't in the "check-box area", for example. I would have 
> liked to have done a bullet-list, too. Is this possible?

The syntax is pretty much MediaWiki with a couple of exceptions. I 
really must write the syntax up properly. If you look at an existing 
recipe and show it's properties you will see the markup used for the 
description, with one exception.

If you want to embed pre formatted stuff, like short code examples, then 
prefix each line with four spaces. The spaces get collapsed in the 
properties view so you don't see them. E.g. 
http://www.boostcookbook.com/_fslib/properties.asp?id=1234820

Other formatting is * for bullet list, # for numbered list. 
[http://www.example.com Example link] and [[Libraries:Boost.Thread|link 
to library page]]. The content system is much richer than this, but I've 
not had time to configure it fully to combat XSS etc. so all HTML is 
just turned off.

I've not had time to add all the libraries - there's a surprising number 
of them and I've been busy getting the thing working. There's a thread 
where you can post requests - 
http://www.boostcookbook.com/_fslib/_content/thread.asp?id=1234798 The 
site will email you when I reply to say I've added the library. I 
haven't even gotten around to putting in Boost.Thread for the futures 
example :(

Don't forget that recipes can be edited later so you don't need to get 
them perfect first time (and we can edit each others, just like a normal 
wiki). So if a library you want to reference isn't there yet then post 
the recipe anyway, request the library and then edit the post later. The 
site feed will also automatically update to the new contents.

I've also just added a blog. Please everybody grab a copy of the site's 
Atom feed to keep up to date with what's going on at 
http://www.boostcookbook.com/_fslib/_content/atom.asp

K