# Bug in package building and web site **URL:** \ **Category:** Questions & Answers\ **Created:** [January 28, 2026, 8:53am UTC](https://racket.discourse.group/t/bug-in-package-building-and-web-site/4090 "2026-01-28T08:53:00Z")\ **Posts on this page:** 8\ **Page:** 1
**Author:** ![damien\_mattei](https://yyz2.discourse-cdn.com/free1/user_avatar/racket.discourse.group/damien_mattei/32/2706_2.png) [@damien\_mattei](https://racket.discourse.group/u/damien_mattei)\ **Post date:** [January 28, 2026, 8:53am UTC](https://racket.discourse.group/t/bug-in-package-building-and-web-site/4090/1 "2026-01-28T08:53:00Z")
Hi, when updating [Scheme+](https://docs.racket-lang.org/Scheme-PLUS-for-Racket/index.html) the package system initially failed to build the package because doc had an error: if i insert an image in the doc, which is rarely done but feature exists, then if i put the image in the `scribbling` subdirectory of the project it will build the html page from scribble file correctly with the good local link to the image but then the package manager will fail to find the image. By reading the log error of the failed build i understood that the images need to be also at the root directory of the project. So, if my project is: [Scheme-PLUS-for-Racket](https://github.com/damien-mattei/Scheme-PLUS-for-Racket) and my doc in `Scheme-PLUS-for-Racket/scribbling` and i have an image : `Scheme-PLUS-for-Racket/scribbling/neural-harmonic-oscillator-and-equation-computed-harmonic-oscillator.png` , the image for package manager need to be too in `Scheme-PLUS-for-Racket/neural-harmonic-oscillator-and-equation-computed-harmonic-oscillator.png`. This would be better to have the image in the same documentation subdirectory, not at the root of project , where generally source code is. I think it is a bug or perheaps there is a way to better describe the documentation in my project, for now i use a tag like this in my scribble file: `@centerline{@image[#:scale 1.1 "neural-harmonic-oscillator-and-equation-computed-harmonic-oscillator.png"]}` Regards, Damien ---
**Author:** ![usao](https://yyz2.discourse-cdn.com/free1/user_avatar/racket.discourse.group/usao/32/1375_2.png) [@usao](https://racket.discourse.group/u/usao)\ **Post date:** [January 29, 2026, 1:54am UTC](https://racket.discourse.group/t/bug-in-package-building-and-web-site/4090/2 "2026-01-29T01:54:44Z")
My understanding is that you should use [`define-runtime-path`](https://docs.racket-lang.org/reference/Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-path%29%29) to access resource files. ---
**Author:** ![damien\_mattei](https://yyz2.discourse-cdn.com/free1/user_avatar/racket.discourse.group/damien_mattei/32/2706_2.png) [@damien\_mattei](https://racket.discourse.group/u/damien_mattei)\ **Post date:** [January 29, 2026, 7:31am UTC](https://racket.discourse.group/t/bug-in-package-building-and-web-site/4090/3 "2026-01-29T07:31:05Z")
(Early reading this morning) I do not know how it could work because i'm not in a code program but in a document scribble file. (anyway the topic is of minor importance, the documentation is good like that, but with images in code source directory too...) ---
**Author:** ![damien\_mattei](https://yyz2.discourse-cdn.com/free1/user_avatar/racket.discourse.group/damien_mattei/32/2706_2.png) [@damien\_mattei](https://racket.discourse.group/u/damien_mattei)\ **Post date:** [January 29, 2026, 7:48am UTC](https://racket.discourse.group/t/bug-in-package-building-and-web-site/4090/4 "2026-01-29T07:48:41Z")
seems i need to import some definitions in the scribble document to test it: ```scheme mattei@mac scribblings % /Applications/Racket/bin/scribble +m --redirect-main http://docs.racket-lang.org Scheme-PLUS-for-Racket.scrbl Scheme-PLUS-for-Racket.scrbl:1263:2: define-runtime-path: unbound identifier in: define-runtime-path location...: Scheme-PLUS-for-Racket.scrbl:1263:2 context...: /Applications/Racket/share/pkgs/scribble-lib/scribble/run.rkt:175:26: go .../private/map.rkt:40:19: loop .../racket/cmdline.rkt:191:51 body of "/Applications/Racket/share/pkgs/scribble-lib/scribble/run.rkt" ``` i tried `@(define-runtime-path ....... )` but i do not know how to import definitions in scribble document? ---
**Author:** ![damien\_mattei](https://yyz2.discourse-cdn.com/free1/user_avatar/racket.discourse.group/damien_mattei/32/2706_2.png) [@damien\_mattei](https://racket.discourse.group/u/damien_mattei)\ **Post date:** [January 29, 2026, 8:03am UTC](https://racket.discourse.group/t/bug-in-package-building-and-web-site/4090/5 "2026-01-29T08:03:13Z")
```scheme @(require racket/runtime-path) ``` i commited the change, removed the image from root, just leave the one in scribble dir ,will see in a few hours if the Racket package still build online and if the link to the image is not broken.... just have to wait now.... ---
**Author:** ![damien\_mattei](https://yyz2.discourse-cdn.com/free1/user_avatar/racket.discourse.group/damien_mattei/32/2706_2.png) [@damien\_mattei](https://racket.discourse.group/u/damien_mattei)\ **Post date:** [January 29, 2026, 2:22pm UTC](https://racket.discourse.group/t/bug-in-package-building-and-web-site/4090/6 "2026-01-29T14:22:20Z")
Yes it worked. So i removed all the images at root of package project and just keeped the ones in scribbling sub directory: ```scheme mattei@mac Scheme-PLUS-for-Racket % rm *.png mattei@mac Scheme-PLUS-for-Racket % ls scribblings/*.png scribblings/BepiColombo-Mercury-Planet.png scribblings/neural-harmonic-oscillator-and-equation-computed-harmonic-oscillator.png scribblings/neural-sine-and-sine.png scribblings/Scheme+.png ``` so, solution is to code as this in general for an image: ```scheme #lang scribble/manual @(require scribble/core) @(require scribble-code-examples) @(require scriblib/footnote) @(require racket/runtime-path) @(define-runtime-path Scheme+ "Scheme+.png") @centerline{@image[#:scale 1.0 Scheme+]} ``` to have it available at root of URL documentation of package while being in the scribbling sub-directory: [https://docs.racket-lang.org/Scheme-PLUS-for-Racket/Scheme%2B.png](https://racket.discourse.group/uploads/short-url/s747my07oR6nj3uxNox373WCBFL.png) ![Scheme+](https://global.discourse-cdn.com/free1/uploads/racket/original/2X/c/c5095c907202266f96633863bff9c0f544d34301.png) thank you all, it is really great to have some help from the Racket discourse users. update: currently not working because i had removed Scheme+.rkt ah ah ah with Scheme+.png... but sure it will works in a few hours.....i just restored the delted file. update 2: yes it works: `https://docs.racket-lang.org/Scheme-PLUS-for-Racket/neural-harmonic-oscillator-and-equation-computed-harmonic-oscillator.png` [https://docs.racket-lang.org/Scheme-PLUS-for-Racket/neural-harmonic-oscillator-and-equation-computed-harmonic-oscillator.png](https://racket.discourse.group/uploads/short-url/xiw19FtzVvf5XLRjxb1XwQIg2uk.png) ![neural-harmonic-oscillator-and-equation-computed-harmonic-oscillator](https://global.discourse-cdn.com/free1/uploads/racket/original/2X/e/e95f932506aef7ec50bcf159471ffee6e54f02a0.png) ---
**Author:** ![damien\_mattei](https://yyz2.discourse-cdn.com/free1/user_avatar/racket.discourse.group/damien_mattei/32/2706_2.png) [@damien\_mattei](https://racket.discourse.group/u/damien_mattei)\ **Post date:** [February 15, 2026, 10:22pm UTC](https://racket.discourse.group/t/bug-in-package-building-and-web-site/4090/7 "2026-02-15T22:22:16Z")
Strange... should be the "Sunday evening bug" 😉 : the bug is coming back again, my image link are broken again : ![Scheme+](https://global.discourse-cdn.com/free1/uploads/racket/original/2X/c/c5095c907202266f96633863bff9c0f544d34301.png) ![Capture d’écran_2026-02-15_23-29-05](https://global.discourse-cdn.com/free1/uploads/racket/original/2X/f/ffee3463d72cdee371dfca6bb2778d9eeee7a43d.png) But i did not change this part of doc : > it is mysterious . I recompiled the doc ,wait and see if it solves the problem, if not i will have no other solution to put again the images at 2 places: root of project and scribbling directory. update: to see the problem (the image did not displayed editing the post but then reappeared after 🤔 ) check the original page of doc: > **[Scheme+ for Racket](https://docs.racket-lang.org/Scheme-PLUS-for-Racket/index.html)** update: i see this (image not displayed) : ![Capture d’écran_2026-02-15_23-25-39](https://global.discourse-cdn.com/free1/uploads/racket/original/2X/a/ab6a4dcb512343177fc1a28173bf565f4659828b.png) i do not know how the discourse site can access the image and not from racket doc ---
**Author:** ![damien\_mattei](https://yyz2.discourse-cdn.com/free1/user_avatar/racket.discourse.group/damien_mattei/32/2706_2.png) [@damien\_mattei](https://racket.discourse.group/u/damien_mattei)\ **Post date:** [February 16, 2026, 6:59am UTC](https://racket.discourse.group/t/bug-in-package-building-and-web-site/4090/8 "2026-02-16T06:59:24Z")
With the images in 2 places the problem disappeared.