This page is not created by, affiliated with, or supported by Slack Technologies, Inc.
2020-12-20
Channels
- # adventofcode (72)
- # aleph (8)
- # announcements (21)
- # beginners (43)
- # calva (10)
- # cider (2)
- # cljdoc (12)
- # cljsrn (3)
- # clojure (9)
- # clojure-android (1)
- # clojure-europe (38)
- # clojure-norway (2)
- # clojure-romania (1)
- # clojure-uk (2)
- # clojurescript (58)
- # cursive (8)
- # datomic (29)
- # deps-new (2)
- # depstar (2)
- # fulcro (3)
- # java (20)
- # leiningen (11)
- # luminus (2)
- # off-topic (13)
- # sci (1)
- # shadow-cljs (3)
I'm obviously doing something wrong. I'm trying to "preview" documentation for a library. Following the instructions on the webpage, I've cloned the repo, and I'm executing this command within the project (library) directory...
../cljdoc/script/cljdoc ingest --project io.sentry/sentry-clj --version 1.1.136 --git $(pwd) --rev $(git rev-parse HEAD)
** ERROR: **
Exception: #error {
:cause Requested version cannot be found in configured repositories: [io.sentry/sentry-clj 1.1.136]
:data {:project io.sentry/sentry-clj, :version 1.1.136}
:via
[{:type clojure.lang.ExceptionInfo
:message Requested version cannot be found in configured repositories: [io.sentry/sentry-clj 1.1.136]
:data {:project io.sentry/sentry-clj, :version 1.1.136}
:at [cljdoc.util.repositories$artifact_uris invokeStatic repositories.clj 119]}]
:trace
[[cljdoc.util.repositories$artifact_uris invokeStatic repositories.clj 119]
I have to deploy it to my local m2 first. I guess, there's no way for it to simply scan the local src directory and not rely upon deployments?
Hiya @dharrigan! Glad you got sorted out. > I guess, there’s no way for it to simply scan the local src directory and not rely upon deployments? We could probably make this work, but right now we are simply reusing cljdoc production behaviours. Keeping the number of variables down has its advantages. But I do see your point, I was just doing a local preview yesterday, and it is on the heavy and slow side. I find a script helps, here’s https://github.com/lread/rewrite-cljc-playground/blob/master/script/cljdoc_preview.clj.
Just a quick sanity check: I know that ^:no-doc
on an ns
form will tell cljdoc to ignore it. Does that work on an individual def
/`defn` basis as well or should I use something else to exclude a (public) function from the docs?
Works on vars too :) https://github.com/cljdoc/cljdoc/blob/master/doc/userguide/for-library-authors.adoc#hiding-namespaces-vars-in-documentation
I should just RTFM 🙂
no worries 😄