Skip to content

Comments

Unify news posts and blog posts, and standardise "authors" vs "author" in frontmatter#695

Merged
agriyakhetarpal merged 2 commits intoscientific-python:mainfrom
agriyakhetarpal:unify-news-and-blog-posts
Feb 10, 2026
Merged

Unify news posts and blog posts, and standardise "authors" vs "author" in frontmatter#695
agriyakhetarpal merged 2 commits intoscientific-python:mainfrom
agriyakhetarpal:unify-news-and-blog-posts

Conversation

@agriyakhetarpal
Copy link
Member

Closes #128; this PR adds author and date icons to news posts. @jarrodmillman suggested there were past inconsistencies in the headings, rendering, and content; which I think we have covered.

Also, there is some inconsistency in how authors are mentioned in the YAML frontmatter, which I think we should standardise:

use of authors: ["foo"]

https://github.com/search?q=%22authors%3A+%5B%22+%28org%3Ascientific-python+OR+repo%3Anumpy%2Fnumpy.org+OR+repo%3Ascipy%2Fscipy.org%29+language%3AMarkdown&type=code

use of author: ["foo"]

https://github.com/search?q=%22author%3A+%5B%22+%28org%3Ascientific-python+OR+repo%3Anumpy%2Fnumpy.org+OR+repo%3Ascipy%2Fscipy.org%29+language%3AMarkdown&type=code

This PR makes it authors: only, which can imply either a single author or multiple authors. In that regard, I think authors: is more correct, despite author: being more widely used. I would like to argue that such breakage is necessary for standardisation; we are still in the v0.x cycle anyway and we have long documented the experimental nature of the theme in the user guide. Once this PR is released in v0.23, I can change all instances of author: downstream.

@netlify
Copy link

netlify bot commented Jan 2, 2026

Deploy Preview for scientific-python-hugo-theme failed.

Built without sensitive environment variables

Name Link
🔨 Latest commit 16243fc
🔍 Latest deploy log https://app.netlify.com/projects/scientific-python-hugo-theme/deploys/698a9044ee8a7e0008cee9fd

@stefanv
Copy link
Member

stefanv commented Feb 9, 2026

I agree that authors: is more consistent.

@stefanv stefanv force-pushed the unify-news-and-blog-posts branch from f7d591d to 16243fc Compare February 10, 2026 01:56
@stefanv
Copy link
Member

stefanv commented Feb 10, 2026

Test sites error out because they use author still. E.g.:

5:57:10 PM: ERROR Page "posts/matplotlib/custom-3d-engine/index.md" uses deprecated 'author' field. Please use 'authors' instead.

@agriyakhetarpal
Copy link
Member Author

I think I can fix that later today for all sites – it should be quick!

@agriyakhetarpal
Copy link
Member Author

Done in scientific-python/blog.scientific-python.org#267. I'll merge this, since the blog repository is the only one that requires changes (the rest of the sites are fine). In the organisation, there are a few private repositories that would need this change, but have not been updated in years, so I assume we can leave them alone.

@agriyakhetarpal agriyakhetarpal merged commit fd217bc into scientific-python:main Feb 10, 2026
2 of 6 checks passed
@agriyakhetarpal agriyakhetarpal deleted the unify-news-and-blog-posts branch February 10, 2026 21:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

news and blog posts

2 participants