Support de documentation multilingue pour Clojure

Question

Existe-t-il un support de documentation multilingue pour les fonctions? Je viens de Turquie. Je veux que les gens à écrire dans Clojure et je rêve d'une ligne comme

(doc hello-world "Turkish") 

Answer 1

A partir d'aujourd'hui il n'y a pas de fonctionnalité intégrée dans la langue. Vous pouvez attacher des métadonnées arbitraires à vars, cependant:

(defn ^{:docs {:en "Prints and returns its argument" 
       :es "Imprime y devuelve su argumento"}} 
    debug [x] 
    (println x) 
    x) 

Rappelons que le système de documentation de Clojure utilise le nom du mot-clé de métadonnées :doc. Vous devez donc choisir un autre nom (par exemple, :docs).

Ensuite, vous pouvez redéfinir des fonctions telles que clojure.repl/doc afin qu'elles prennent en compte vos métadonnées.