mortenpibut just FYI, you can't unfortunately include a file file that in a Documenter build since it contains HTML and the Markdown parser we have can't handle HTML
mortenpiand it seems that the parsing problems comes from some strange interpretation of that HTML
mortenpiand it seems that the parsing problem comes from some strange interpretation of that HTML
mortenpione option would also be to customize the nbconvert plugin that does NB -> Markdown to put HTML at-raw blocks around the HTML output
""" f(a, b) Return the sum of `a` and `b`. """ function f(a, b) return a + b end
Setting environment variables from repository settings $ export DOCUMENTER_KEY=[secure] We were unable to parse one of your secure environment variables. Please make sure to escape special characters such as ' ' (white space) and $ (dollar symbol) with \ (backslash) . For example, thi$isanexample would be typed as thi\$isanexample. See https://docs.travis-ci.com/user/encryption-keys.
But you'd have to add keys for each repo separately anyway, right?
hmm the new github repo has only 1 deploy key. i think we just kept with https://travis-ci.org
@docs yyyymmdd2yyyy(d)in the index.md file and exported the functions in the module.
Query.jldifferences. Or for DataKnots, a macro form (very readable, but not Julia) and a non-macro form (raw Julia). Having these side-by-side is really important to facilitate comparisons and to not have the user distracted by contextual switching.
Hi all, I'm trying to deploy docs for a new package (https://github.com/joehuchette/Justitia.jl) and am running into some problems. I'm using a Github workflow, generated my two keys using DocumenterTools.genkeys, and then set them correctly in the Github repo (I think). But, when the workflow runs, it appears to crash pretty early in the deploy stage with:
Initialized empty Git repository in /tmp/jl_mYkDJ1/.git/ Failed to add the RSA host key for IP address 'XXX.XX.XXX.X' to the list of known hosts (/home/runner/.ssh/known_hosts). Load key "/home/runner/work/Justitia.jl/Justitia.jl/docs/.documenter": invalid format email@example.com: Permission denied (publickey). fatal: Could not read from remote repository. Please make sure you have the correct access rights and the repository exists. ┌ Error: Git failed to fetch firstname.lastname@example.org:joehuchette/Justitia.jl.git │ This can be caused by a DOCUMENTER_KEY variable that is not correctly set up. │ Make sure that the environment variable is properly set up as a Base64-encoded string │ of the SSH private key. You may need to re-generate the keys with DocumenterTools. └ @ Documenter ~/.julia/packages/Documenter/FuXcO/src/Documenter.jl:554
I've reset the keys a few times but I get the same failure. Am I missing something silly here? My best guess is that the public key I'm setting in "step 1" of uploading the keys, but I'm just copy-pasting the key right from the output of genkeys. Thanks in advance!