Hello fellow Racketeers,
I've started a small side project and as a part of that I want to write
some articles interspersed with code. Scribble was a natural choice for
that task.
So I started with #lang scribble/manual as usual and after writing some
text, I tried to do something like the following:
====
#lang scribble/manual
... and here are the requires:
@racketblock{
(require
}
.. with the first one being this and we need that for ....
@racketblock{
(only-in ffi/unsafe ptr-set! _uint32)
}
...
====
Of course it renders the racketblocks as string, silly me. So I go for
@racketblock[] but that - in @-syntax translates to S-expressions with
"(require" (without the quotes) definitely not being a valid
S-expression. And therefore scribble cannot handle it.
Looking at [1] leaves me with an impression that it is not possible to
typeset parts of racket code in scribble. Only valid S-expressions (and
the #lang line, of course).
Using scribble/lp2 I can get closer to my wanted result, but really it
just works around the issue by forming valid S-expressions and expanding
chunks inside those.
What is the proper way of typesetting (in scribble) parts of racket code
which do not form complete S-expression?
And yes, I know this is rather strange requirement, but in this
particular case, I am pretty sure, I want to work with parts of
S-expressions without balanced parentheses. (Although the minimal
example definitely does not answer "why").
I assume I must have overlooked something, of course.
Cheers,
Dominik
[1]
https://docs.racket-lang.org/scribble/scribble_manual_code.html