quarto-dev / quarto-dev/quarto-cli

Support gender/pronouns in author metadata?

Open
#8,476 0 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

authors enhancement metadata
Dominant language
JavaScript
Stars
6k
Forks
458
Avg merge
1d 9h
Merged PRs (30d)
41

Description

Discussed in https://github.com/quarto-dev/quarto-cli/discussions/2796

Originally posted by knuesel October 11, 2022
Following https://github.com/quarto-dev/quarto-cli/discussions/1309 quarto uses a neutral form for the author text in French. Maybe the author metadata could also support a "gender", so that translations can use the appropriate male/female/neutral form?

For example

---
title: Titre
author:
  name: Jane Doe
  gender: female
lang: fr
---

could produce a title block with "Autrice: Jane Doe" (and "Auteur: Jane Doe" in case of gender: male) instead of the current "Auteur·rice: Jane Doe".

I think "auteur·rice" is nice when the gender is not known or when there are several authors of different gender, but when the gender is known it's rather weird... (for readers unfamiliar with French, an English equivalent would be to write "(Wo)man who wrote this: Jane Doe").

For example if I put my name on a document for my students, of course I know my gender and it seems impersonal and strange to write "auteur·rice".

Originally posted by **javentous
** January 28, 2024

Hello, I was looking for a pronoun option as well for a blog I am making. I wanted to add it to the yaml in the .qmd preceeding the document body.

something like

---
title: "Paradise Lost"
author: "John Milton"
author-pronouns: "he / him"
categories:
  - Epic Poetry
  - Blank Verse
  - Religious Fiction
  - Christian Mythology
---

or for an extended author section

---
title: "Paradise Lost"
author: 
  name: "John Milton"
  pronouns: "he / him"
  gender: "man"
categories:
  - Epic Poetry
  - Blank Verse
  - Religious Fiction
  - Christian Mythology
---

Thanks for the work! Really liking quarto a ton

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the linked discussion 2796 and the referenced discussion 1309 to understand the current French author label behavior and the proposed metadata forms. Compare the gender and pronoun examples, then define the supported author metadata and fallback behavior for unknown or mixed authors. Done means the metadata is accepted and produces appropriate localized author text.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript, yaml
Domain
localization
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
28/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.