add docs for publishing to github pages manually

This commit is contained in:
Benjamin Fry 2019-03-12 11:22:00 -07:00
parent c068703028
commit 62af2367bb
1 changed files with 32 additions and 0 deletions

View File

@ -54,3 +54,35 @@ deploy:
``` ```
That's it! That's it!
### Deploying to GitHub Pages manually
If you're CI doesn't support a GitHub pages, or you're deploying somewhere else
with GitHub pages like integration, *note: you may want to use different tmp dirs*:
```console
$> git worktree add /tmp/book gh-pages
$> mdbook build
$> rm -rf /tmp/book/* # this won't delete the .git directory
$> cp -rp book/* /tmp/book/
$> cd /tmp/book
$> git add -A
$> git commit 'new book message'
$> git push origin gh-pages
$> cd -
```
Or put this into a Makefile rule:
```makefile
.PHONY: deploy
deploy: book
@echo "====> deploying to github"
git worktree add /tmp/book gh-pages
rm -rf /tmp/book/*
cp -rp book/* /tmp/book/
cd /tmp/book && \
git add -A && \
git commit -m "deployed on $(shell date) by ${USER}" && \
git push origin gh-pages
```