Switch from scribble/manual to something else
sorawee opened this issue · comments
As I understand, #lang scribble/manual is for writing Racket manual. One constraint of scribble/manual is that it needs to support multiple formats: pdf, html, etc, so the language necessarily needs to pick a subset of html tags that it wants to support. The consequence is that it's impossible to use unsupported tags, like HTML5 <aside>.
I think it doesn't make sense to live under the constraint of scribble/manual. More generally, I think it doesn't make sense to use a language for writing Racket manual to write blog posts. scribble/html might be more appropriate.
I guess that's not true. I just saw:
@(elem
#:style
(style #f
(list (alt-tag "img")
(attributes '((src . "/img/IMG_20170918_155136272_HDR.jpg")
(beep . "boop"))))))
in one of the issues, so I guess it's possible to use an arbitrary tag.
Is this a good way to do things, though?
It's not a great way. I'm open to considering a better way. (But alas no time now myself.)
Although Frog should be "blog topic agnostic", realistically many/most Frog users are writing about programming and frequently about Racket.
As a result, any scribble/manual features aiding that, are good to have and we should keep.
It would be nice to have "scribble/manual the good parts, without the bad parts"... whatever that means exactly idk.
I will close this, since there doesn't seem to be any actionable item.