Clojurians Log v2

I'd like to link via Clojure namespaces. Why? Because then I can rely on LSP / Kondo for analysis (including backlinks) and refactoring. I stunted a system like this for Civitas (which is based on Clay), but ended up removing it because it caused trouble for the library we used to read the forms. The gist is:

(ns civitas.why.explanations-are-value-laden
  (:require [civitas.why.growing-explanations-together :as-alias growing-explanations-together]
            [civitas.why.village.scene :as-alias search-for-meaning]
            [scicloj.kindly.v4.kind :as kind]))

(defn infer-html-location [anchor]
  ;; Full details in
  ;; 
  )

(defn link [anchor linktext]
  [:a {:href (infer-html-location anchor)} linktext])

(kind/hiccup
 [:p "Timothy Pratley recently wrote about "
  (link ::search-for-meaning/anchor
        [:span "the pursuit of " [:em "meaning"]])
  " on civitas."
  " Before that; I argued that "
  (link ::growing-explanations-together/anchor
        "Civitas is a great place to grow explanations together")
  "."])

using symbols or keywords as links is interesting. In your system you were using namespaced keywords but threw away the name? That also feels a bit strange to me. Also not every notebook needs a namespace, pure markdown docs are also fine…

on the trailing slash, we do always export a folder but don’t expect a trailing slash when accessing a doc. I feel it would be unexpected to link between different files in the same directory using a ../ prefix?

> on the trailing slash, we do always export a folder but don’t expect a trailing slash when accessing a doc. I feel it would be unexpected to link between different files in the same directory using a ../ prefix? That's what I have done previously, and how I expect it to work. If that's not desired, then (the way I see it), we're stuck with a bit of ambiguity.

> using symbols or keywords as links is interesting. In your system you were using namespaced keywords but threw away the name? That also feels a bit strange to me. I intended that :teodorlu.rainbow-tables/prerequisites would refer to /teodorlu/rainbow-tables/#prerequisites. In other word, the name of the keyword correspons to the name of an HTML anchor (`<a name="prerequisites">...</a>`). It looks funny for links without an anchor in the linked document, but in my estimation, anchors are important enough to warrant proper support (for example ) > Also not every notebook needs a namespace, pure markdown docs are also fine… In that case, require :as-alias and keywords for anchor still works! Pure markdown docs still need to be published in the same URL namespace as Clojure notebooks.

I realize that you make have different goals / intentions with this than the things I'm suggesting. Just wanted to share my thoughts! I still think Clerk is great — I just desire more REPL/editor oriented ways of working with cross document links.

I’m onboard with that clerk should let you do this

not sure this should be the default / built-in. One way to allow this would be to have a default clerk/href or similar which would be called for all links in markdown etc and letting you provide your own fn. Then you could implement the behavior you want.