Skip to content

Commit 2fbd613

Browse files
authored
Merge pull request #374 from eduralph/docs/373-relative-src-path
docs: warn that a relative local template path breaks `copier update`
2 parents 77401c5 + d884e8d commit 2fbd613

1 file changed

Lines changed: 10 additions & 0 deletions

File tree

docs/01-render-and-integrate.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,16 @@ copier copy gh:eduralph/pdca-harness ../gramps-testbed-v2
2020
cd ../gramps-testbed-v2
2121
```
2222

23+
> **Rendering from a local checkout instead?** Give copier a `gh:`/`https:`
24+
> URL (as above) or an **absolute** path. Copier records the source argument
25+
> verbatim as `_src_path` in `.copier-answers.yml`, and `copier update`
26+
> resolves it from the *project* directory — a path relative to your render
27+
> cwd never resolves there, so the first `copier update` fails
28+
> ([copier#335](https://github.com/copier-org/copier/issues/335); fix pending
29+
> in [copier#2717](https://github.com/copier-org/copier/pull/2717)). Already
30+
> rendered that way? Hand-edit `_src_path` to the template URL or an absolute
31+
> path — that's the whole repair.
32+
2333
The prompts (from [`copier.yml`](../copier.yml)) and what gramps answered:
2434

2535
| Prompt | What it sets | gramps-testbed-v2 |

0 commit comments

Comments
 (0)