package b0
Install
Dune Dependency
Authors
Maintainers
Sources
sha512=78fd9e53b84cf5d6bf497adaf4b6d7d974134044318639cdfe5e01c7faaa8d987d04769abe3b3b1cbdb937132e21d8723dc185cd3c68433a793278907a8e757e
doc/b0_b00_kit/B00_github/Pages/index.html
Module B00_github.Pages
Publish to GitHub pages.
Updating GitHub pages
val update :
?follow_symlinks:bool ->
src:B00_std.Fpath.t option ->
B00_std.Fpath.t ->
update
update ~follow_symlinks ~src dst
is an update that given a relative path dst
in the work tree that may not exist:
- If
src
isNone
, deletesdst
in the work tree. - If
src
isSome src
replacesdst
in the work tree by the contents of the file or file hierarchysrc
. Iffollow_symlinks
istrue
(default) symbolic links are followed insrc
.
Use .
for dst
to denote the root of the work tree; for example update ~src:(Some dir) (Fpath.v ".")
replaces the whole website by the file hierarchy rooted at dir
.
val nojekyll : update
nojekyll is update ~src:(Some Os.File.null) (Fpath.v ".nojekyll")
. Add this to the updtaes to prevent the Jekyll processing that is automatically performed on GitHub pages.
val default_branch : B00_vcs.Git.branch
default_branch
is "gh-pages"
, GitHub's default publication branch for GitHub pages.
val commit_updates :
?log:B00_std.Log.level ->
?branch:B00_vcs.Git.branch ->
B00_vcs.t ->
amend:bool ->
force:bool ->
remote:B00_vcs.Git.remote ->
msg:string ->
update list ->
(bool, string) Stdlib.result
commit_updates vcs ~log ~remote ~branch ~msg us
updates branch
(defaults to gh-pages
) on remote
according to updates us
with commit message msg
. Ok false
is returned if there was nothing to update.
- If
amend
istrue
, the last commit is amended (if any exists) and the author reset rather than a new commit added - If
force
istrue
, the various git operations are forced. log
indicates a logging level used to monitor progress (defaults toLog.app
).
More precisely this:
- Fetches
remote/branch
if it exists. - Creates a transient checkout with a temporary workdir in
Os.Dir.default_tmp
and a branch called_b0-update-gh-pages
reset toremote/branch
. - Commits changes with message
msg
according tous
which are applied in order, seeupdate
. - Destroys the transient checkout
- Pushes
_b0-update-gh-pages
onremote/branch
- Destroys the branch
_b0-update-gh-pages
Warning. If you have paths that start with _
GitHub pages won't publish them. You can disable this by adding a .nojekyll
file at the root the gh-page branch, see nojekyll
.