Skip to content

Add author and translator attribution per lecture page #143

Description

@mmcky

Part of QuantEcon/project-themes#3 (author and translator attribution across all themes).

What

The theme currently has no per-page author attribution and no translator concept. Add rendering for both authors and translators — each a list of {name, url} pairs — so lecture pages credit their authors and, for translated editions (zh-cn, fa, fr), the translators who produced them.

Scope for this repo

  • Read authors and translators from the MyST project configuration (myst.yml site/project options) as the project-level default, and from page front matter as a per-page override. Reuse the existing MyST authors front-matter convention where it fits rather than inventing a parallel key.
  • Render both under the page title, with translators visually distinguished from authors (distinct class, rel="author" only on authors).
  • Make the "Authors" / "Translators" labels overridable so each edition can render them in its own language.
  • Omit the translators block entirely when the list is empty.

Design decisions

The data model, placement, and label-localisation decisions are being settled in the tracking issue QuantEcon/project-themes#3 so all three themes stay consistent — implement against whatever is agreed there. This also relates to the book-theme parity work in QuantEcon/meta#93 and the internationalisation phase in QuantEcon/meta#90.

Acceptance

  • A project with authors and translators configured shows both on every page; a project with neither renders exactly as today.
  • A page-level override replaces the project-level value for that page only.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementImprovement to existing material

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions