git » homepage.git » commit f855869

Document offline LFS restoration

author Alan Dipert
2026-08-09 22:13:14 UTC
committer Alan Dipert
2026-08-09 22:13:14 UTC
parent 6b1bac9d25e6ef50ded9b00f941bf521b4e9a46a

Document offline LFS restoration

tools/archive_techworks.py +13 -4

diff --git a/tools/archive_techworks.py b/tools/archive_techworks.py
index 903db31..2c5c03e 100644
--- a/tools/archive_techworks.py
+++ b/tools/archive_techworks.py
@@ -201,10 +201,19 @@ def export(root: Path, manifest_path: Path, destination: Path) -> None:
 
 Verify this export with `sha256sum --check SHA256SUMS`.
 
-Restore Git history with `git clone git/homepage.bundle homepage`. Copy
-`lfs/objects/` into `homepage/.git/lfs/objects/`, then check out the desired
-revision. The `files/` tree is a directly browsable copy of every preserved
-artifact in the manifest.
+Restore Git history and materialize the LFS files with:
+
+```
+GIT_LFS_SKIP_SMUDGE=1 git clone git/homepage.bundle homepage
+git -C homepage lfs install --local
+mkdir -p homepage/.git/lfs/objects
+cp -a lfs/objects/. homepage/.git/lfs/objects/
+git -C homepage lfs checkout
+git -C homepage lfs fsck
+```
+
+The `files/` tree is a directly browsable copy of every preserved artifact in
+the manifest. It does not depend on Git or Git LFS for access.
 """,
         encoding="utf-8",
     )