docusaurus/docs/es-ES/versioning.html
Website Deployment Script c1f8c2b060 Deploy website
Deploy website version based on 3b55e2c5fc
2018-04-12 15:38:39 +00:00

82 lines
No EOL
18 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<html lang="es-ES"><head><meta charset="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Versiones · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta property="og:title" content="Versiones · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/index.html"/><meta property="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."/><meta property="og:image" content="https://docusaurus.io/img/docusaurus.png"/><link rel="shortcut icon" href="/img/docusaurus.ico"/><link rel="stylesheet" href="https://cdn.jsdelivr.net/docsearch.js/1/docsearch.min.css"/><link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/solarized-dark.min.css"/><link rel="alternate" type="application/atom+xml" href="https://docusaurus.io/blog/atom.xml" title="Docusaurus Blog ATOM Feed"/><link rel="alternate" type="application/rss+xml" href="https://docusaurus.io/blog/feed.xml" title="Docusaurus Blog RSS Feed"/><script type="text/javascript" src="https://buttons.github.io/buttons.js"></script><link rel="stylesheet" href="/css/main.css"/></head><body class="sideNavVisible doc separateOnPageNav"><div class="fixedHeaderContainer"><div class="headerWrapper wrapper"><header><a href="/es-ES"><img class="logo" src="/img/docusaurus.svg" alt="Docusaurus"/><h2 class="headerTitle">Docusaurus</h2></a><div class="navigationWrapper navigationSlider"><nav class="slidingNav"><ul class="nav-site nav-site-internal"><li class="siteNavGroupActive"><a href="/docs/es-ES/installation.html" target="_self">Documentos</a></li><li class=""><a href="/es-ES/help.html" target="_self">Ayuda</a></li><li class=""><a href="/es-ES/users.html" target="_self">Users</a></li><li class=""><a href="/es-ES/about-slash.html" target="_self">About /</a></li><li class=""><a href="/blog" target="_self">Blog</a></li><li class=""><a href="https://github.com/facebook/docusaurus" target="_self">GitHub</a></li><span><li><a id="languages-menu" href="#"><img class="languages-icon" src="/img/language.svg"/>English</a><div id="languages-dropdown" class="hide"><ul id="languages-dropdown-items"><li><a href="/en">English</a></li><li><a href="/es-ES">Español</a></li><li><a href="https://crowdin.com/project/docusaurus" target="_blank" rel="noreferrer noopener">Help Translate</a></li></ul></div></li><script>
const languagesMenuItem = document.getElementById("languages-menu");
const languagesDropDown = document.getElementById("languages-dropdown");
languagesMenuItem.addEventListener("click", function(){
if(languagesDropDown.className == "hide") {
languagesDropDown.className = "visible";
} else {
languagesDropDown.className = "hide";
}
});
</script></span><li class="navSearchWrapper reactNavSearchWrapper"><input type="text" id="search_input_react" placeholder="Search" title="Search"/></li></ul></nav></div></header></div></div><div class="navPusher"><div class="docMainWrapper wrapper"><div class="container docsNavContainer" id="docsNav"><nav class="toc"><div class="toggleNav"><section class="navWrapper wrapper"><div class="navBreadcrumb wrapper"><div class="navToggle" id="navToggler"><i></i></div><h2><i></i><span>Guías</span></h2></div><div class="navGroups"><div class="navGroup navGroupActive"><h3>Empezando</h3><ul><li class="navListItem"><a class="navItem" href="/docs/es-ES/installation.html">Instalación</a></li><li class="navListItem"><a class="navItem" href="/docs/es-ES/site-preparation.html">Preparación del sitio</a></li><li class="navListItem"><a class="navItem" href="/docs/es-ES/site-creation.html">Creando su sitio</a></li><li class="navListItem"><a class="navItem" href="/docs/es-ES/publishing.html">Publishing your site</a></li></ul></div><div class="navGroup navGroupActive"><h3>Guías</h3><ul><li class="navListItem"><a class="navItem" href="/docs/es-ES/blog.html">Añadiendo un blog</a></li><li class="navListItem"><a class="navItem" href="/docs/es-ES/custom-pages.html">Páginas Personalizadas</a></li><li class="navListItem"><a class="navItem" href="/docs/es-ES/search.html">Habilitando la búsqueda</a></li><li class="navListItem"><a class="navItem" href="/docs/es-ES/navigation.html">Navegación y barras laterales</a></li><li class="navListItem"><a class="navItem" href="/docs/es-ES/translation.html">Traducciones y localización</a></li><li class="navListItem navListItemActive"><a class="navItem navItemActive" href="/docs/es-ES/versioning.html">Versiones</a></li></ul></div><div class="navGroup navGroupActive"><h3>Interfaz de programación de aplicaciones</h3><ul><li class="navListItem"><a class="navItem" href="/docs/es-ES/commands.html">Comandos de la CLI</a></li><li class="navListItem"><a class="navItem" href="/docs/es-ES/doc-markdown.html">Caracteristicas de Markdown</a></li><li class="navListItem"><a class="navItem" href="/docs/es-ES/api-pages.html">Páginas y estilos</a></li><li class="navListItem"><a class="navItem" href="/docs/es-ES/site-config.html">Configuración del sitio</a></li></ul></div></div></section></div><script>
var toggler = document.getElementById('navToggler');
var nav = document.getElementById('docsNav');
toggler.onclick = function() {
nav.classList.toggle('docsSliderActive');
};
</script></nav></div><div class="container mainContainer"><div class="wrapper"><div class="post"><header class="postHeader"><a class="edit-page-link button" href="https://crowdin.com/project/docusaurus/es-ES" target="_blank" rel="noreferrer noopener">Translate</a><h1>Versiones</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>
<h2><a class="anchor" aria-hidden="true" id="como-crear-nuevas-versiones"></a><a href="#como-crear-nuevas-versiones" aria-hidden="true" class="hash-link" ><svg aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Cómo crear nuevas versiones</h2>
<p>Run the following script to generate a starter versions page listing all the site versions:</p>
<pre><code class="hljs css bash">yarn examples versions
</code></pre>
<p>This creates the <code>pages/en/versions.js</code> file.</p>
<p>You can edit this file later on to customize how you display the versions.</p>
<p>Add the following script to your <code>package.json</code> file if it doesn't already exist:</p>
<pre><code class="hljs css json">...
"scripts": {
"version": "docusaurus-version"
},
...
</code></pre>
<p>Ejecute el script con un argumento de línea de comando de la versión que desea crear. p.ej.,</p>
<pre><code class="hljs css bash">yarn run version 1.0.0
</code></pre>
<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>
<h2><a class="anchor" aria-hidden="true" id="patrones-de-versiones"></a><a href="#patrones-de-versiones" aria-hidden="true" class="hash-link" ><svg aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Patrones de versiones</h2>
<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. El orden de las versiones está determinado por el orden en que se crean las versiones, independientemente de cómo estén numeradas.</p>
<h2><a class="anchor" aria-hidden="true" id="almacenamiento-de-archivos-para-cada-version"></a><a href="#almacenamiento-de-archivos-para-cada-version" aria-hidden="true" class="hash-link" ><svg aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Almacenamiento de archivos para cada versión</h2>
<p>Los documentos versionados se colocan en <code>website/versioned_docs/version-${version}</code> es el número de versión que proporcionó el script <code>version</code>.</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>&quot;version-${version}-${original_id}&quot;</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>Se crea un archivo <code>website/versions.json</code> la primera vez que se corta una versión y Docusaurus lo usa para detectar qué versiones existen. Cada vez que se agrega una nueva versión, se agrega al archivo <code>versions.json</code>.</p>
<p>Si desea cambiar la documentación de una versión anterior, puede acceder a los archivos para esa versión respectiva.</p>
<h2><a class="anchor" aria-hidden="true" id="funcionalidad-de-respaldo"></a><a href="#funcionalidad-de-respaldo" aria-hidden="true" class="hash-link" ><svg aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Funcionalidad de respaldo</h2>
<p>Solo los archivos en la carpeta <code>docs</code> y los archivos de la barra lateral que difieren de los de la última versión se copiarán cada vez que se especifique una nueva versión. Si no hay cambios en las versiones, Docusaurus usará el archivo de la última versión con ese archivo.</p>
<p>Por ejemplo, existe un documento con el id original <code>doc1</code> para la última versión, <code>1.0.0</code>, y tiene el mismo contenido que el documento con el id <code>doc1</code> en la carpeta <code>docs</code>. Cuando se crea una nueva versión <code>2.0.0</code>, el archivo para <code>doc1</code> no se copiará en <code>versioned_docs/version-2.0.0/</code>. Todavía habrá una página para <code>docs/2.0.0/doc1.html</code>, pero usará el archivo de la versión <code>1.0.0</code>.</p>
<h2><a class="anchor" aria-hidden="true" id="cambiar-el-nombre-de-las-versiones-existentes"></a><a href="#cambiar-el-nombre-de-las-versiones-existentes" aria-hidden="true" class="hash-link" ><svg aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Cambiar el nombre de las versiones existentes</h2>
<p>Para cambiar el nombre de un número de versión existente a otra cosa, primero asegúrese de que la siguiente secuencia de comandos se encuentre en su archivo <code>package.json</code>:</p>
<pre><code class="hljs css json">...
"scripts": {
"rename-version": "docusaurus-rename-version"
},
...
</code></pre>
<p>Ejecute la secuencia de comandos con argumentos de línea de comando de primero, el nombre de la versión actual, luego el segundo, el nombre de la nueva versión. p.ej.,</p>
<pre><code class="hljs css bash">yarn run rename-version 1.0.0 1.0.1
</code></pre>
<h2><a class="anchor" aria-hidden="true" id="versiones-y-traducciones"></a><a href="#versiones-y-traducciones" aria-hidden="true" class="hash-link" ><svg aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Versiones y Traducciones</h2>
<p>Si desea utilizar funciones de control de versiones y traducciones, el archivo <code>crowdin.yaml</code> debe configurarse para cargar y descargar documentos versionados desde y hacia Crowdin para su traducción. Los archivos traducidos y versionados irán a la carpeta<code>translated_docs/${language}/version-${version}/</code>. For more information, check out the <a href="/docs/es-ES/traducción.html">translations guide</a>.</p>
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="translation.html">← Traducciones y localización</a><a class="docs-next button" href="commands.html">Comandos de la CLI →</a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#como-crear-nuevas-versiones">Cómo crear nuevas versiones</a></li><li><a href="#patrones-de-versiones">Patrones de versiones</a></li><li><a href="#almacenamiento-de-archivos-para-cada-version">Almacenamiento de archivos para cada versión</a></li><li><a href="#funcionalidad-de-respaldo">Funcionalidad de respaldo</a></li><li><a href="#cambiar-el-nombre-de-las-versiones-existentes">Cambiar el nombre de las versiones existentes</a></li><li><a href="#versiones-y-traducciones">Versiones y Traducciones</a></li></ul></nav></div><footer class="nav-footer" id="footer"><section class="sitemap"><a href="/" class="nav-home"><img src="/img/docusaurus_monochrome.svg" alt="Docusaurus" width="66" height="58"/></a><div><h5>Docs</h5><a href="
/docs/es-ES/installation.html">Getting Started</a><a href="
/docs/es-ES/versioning.html">Versioning</a><a href="
/docs/es-ES/translation.html">Localization</a><a href="
/docs/es-ES/search.html">Adding Search</a></div><div><h5>Community</h5><a href="/es-ES/users.html">User Showcase</a><a href="https://twitter.com/docusaurus">Twitter</a></div><div><h5>More</h5><a href="https://github.com/facebook/docusaurus">GitHub</a><a class="github-button" href="https://github.com/facebook/Docusaurus" data-icon="octicon-star" data-count-href="/facebook/Docusaurus/stargazers" data-count-api="/repos/facebook/Docusaurus#stargazers_count" data-count-aria-label="# stargazers on GitHub" aria-label="Star this project on GitHub">Star</a></div></section><a href="https://code.facebook.com/projects/" target="_blank" rel="noreferrer noopener" class="fbOpenSource"><img src="/img/oss_logo.png" alt="Facebook Open Source" width="170" height="45"/></a><section class="copyright"><span>Copyright © 2018 Facebook Inc.</span></section></footer></div><script type="text/javascript" src="https://cdn.jsdelivr.net/docsearch.js/1/docsearch.min.js"></script><script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
ga('create', 'UA-44373548-31', 'auto');
ga('send', 'pageview');
</script><script>window.fbAsyncInit = function() {FB.init({appId:'1615782811974223',xfbml:true,version:'v2.7'});};(function(d, s, id){var js, fjs = d.getElementsByTagName(s)[0];if (d.getElementById(id)) {return;}js = d.createElement(s); js.id = id;js.src = '//connect.facebook.net/en_US/sdk.js';fjs.parentNode.insertBefore(js, fjs);}(document, 'script','facebook-jssdk'));
</script><script>window.twttr=(function(d,s, id){var js,fjs=d.getElementsByTagName(s)[0],t=window.twttr||{};if(d.getElementById(id))return t;js=d.createElement(s);js.id=id;js.src='https://platform.twitter.com/widgets.js';fjs.parentNode.insertBefore(js, fjs);t._e = [];t.ready = function(f) {t._e.push(f);};return t;}(document, 'script', 'twitter-wjs'));</script><script>
var search = docsearch({
apiKey: '3eb9507824b8be89e7a199ecaa1a9d2c',
indexName: 'docusaurus',
inputSelector: '#search_input_react'
});
</script></body></html>