<!DOCTYPE html><htmllang="es-ES"><head><metacharSet="utf-8"/><metahttp-equiv="X-UA-Compatible"content="IE=edge"/><title>Versioning · Docusaurus</title><metaname="viewport"content="width=device-width"/><metaname="generator"content="Docusaurus"/><metaproperty="og:title"content="Versioning · Docusaurus"/><metaproperty="og:type"content="website"/><metaproperty="og:url"content="https://docusaurus.io/index.html"/><metaproperty="og:description"content="You can use the `version` script to cut a new documentation version based on the latest content in the `docs` folder. Ese conjunto específico de documentación se conservará y se podrá acceder incluso cuando la documentación en la carpeta `docs` cambie en adelante."/><metaproperty="og:image"content="https://docusaurus.io/img/docusaurus.png"/><metaname="twitter:card"content="summary"/><metaname="twitter:image"content="https://docusaurus.io/img/docusaurus.png"/><linkrel="shortcut icon"href="/img/docusaurus.ico"/><linkrel="stylesheet"href="https://cdn.jsdelivr.net/docsearch.js/1/docsearch.min.css"/><linkrel="stylesheet"href="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/atom-one-dark.min.css"/><linkrel="alternate"type="application/atom+xml"href="https://docusaurus.io/blog/atom.xml"title="Docusaurus Blog ATOM Feed"/><linkrel="alternate"type="application/rss+xml"href="https://docusaurus.io/blog/feed.xml"title="Docusaurus Blog RSS Feed"/><script>
</script></span><liclass="navSearchWrapper reactNavSearchWrapper"><inputtype="text"id="search_input_react"placeholder="Search"title="Search"/></li></ul></nav></div></header></div></div><divclass="navPusher"><divclass="docMainWrapper wrapper"><divclass="container docsNavContainer"id="docsNav"><navclass="toc"><divclass="toggleNav"><sectionclass="navWrapper wrapper"><divclass="navBreadcrumb wrapper"><divclass="navToggle"id="navToggler"><i></i></div><h2><i>›</i><span>Guías</span></h2><divclass="tocToggler"id="tocToggler"><iclass="icon-toc"></i></div></div><divclass="navGroups"><divclass="navGroup navGroupActive"><h3>Empezando</h3><ul><liclass="navListItem"><aclass="navItem"href="/docs/es-ES/installation">Installation</a></li><liclass="navListItem"><aclass="navItem"href="/docs/es-ES/site-preparation">Site Preparation</a></li><liclass="navListItem"><aclass="navItem"href="/docs/es-ES/site-creation">Creating your site</a></li><liclass="navListItem"><aclass="navItem"href="/docs/es-ES/publishing">Publishing your site</a></li></ul></div><divclass="navGroup navGroupActive"><h3>Guías</h3><ul><liclass="navListItem"><aclass="navItem"href="/docs/es-ES/blog">Adding a Blog</a></li><liclass="navListItem"><aclass="navItem"href="/docs/es-ES/custom-pages">Custom Pages</a></li><liclass="navListItem"><aclass="navItem"href="/docs/es-ES/search">Enabling Search</a></li><liclass="navListItem"><aclass="navItem"href="/docs/es-ES/navigation">Navigation and Sidebars</a></li><liclass="navListItem"><aclass="navItem"href="/docs/es-ES/translation">Traducciones y localización</a></li><liclass="navListItem navListItemActive"><aclass="navItem navItemActive"href="/docs/es-ES/versioning">Versioning</a></li></ul></div><divclass="navGroup navGroupActive"><h3>Interfaz de programación de aplicaciones</h3><ul><liclass="navListItem"><aclass="navItem"href="/docs/es-ES/commands">CLI Commands</a></li><liclass="navListItem"><aclass="navItem"href="/docs/es-ES/doc-markdown">Markdown Features</a></li><liclass="navListItem"><aclass="navItem"href="/docs/es-ES/api-pages">Pages and Styles</a></li><liclass="navListItem"><aclass="navItem"href="/docs/es-ES/site-config">siteConfig.js</a></li></ul></div></div></section></div><script>
</script></nav></div><divclass="container mainContainer"><divclass="wrapper"><divclass="post"><headerclass="postHeader"><aclass="edit-page-link button"href="https://crowdin.com/project/docusaurus/es-ES"target="_blank"rel="noreferrer noopener">Translate</a><h1>Versioning</h1></header><article><div><span><p>You can use the <code>version</code> script to cut a new documentation version based on the latest content in the <code>docs</code> folder. Ese conjunto específico de documentación se conservará y se podrá acceder incluso cuando la documentación en la carpeta <code>docs</code> cambie en adelante.</p>
<p>Esto conservará todos los documentos actualmente en la carpeta <code>docs</code> y los pondrá a disposición como documentación para la versión <code>1.0.0</code>.</p>
<p>If, for example, you ran the version script with <code>1.0.0</code> as the version number, version <code>1.0.0</code> is considered the latest release version for your project. The site will display the version number next to the title in the header. This version number links to a versions page that you created earlier.</p>
<p>Los documentos en la carpeta <code>docs</code> se considerarán parte de la versión <code>next</code> y estarán disponibles, por ejemplo, en url <code>docs/next/doc1.html</code>. Los documentos de la última versión usan url <code>docs/doc1.html</code>.</p>
<p>Running the script again with <code>yarn run version 2.0.0</code> will create a version <code>2.0.0</code>, making version <code>2.0.0</code> the most recent set of documentation. Los documentos de la versión <code>1.0.0</code> usarán la url <code>docs/1.0.0/doc1.html</code> mientras que <code>2.0.0</code> usará <code>docs/doc1.html</code>.</p>
<p>This table below summarizes Docusaurus versioning at a glance:</p>
<p>You can create version numbers in whatever format you wish, and a new version can be created with any version number as long as it does not match an existing version. Version ordering is determined by the order in which versions are created, independently of how they are numbered.</p>
<p>Versioned documents are placed into <code>website/versioned_docs/version-${version}</code>, where <code>${version}</code> is the version number you supplied the <code>version</code> script.</p>
<p>The markdown header for each versioned doc is altered by renaming the id front matter field to <code>original_id</code>, then using <code>"version-${version}-${original_id}"</code> as the value for the actual <code>id</code> field.</p>
<p>Versioned sidebars are copied into <code>website/versioned_sidebars</code> and are named as <code>version-${version}-sidebars.json</code>.</p>
<p>A <code>website/versions.json</code> file is created the first time you cut a version and is used by Docusaurus to detect what versions exist. Each time a new version is added, it gets added to the <code>versions.json</code> file.</p>
<p>If you wish to change the documentation for a past version, you can access the files for that respective version.</p>
<p>Only files in the <code>docs</code> folder and sidebar files that differ from those of the latest version will get copied each time a new version is specified. If there is no change across versions, Docusaurus will use the file from the latest version with that file.</p>
<p>For example, a document with the original id <code>doc1</code> exists for the latest version, <code>1.0.0</code>, and has the same content as the document with the id <code>doc1</code> in the <code>docs</code> folder. When a new version <code>2.0.0</code> is created, the file for <code>doc1</code> will not be copied into <code>versioned_docs/version-2.0.0/</code>. There will still be a page for <code>docs/2.0.0/doc1.html</code>, but it will use the file from version <code>1.0.0</code>.</p>
<p>If you wish to use versioning and translations features, the <code>crowdin.yaml</code> file should be set up to upload and download versioned documents to and from Crowdin for translation. Translated, versioned files will go into the folder <code>translated_docs/${language}/version-${version}/</code>. For more information, check out the <ahref="/docs/es-ES/translation">translations guide</a>.</p>
</span></div></article></div><divclass="docs-prevnext"><aclass="docs-prev button"href="translation">← Traducciones y localización</a><aclass="docs-next button"href="commands">CLI Commands →</a></div></div></div><navclass="onPageNav"><ulclass="toc-headings"><li><ahref="#como-crear-nuevas-versiones">Cómo crear nuevas versiones</a></li><li><ahref="#patrones-de-versiones">Patrones de versiones</a></li><li><ahref="#almacenamiento-de-archivos-para-cada-version">Almacenamiento de archivos para cada versión</a></li><li><ahref="#funcionalidad-de-respaldo">Funcionalidad de respaldo</a></li><li><ahref="#cambiar-el-nombre-de-las-versiones-existentes">Cambiar el nombre de las versiones existentes</a></li><li><ahref="#versiones-y-traducciones">Versiones y Traducciones</a></li></ul></nav></div><footerclass="nav-footer"id="footer"><sectionclass="sitemap"><ahref="/"class="nav-home"><imgsrc="/img/docusaurus_monochrome.svg"alt="Docusaurus"width="66"height="58"/></a><div><h5>Docs</h5><ahref="
