# \#scribble

**URL:** https://racket.discourse.group/tag/scribble/64.md

[Latest](https://racket.discourse.group/latest.md) · [Categories](https://racket.discourse.group/categories.md) · [Tags](https://racket.discourse.group/tags.md)

---

## [Scribble + built-in REPL/sandbox](https://racket.discourse.group/t/scribble-built-in-repl-sandbox/4105)

<div class="topic-metadata">

**Author:** [@jschuster](https://racket.discourse.group/u/jschuster)\
**Replies:** 1\
**Last updated:** [February 13, 2026, 12:06am UTC](https://racket.discourse.group/t/scribble-built-in-repl-sandbox/4105 "2026-02-13T00:06:34Z")

</div>

Hello, Racketeers. I have a little side project to design a new language, and I thought it would be nice to have docs that let the reader try out the language in a built-in sandbox along the way. It would be a lot like A…

---

## [Scribble and plot/pict doesn't know about pi?](https://racket.discourse.group/t/scribble-and-plot-pict-doesnt-know-about-pi/3850)

<div class="topic-metadata">

**Author:** [@ddrake](https://racket.discourse.group/u/ddrake)\
**Replies:** 2\
**Last updated:** [July 12, 2025, 7:47pm UTC](https://racket.discourse.group/t/scribble-and-plot-pict-doesnt-know-about-pi/3850 "2025-07-12T19:47:16Z")

</div>

I'm experimenting with Scribble and wanted to see about including function plots. Something like this: #lang scribble/base @(require scribble/manual) @(require plot/pict) @title{Plots in Scribble} The sine function: …

---

## [When is a part collected-info-number set to '(#f)?](https://racket.discourse.group/t/when-is-a-part-collected-info-number-set-to-f/3823)

<div class="topic-metadata">

**Author:** [@stevebyan](https://racket.discourse.group/u/stevebyan)\
**Replies:** 1\
**Last updated:** [June 29, 2025, 2:42pm UTC](https://racket.discourse.group/t/when-is-a-part-collected-info-number-set-to-f/3823 "2025-06-29T14:42:39Z")

</div>

Under some circumstances, the collected-info-number for a Scribble part is set to '(#f). Does anyone happen to know what causes it to be set to that value?

---

## [Should the html section tag include section pretitle content?](https://racket.discourse.group/t/should-the-html-section-tag-include-section-pretitle-content/3808)

<div class="topic-metadata">

**Author:** [@stevebyan](https://racket.discourse.group/u/stevebyan)\
**Replies:** 1\
**Last updated:** [June 27, 2025, 2:49pm UTC](https://racket.discourse.group/t/should-the-html-section-tag-include-section-pretitle-content/3808 "2025-06-27T14:49:08Z")

</div>

I'm adding the html section tag to the Scribble html renderer. Should the scope of the section tag include pretitle content, or should it only include content starting at the Scribble section command?

---

## [DrRacket and Scribble datums](https://racket.discourse.group/t/drracket-and-scribble-datums/3659)

<div class="topic-metadata">

**Author:** [@stevebyan](https://racket.discourse.group/u/stevebyan)\
**Replies:** 5\
**Last updated:** [March 27, 2025, 1:03am UTC](https://racket.discourse.group/t/drracket-and-scribble-datums/3659 "2025-03-27T01:03:07Z")

</div>

How do I persuade DrRacket to let me type an opening square bracket to introduce a datum after the command, as in this example from the Scribble docs: @foo\[#:width 2\]{blah blah} It insists on inserting an open parenthes…

---

## [How can I access the author and date in \`html-render:render-one-part\`?](https://racket.discourse.group/t/how-can-i-access-the-author-and-date-in-html-render-render-one-part/3650)

<div class="topic-metadata">

**Author:** [@stevebyan](https://racket.discourse.group/u/stevebyan)\
**Replies:** 1\
**Last updated:** [March 25, 2025, 5:54pm UTC](https://racket.discourse.group/t/how-can-i-access-the-author-and-date-in-html-render-render-one-part/3650 "2025-03-25T17:54:20Z")

</div>

I'm trying to access the author(s) and date in the render-one-part method in html-render.rkt. I've added extract-date to the list of methods inherited from the render-mixin. extract-authors is already there. However, ca…

---

## [How to test scribble?](https://racket.discourse.group/t/how-to-test-scribble/3642)

<div class="topic-metadata">

**Author:** [@stevebyan](https://racket.discourse.group/u/stevebyan)\
**Replies:** 0\
**Last updated:** [March 22, 2025, 2:47pm UTC](https://racket.discourse.group/t/how-to-test-scribble/3642 "2025-03-22T14:47:29Z")

</div>

Are there additional tests for scribble beyond raco test -c scribble?

---

## ["path+anchor-\>tag", or, get bluebox given path+anchor](https://racket.discourse.group/t/path-anchor-tag-or-get-bluebox-given-path-anchor/3165)

<div class="topic-metadata">

**Author:** [@greghendershott](https://racket.discourse.group/u/greghendershott)\
**Replies:** 1\
**Last updated:** [September 11, 2024, 7:21pm UTC](https://racket.discourse.group/t/path-anchor-tag-or-get-bluebox-given-path-anchor/3165 "2024-09-11T19:21:00Z")

</div>

There exists xref-tag-\>path+anchor. I don't see the reverse -- anything like "xref-path+anchor-\>tag". Is it possible for me to write this myself, and if so, how? Why I ask: Given a documentation path + anchor, I want…

---

## [Include partial content from another scribble document](https://racket.discourse.group/t/include-partial-content-from-another-scribble-document/3100)

<div class="topic-metadata">

**Author:** [@nik](https://racket.discourse.group/u/nik)\
**Replies:** 9\
**Last updated:** [August 17, 2024, 9:33am UTC](https://racket.discourse.group/t/include-partial-content-from-another-scribble-document/3100 "2024-08-17T09:33:30Z")

</div>

I was wondering whether it's possible to include content from another scribble document directly. I know that it's possible to reference other parts via the tagging functionality, but would something similar be possible…

---

## [Can one add new renderers to Scribble via a package?](https://racket.discourse.group/t/can-one-add-new-renderers-to-scribble-via-a-package/3023)

<div class="topic-metadata">

**Author:** [@stevebyan](https://racket.discourse.group/u/stevebyan)\
**Replies:** 1\
**Last updated:** [July 18, 2024, 3:27am UTC](https://racket.discourse.group/t/can-one-add-new-renderers-to-scribble-via-a-package/3023 "2024-07-18T03:27:21Z")

</div>

I'd like to extend Scribble with an --html-nav option to produce a separate file containing the navigational elements. My intent is to convert the Scribble-generated html to sxml, then include the body sxml and navigatio…

---

## [How to hilight non-racket code with Scribble?](https://racket.discourse.group/t/how-to-hilight-non-racket-code-with-scribble/2832)

<div class="topic-metadata">

**Author:** [@janus](https://racket.discourse.group/u/janus)\
**Replies:** 3\
**Last updated:** [March 30, 2024, 3:35am UTC](https://racket.discourse.group/t/how-to-hilight-non-racket-code-with-scribble/2832 "2024-03-30T03:35:34Z")

</div>

As a continuation to this StackOverflow question, I now want to hilight Idris2 code using Scribble. I like Scribble for the styling and the programmability in general, but the code of my documentation is not Scheme/Racke…

---

## [How can I insert an image file into a Scribble document?](https://racket.discourse.group/t/how-can-i-insert-an-image-file-into-a-scribble-document/2779)

<div class="topic-metadata">

**Author:** [@spdegabrielle](https://racket.discourse.group/u/spdegabrielle)\
**Replies:** 0\
**Last updated:** [March 11, 2024, 2:53pm UTC](https://racket.discourse.group/t/how-can-i-insert-an-image-file-into-a-scribble-document/2779 "2024-03-11T14:53:50Z")

</div>

Someone recently asked how can I insert a png image file into a Scribble document? The scribble manual gives a nice example of using a pict you create yourself: @; ---------------------------------------- @section\[#…

---

## [Documenting struct in Scribble](https://racket.discourse.group/t/documenting-struct-in-scribble/2618)

<div class="topic-metadata">

**Author:** [@PLux55](https://racket.discourse.group/u/PLux55)\
**Replies:** 2\
**Last updated:** [January 4, 2024, 10:12pm UTC](https://racket.discourse.group/t/documenting-struct-in-scribble/2618 "2024-01-04T22:12:13Z")

</div>

How do you document a field of a struct which has a #:mutable option. There is nothing about this in the documentation. I'm running racket 8.7.

---

## ['undefined tag' when building package scribble](https://racket.discourse.group/t/undefined-tag-when-building-package-scribble/2624)

<div class="topic-metadata">

**Author:** [@houpt](https://racket.discourse.group/u/houpt)\
**Replies:** 2\
**Last updated:** [December 31, 2023, 5:55pm UTC](https://racket.discourse.group/t/undefined-tag-when-building-package-scribble/2624 "2023-12-31T17:55:43Z")

</div>

Long time, first time. I've posted my first package('circular-layout') to pkgs.racket-lang.org, and the process was very easy -- except I get some cross-reference errors when the documentation is built by 'raco pkg ins…

---

## [Optional Scribble Sections; General Macro for Inclusion / Exclusion of Code](https://racket.discourse.group/t/optional-scribble-sections-general-macro-for-inclusion-exclusion-of-code/2329)

<div class="topic-metadata">

**Author:** [@bakgatviooldoos](https://racket.discourse.group/u/bakgatviooldoos)\
**Replies:** 6\
**Last updated:** [December 14, 2023, 7:57am UTC](https://racket.discourse.group/t/optional-scribble-sections-general-macro-for-inclusion-exclusion-of-code/2329 "2023-12-14T07:57:14Z")

</div>

Hi, Racket Discourse. I am wondering whether there is an "obvious" way to include or exclude certain pieces of code based on some form of "check". In particular, I want to exclude and include certain sections in a Scrib…

---

## [Scribble possible to render to custom output format (Anki)?](https://racket.discourse.group/t/scribble-possible-to-render-to-custom-output-format-anki/2463)

<div class="topic-metadata">

**Author:** [@jegfish](https://racket.discourse.group/u/jegfish)\
**Replies:** 4\
**Last updated:** [November 7, 2023, 3:06pm UTC](https://racket.discourse.group/t/scribble-possible-to-render-to-custom-output-format-anki/2463 "2023-11-07T15:06:27Z")

</div>

I am looking to create a set of tutorials and am considering including Anki notes (spaced-repetition flashcards) alongside them to give readers an additional resource and facility to remember the information. I'm conside…

---

## [Newbie Trouble using Scribble Links](https://racket.discourse.group/t/newbie-trouble-using-scribble-links/2237)

<div class="topic-metadata">

**Author:** [@bakgatviooldoos](https://racket.discourse.group/u/bakgatviooldoos)\
**Replies:** 8\
**Last updated:** [August 22, 2023, 10:20am UTC](https://racket.discourse.group/t/newbie-trouble-using-scribble-links/2237 "2023-08-22T10:20:29Z")

</div>

Hi, Racket Discourse. I am busy preparing some documentation for a presentation that I have to do this afternoon, but I am banging my head against a wall trying to use Scribble section references and the like. All I wa…

---

## [How to add a search box to a scrrible document](https://racket.discourse.group/t/how-to-add-a-search-box-to-a-scrrible-document/2112)

<div class="topic-metadata">

**Author:** [@jmj](https://racket.discourse.group/u/jmj)\
**Replies:** 4\
**Last updated:** [July 18, 2023, 3:13pm UTC](https://racket.discourse.group/t/how-to-add-a-search-box-to-a-scrrible-document/2112 "2023-07-18T15:13:14Z")

</div>

Hello everyone, I am making study notes with scrrible. I hope the notes can be searched, just like Racket documents. How to do that?

---

## [Links in scribble to rkt files and the like](https://racket.discourse.group/t/links-in-scribble-to-rkt-files-and-the-like/2096)

<div class="topic-metadata">

**Author:** [@joskoot](https://racket.discourse.group/u/joskoot)\
**Replies:** 2\
**Last updated:** [July 13, 2023, 6:18am UTC](https://racket.discourse.group/t/links-in-scribble-to-rkt-files-and-the-like/2096 "2023-07-13T06:18:21Z")

</div>

In a scribble file (especially scribble/manual) I include hyperlinks to .rkt files and alike. However, clicking a link opens the file in the browser, it does not open it with DrRacket. This problem does not occur in .doc…

---

## [Copy/paste from scribble/acmart @sigplan into DrRacket?](https://racket.discourse.group/t/copy-paste-from-scribble-acmart-sigplan-into-drracket/2078)

<div class="topic-metadata">

**Author:** [@benknoble](https://racket.discourse.group/u/benknoble)\
**Replies:** 14\
**Last updated:** [July 8, 2023, 3:38pm UTC](https://racket.discourse.group/t/copy-paste-from-scribble-acmart-sigplan-into-drracket/2078 "2023-07-08T15:38:49Z")

</div>

This should be a short example document that produces the problem: #lang scribble/acmart @sigplan @screen @(require scriblib/figure (only-in scribble/manual racketmod0)) @title{Title} @section{Section} @fi…

---

## [How to include a Google analytics tag to a scribble website](https://racket.discourse.group/t/how-to-include-a-google-analytics-tag-to-a-scribble-website/2042)

<div class="topic-metadata">

**Author:** [@Panadestein](https://racket.discourse.group/u/Panadestein)\
**Replies:** 1\
**Last updated:** [June 26, 2023, 9:08am UTC](https://racket.discourse.group/t/how-to-include-a-google-analytics-tag-to-a-scribble-website/2042 "2023-06-26T09:08:11Z")

</div>

I would like to add a Google Analytics tag to a scribble generated website. I have found this solution here, but it is outdated. The new form of the tags is: \<!-- Google tag (gtag.js) --\> \<script async src="https://www.…

---

## [How to programmatically generate a newline using scribble-slideshow?](https://racket.discourse.group/t/how-to-programmatically-generate-a-newline-using-scribble-slideshow/1869)

<div class="topic-metadata">

**Author:** [@janus](https://racket.discourse.group/u/janus)\
**Replies:** 0\
**Last updated:** [April 15, 2023, 10:55pm UTC](https://racket.discourse.group/t/how-to-programmatically-generate-a-newline-using-scribble-slideshow/1869 "2023-04-15T22:55:31Z")

</div>

I am generating code listings in Scribble that I highlight myself. Example: todo list I have been using (make-element 'newline '()) to generate newlines which work when rendered to HTML, but when shown in slideshow, the…

---

## [Supress reader abbreviation in scribble interaction](https://racket.discourse.group/t/supress-reader-abbreviation-in-scribble-interaction/1830)

<div class="topic-metadata">

**Author:** [@joskoot](https://racket.discourse.group/u/joskoot)\
**Replies:** 3\
**Last updated:** [March 24, 2023, 5:55pm UTC](https://racket.discourse.group/t/supress-reader-abbreviation-in-scribble-interaction/1830 "2023-03-24T17:55:48Z")

</div>

In general it is nice that scribble/manual applies reader abbreviations, but in some cases I want to suppress abbreviation, especially in an interaction. I have made several attempts like (interaction #:eval (…

---

## [Custom scribble site design](https://racket.discourse.group/t/custom-scribble-site-design/1674)

<div class="topic-metadata">

**Author:** [@spdegabrielle](https://racket.discourse.group/u/spdegabrielle)\
**Replies:** 1\
**Last updated:** [February 6, 2023, 8:31am UTC](https://racket.discourse.group/t/custom-scribble-site-design/1674 "2023-02-06T08:31:22Z")

</div>

Hi I’d like to make a variant of #lang scribble/manual that has keeps the same site structure; table of contents page with individual chapter pages, but has a preamble followers by the table of contents as tiled images …

---

## [Usage of code-examples in scribble](https://racket.discourse.group/t/usage-of-code-examples-in-scribble/1628)

<div class="topic-metadata">

**Author:** [@Panadestein](https://racket.discourse.group/u/Panadestein)\
**Replies:** 4\
**Last updated:** [January 9, 2023, 12:13am UTC](https://racket.discourse.group/t/usage-of-code-examples-in-scribble/1628 "2023-01-09T00:13:56Z")

</div>

Hello everyone, I have been recently working on SICP with Chez Scheme. I was using Emacs with org-mode to organize my solutions using literate programming, and then exporting them to HTML. Then I read about Racket, DrR…

---

## [Scribble Cheatsheet](https://racket.discourse.group/t/scribble-cheatsheet/1441)

<div class="topic-metadata">

**Author:** [@a11ce](https://racket.discourse.group/u/a11ce)\
**Replies:** 1\
**Last updated:** [November 5, 2022, 6:15pm UTC](https://racket.discourse.group/t/scribble-cheatsheet/1441 "2022-11-05T18:15:39Z")

</div>

I wrote a cheatsheet/quick reference for Scribble: https://docs.racket-lang.org/scribble-cheatsheet/index.html It's purposefully non-exhaustive, but if there's something missing that you think fits the scope lmk or sen…

---

## [Multiple bibliographies in a scribble document](https://racket.discourse.group/t/multiple-bibliographies-in-a-scribble-document/1373)

<div class="topic-metadata">

**Author:** [@brittAnderson](https://racket.discourse.group/u/brittAnderson)\
**Replies:** 2\
**Last updated:** [October 16, 2022, 1:10pm UTC](https://racket.discourse.group/t/multiple-bibliographies-in-a-scribble-document/1373 "2022-10-16T13:10:35Z")

</div>

I am writing a scribble document for a class I am teaching and am including references. The document is rather long and I would like the references to appear in the sections where they are referred to. Thus there will be…

---

## [How to use \`head-extra\` in scribble?](https://racket.discourse.group/t/how-to-use-head-extra-in-scribble/1371)

<div class="topic-metadata">

**Author:** [@KDr2](https://racket.discourse.group/u/KDr2)\
**Replies:** 6\
**Last updated:** [October 11, 2022, 12:35pm UTC](https://racket.discourse.group/t/how-to-use-head-extra-in-scribble/1371 "2022-10-11T12:35:28Z")

</div>

I want to add a favicon to my website which is built with scribble, but when I put something like (make-head-extra ...) into my scribble file, it tells me that: not valid in document body (need a pre-part for decode) i…

---

## [Scribble: How to wrap a subsection in a custom \`div\` element?](https://racket.discourse.group/t/scribble-how-to-wrap-a-subsection-in-a-custom-div-element/1340)

<div class="topic-metadata">

**Author:** [@sschwarzer](https://racket.discourse.group/u/sschwarzer)\
**Replies:** 5\
**Last updated:** [October 6, 2022, 12:06pm UTC](https://racket.discourse.group/t/scribble-how-to-wrap-a-subsection-in-a-custom-div-element/1340 "2022-10-06T12:06:22Z")

</div>

I'm trying to write a function that wraps a subsection, i.e. the subsection and the content belonging to the subsection, in a div element with a custom class. The function without the div wrapping currently looks like t…

---

## [Elemtag and elemref advice for Scribble documents](https://racket.discourse.group/t/elemtag-and-elemref-advice-for-scribble-documents/1329)

<div class="topic-metadata">

**Author:** [@brittAnderson](https://racket.discourse.group/u/brittAnderson)\
**Replies:** 2\
**Last updated:** [September 27, 2022, 11:29am UTC](https://racket.discourse.group/t/elemtag-and-elemref-advice-for-scribble-documents/1329 "2022-09-27T11:29:56Z")

</div>

I am trying to figure out if I can use, and how to use, elemtag and elemref to create hyperlinks to equations. I would like to do something like: @elemtag{eqn1 @($$ "1 + 1 = 2")} and later be able to create a link with…

[Next page](https://racket.discourse.group/tag/scribble/64.md?match_all_tags=true&page=1&tags%5B%5D=scribble)