Online documentation

[serenity4]

I would like to deploy some initial online documentation, but for this a DOCUMENTER_KEY variable must be set, as described in the Documenter docs. I currently don't have the permissions to add such a key, so would it be possible for someone with the right accesses to do that?

[SimonDanisch]

[serenity4]

Thanks! Sorry to reopen that, but I got an access denied error. Did you also add the public key?

[serenity4]

@SimonDanisch Could you please add the public key if you did not already? It might fix it. Thanks!

[SimonDanisch]

For what do you actually need that? I think I set that for travis, but I see that travis isn't even used :D
Should the repository switch to github-actions? I think that's what's widely used now for all Julia packages, and I think you don't even need to setup any keys!

[SimonDanisch]

GLMakie shows how to setup xvfb to open windows: https://github.com/JuliaPlots/GLMakie.jl/blob/master/.github/workflows/ci.yml

[serenity4]

Yes, I think we should switch to github-actions. I already pushed some workflows for documentation .github/workflows/Documenter.yml and for testing .github/workflows/Test.yml. Everything works fine with xvfb (so far), I have yet to fake inputs to actually test stuff (for now it loops forever because we never give it input, I'm working on it).

As for Documenter, it is used with a SSH deploy key, but it has trouble fetching the repo:

And from the error, it seems that we do need a public key along with the private key. From the repos I've been working on it has always been the case. Maybe authentication can be done with a Github Actions token, but apparently it does not build gh-pages.

Also, is there a way to retrigger a build? I can do it on my repos, but not here, so I can't test whether Documenter works without pushing a new commit.

[serenity4]

@SimonDanisch could you please try to re-generate the private key and the public key via

using DocumenterTools
DocumenterTools.genkeys()

to try to solve this issue? By re-reading the error message I posted above, the very first line actually indicates an invalid format.

[SimonDanisch]

Ok, hopefully this time: