mortenpi
but 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
mortenpi
and it seems that the parsing problems comes from some strange interpretation of that HTML
mortenpi
and it seems that the parsing problem comes from some strange interpretation of that HTML
mortenpi
one option would also be to customize the nbconvert plugin that does NB -> Markdown to put HTML at-raw blocks around the HTML output
~/.julia
General
to ~/.julia/registries/General
"""
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.
DataFrames.jl
vs Query.jl
differences. 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
git@github.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 git@github.com: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!