Clojurians Log v2
cljdoc 2026-09-17
i've got cljdoc running locally for a library i have, but i have to rerun the importer every time i make a change. is it possible to have it "watch" my doc directory and rebuild just the markdown pages, without doing analysis on the source code?
No... sorry! I think Cora and I chatted about that ages ago. Local preview is still pretty slow and awkward.
I tend to use out-of-cljdoc previewing (VSCode is nice for that) while editing and do my final previews via cljdoc. I've also used adoc browser plugins for out-of-cljdoc previewing my adoc articles.
i'm trying to debug wiki-links in markdown files, and struggling to figure out what i'm doing wrong
wikilinks only work from docstrings: https://github.com/cljdoc/cljdoc/blob/master/doc/userguide/for-library-authors.adoc#link-to-api-docs
homerdisappear doh!
i'm pretty sure you've told me that once a month for the last two years
I cannot remember. But folks do ask from time to time. The rationale is that folks read docs on GitHub etc too, so nice for links to work there as well.
hah i mean that i've both read it and asked you about it many times and i'm shamefully forgetting over and over
I'm forgetting you've asked, so no harm done!
what does
Execution error (ExceptionInfo) at cljdoc.server.api/kick-off-build! (api.clj:54).
Requested version cannot be found in configured repositories: [io.github.noahtheduke/lazytest 2.1.0-SNAPSHOT]v2.1.0-SNAPSHOT locally, and i run the long command with --rev git rev-parse HEAD etc, and then it errors out with this$ docker run --rm --volume $(pwd):/Users/noah/programming/lazytest --volume "$HOME/.m2:/root/.m2" --volume ./.cljdoc-preview:/app/data --entrypoint clojure cljdoc/cljdoc -Sforce -M:cli ingest --project io.github.noahtheduke/lazytest --version 2.1.0-SNAPSHOT --git /Users/noah/programming/lazytest --rev $(git rev-parse HEAD)commit 84f8c9d8ec14b6b47d291aa27fafa110c0b1a516 (HEAD -> nb/temp, tag: v2.1.0-SNAPSHOT)
Author: Noah Bogart <noah.bogart@hey.com>
Date: Thu Sep 17 14:46:14 2026 -0400
lots of docsoh i figured it out, i have to actually build the jar and put it in my .m2
Yeah, and push your commits to GitHub. Don't think the tag matters for local preview though...
You'll want to read through https://github.com/cljdoc/cljdoc/blob/master/doc/running-cljdoc-locally-author.adoc
oh huh, that's different than the last time i tried. i'll update my commands
It's a pain... apologies for the awkwardness of it all!