@@ -47,33 +47,49 @@ and it will not work without it!
4747
4848
4949
50- ::: {.callout-important collapse=true}
51- ## /home/daslu/my-secret.txt (No such file or directory)
50+ ::: {.printedClojure}
51+ ``` clojure
52+ " this is my secret!!!!!\n "
53+
54+ ```
55+ :::
56+
57+
58+ If you are the author of such a notebook, the recommended practice is to
59+ render the notebook locally usinc Clay in Quarto ` .qmd ` format, and include
60+ that file in your Pull Request.
61+
62+ The ` .qmd ` file is all that Civitas needs to include your notebook in the
63+ website. As long as the ` .qmd ` file is included in the PR, and is not older than
64+ your source ` .clj ` file, Civitas will just rely on it and not even try
65+ to generate it in GitHub Actions.
66+
67+ To do that, you will need to make the file locally with a Quarto target.
68+
69+ Here are two ways to do that:
70+
71+ 1 . Use the command line.
72+ Note that here, we use the path to the notebook, relative to ` src ` .
73+ ``` sh
74+ clojure -M:clay -A:markdown scicloj/clay/skip_if_unchanged_example.clj
5275```
53- clojure.core/eval core.clj: 3232
54- ...
55- scicloj.clay.skip-if-unchanged-example/eval36968 REPL Input:
56- ...
57- clojure.core/slurp core.clj: 7089 (repeats 2 times)
58- ...
59- clojure.java.io/reader io.clj: 89
60- clojure.java.io/reader io.clj: 105
61- clojure.java.io/fn/G io.clj: 72
62- clojure.java.io/fn io.clj: 168
63- clojure.java.io/fn/G io.clj: 72
64- clojure.java.io/fn io.clj: 261
65- clojure.java.io/fn/G io.clj: 72
66- clojure.java.io/fn io.clj: 232
67- java.io.FileInputStream.<init> FileInputStream.java: 159
68- java.io.FileInputStream.open FileInputStream.java: 219
69- java.io.FileInputStream.open0 FileInputStream.java:
70- java.io.FileNotFoundException: /home/daslu/my-secret.txt (No such file or directory)
76+
77+ 2 . ... Or do the same in Clojure code.
7178
7279
80+ ::: {.sourceClojure}
81+ ``` clojure
82+ (comment
83+ (require '[scicloj.clay.v2.api :as clay])
84+ (clay/make! {:source-path " scicloj/clay/skip_if_unchanged_example.clj"
85+ :aliases [:markdown ]}))
7386```
7487:::
7588
7689
90+ Now, need to ` git add ` the generated ` qmd ` file.
91+ Here is how.
92+
7793
7894``` {=html}
7995<div style="background-color:grey;height:2px;width:100%;"></div>
0 commit comments