quarto-dev / quarto-dev/quarto-cli
Show possible customisation for title block in the guide and not just reference page
Nobody has claimed this yet.
- Dominant language
- JavaScript
- Stars
- 6k
- Forks
- 458
- Avg merge
- 1d 9h
- Merged PRs (30d)
- 41
Description
What would you like to do?
Give feedback or suggest an improvement
Description
From https://github.com/quarto-dev/quarto-web/pull/1421
We have a page on title block, which shows some possibly value to override labels
https://quarto.org/docs/authoring/title-blocks.html
However, it does not show the associated metadata to set the value. There are in reference page only
https://quarto.org/docs/reference/formats/html.html#title-author
Feedback is that it is confusing (see quarto-dev/quarto-web#1421)
It could be good to add a table there with the value, like doi. Or add a column in the table to have value associated with its label override (doi next to doi-title).
Contributor guide
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 by comparing the title-blocks guide with the HTML format reference, especially the title-author section and the feedback in quarto-web#1421. Update the guide so each label override is paired with its associated metadata value, such as doi, and confirm the customization is understandable without consulting the reference page.
Written by the indexing model from the issue text.
Assessment
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 48/100