QuantEcon / QuantEcon/quantecon-sphinx-theme
No support for Authors and Translator attribution per lecture
Nobody has claimed this yet.
- Dominant language
- SCSS
- Stars
- 0
- Forks
- 0
- Avg merge
- 3h 29m
- Merged PRs (30d)
- 1
Description
The theme has no equivalent of quantecon-book-theme's authors option, and no notion of translators at all. Raised during the theme evaluation in QuantEcon/lecture-python-programming#475 (closed, never merged).
How this surfaced. Porting the QuantEcon Python Programming lecture config to this theme meant deleting the authors block outright, because there was nothing to map it onto:
quantecon-book-theme |
quantecon-sphinx-theme |
|---|---|
authors: — list of {name, url} pairs, rendered per lecture |
no equivalent; dropped in the port |
| — | no translator concept exists in either theme |
What's wanted. Author and translator attribution rendered per lecture page. Translators matter specifically because the QuantEcon lecture series are translated into several languages (zh-cn, fa, fr), and translator credit currently has nowhere to live in either theme.
Design questions worth settling first
- Is attribution per-page (front-matter driven) or per-project (
html_theme_optionsdriven), or both, with page-level overriding project-level? - Where does it render — under the page title, in the footer, or both?
- Does this belong in a brand-neutral theme at all, or is it QuantEcon-specific?
PLAN.mdpositions this theme as deliberately brand-neutral with "minimal opinion", but per-page authorship is a general scholarly-documentation need, not a QuantEcon one. Worth deciding explicitly rather than by default. - If it lands here, does
quantecon-book-themeeventually inherit it, per thePLAN.mdgoal of this theme becoming the upstream base?
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with PLAN.md and the existing theme configuration and lecture-page rendering paths. Resolve whether attribution is page-level, project-level, or both, where it renders, and whether it belongs in this brand-neutral theme. Done means the scope and rendering design are agreed before implementation begins.
Written by the indexing model from the issue text.
Assessment
- Domain
- documentation
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Active
- Clarity
- Needs clarification
- Newbie friendliness
- 25/100