✨ Template | repo_url: add repository URL to generated files

Several files in generated packages benefit from knowing the source repository
URL: the MkDocs/MyST docs sites get a header link to the repo, `pyproject.toml`
gets `[project.urls]` entries that surface on PyPI, and other downstream uses
(README badges, changelog commit links) can hook into the same value. Today the
URL is hardcoded in a few places or missing entirely, and there's no single
source of truth users can set without editing template output by hand.

Add a hidden `repo_url` Copier question (default empty, `when: false`) so
nothing is prompted on initial copy — the template still works fine without a
remote — and wire it into:

- `mkdocs.yml.jinja`: `repo_url`, `repo_name` (derived via Jinja from the URL),
  and the Material GitHub icon, all wrapped in `{% if repo_url %}` so empty
  values render a clean config.
- `myst.yml.jinja`: set `github:` to `repo_url` when present; keep the existing
  commented-out placeholder otherwise.
- `pyproject.toml.jinja`: add `[project.urls]` with `Repository` and `Issues`
  entries (the well-known PyPI labels) when `repo_url` is set.

Document the workflow in `docs/index.md` next steps: users create the remote,
then run `copier update -A -d repo_url=https://github.com/<user>/<repo>` to
populate every wired-in spot in one shot. The `-A` (`--skip-answered`) flag
keeps the update non-interactive for already-answered questions, mirroring the
pattern already used by the hidden `auto_update` question.

Author: mbercx

copier.yml

@@ -40,6 +40,12 @@ coverage:
     - codecov
   default: none
 
+repo_url:
+  type: str
+  help: 'URL of the source repository (e.g. https://github.com/user/repo).'
+  default: ''
+  when: false
+
 # github-token: uses the default GITHUB_TOKEN (zero setup, but PRs won't trigger CI).
 # pat: uses a PAT stored as COPIER_UPDATE_TOKEN secret (PRs trigger CI normally).
 auto_update:

docs/index.md

@@ -59,6 +59,20 @@ To get this working:
 No repository secret is needed for public repos.
 For private repos, add a `CODECOV_TOKEN` secret to your repository and pass it in the workflow's `codecov-action` step.
 
+### Repository URL
+
+Several files in the generated package reference the source repository URL: the docs site (GitHub icon + link), `[project.urls]` in `pyproject.toml`, the README badges, and commit links in the generated changelog.
+The URL is controlled by the hidden `repo_url` question, which is empty by default so the template works without a remote.
+
+Once you have created the remote repository, set it via:
+
+```
+copier update -A -d repo_url=https://github.com/<user>/<repo>
+```
+
+The `-A` flag (`--skip-answered`) skips questions you already answered, so only `repo_url` is applied.
+To change the URL later, run the same command with the new value.
+
 ### Automatic template updates
 
 The template can optionally add a `copier-update.yaml` workflow that checks for upstream template changes every week, runs `copier update`, and opens a PR with the proposed changes.

template/docs/{% if docs == 'myst' %}myst.yml{% endif %}.jinja

@@ -4,7 +4,11 @@ project:
   title: {{ package_name }}
   # keywords: []
   # authors: []
+{%- if repo_url %}
+  github: {{ repo_url }}
+{%- else %}
   # github: https://github.com/
+{%- endif %}
   # To autogenerate a Table of Contents, run "myst init --write-toc"
 site:
   template: book-theme

template/pyproject.toml.jinja

@@ -20,7 +20,12 @@ classifiers = [
   "Programming Language :: Python :: 3.13",
   "Programming Language :: Python :: 3.14",
 ]
+{% if repo_url %}
+[project.urls]
+Repository = "{{ repo_url }}"
+Issues = "{{ repo_url }}/issues"
 
+{% endif -%}
 [project.optional-dependencies]
 docs = [
 {% if docs == 'myst'-%}

template/{% if docs == 'mkdocs' %}mkdocs.yml{% endif %}.jinja

@@ -1,7 +1,15 @@
 site_name: {{package_name}}
+{%- if repo_url %}
+repo_url: {{ repo_url }}
+repo_name: {{ repo_url.rstrip('/').split('/')[-2:] | join('/') }}
+{%- endif %}
 
 theme:
   name: material
+{%- if repo_url %}
+  icon:
+    repo: fontawesome/brands/github
+{%- endif %}
 
 markdown_extensions:
   - admonition