facebook / facebook/docusaurus

Last updated: feeding data through front matter, new "created" metadata

Abierto
#5,691 24 comentarios 0 reacciones 0 asignados Ver en GitHub
domain: content plugin feature good first issue
Lenguaje dominante
TypeScript
Estrellas
66.2k
Forks
10k
Merge medio
1 d 3 h
PR fusionados (30 d)
52

Descripción

## 🚀 Feature

Two things:

- A new "created" metadata (using git history)
- Allow manually feeding the "last updated" / "created" data in front matter when git history is not available / is messed up (e.g. #5598)

### Have you read the [Contributing Guidelines on issues](https://github.com/facebook/docusaurus/blob/main/CONTRIBUTING.md#reporting-new-issues)?

Yes

### Has this been requested on [Canny](https://docusaurus.io/feature-requests)?

Requested multiple times on Discord

## Motivation

The "created" metadata can be used to differentiate between "new" pages and "deprecated" pages. "Last updated" shouldn't be entirely relying on git history since that can be buggy sometimes.

## API Design

Front matter options:

```ts
last_update_time: Date | string
last_update_author: string
create_time: Date | string
create_author: string
```

New config options `showCreateTime` and `showCreateAuthor`

The implementation of "create time" shouldn't be too hard with git, but it can also be messed up in versioning, so🤷‍♂️ Front matter metadata FTW

## Have you tried building it?

No

Guía de contribución

Abrir la guía de contribución

Evaluación

Este issue todavía no se ha evaluado.

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.