Discussion:
ReSpec: highlighter and news
m***@marcosc.com
2016-05-19 13:36:43 UTC
Permalink
Hi ReSpec users,
We are super excited to announce an update to ReSpec's syntax highlighter - coming in the next day or so. We are ditching the old google prettify and moving to "hljs" [1]. This is exciting because it brings support for ES2016 syntax, performance improvements, smart language detection, and ongoing updates.

How does this impact you?

* pre elements will be highlighted by default (yay!). You can opt out totally by setting "noHighlightCSS: true," in your ReSpec config - or give an individual pre a "nohighlight" class.

* having a "highlight" class is now deprecated (it will generate a warning).

Other cool things we are releasing:

* we've upgraded our markdown support: you can now use ``` to denote a code block, just like on GitHub.

* beatification of output. When you export (X)HTML for publication, ReSpec will try to beautify the generated code a bit for you (section tags will be nested, etc.).

We hope ❤️ like the updates! Any issues, please let us know.

The ReSpec Team
[1] https://highlightjs.org
Shane McCarron
2016-05-19 14:57:27 UTC
Permalink
Marcos,

Thanks for all your hard work on this! (For the record, while I am on the
'team' I did basically none of this.)

As we move ahead, I wonder how people would feel about harmonizing the
styles for things like example, issue, and webidl markup between ReSpec and
bikeshed. I think this would help solidify the brand. I also think it
would help if we just pushed those styles into the W3C base styles (at
least when ReSpec is in W3C mode).
Post by m***@marcosc.com
* beatification of output. When you export (X)HTML for publication, ReSpec
will try to beautify the generated code a bit for you (section tags will be
nested, etc.).
I like that this is being 'beatified' - I had no idea you had a connection
to the Pope!
--
Shane McCarron
Projects Manager, Spec-Ops
Michiel Bijl
2016-05-19 15:27:31 UTC
Permalink
Thanks for the effort, sounds really good!

—Michiel
Post by m***@marcosc.com
Hi ReSpec users,
We are super excited to announce an update to ReSpec's syntax highlighter - coming in the next day or so. We are ditching the old google prettify and moving to "hljs" [1]. This is exciting because it brings support for ES2016 syntax, performance improvements, smart language detection, and ongoing updates.
How does this impact you?
* pre elements will be highlighted by default (yay!). You can opt out totally by setting "noHighlightCSS: true," in your ReSpec config - or give an individual pre a "nohighlight" class.
* having a "highlight" class is now deprecated (it will generate a warning).
* we've upgraded our markdown support: you can now use ``` to denote a code block, just like on GitHub.
* beatification of output. When you export (X)HTML for publication, ReSpec will try to beautify the generated code a bit for you (section tags will be nested, etc.).
We hope ❤️ like the updates! Any issues, please let us know.
The ReSpec Team
[1] https://highlightjs.org
Travis Leithead
2016-05-19 16:57:29 UTC
Permalink
Where might I find out more about how much Markdown support is currently available? I didn't see anything about it in the User's Guide or Reference docs...

-----Original Message-----
Post by m***@marcosc.com
* we've upgraded our markdown support: you can now use ``` to denote a code block, just like on GitHub.
We hope ❤️ like the updates! Any issues, please let us
Shane McCarron
2016-05-19 17:23:31 UTC
Permalink
I added an issue about this Travis:
https://github.com/w3c/respec-docs/issues/45

The short answer is that there is support for markdown in general. Do you
mean which dialect(s)?

On Thu, May 19, 2016 at 11:57 AM, Travis Leithead <
Post by Travis Leithead
Where might I find out more about how much Markdown support is currently
available? I didn't see anything about it in the User's Guide or Reference
docs...
-----Original Message-----
Post by m***@marcosc.com
* we've upgraded our markdown support: you can now use ``` to denote a
code block, just like on GitHub.
Post by m***@marcosc.com
We hope ❀ like the updates! Any issues, please let us know.
The ReSpec Team
--
Shane McCarron
Projects Manager, Spec-Ops
Loading...