Module
jinks/publish
src/jinks/publish.pookaPut the next edition beside the old one before changing the sign outside. The manifest names only Jinks's files. Everything else is carried forward, and a newly generated path may not quietly claim an unowned file.
API reference
manifest() -> String
fn() -> Stringvalidate(names: List(String)) -> Result(Nil, String)
fn(List(String)) -> Result(Nil, String)Validate names before touching staging, including case-folded collisions. This keeps an output built on Unix portable to a Windows checkout.
conflicts(left: String, right: String) -> Bool
fn(String, String) -> Booldecode(source: String) -> Result(List(String), String)
fn(String) -> Result(List(String), String)The on-disk format is versioned. A broken manifest never becomes permission to delete files; publication stops until the author can inspect it.
assert publish.decode(publish.encode(["index.html"])) == Ok(["index.html"])
encode(names: List(String)) -> String
fn(List(String)) -> Stringowned(output: String) -> Result(List(String), String)
fn(String) -> Result(List(String), String)run(
root: String,
output: String,
pages: List(#(String, String)),
assets: List(#(String, String))
) -> Result(Nil, String)
fn(String, String, List(#(String, String)), List(#(String, String))) -> Result(Nil, String)Build all files in a private sibling, then let the boundary exchange trees. Example ownership: deleting content/owl.md removes owl/index.html on the next build, while an unowned public/notes.txt survives unchanged.
copy(source: String, destination: String) -> Result(Nil, String)
fn(String, String) -> Result(Nil, String)clean(root: String, output: String) -> Result(Nil, String)
fn(String, String) -> Result(Nil, String)Cleaning is publication of an empty owned set. Unowned files and the versioned empty manifest remain; no source/cache directory is removed.