facebook / facebook/docusaurus

Support for symbolic linked .md files

Abierto
#11,080 2 comentarios 2 reacciones 0 asignados Ver en GitHub
proposal
Lenguaje dominante
TypeScript
Estrellas
66.2k
Forks
10k
Merge medio
1 d 3 h
PR fusionados (30 d)
52

Descripción

### 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

This issue is kind of a continuation from:

- https://github.com/facebook/docusaurus/issues/3579
- And https://github.com/facebook/docusaurus/issues/3272#issuecomment-2778515784

I have a repository with many helm charts, docker images, and whatnot. I like to keep a README.md for each of these little sub-projects, right inside each folder.

That's so when people open the directories in GitHub, they will have the README rendered.

And also, I'd like to show them in my documentation portal.

For now, I'm creating symbolic links to all these READMEs into my `website/docs` dir, so that they get parsed by Docusaurus too. For that to work, I need to use the WebPack `resolve.symlinks: false` trick.

And it works great, except it does not work when the Docusaurus project is installed with `pnpm install` (and also `deno install`, which works the same way as pnpm).

So, it would be great if Docusaurus had direct support for reading symlinked `.md` files.

### Self-service

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

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.