Fix Quartz build to preserve git history for accurate file dates #105

Merged
eblume merged 2 commits from fix/quartz-git-dates into main 2026-02-04 08:25:47 -08:00
Owner

Summary

Fixes the "isn't yet tracked by git, dates will be inaccurate" warnings in the Build docs step by restructuring how Quartz builds the documentation.

Problem

Previously, we copied docs into Quartz's content folder. Since this was inside a fresh Quartz clone with no history of our files, the CreatedModifiedDate plugin couldn't determine accurate dates.

Solution

Build Quartz from within the blumeops repo instead:

  1. Copy Quartz's build system (quartz/, package.json, etc.) into the workspace
  2. Symlink content -> docs (preserves git history)
  3. Symlink docs/CHANGELOG.md -> ../CHANGELOG.md
  4. Build from workspace root where git can trace file history
  5. Clean up artifacts after creating tarball

Deployment and Testing

  • Run build workflow and verify no "not tracked by git" warnings
  • Verify file dates appear correctly on built docs site
## Summary Fixes the "isn't yet tracked by git, dates will be inaccurate" warnings in the Build docs step by restructuring how Quartz builds the documentation. ## Problem Previously, we copied docs into Quartz's content folder. Since this was inside a fresh Quartz clone with no history of our files, the `CreatedModifiedDate` plugin couldn't determine accurate dates. ## Solution Build Quartz from within the blumeops repo instead: 1. Copy Quartz's build system (quartz/, package.json, etc.) into the workspace 2. Symlink `content` -> `docs` (preserves git history) 3. Symlink `docs/CHANGELOG.md` -> `../CHANGELOG.md` 4. Build from workspace root where git can trace file history 5. Clean up artifacts after creating tarball ## Deployment and Testing - [ ] Run build workflow and verify no "not tracked by git" warnings - [ ] Verify file dates appear correctly on built docs site
Build Quartz from within the blumeops repo instead of copying files
to a separate location. This allows git to find file history for
the CreatedModifiedDate plugin, eliminating the "not tracked by git"
warnings.

Changes:
- Copy Quartz build system into workspace instead of vice versa
- Use symlinks for content and CHANGELOG.md
- Clean up build artifacts after creating tarball

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
The showcontent=false setting expected issue-number-style fragment names.
Since blumeops uses branch names for fragments, change to showcontent=true
so the content is displayed like other fragment types.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
eblume merged commit 03bda41de4 into main 2026-02-04 08:25:47 -08:00
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
eblume/blumeops!105
No description provided.