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.