[IBD] Trac Syntax Coloring Subproject

[Kai Brüning-2]

(Positing this here because boost-docs@... currently rejects my mails although subscribing did work.)


Hi,

after volunteering help on boost.dev, Glyn Matthews and Matias Capeletto suggested that I take a look at IBD.

I think the Trac Syntax Coloring project should be rather fast and simple for starters, so I like to give it a try.

Looking around, I found that Trac is going to switch to Pygments (http://pygments.pocoo.org/) as default highlighter in version 0.11:

>Starting with trac 0.11 pygments will be the new default highlighter. It's a highlighting library implemented in pure python, very fast, easy to extend and well documented. While it does not support as many languages as Enscript or Scintilla the overall output quality is much better.

Since Pygments is supported in 0.10 via a plugin, too, I suggest to add new syntax lexing to Pygments.

>To use pygments trac 0.11 you just have to install pygments 0.5.1 or higher. If you want to use it in trac 0.10 too you have to install the TracPygmentsPlugin from trac hacks. If you encounter any bugs, please file tickets regarding pygments in the pocoo trac.

Joel and Eric, your QuickBook doc (http://www.boost.org/doc/html/quickbook.html) seems to be incomplete. At least I am missing keywords like super, alpha or template. Is there a complete syntax guide somewhere or should I look at the source as definitive references?

Kai
_______________________________________________
Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost

[John Maddock]

Kai Brüning wrote:
> Joel and Eric, your QuickBook doc
> (http://www.boost.org/doc/html/quickbook.html) seems to be
> incomplete. At least I am missing keywords like super, alpha or
> template. Is there a complete syntax guide somewhere or should I look
> at the source as definitive references?

No you should RTM :-)

"template" is documented under "block level elements -> templates" and
super/alpha should you ever see them are implemented as templates in the
docs they are used in - although at some point they may get moved into
quickbook itself, given that they are generally useful.

John.

_______________________________________________
Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost

[Matias Capeletto]

On 7/17/07, Kai Brüning <kai@...> wrote:
> (Positing this here because boost-docs@... currently rejects my mails although subscribing did work.)

Something strange is happening in that list.
Can someone take a look? Can we start thinking moving the boost-docs
list outside sourceforge?

> Hi,

Hello :)

> after volunteering help on boost.dev, Glyn Matthews and
> Matias Capeletto suggested that I take a look at IBD.
>
> I think the Trac Syntax Coloring project should be rather fast
> and simple for starters, so I like to give it a try.

Great!

> Looking around, I found that Trac is going to switch to Pygments.
> (snip)

I agree with the use of Pygments.

> Joel and Eric, your QuickBook doc
> (http://www.boost.org/doc/html/quickbook.html) seems to be incomplete.
> At least I am missing keywords like super, alpha or template.

You are reading Quickbook 1.3 docs.

> Is there a complete syntax guide somewhere or should I look at the
> source as definitive references?

Here it is a Quickbook 1.4 docs online version:
http://tinyurl.com/2r6nae

Before you start hacking at it, please read:
http://svn.boost.org/trac/boost/wiki/BoostKateSupport

The idea is to make both syntax coloring similar.

Download boost::hs, and look for the file:
http://tinyurl.com/33nb7b

It is an already working syntax higlighting for Kate:
http://docs.kde.org/stable/en/kdebase/kate/highlight.html

I think it may help you in your project.

This is other thing you may want to check:
http://svn.boost.org/trac/boost/wiki/QuickbookSourceStylesheetProject

The colors are already similar to the quickbook kate support definition.

Thanks for jumping in!
We really need this kind of energy at IBD :)
Please, be free to ask for anything you need.

King regards
Matias
_______________________________________________
Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost