facebook / facebook/docusaurus

Ability to expose extra docs data to existing pages (ex: expose frontMatter in tags pages)

Aperta
#8,886 3 commenti 0 reazioni 0 assegnatari Vedi su GitHub
proposal
Lingua principale
TypeScript
Stelle
66.2k
Fork
10k
Merge medio
1g 3h
PR unite (30g)
52

Descrizione

### Have you read the Contributing Guidelines on issues?

- [X] I have read the [Contributing Guidelines on issues](https://github.com/facebook/docusaurus/blob/main/CONTRIBUTING.md#issues).

### Motivation

I want to expose more data from docs inside auto-generated tags pages (DocTagDocListPage).

Currently, there are only few things exposed ( `docusaurus/packages/docusaurus-plugin-content-docs/src/props.ts` ):
- id
- title
- description
- permalink

Generated tags pages are simple. I would like to improve them a lot by using more data from docs like front matter, especially since I've got a lot of custom front matter attributes.
For now, modifying & extending tags pages is very limited due to limited info.

Since those pages are generated outside of DocProviders, i didn't find a way to fetch more data otherwise that modify whole plugin workflow ( probably modifying `contentLoaded` function )

Moreover, I don't understand why currently only those 4 fields are exposed for tags pages.

### Self-service

- [X] I'd be willing to do some initial work on this proposal myself.

Guida per i contributori

Apri la guida per i contributori

Valutazione

Questa issue non è ancora stata valutata.

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.