Repository navigation
A release that connects a site to GitHub: give a fine-grained token for one repository, and Kite sets up the rest, from the studio or the command line, in a container too. It also fixes pictures whose file names hold spaces, Ctrl+B in the editor, and listings that answered 404 before they listed anything.
Highlights
- Connect GitHub. System → Deploy has a Connect GitHub card, and
kite github connect owner/namedoes the same from a terminal. Given a fine-grained token for that repository alone, with Contents, Workflows and Pages: read and write (the card links to GitHub's form with them filled in), Kite starts a git repository and addsoriginwhere there are none, writes the deploy workflow where there is none, commits the site's own files, turns Pages on with GitHub Actions as its source and pushes. A site run in Docker no longer needs an ssh key or a git identity: commits are made by the connected account at its noreply address. Whatever a connect would have to refuse, a token GitHub does not take, a repository it cannot see, one with commits of its own while the site has none, anoriginthat points elsewhere, it refuses before changing anything (#15). - The token stays put. It is kept in
.kite/secrets/github.json, readable by its owner alone, or given inKITE_GITHUB_TOKEN, which wins. It goes to github.com with pushes over https and with the studio's questions about deployments, and nowhere else: git gets it through its environment, never in a file or among a command's arguments. With it, the studio also follows deployments of a private repository, and has 5,000 requests an hour to do it instead of 60.kite githubsays where things stand, andkite github disconnectforgets the kept token. - Pictures named with spaces. The visual editor wrote a picture or a link to a file whose name holds a space, as a screenshot's does, in a form markdown reads as text, so the site and the editor showed the raw line (#18). Such addresses are now written in angle brackets. A line saved before needs mending by hand: put the file name in angle brackets, or insert the picture again from Files.
- Ctrl+B makes text bold. Ctrl+B and Cmd+B no longer also fold or unfold the sidebar while you type (#17).
- Empty listings. A kind's listing and a taxonomy's page are published before they list anything, so a theme's link to
/posts/or/tags/no longer answers 404 on a new site (#19). Until they list something, the sitemap leaves them out.
Install
Download the archive for your platform, or pin the version in a project
so that local builds and CI agree:
./kitew build
Verify a download against checksums.txt before running it.