Re: tips/tools for ReSpec-to-Bikeshed conversion?

Shane McCarron <[email protected]> Tue, 8 Mar 2016 07:13:22 -0600
Newsgroups gmane.org.w3c.specifications
Message-ID <CAOk_reHC5-PWPqyO48kDash+po6XbOnEbW4f1HaoDfcGkXQknw@mail.gmail.com>
I would have started with the respec INPUT, not the output.  But otherwise
I am happy it seemed simple.

On Mon, Mar 7, 2016 at 6:55 PM, Tab Atkins Jr. <[email protected]> wrote:

> On Mon, Mar 7, 2016 at 4:43 PM, Hodges, Jeff <[email protected]>
> wrote:
> > installed pygments per one of the bikeshed error msgs
>
> It sounds like you didn't follow the installation instructions
> <https://github.com/tabatkins/bikeshed/blob/master/docs/install.md>
> linked from the README.  You're probably fine by now, but I find that
> people often run into problems because they cowboy'd the installation
> and missed some important steps. ^_^
>
> > FATAL ERROR: Found unmatched text macro [DOM4]. Correct the macro, or
> > escape it with a leading backslash.
> > FATAL ERROR: Found unmatched text macro [HTML5]. Correct the macro, or
> > escape it with a leading backslash.
> > FATAL ERROR: Found unmatched text macro [RFC2119]. Correct the macro, or
> > escape it with a leading backslash.
> > FATAL ERROR: Found unmatched text macro [PSL]. Correct the macro, or
> > escape it with a leading backslash.
>
> These are because strings like "[FOO]" are recognized by Bikeshed as
> text macros, which get substituted with something else at run-time.
> For a biblio reference, you want to double up on the brackets, to get
> "[[DOM4]]", etc.  This is described in
> <
> https://github.com/tabatkins/bikeshed/blob/master/docs/markup.md#autolink-shortcuts
> >.
>
> ~TJ
>



-- 
Shane McCarron
Managing Director, Applied Testing and Technology, Inc.