Gestionar versiones de documentos

Docusaurus puede gestionar varias versiones de tus documentos.

Crear una versión de documentos

Lanza la versión 1.0 de tu proyecto:

npm run docusaurus docs:version 1.0

La carpeta docs se copia en versioned_docs/version-1.0 y se crea versions.json.

Ahora tus documentos tienen dos versiones:

• 1.0 en http://localhost:3000/docs/ para los documentos de la versión 1.0
• current en http://localhost:3000/docs/next/ para la próxima documentación, aún sin publicar

Añadir un menú desplegable de versiones

Para navegar fácilmente entre las versiones, añade un menú desplegable de versiones.

Modifica el archivo docusaurus.config.js:

docusaurus.config.js

export default {
  themeConfig: {
    navbar: {
      items: [
        {
          type: “docsVersionDropdown”,
        },
      ],
    },
  },
};

El menú desplegable de versiones de la documentación aparecerá en la barra de navegación:

Actualizar una versión existente

Es posible editar los documentos versionados en su respectiva carpeta:

• versioned_docs/version-1.0/hello.md actualiza http://localhost:3000/docs/hello
• docs/hello.md actualiza http://localhost:3000/docs/next/hello