govspeak icon indicating copy to clipboard operation
govspeak copied to clipboard

Is this gem intended to be used standalone?

Open peteryates opened this issue 2 years ago • 3 comments

Some time ago I created a small Govspeak prototype kit which was heavily used by the DfE as part of the early COVID-19 response - its purpose was to allow content to be researched with users prior to publishing.

That application is a static site generator and should have minimal dependencies. Unfortunately, requiring in govspeak pulls in GOV.UK Publishing Components which pulls in Rails; it's all a bit unwieldy.

As far as I can see there's only a minimal need for the publishing components by this gem, is it necessary to make it a concrete requirement? It's fine if the answer is 'yes', it might be easier for us to just support plain Markdown and apply our own extensions if and when we need them.

peteryates avatar Mar 31 '22 10:03 peteryates

I'd like to add another vote to this.

We had a simple need to support (some) Govspeak syntax and as we were already using Kramdown, I thought it would be a simple switch to use this for parsing. It would have been except for the dependency on GOV.UK Publishing Componnents, which caused issues within our asset pipeline, and in our build pipleine due to ENV vars required by Plek (a dependency of Publishing Components).

It would seem to make sense to me that this repo would handle the conversion of Govspeak-flavoured-markdown into HTML, and the user is then indendently responsible for the styling of the HTML however they choose.

chrispymm avatar Jun 07 '23 15:06 chrispymm

@chrispymm since raising this we did some work with govuk_markdown and it now supports inset text and details components. Others will only be a PR away.

peteryates avatar Jun 07 '23 15:06 peteryates

@peteryates Thanks, govuk_markdown looks good but unfortunately we already have content published using govspeak syntax so wouldn't easily be able to switch to a different syntax now.

chrispymm avatar Jun 08 '23 09:06 chrispymm