diff --git a/translations/es-ES/content/github/importing-your-projects-to-github/importing-source-code-to-github/about-github-importer.md b/translations/es-ES/content/github/importing-your-projects-to-github/importing-source-code-to-github/about-github-importer.md deleted file mode 100644 index ff469e6d2d..0000000000 --- a/translations/es-ES/content/github/importing-your-projects-to-github/importing-source-code-to-github/about-github-importer.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: Acerca de Importador GitHub -intro: 'Si tienes código fuente en Subversion, Mercurial, Team Foundation Version Control (TFVC) u otro repositorio de Git, puedes moverlo a GitHub utilizando el Importador de GitHub.' -redirect_from: - - /articles/about-github-importer - - /github/importing-your-projects-to-github/about-github-importer -versions: - fpt: '*' - ghec: '*' ---- - -Importador GitHub es una herramienta que importa de forma rápida repositorios de código fuente, incluido el historial de revisiones y confirmaciones de cambios, a GitHub para tí. - -![Importar un gif de repositorio](/assets/images/help/importer/github-importer.gif) - -Durante una importación, dependiendo del sistema de control de la versión del que estás importando, puedes autenticar con tu repositorio remoto, actualizar la atribución del autor de la confirmación e importar repositorios con archivos grandes (o eliminar archivos grandes si no quieres usar Large File Storage de Git). - -| Acción de importación | Subversion | Mercurial | TFVC | Git | -|:-------------------------------------------------------------------------------------------------------------------------- |:----------:|:---------:|:-----:|:-----:| -| Autenticar con repositorio remoto | **X** | **X** | **X** | **X** | -| [Actualizar la atribución del autor de la confirmación](/articles/updating-commit-author-attribution-with-github-importer) | **X** | **X** | **X** | | -| Mover archivos grandes a [Large File Storage de Git](/articles/about-git-large-file-storage) | **X** | **X** | **X** | | -| Eliminar archivos grandes de tu repositorio | **X** | **X** | **X** | | - -## Leer más - -- "[Importar un repositorio con Importador GitHub](/articles/importing-a-repository-with-github-importer)" -- "[Actualizar la atribución del autor de la confirmación con Importador GitHub ](/articles/updating-commit-author-attribution-with-github-importer)" -- "[Importar un repositorio de Git usando la línea de comando](/articles/importing-a-git-repository-using-the-command-line)" -- "[Herramientas de migración de código fuente](/articles/source-code-migration-tools)" diff --git a/translations/es-ES/content/github/importing-your-projects-to-github/importing-source-code-to-github/adding-an-existing-project-to-github-using-the-command-line.md b/translations/es-ES/content/github/importing-your-projects-to-github/importing-source-code-to-github/adding-an-existing-project-to-github-using-the-command-line.md deleted file mode 100644 index 588079753f..0000000000 --- a/translations/es-ES/content/github/importing-your-projects-to-github/importing-source-code-to-github/adding-an-existing-project-to-github-using-the-command-line.md +++ /dev/null @@ -1,158 +0,0 @@ ---- -title: Agregar un proyecto existente a GitHub utilizando la línea de comando -intro: 'Poner tu trabajo existente en {% data variables.product.product_name %} puede permitirte compartir y colaborar de muchas maneras increíbles.' -redirect_from: - - /articles/add-an-existing-project-to-github - - /articles/adding-an-existing-project-to-github-using-the-command-line - - /github/importing-your-projects-to-github/adding-an-existing-project-to-github-using-the-command-line -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -shortTitle: Agregar un proyecto localmente ---- - -## Acerca de agregar proyectos existentes a {% data variables.product.product_name %} - -{% tip %} - -**Sugerencia:** Si estás más a gusto con una interfaz de usuario de tipo "apuntar y hacer clic", trata de agregar tu proyecto con {% data variables.product.prodname_desktop %}. Para más información, consulta "[Agregar un repositorio de tu computadora local a GitHub Desktop](/desktop/guides/contributing-to-projects/adding-a-repository-from-your-local-computer-to-github-desktop)" en *{% data variables.product.prodname_desktop %} Ayuda*. - -{% endtip %} - -{% data reusables.repositories.sensitive-info-warning %} - -## Agregar un proyecto a {% data variables.product.product_name %} con {% data variables.product.prodname_cli %} - -{% data variables.product.prodname_cli %} es una herramienta de código abierto para utilizar {% data variables.product.prodname_dotcom %} desde la línea de comandos de tu computadora. El {% data variables.product.prodname_cli %} puede simplificar el proceso de agregar un proyecto existente a {% data variables.product.product_name %} utilizando la línea de comandos. Para aprender más sobre el {% data variables.product.prodname_cli %}, consulta la sección "[Acerca del {% data variables.product.prodname_cli %}](/github-cli/github-cli/about-github-cli)". - -1. En la línea de comandos, navega al directorio raíz de tu proyecto. -1. Inicializar el directorio local como un repositorio de Git. - - ```shell - git init -b main - ``` - -1. Probar y confirmar todos los archivos en tu proyecto - - ```shell - git add . && git commit -m "initial commit" - ``` - -1. Para crear un repositorio para tu proyecto en GitHub, utiliza el subcomando `gh repo create`. Cuando se te solicite, selecciona **Subir un repositorio local existente a GitHub** e ingresa el nombre que quieras ponerle a tu repositorio. Si quieres que tu proyecto pertenezca a una organización en vez de a tu cuenta de usuario, especifica el nombre de la organización y del proyecto con `organization-name/project-name`. - -1. Sigue los mensajes interactivos. Para agregar el remoto y subir el repositorio, confirma con "Sí" cuando se te pida agregar el remoto y subir las confirmaciones a la rama actual. - -1. Como alternativa, para saltarte todos los mensajes, proporciona la ruta del repositorio con el marcador `--source` y pasa un marcador de visibilidad (`--public`, `--private` o `--internal`). Por ejemplo, `gh repo create --source=. --public`. Especifica un remoto con el marcador `--remote`. Para subir tus confirmaciones, pasa el marcador `--push`. Para obtener más información sobre los argumentos posibles, consulta el [manual del CLI de GitHub](https://cli.github.com/manual/gh_repo_create). - -## Agregar un proyecto a {% data variables.product.product_name %} sin el {% data variables.product.prodname_cli %} - -{% mac %} - -1. [Crear un repositorio nuevo](/repositories/creating-and-managing-repositories/creating-a-new-repository) en {% data variables.product.product_location %}. Para evitar errores, no inicialices el nuevo repositorio con archivos *README* licencia o `gitingnore`. Puedes agregar estos archivos después de que tu proyecto se haya subido a {% data variables.product.product_name %}. ![Desplegable Create New Repository (Crear nuevo repositorio)](/assets/images/help/repository/repo-create.png) -{% data reusables.command_line.open_the_multi_os_terminal %} -3. Cambiar el directorio de trabajo actual en tu proyecto local. -4. Inicializar el directorio local como un repositorio de Git. - ```shell - $ git init -b main - ``` -5. Agregar los archivos a tu nuevo repositorio local. Esto representa la primera confirmación. - ```shell - $ git add . - # Agrega el archivo en el repositorio local y lo presenta para la confirmación. {% data reusables.git.unstage-codeblock %} - ``` -6. Confirmar los archivos que has preparado en tu repositorio local. - ```shell - $ git commit -m "First commit" - # Commits the tracked changes and prepares them to be pushed to a remote repository. {% data reusables.git.reset-head-to-previous-commit-codeblock %} - ``` -7. En la parte superior de tu repositorio en la página de configuración rápida de {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %}, haz clic en {% octicon "clippy" aria-label="The copy to clipboard icon" %} para copiar la URL del repositorio remoto. ![Copiar el campo de URL de repositorio remoto](/assets/images/help/repository/copy-remote-repository-url-quick-setup.png) -8. En Terminal, [agrega la URL para el repositorio remoto](/github/getting-started-with-github/managing-remote-repositories) donde se subirá tu repositorio local. - ```shell - $ git remote add origin <REMOTE_URL> - # Sets the new remote - $ git remote -v - # Verifies the new remote URL - ``` -9. [Sube los cambios](/github/getting-started-with-github/pushing-commits-to-a-remote-repository/) en tu repositorio local a {% data variables.product.product_location %}. - ```shell - $ git push -u origin main - # Pushes the changes in your local repository up to the remote repository you specified as the origin - ``` - -{% endmac %} - -{% windows %} - -1. [Crear un repositorio nuevo](/articles/creating-a-new-repository) en {% data variables.product.product_location %}. Para evitar errores, no inicialices el nuevo repositorio con archivos *README* licencia o `gitingnore`. Puedes agregar estos archivos después de que tu proyecto se haya subido a {% data variables.product.product_name %}. ![Desplegable Create New Repository (Crear nuevo repositorio)](/assets/images/help/repository/repo-create.png) -{% data reusables.command_line.open_the_multi_os_terminal %} -3. Cambiar el directorio de trabajo actual en tu proyecto local. -4. Inicializar el directorio local como un repositorio de Git. - ```shell - $ git init -b main - ``` -5. Agregar los archivos a tu nuevo repositorio local. Esto representa la primera confirmación. - ```shell - $ git add . - # Agrega el archivo en el repositorio local y lo presenta para la confirmación. {% data reusables.git.unstage-codeblock %} - ``` -6. Confirmar los archivos que has preparado en tu repositorio local. - ```shell - $ git commit -m "First commit" - # Commits the tracked changes and prepares them to be pushed to a remote repository. {% data reusables.git.reset-head-to-previous-commit-codeblock %} - ``` -7. En la parte superior de tu repositorio en la página de configuración rápida de {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %}, haz clic en {% octicon "clippy" aria-label="The copy to clipboard icon" %} para copiar la URL del repositorio remoto. ![Copiar el campo de URL de repositorio remoto](/assets/images/help/repository/copy-remote-repository-url-quick-setup.png) -8. En la indicación Command (Comando), [agrega la URL para el repositorio remoto](/github/getting-started-with-github/managing-remote-repositories) donde se subirá tu repositorio local. - ```shell - $ git remote add origin <REMOTE_URL> - # Sets the new remote - $ git remote -v - # Verifies the new remote URL - ``` -9. [Sube los cambios](/github/getting-started-with-github/pushing-commits-to-a-remote-repository/) en tu repositorio local a {% data variables.product.product_location %}. - ```shell - $ git push origin main - # Pushes the changes in your local repository up to the remote repository you specified as the origin - ``` - -{% endwindows %} - -{% linux %} - -1. [Crear un repositorio nuevo](/articles/creating-a-new-repository) en {% data variables.product.product_location %}. Para evitar errores, no inicialices el nuevo repositorio con archivos *README* licencia o `gitingnore`. Puedes agregar estos archivos después de que tu proyecto se haya subido a {% data variables.product.product_name %}. ![Desplegable Create New Repository (Crear nuevo repositorio)](/assets/images/help/repository/repo-create.png) -{% data reusables.command_line.open_the_multi_os_terminal %} -3. Cambiar el directorio de trabajo actual en tu proyecto local. -4. Inicializar el directorio local como un repositorio de Git. - ```shell - $ git init -b main - ``` -5. Agregar los archivos a tu nuevo repositorio local. Esto representa la primera confirmación. - ```shell - $ git add . - # Agrega el archivo en el repositorio local y lo presenta para la confirmación. {% data reusables.git.unstage-codeblock %} - ``` -6. Confirmar los archivos que has preparado en tu repositorio local. - ```shell - $ git commit -m "First commit" - # Commits the tracked changes and prepares them to be pushed to a remote repository. {% data reusables.git.reset-head-to-previous-commit-codeblock %} - ``` -7. En la parte superior de tu repositorio en la página de configuración rápida de {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %}, haz clic en {% octicon "clippy" aria-label="The copy to clipboard icon" %} para copiar la URL del repositorio remoto. ![Copiar el campo de URL de repositorio remoto](/assets/images/help/repository/copy-remote-repository-url-quick-setup.png) -8. En Terminal, [agrega la URL para el repositorio remoto](/github/getting-started-with-github/managing-remote-repositories) donde se subirá tu repositorio local. - ```shell - $ git remote add origin <REMOTE_URL> - # Sets the new remote - $ git remote -v - # Verifies the new remote URL - ``` -9. [Sube los cambios](/github/getting-started-with-github/pushing-commits-to-a-remote-repository/) en tu repositorio local a {% data variables.product.product_location %}. - ```shell - $ git push origin main - # Pushes the changes in your local repository up to the remote repository you specified as the origin - ``` - -{% endlinux %} - -## Leer más - -- "[Agregar un archivo a un repositorio](/repositories/working-with-files/managing-files/adding-a-file-to-a-repository#adding-a-file-to-a-repository-using-the-command-line)" diff --git a/translations/es-ES/content/github/importing-your-projects-to-github/importing-source-code-to-github/importing-a-git-repository-using-the-command-line.md b/translations/es-ES/content/github/importing-your-projects-to-github/importing-source-code-to-github/importing-a-git-repository-using-the-command-line.md deleted file mode 100644 index 34814042da..0000000000 --- a/translations/es-ES/content/github/importing-your-projects-to-github/importing-source-code-to-github/importing-a-git-repository-using-the-command-line.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: Importar un repositorio de Git usando la línea de comando -intro: '{% ifversion fpt %}Si [GitHub Importer](/articles/importing-a-repository-with-github-importer) no se ajusta a tus necesidades, por ejemplo, si tu código existente se hospeda en una red privada, entonces te recomendamos importar utilizando la línea de comandos.{% else %}Importar proyectos de Git utilizando la línea de comandos es adecuado cuando tu código existente se encuentra hospedado en una red privada.{% endif %}' -redirect_from: - - /articles/importing-a-git-repository-using-the-command-line - - /github/importing-your-projects-to-github/importing-a-git-repository-using-the-command-line -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -shortTitle: Importar un repositorio localmente ---- - -Antes de comenzar, asegúrate de saber lo siguiente: - -- Tu nombre de usuario {% data variables.product.product_name %} -- La URL del clon del repositorio externo, como `https://external-host.com/user/repo.git` o `git://external-host.com/user/repo.git` (quizás con un `user@` adelante del nombre de dominio `external-host.com`) - -{% tip %} - -A los fines de demostración, usaremos lo siguiente: - -- Una cuenta externa llamada **extuser** -- Un host de Git externo llamado `https://external-host.com` -- Una cuenta de usuario personal {% data variables.product.product_name %} llamada **ghuser** -- Un repositorio en {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %} que se llame **repo.git** - -{% endtip %} - -1. [Crear un repositorio nuevo en {% data variables.product.product_name %}](/articles/creating-a-new-repository). Importarás tu repositorio de Git externo a este repositorio nuevo. -2. En la línea de comando, haz un clon "en blanco" del repositorio usando la URL del clon externo. Esto crea una copia completa de los datos, pero sin un directorio de trabajo para editar archivos, y asegura una exportación limpia y nueva de todos los datos antiguos. - ```shell - $ git clone --bare https://external-host.com/extuser/repo.git - # Makes a bare clone of the external repository in a local directory - ``` -3. Sube el repositorio clonado de forma local a {% data variables.product.product_name %} usando la opción "espejo", que asegura que todas las referencias, como ramas y etiquetas, se copien en el repositorio importado. - ```shell - $ cd repo.git - $ git push --mirror https://{% data variables.command_line.codeblock %}/ghuser/repo.git - # Pushes the mirror to the new repository on {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %} - ``` -4. Elimina el repositorio local temporal. - ```shell - $ cd .. - $ rm -rf repo.git - ``` diff --git a/translations/es-ES/content/github/importing-your-projects-to-github/importing-source-code-to-github/importing-a-repository-with-github-importer.md b/translations/es-ES/content/github/importing-your-projects-to-github/importing-source-code-to-github/importing-a-repository-with-github-importer.md deleted file mode 100644 index 46548af2a2..0000000000 --- a/translations/es-ES/content/github/importing-your-projects-to-github/importing-source-code-to-github/importing-a-repository-with-github-importer.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: Importar un repositorio con el Importador GitHub -intro: 'Si tienes un proyecto alojado en otro sistema de control de versión, puedes importarlo automáticamente a GitHub usando la herramienta Importador GitHub.' -redirect_from: - - /articles/importing-from-other-version-control-systems-to-github - - /articles/importing-a-repository-with-github-importer - - /github/importing-your-projects-to-github/importing-a-repository-with-github-importer -versions: - fpt: '*' - ghec: '*' -shortTitle: Utilizar el importador de GitHub ---- - -{% tip %} - -**Sugerencia:** El Importador GitHub no útil para todas las importaciones. Por ejemplo, si tu código existente está alojado en una red privada, nuestra herramienta no podrá acceder a él. En estos casos, recomendamos [importar usando la línea de comando](/articles/importing-a-git-repository-using-the-command-line) para los repositorios de Git o una [herramienta de migración de código fuente](/articles/source-code-migration-tools) externa para los proyectos importados desde otros sistemas de control de versión. - -{% endtip %} - -Si quieres hacer coincidir las confirmaciones de tu repositorio con las cuentas de usuario de GitHub de los autores durante la importación, asegúrate de que cada contribuyente de tu repositorio tenga una cuenta de GitHub antes de comenzar la importación. - -{% data reusables.repositories.repo-size-limit %} - -1. En la esquina superior derecha de cada página, haz clic en {% octicon "plus" aria-label="Plus symbol" %} y luego haz clic en **Import repository** (Importar repositorio). ![Opción de Importar repositorio en el menú del nuevo repositorio](/assets/images/help/importer/import-repository.png) -2. En "La URL del clon de tu repositorio antiguo", escribe la URL del proyecto que quieres importar. ![Campo de texto para la URL del repositorio importado](/assets/images/help/importer/import-url.png) -3. Elige tu cuenta de usuario o una organización como propietaria del repositorio, luego escribe un nombre para el repositorio en GitHub. ![Menú del propietario del repositorio y campo del nombre del repositorio](/assets/images/help/importer/import-repo-owner-name.png) -4. Especifica si el repositorio nuevo debe ser *público* o *privado*. Para obtener más información, consulta "[Configurar la visibilidad de un repositorio](/articles/setting-repository-visibility)". ![Botones Radio para el repositorio público o privado](/assets/images/help/importer/import-public-or-private.png) -5. Revisa la información que ingresaste, luego haz clic en **Begin import** (Comenzar importación). ![Botón Begin import (Comenzar importación)](/assets/images/help/importer/begin-import-button.png) -6. Si tus proyectos antiguos estaban protegidos con contraseña, escribe tu información de inicio de sesión para ese proyecto, luego haz clic en **Submit** (Enviar). ![Formulario de contraseña y botón Submit (Enviar) para proyecto protegido con contraseña](/assets/images/help/importer/submit-old-credentials-importer.png) -7. Si hay múltiples proyectos alojados en la URL del clon de tu proyecto antiguo, elige el proyecto que quieras importar, luego haz clic en **Submit** (Enviar). ![Lista de proyectos para importar y botón Submit (Enviar)](/assets/images/help/importer/choose-project-importer.png) -8. Si tu proyecto contiene archivos mayores a 100 MB, elige si importarás los archivos grandes usando [Git Large File Storage](/articles/versioning-large-files), luego haz clic en **Continue** (Continuar). ![Menú de Git Large File Storage y botón Continue (Continuar)](/assets/images/help/importer/select-gitlfs-importer.png) - -Recibirás un correo electrónico cuando se haya importado todo el repositorio. - -## Leer más - -- "[Actualizar la atribución del autor de la confirmación con Importador GitHub ](/articles/updating-commit-author-attribution-with-github-importer)" diff --git a/translations/es-ES/content/github/importing-your-projects-to-github/importing-source-code-to-github/index.md b/translations/es-ES/content/github/importing-your-projects-to-github/importing-source-code-to-github/index.md deleted file mode 100644 index 6376c9b343..0000000000 --- a/translations/es-ES/content/github/importing-your-projects-to-github/importing-source-code-to-github/index.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: Importar código fuente a GitHub -intro: 'Puedes importar repositorios a GitHub usando el {% ifversion fpt %}Importador GitHub, la línea de comando,{% else %}la línea de comando{% endif %} o herramientas de migración externas.' -redirect_from: - - /articles/importing-an-external-git-repository - - /articles/importing-from-bitbucket - - /articles/importing-an-external-git-repo - - /articles/importing-your-project-to-github - - /articles/importing-source-code-to-github -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -children: - - /about-github-importer - - /importing-a-repository-with-github-importer - - /updating-commit-author-attribution-with-github-importer - - /importing-a-git-repository-using-the-command-line - - /adding-an-existing-project-to-github-using-the-command-line - - /source-code-migration-tools -shortTitle: Importar código a GitHub ---- - diff --git a/translations/es-ES/content/github/importing-your-projects-to-github/importing-source-code-to-github/source-code-migration-tools.md b/translations/es-ES/content/github/importing-your-projects-to-github/importing-source-code-to-github/source-code-migration-tools.md deleted file mode 100644 index 8f1420d095..0000000000 --- a/translations/es-ES/content/github/importing-your-projects-to-github/importing-source-code-to-github/source-code-migration-tools.md +++ /dev/null @@ -1,58 +0,0 @@ ---- -title: Herramientas de migración de código fuente -intro: Puedes utilizar herramientas externas para mover tus proyectos a GitHub. -redirect_from: - - /articles/importing-from-subversion - - /articles/source-code-migration-tools - - /github/importing-your-projects-to-github/source-code-migration-tools -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -shortTitle: Herramientas de migración de código ---- - -{% ifversion fpt or ghec %} - -Te recomendamos utilizar el [Importador de GitHub](/articles/about-github-importer) para importar proyectos de Subversion, Mercurial, Team Foundation Version Control (TFVC) u otro repositorio de Git. También puedes utilizar estas herramientas externas para convertir tus proyectos a Git. - -{% endif %} - -## Importar desde Subversion - -En un entorno normal de Subversion, se almacenan varios proyectos en un único repositorio raíz. En GitHub, cada uno de estos proyectos generalmente se mapeará a un repositorio de Git separado para una cuenta de usuario o de organización. Sugerimos importar cada parte de tu repositorio de Subversion a un repositorio de GitHub separado si: - -* Los colaboradores necesitan revisar o confirmar esa parte del proyecto de forma separada desde las otras partes -* Deseas que distintas partes tengan sus propios permisos de acceso - -Recomendamos estas herramientas para convertir repositorio de Subversion a Git: - -- [`git-svn`](https://git-scm.com/docs/git-svn) -- [svn2git](https://github.com/nirvdrum/svn2git) - -## Importar desde Mercurial - -Recomendamos [hg-fast-export](https://github.com/frej/fast-export) para convertir repositorios de Mercurial a Git. - -## Importar desde TFVC - -Te recomendamos utilizar [git-tfs](https://github.com/git-tfs/git-tfs) para mover los cambios entre TFVC y Git. - -Para obtener más información acerca de migrarse de TFVC (un sistema de control de versiones centralizado) a Git, consulta la sección "[Planea tu migración a Git](https://docs.microsoft.com/devops/develop/git/centralized-to-git)" del sitio de documentos de Microsoft. - -{% tip %} - -**Sugerencia:** después de haber convertido con éxito tu proyecto a Git, puedes [subirlo a {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/pushing-commits-to-a-remote-repository/). - -{% endtip %} - -{% ifversion fpt or ghec %} - -## Leer más - -- "[Acerca del Importador GitHub](/articles/about-github-importer)" -- "[Importar un repositorio con Importador GitHub](/articles/importing-a-repository-with-github-importer)" -- [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}) - -{% endif %} diff --git a/translations/es-ES/content/github/importing-your-projects-to-github/importing-source-code-to-github/updating-commit-author-attribution-with-github-importer.md b/translations/es-ES/content/github/importing-your-projects-to-github/importing-source-code-to-github/updating-commit-author-attribution-with-github-importer.md deleted file mode 100644 index 89c482136d..0000000000 --- a/translations/es-ES/content/github/importing-your-projects-to-github/importing-source-code-to-github/updating-commit-author-attribution-with-github-importer.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: Actualizar la atribución del autor de la confirmación con Importador GitHub -intro: 'Durante una importación, puedes hacer coincidir las confirmaciones de tu repositorio con la cuenta de GitHub del autor de la confirmación.' -redirect_from: - - /articles/updating-commit-author-attribution-with-github-importer - - /github/importing-your-projects-to-github/updating-commit-author-attribution-with-github-importer -versions: - fpt: '*' - ghec: '*' -shortTitle: Actualizar el importador de GitHub de autor ---- - -El Importador GitHub busca los usuarios de GitHub cuyas direcciones de correo electrónico coincidan con los autores de las confirmaciones del repositorio que estás importando. Luego puedes conectar una confirmación con su autor utilizando su dirección de correo electrónico o el nombre de usuario de GitHub del autor. - -## Actualizar autores de la confirmación - -1. Después de que hayas importado tu repositorio, en la página de estado de importación, haz clic en **Match authors** (Hacer coincidir autores). ![Botón Match authors (Hacer coincidir autores)](/assets/images/help/importer/match-authors-button.png) -2. Al lado del autor cuya información quieres actualizar, haz clic en **Connect** (Conectar). ![Lista de autores de la confirmación](/assets/images/help/importer/connect-commit-author.png) -3. Escribe la dirección de correo electrónico o el nombre de usuario de GitHub del autor, luego presiona **Enter**. - -## Atribuir confirmaciones a un usuario de GitHub con una dirección de correo electrónico pública - -Si el autor de una confirmación en tu repositorio importado tiene una cuenta de GitHub asociada con la dirección de correo electrónico que utilizó para figurar como autor de la confirmación y no estableció [su dirección de correo electrónico de confirmaciones como privada](/articles/setting-your-commit-email-address), el Importador GitHub hará coincidir la dirección de correo electrónico asociada a la confirmación con la dirección de correo electrónico pública asociada a su cuenta de GitHub, y atribuirá la confirmación a su cuenta de GitHub. - -## Atribuir confirmaciones a un usuario de GitHub sin una dirección de correo electrónico pública - -Si el autor de una confirmación en tu repositorio importado no estableció una dirección de correo electrónico pública en su perfil de GitHub ni [estableció su dirección de correo electrónico de confirmaciones como privada](/articles/setting-your-commit-email-address), el Importador GitHub no podrá hacer coincidir la dirección de correo electrónico asociada a la confirmación con su cuenta de GitHub. - -El autor de la confirmación puede resolver esto estableciendo su dirección de correo electrónico como privada. Sus confirmaciones luego se le atribuirán a `@users.noreply.github.com`, y las confirmaciones importadas se asociarán a su cuenta de GitHub. - -## Atribuir confirmaciones utilizando una dirección de correo electrónico - -Si la dirección de correo electrónico del autor no está asociada a su cuenta de GitHub, puede [agregar la dirección a su cuenta](/articles/adding-an-email-address-to-your-github-account) después de la importación, y las confirmaciones se atribuirán de manera correcta. - -Si el autor no tiene una cuenta de GitHub, el Importador GitHub atribuirá sus confirmaciones a la dirección de correo electrónico asociada a las confirmaciones. - -## Leer más - -- "[Acerca del Importador GitHub](/articles/about-github-importer)" -- "[Importar un repositorio con Importador GitHub](/articles/importing-a-repository-with-github-importer)" -- "[Agregar una dirección de correo electrónico a tu cuenta](/articles/adding-an-email-address-to-your-github-account/)" -- "[Establecer tu dirección de correo electrónico de confirmaciones](/articles/setting-your-commit-email-address)" diff --git a/translations/es-ES/content/github/importing-your-projects-to-github/index.md b/translations/es-ES/content/github/importing-your-projects-to-github/index.md deleted file mode 100644 index 804005675e..0000000000 --- a/translations/es-ES/content/github/importing-your-projects-to-github/index.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: Importar tus proyectos a GitHub -intro: 'Puedes importar tu código fuente a {% data variables.product.product_name %} utilizando diversos métodos diferentes.' -shortTitle: Importar tus proyectos -redirect_from: - - /categories/67/articles - - /categories/importing - - /categories/importing-your-projects-to-github -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -children: - - /importing-source-code-to-github - - /working-with-subversion-on-github ---- - diff --git a/translations/es-ES/content/github/importing-your-projects-to-github/working-with-subversion-on-github/index.md b/translations/es-ES/content/github/importing-your-projects-to-github/working-with-subversion-on-github/index.md deleted file mode 100644 index b049d8948a..0000000000 --- a/translations/es-ES/content/github/importing-your-projects-to-github/working-with-subversion-on-github/index.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: Trabajar con Subversion en GitHub -intro: Puedes usar clientes de Subversion y algunos flujos de trabajo y propiedades de Subversion con GitHub. -redirect_from: - - /articles/working-with-subversion-on-github -versions: - fpt: '*' - ghes: '*' - ghec: '*' -children: - - /what-are-the-differences-between-subversion-and-git - - /support-for-subversion-clients - - /subversion-properties-supported-by-github -shortTitle: Trabajar con Subversion en GitHub ---- - diff --git a/translations/es-ES/content/github/importing-your-projects-to-github/working-with-subversion-on-github/subversion-properties-supported-by-github.md b/translations/es-ES/content/github/importing-your-projects-to-github/working-with-subversion-on-github/subversion-properties-supported-by-github.md deleted file mode 100644 index b14bfcda21..0000000000 --- a/translations/es-ES/content/github/importing-your-projects-to-github/working-with-subversion-on-github/subversion-properties-supported-by-github.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: Propiedades de Subversion admitidas por GitHub -intro: 'Existen varios flujos de trabajo y propiedades de Subversion que son similares a la funcionalidad existente en {% data variables.product.product_name %}.' -redirect_from: - - /articles/subversion-properties-supported-by-github - - /github/importing-your-projects-to-github/subversion-properties-supported-by-github -versions: - fpt: '*' - ghes: '*' - ghec: '*' -shortTitle: Propiedades compatibles con GitHub ---- - -## Archivos ejecutables (svn:executable) - -Convertimos propiedades `svn:executable` al actualizar el modo archivo directamente antes de agregarlo al repositorio de Git. - -## Tipos MIME (svn:mime-type) - -{% data variables.product.product_name %} internalmente rastrea las propiedades mime-type de los archivos y las confirmaciones que los agregaron. - -## Ignorar elementos sin versión (svn:ignore) - -Si has configurado que los archivos y los directorios se ignoren en Subversion, {% data variables.product.product_name %} los rastrearemos de manera interna. Los archivos ignorados por los clientes de Subversion son completamente distintos a las entradas en un archivo *.gitignore*. - -## Propiedades admitidas actualmente - -{% data variables.product.product_name %} no admite actualmente `svn:externals`, `svn:global-ignores`, o culaquier propiedad no enumerada anteriormente, incluidas las propiedades personalizadas. diff --git a/translations/es-ES/content/github/importing-your-projects-to-github/working-with-subversion-on-github/support-for-subversion-clients.md b/translations/es-ES/content/github/importing-your-projects-to-github/working-with-subversion-on-github/support-for-subversion-clients.md deleted file mode 100644 index c1e0e96584..0000000000 --- a/translations/es-ES/content/github/importing-your-projects-to-github/working-with-subversion-on-github/support-for-subversion-clients.md +++ /dev/null @@ -1,133 +0,0 @@ ---- -title: Soporte para clientes de Subversion -intro: Los repositorios de GitHub pueden accederse desde los clientes de Git y de Subversion (SVN). En este artículo se aborda el uso de un cliente de Subversion en GitHub y algunos problemas comunes que puedes llegar a encontrar. -redirect_from: - - /articles/support-for-subversion-clients - - /github/importing-your-projects-to-github/support-for-subversion-clients -versions: - fpt: '*' - ghes: '*' - ghec: '*' -shortTitle: Soporte para clientes de Subversion ---- - -GitHub admite clientes de Subversion por medio del protocolo HTTPS. Utilizamos el puente de Subversion para comunicar los comandos svn a GitHub. - -## Funciones de Subversion admitidas en GitHub - -### Control - -La primera cosa que desearás realizar es un control de Subversion. Ya que los clones de Git mantienen un directorio de trabajo (donde editas los archivos) separado de los datos del repositorio, solo hay una rama en el directorio de trabajo a la vez. - -Los controles de Subversion son diferentes: combinan los datos del repositorio en los directorios de trabajo, por lo que hay un directorio de trabajo para cada rama y etiqueta que has revisado. Para los repositorios con muchas ramas y etiquetas, revisar cada cosa puede ser una sobrecarga del ancho de banda, por lo que deberías comenzar con un control parcial. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.copy-clone-url %} - -3. Realiza un control vacío del repositorio: - ```shell - $ svn co --depth empty https://github.com/user/repo - > Checked out revision 1. - $ cd repo - ``` - -4. Llega hasta la rama `trunk` (tronco). El puente de Subversion mapea a trunk en la rama HEAD de Git. - ```shell - $ svn up trunk - > A trunk - > A trunk/README.md - > A trunk/gizmo.rb - > Updated to revision 1. - ``` - -5. Consigue un control vacío del directorio de `branches` (ramas). Aquí es donde están todas las ramas non-`HEAD` (no encabezado), y donde harás las ramas de características. - ```shell - $ svn up --depth empty branches - Updated to revision 1. - ``` - -### Crear ramas - -También puedes crear ramas usando el puente de Subversion a GitHub. - -Desde tu cliente de svn, asegúrate de que la rama predeterminada es la más reciente actualizando `trunk`: -```shell -$ svn up trunk -> At revision 1. -``` - -A continuación, puedes utilizar `svn copy` para crear una nueva rama: -```shell -$ svn copy trunk branches/more_awesome -> A branches/more_awesome -$ svn commit -m 'Added more_awesome topic branch' -> Adding branches/more_awesome - -> Revisión confirmada 2. -``` - -Puedes confirmar que la nueva rama existe en el menú desplegable de la rama del repositorio: - -![branch-snapshot](/assets/images/help/branch/svnflow-branch-snapshot.png) - -También puedes confirmar la nueva rama por medio de la línea de comando: - -```shell -$ git fetch -> From https://github.com/user/repo/ -> * [new branch] more_awesome -> origin/more_awesome -``` - -### Realizar confirmaciones de cambios en Subversion - -Después de haber agregado algunas características y haber arreglado algunos errores, desearás confirmar estos cambios en GitHub. Esto funciona de la misma forma en la que estás acostumbrado en Subversion. Edita tus archivos y utiliza `svn commit` para registrar tus cambios: - -```shell -$ svn status -> M gizmo.rb -$ svn commit -m 'Guard against known problems' -> Sending more_awesome/gizmo.rb -> Transmitiendo los datos del archivo. -> Revisión confirmada 3. -$ svn status -> ? test -$ svn add test -> A test -> A test/gizmo_test.rb -$ svn commit -m 'Test coverage for problems' -> Adding more_awesome/test -> Adding more_awesome/test/gizmo_test.rb -> Transmitiendo los datos del archivo. -> Revisión confirmada 4. -``` - -### Alternar entre ramas - -Para alternar entre ramas, probablemente desearás comenzar con un control del `trunk` (tronco): - -```shell -$ svn co --depth empty https://github.com/user/repo/trunk -``` - -Luego, puedes alternar a otra rama: - -```shell -$ svn switch https://github.com/user/repo/branches/more_awesome -``` - -## Encontrar el SHA de confirmación de Git para una confirmación de Subversion - -El servidor de Subversion de GitHub muestra el sha de confirmación de Git para cada confirmación de Subversion. - -Para ver el SHA de confirmación, deberías solicitar la propiedad remota sin versión de `git-commit`. - -```shell -$ svn propget git-commit --revprop -r HEAD https://github.com/user/repo -05fcc584ed53d7b0c92e116cb7e64d198b13c4e3 -``` - -Con este SHA de confirmación, puedes, por ejemplo, consultar la correspondiente confirmación Git en GitHub. - -## Leer más - -* "[Propiedades de Subversion admitidas por GitHub](/articles/subversion-properties-supported-by-github)" diff --git a/translations/es-ES/content/github/importing-your-projects-to-github/working-with-subversion-on-github/what-are-the-differences-between-subversion-and-git.md b/translations/es-ES/content/github/importing-your-projects-to-github/working-with-subversion-on-github/what-are-the-differences-between-subversion-and-git.md deleted file mode 100644 index 8931d347ce..0000000000 --- a/translations/es-ES/content/github/importing-your-projects-to-github/working-with-subversion-on-github/what-are-the-differences-between-subversion-and-git.md +++ /dev/null @@ -1,70 +0,0 @@ ---- -title: ¿Cuáles son las diferencias entre Subversion y Git? -intro: 'Los repositorios de Subversion (SVN) son similares a los repositorios de Git, pero hay diferencias cuando se refiere a la arquitectura de tus proyectos.' -redirect_from: - - /articles/what-are-the-differences-between-svn-and-git - - /articles/what-are-the-differences-between-subversion-and-git - - /github/importing-your-projects-to-github/what-are-the-differences-between-subversion-and-git -versions: - fpt: '*' - ghes: '*' - ghec: '*' -shortTitle: Diferencias entre Subversion & Git ---- - -## Estructura del directorio - -Cada *referencia*, o instantánea etiquetada de una confirmación, en un proyecto se organiza dentro de subdirectorios específicos, como `tronco`, `ramas` y `etiquetas`. Por ejemplo, un proyecto SVN con dos características bajo desarrollo debería parecerse a esto: - - sample_project/trunk/README.md - sample_project/trunk/lib/widget.rb - sample_project/branches/new_feature/README.md - sample_project/branches/new_feature/lib/widget.rb - sample_project/branches/another_new_feature/README.md - sample_project/branches/another_new_feature/lib/widget.rb - -Un flujo de trabajo SVN se parece a esto: - -* El directorio `tronco` representa el último lanzamiento estable de un proyecto. -* El trabajo de característica activa se desarrolla dentro de subdirectorios dentro de `ramas`. -* Cuando una característica se termina, el directorio de la característica se fusiona dentro del `tronco` y se elimina. - -Los proyectos de Git también se almacenan dentro de un directorio único. Sin embargo, Git oculta los detalles de sus referencias al almacenarlos en un directorio *.git* especial. Por ejemplo, un proyecto Git con dos características bajo desarrollo debería parecerse a esto: - - sample_project/.git - sample_project/README.md - sample_project/lib/widget.rb - -Un flujo de trabajo Git se parece a esto: - -* Un repositorio Git almacena el historial completo de todas sus ramas y etiquetas dentro del directorio de *.git*. -* El último lanzamiento estables se contiene dentro de la rama predeterminada. -* El trabajo de característica activa se desarrolla en ramas separadas. -* Cuando una característica finaliza, la rama de característica se fusiona en la rama predeterminada y se borra. - -A diferencia de SVN, con Git la estructura del directorio permanece igual, pero los contenidos de los archivos cambia en base a tu rama. - -## Incluir los subproyectos - -Un *subproyecto* es un proyecto que se ha desarrollado y administrado en algún lugar fuera del proyecto principal. Normalmente importas un subproyecto para agregar alguna funcionalidad a tu proyecto sin necesidad de mantener el código. Cada vez que el proyecto se actualiza, puedes sincronizarlo con tu proyecto para garantizar que todo esté actualizado. - -En SVN, un subproyecto se llama un *SVN externo*. En Git, se llama un *submódulo Git*. A pesar de que conceptualmente son similares, los submódulos Git no se mantienen actualizados de forma automática; debes solicitar explícitamente que se traiga una nueva versión a tu proyecto. - -Para obtener más información, consulta la sección "[Submódulos de las Git Tools](https://git-scm.com/book/en/Git-Tools-Submodules)" en la documentación de Git. - -## Mantener el historial - -SVN está configurado para suponer que el historial de un proyecto nunca cambia. Git te permite modificar cambios y confirmaciones previas utilizando herramientas como [`git rebase`](/github/getting-started-with-github/about-git-rebase). - -{% tip %} - -[GitHub admite clientes de Subversion](/articles/support-for-subversion-clients), lo que puede generar algunos resultados inesperados si estás utilizando tanto Git como SVN en el mismo proyecto. Si has manipulado el historial de confirmación de Git, esas mismas confirmaciones siempre permanecerán dentro del historial de SVN. Si accidentalmente confirmaste algunos datos confidenciales, hay un [artículo que te ayudará a eliminarlo del historial de Git](/articles/removing-sensitive-data-from-a-repository). - -{% endtip %} - -## Leer más - -- "[Propiedades de Subversion admitidas por GitHub](/articles/subversion-properties-supported-by-github)" -- ["Branching and Merging" del libro _Git SCM_](https://git-scm.com/book/en/Git-Branching-Basic-Branching-and-Merging) -- "[Importar código fuente a GitHub](/articles/importing-source-code-to-github)" -- "[Herramientas de migración de código fuente](/articles/source-code-migration-tools)" diff --git a/translations/es-ES/content/github/understanding-how-github-uses-and-protects-your-data/about-githubs-use-of-your-data.md b/translations/es-ES/content/github/understanding-how-github-uses-and-protects-your-data/about-githubs-use-of-your-data.md deleted file mode 100644 index dae838a645..0000000000 --- a/translations/es-ES/content/github/understanding-how-github-uses-and-protects-your-data/about-githubs-use-of-your-data.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: Acerca del uso de tus datos de GitHub -redirect_from: - - /articles/about-github-s-use-of-your-data - - /articles/about-githubs-use-of-your-data -intro: '{% data variables.product.product_name %} usa los datos de tu repositorio para conectarte con información, proyectos, personas y herramientas relevantes.' -versions: - fpt: '*' - ghec: '*' -topics: - - Policy - - Legal -shortTitle: Cómo utiliza tus datos GitHub ---- - -## Acerca de como {% data variables.product.product_name %} utiliza tus datos - -{% data variables.product.product_name %} agrega metadatos y analiza patrones de contenidos con el fin de suministrar información generalizada dentro del producto. Usa datos de los repositorios públicos y también usa metadatos y agrega datos de repositorios privados cuando el propietario de un repositorio ha elegido compartir los datos con {% data variables.product.product_name %} mediante una opción. Si aceptas el uso de datos de un repositorio privado, entonces se realizará un análisis de solo lectura de ese repositorio privado específico. - -{% data reusables.repositories.about-github-archive-program %} Para obtener más información, consulta la sección "[Acerca de archivar contenido y datos en {% data variables.product.prodname_dotcom %}](/github/creating-cloning-and-archiving-repositories/about-archiving-content-and-data-on-github#about-the-github-archive-program)". - -{% data reusables.user_settings.export-data %} Para obtener más información, consulta "[Solicitar un archivo de los datos de tu cuenta personal](/articles/requesting-an-archive-of-your-personal-account-s-data)". - -Si decides utilizar datos para un repositorio privado, seguiremos tratando tus datos privados, código abierto, o secretos comerciales como confidenciales y privados de acuerdo con nuestras [Condiciones de Servicio](/free-pro-team@latest/github/site-policy/github-terms-of-service). La información que obtenemos viene solo de los datos agregados. Para obtener más información, consulta la sección "[Administrar la configuración de uso de datos para tu repositorio privado](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository)". - -Anunciaremos nuevas funciones sustanciales que usen metadatos o datos agregados en el [{% data variables.product.prodname_dotcom %}blog](https://github.com/blog). - -## Cómo mejoran los datos las recomendaciones de seguridad - -Como ejemplo de cómo deberían usarse tus datos, podemos detectar y alertarte sobre una vulnerabilidad de seguridad en las dependencias de tu repositorio público. Para obtener más información, consulta la sección "[Acerca de las alertas para las dependencias vulnerables](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)". - -Para detectar posibles vulnerabilidades de seguridad {% data variables.product.product_name %} escanea los contenidos del archivo de manifiesto de dependencias para hacer una lista de las dependencias de tu proyecto. - -{% data variables.product.product_name %} también aprende de los cambios que realizas en tu manifiesto de dependencias. Por ejemplo, si actualizas una dependencia vulnerable a una versión segura después de recibir una alerta de seguridad y otros hacen lo mismo, {% data variables.product.product_name %} aprende cómo hacer un parche en la vulnerabiidad y puede recomendar un parche similar para el repositorio afectado. - -## Privacidad y uso compartido de datos - -Los datos del repositorio privado se escanean mediante una máquina y nunca es leído por el personal de {% data variables.product.product_name %}. El ojo humano nunca verá los contenidos de tus repositorios privados, a excepción de lo que se describe en nuestros [Términos de servicio](/free-pro-team@latest/github/site-policy/github-terms-of-service#3-access). - -Tus datos personales individuales o del repositorio no se compartirán con terceros. Podemos compartir datos agregados obtenidos de nuestro análisis con nuestros socios. diff --git a/translations/es-ES/content/github/understanding-how-github-uses-and-protects-your-data/index.md b/translations/es-ES/content/github/understanding-how-github-uses-and-protects-your-data/index.md deleted file mode 100644 index 52a02fdeb2..0000000000 --- a/translations/es-ES/content/github/understanding-how-github-uses-and-protects-your-data/index.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: Comprender cómo GitHub usa y protege tus datos -redirect_from: - - /categories/understanding-how-github-uses-and-protects-your-data -versions: - fpt: '*' - ghec: '*' -children: - - /about-githubs-use-of-your-data - - /requesting-an-archive-of-your-personal-accounts-data - - /managing-data-use-settings-for-your-private-repository - - /opting-into-or-out-of-the-github-archive-program-for-your-public-repository -shortTitle: Cómo protege los datos GitHub ---- - diff --git a/translations/es-ES/content/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository.md b/translations/es-ES/content/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository.md deleted file mode 100644 index 3b99587895..0000000000 --- a/translations/es-ES/content/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository.md +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: Administrar la configuración de uso de datos para tu repositorio privado -intro: 'Para ayudar a que {% data variables.product.product_name %} te conecte a las herramientas, proyectos, personas e información relevantes, puedes configurar el uso de datos para tu repositorio privado.' -redirect_from: - - /articles/opting-into-or-out-of-data-use-for-your-private-repository - - /github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-data-use-for-your-private-repository -versions: - fpt: '*' - ghec: '*' -topics: - - Policy - - Legal -shortTitle: Administrar el uso de datos para un repositorio privado ---- - -## Acerca del uso de datos para tu repositorio privado - -Cuando habilitas el uso de datos para tu repositorio privado, podrás acceder a la gráfica de dependencias, en donde puedes rastrear las dependencias de tus repositorios y recibir las {% data variables.product.prodname_dependabot_alerts %} cuando {% data variables.product.product_name %} detecte las dependencias vulnerables. Para obtener más información, consulta la sección "[Acerca de las alertas para las dependencias vulnerables](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies#dependabot-alerts-for-vulnerable-dependencies)". - -## Habilitar o inhabilitar las características para el uso de datos - -{% data reusables.security.security-and-analysis-features-enable-read-only %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -{% data reusables.repositories.navigate-to-security-and-analysis %} -4. Debajo de "Configurar características de seguridad y análisis", a la derecha de la característica, haz clic en **Inhabilitar** o en **Habilitar**.{% ifversion fpt %} !["Enable" or "Disable" button for "Configure security and analysis" features](/assets/images/help/repository/security-and-analysis-disable-or-enable-fpt-private.png){% elsif ghec %} -!["Enable" or "Disable" button for "Configure security and analysis" features](/assets/images/help/repository/security-and-analysis-disable-or-enable-ghec-private.png){% endif %} - -## Leer más - -- "[Acerca del uso de tus datos de {% data variables.product.prodname_dotcom %}](/articles/about-github-s-use-of-your-data)" -- "[Ver y actualizar las dependencias vulnerables en tu repositorio](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository)" -- "[Administrar la configuración de seguridad y de análisis para tu organización](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository)" diff --git a/translations/es-ES/content/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-the-github-archive-program-for-your-public-repository.md b/translations/es-ES/content/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-the-github-archive-program-for-your-public-repository.md deleted file mode 100644 index 299762be80..0000000000 --- a/translations/es-ES/content/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-the-github-archive-program-for-your-public-repository.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: Aceptar o rechazar el ingreso al Prgrama de GitHub Archive para tu repositorio público -intro: 'Puedes gestionar si {% data variables.product.prodname_dotcom %} incluye tu repositorio público en el {% data variables.product.prodname_archive %} para ayudarte a garantizar la preservación a largo plazo del código abierto global.' -permissions: 'People with admin permissions to a public repository can opt into or out of the {% data variables.product.prodname_archive %}.' -versions: - fpt: '*' - ghec: '*' -topics: - - Policy - - Legal -shortTitle: Programa de Archivo de GitHub ---- - -{% data reusables.repositories.about-github-archive-program %} Para obtener más información, consulta la sección "[Acerca de archivar contenido y datos en {% data variables.product.prodname_dotcom %}](/github/creating-cloning-and-archiving-repositories/about-archiving-content-and-data-on-github#about-the-github-archive-program)". - -Si rechazas el ingreso de un repositorio al {% data variables.product.prodname_archive %}, éste se excluirá de cualquier archivo a largo plazo que {% data variables.product.prodname_dotcom %} pudiera crear posteriormente. También enviaremos una solicitud a cada una de nuestras organizaciones socias para eliminar el repositorio de sus datos. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -3. Debajo de "Características", selecciona o deselecciona **Preservar este repositorio**. ![Casilla para permitir a {% data variables.product.prodname_dotcom %} incluir tu código en el {% data variables.product.prodname_archive %}](/assets/images/help/repository/github-archive-program-checkbox.png) - -## Leer más -- [{% data variables.product.prodname_archive %} Preguntas Frecuentes](https://archiveprogram.github.com/faq/) diff --git a/translations/es-ES/content/github/understanding-how-github-uses-and-protects-your-data/requesting-an-archive-of-your-personal-accounts-data.md b/translations/es-ES/content/github/understanding-how-github-uses-and-protects-your-data/requesting-an-archive-of-your-personal-accounts-data.md deleted file mode 100644 index b4194167cc..0000000000 --- a/translations/es-ES/content/github/understanding-how-github-uses-and-protects-your-data/requesting-an-archive-of-your-personal-accounts-data.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Solicitar un archivo de tus datos de cuenta personal -redirect_from: - - /articles/requesting-an-archive-of-your-personal-account-s-data - - /articles/requesting-an-archive-of-your-personal-accounts-data -intro: '{% data reusables.user_settings.export-data %}' -versions: - fpt: '*' - ghec: '*' -topics: - - Policy - - Legal -shortTitle: Solicitar el archivo de cuentas ---- - -{% data variables.product.product_name %} almacena metadatos del repositorio y del perfil desde tu actividad de cuenta personal. Puedes exportar tus datos de cuenta personal a través de los parámetros {% data variables.product.prodname_dotcom_the_website %} o con la API de migración de usuarios. - -Para obtener más información, acerca de los datos que almacena {% data variables.product.product_name %} y que está disponible para exportarse, consulta las secciones "[Descargar el archivo de migración de un usuario](/rest/reference/migrations#download-a-user-migration-archive)" y "[Acerca del uso de {% data variables.product.product_name %} para tus datos](/articles/about-github-s-use-of-your-data). - -Cuando solicites una exportación de tus datos personales a través de los parámetros de {% data variables.product.prodname_dotcom_the_website %}, {% data variables.product.product_name %} comprime tus datos personales en un archivo `tar.gz` y te envía un correo electrónico a tu dirección principal de correo electrónico con un enlace de descarga. - -Por defecto, el enlace de descarga vence después de siete días. En cualquier momento previo a que venza el enlace de descarga, puedes habilitar el enlace desde los parámetros del usuario. Para obtener más información, consulta "[Eliminar el acceso a un archivo de datos de tu cuenta personal](/articles/requesting-an-archive-of-your-personal-account-s-data/#deleting-access-to-an-archive-of-your-personal-accounts-data)". - -Si tu sistema operativo no puede descomprimir el archivo `tar.gz` de forma nativa, puedes utilizar una herramienta de terceros para extraer los archivos archivados. Para obtener más información, consulta "[Cómo descomprimir un tar.gz file](https://opensource.com/article/17/7/how-unzip-targz-file)" en Opensource.com. - -El archivo `tar.gz` generado refleja los datos almacenados en el momento que comenzaste la exportación de datos. - -## Descargar un archivo de datos de tu cuenta personal - -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.account_settings %} -3. En "Export account data" (Exportar datos de cuenta), haz clic en **Start export** (Comenzar exportación) o **New export** (Nueva exportación). ![Botón Start personal data export (Comenzar exportación de datos personales) resaltado](/assets/images/help/repository/export-personal-data.png) ![Botón New personal data export (Nueva exportación de datos personales) resaltado](/assets/images/help/repository/new-export.png) -4. Una vez que la exportación esté lista para descargar, {% data variables.product.product_name %} te enviará un enlace de descarga a tu dirección principal de correo electrónico. -5. Haz clic en el enlace de descarga de tu correo electrónico y vuelve a ingresar tu contraseña, si se te solicita. -6. Serás redirigido a un archivo `tar.gz` que podrás descargar. - -## Eliminar acceso a un archivo de datos de tu cuenta personal - -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.account_settings %} -3. Para inhabilitar el enlace de descarga que se te envió al correo electrónico antes de que venza, en "Export account data" (Exportar datos de cuenta), encuentra la descarga de exportación de datos que quieres inhabilitar y haz clic en **Delete** (Eliminar). ![Botón Delete personal data export package (Eliminar paquete de exportación de datos personales) resaltado](/assets/images/help/repository/delete-export-personal-account-data.png) diff --git a/translations/es-ES/content/github/writing-on-github/editing-and-sharing-content-with-gists/creating-gists.md b/translations/es-ES/content/github/writing-on-github/editing-and-sharing-content-with-gists/creating-gists.md deleted file mode 100644 index 4a0474baad..0000000000 --- a/translations/es-ES/content/github/writing-on-github/editing-and-sharing-content-with-gists/creating-gists.md +++ /dev/null @@ -1,81 +0,0 @@ ---- -title: Crear gists -intro: 'Puedes crear dos tipos de gists: {% ifversion ghae %}internos{% else %}públicos{% endif %} y secretos. Crea un gist {% ifversion ghae %}interno{% else %}público{% endif %} si estás listo para compartir tus ideas con {% ifversion ghae %}los miembros de la emrpesa{% else %}el mundo{% endif %} o, de lo contrario, un gist secreto.' -permissions: '{% data reusables.enterprise-accounts.emu-permission-gist %}' -redirect_from: - - /articles/about-gists - - /articles/cannot-delete-an-anonymous-gist - - /articles/deleting-an-anonymous-gist - - /articles/creating-gists - - /github/writing-on-github/creating-gists -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' ---- - -## Acerca de los gists - -Todo gist es un repositorio Git, lo que significa que se puede bifurcar y clonar. {% ifversion not ghae %}Si iniciaste sesión en {% data variables.product.product_name %} cuando{% else %}Cuando{% endif %} creas un gist, este se asociará con tu cuenta y lo verás en tu lista de gists cuando navegues a tu {% data variables.gists.gist_homepage %}. - -Los gists pueden ser {% ifversion ghae %}internos{% else %}públicos{% endif %} o secretos. Los gists {% ifversion ghae %}internos{% else %}públicos{% endif %} se muestran en {% data variables.gists.discover_url %}, en donde {% ifversion ghae %}los miembros empresariales{% else %}las personas{% endif %} pueden buscar gists nuevos conforme estos se creen. También se los puede buscar, para que puedas usarlos si deseas que otras personas encuentren tu trabajo y lo vean. - -Los gists secretos no se muestran en {% data variables.gists.discover_url %} y no se pueden buscar. Los gists no son privados. Si envías la URL de un gist secreto a {% ifversion ghae %}otro miembro de la empresa{% else %}un amigo {% endif %}, podrán verlo. Sin embargo, si {% ifversion ghae %}cualquier otro miembro de la empresa{% else %}alguien que no conozcas{% endif %} descubre la URL, también podrán ver tu gist. Si deseas mantener tu código a salvo de las miradas curiosas, puedes optar por [crear un repositorio privado](/articles/creating-a-new-repository) en lugar de un gist. - -{% data reusables.gist.cannot-convert-public-gists-to-secret %} - -{% ifversion ghes %} - -Si el administrador de tu sitio ha inhabilitado el modo privado, también puedes usar gists anónimos, que pueden ser públicos o privados. - -{% data reusables.gist.anonymous-gists-cannot-be-deleted %} - -{% endif %} - -Recibirás una notificación si: -- Seas el autor de un gist. -- Alguien te mencione en un gist. -- Puedes suscribirte a un gist haciendo clic en **Suscribir** en la parte superior de cualquier gist. - -{% ifversion fpt or ghes or ghec %} - -Puedes fijar los gists a tu perfil para que otras personas los puedan ver fácilmente. Para obtener más información, consulta "[A nclar elementos a tu perfil](/articles/pinning-items-to-your-profile)". - -{% endif %} - -Puedes descubrir gists {% ifversion ghae %}internos{% else %}públicos{% endif %} que hayan creado otras personas si vas a la {% data variables.gists.gist_homepage %} y das clic en **Todos los gists**. Esto te llevará a una página en la que aparecen todos los gists clasificados y presentados por fecha de creación o actualización. También puedes buscar los gists por idioma con {% data variables.gists.gist_search_url %}. La búsqueda de gists usa la misma sintaxis de búsqueda que la [búsqueda de código](/search-github/searching-on-github/searching-code). - -Dado que los gists son repositorios Git, puedes ver su historial de confirmaciones completo, que incluye todas las diferencias que existan. También puedes bifurcar o clonar gists. Para obtener más información, consulta "[Bifurcar y clonar gists"](/articles/forking-and-cloning-gists). - -Puedes descargar un archivo ZIP de un gist haciendo clic en el botón **Descargar ZIP** en la parte superior del gist. Puedes insertar un gist en cualquier campo de texto compatible con Javascript, como una publicación en un blog. Para insertar el código, haz clic en el icono del portapapeles junto a la URL **Insertar** de un gist. Para insertar un archivo de gist específico, anexa la URL **Insertar** con `?file=FILENAME`. - -{% ifversion fpt or ghec %} - -Git admite la asignación de archivos GeoJSON. Estas asignaciones se muestran como gists insertos, para que las asignaciones se puedan compartir e insertar fácilmente. Para obtener más información, consulta la sección "[Trabajar con archivos que no sean de código](/repositories/working-with-files/using-files/working-with-non-code-files#mapping-geojson-files-on-github)". - -{% endif %} - -## Crear un gist - -Sigue estos pasos para crear un gist. - -{% ifversion fpt or ghes or ghae or ghec %} -{% note %} - -También puedes crear un gist si utilizas el {% data variables.product.prodname_cli %}. Para obtener más información, consulta "[`gh gist create`](https://cli.github.com/manual/gh_gist_create)" en el {% data variables.product.prodname_cli %}. - -Como alternativa, puedes arrastrar y soltar un archivo de texto desde tu escritorio directamente en el editor. - -{% endnote %} -{% endif %} - -1. Inicia sesión en {% data variables.product.product_name %}. -2. Dirígete a tu {% data variables.gists.gist_homepage %}. -3. Escribe una descripción opcional y un nombre para tu gist. ![Descripción del nombre del gist](/assets/images/help/gist/gist_name_description.png) - -4. Teclea el texto de tu gist en la caja de texto de este. ![Cuadro de texto para el gist](/assets/images/help/gist/gist_text_box.png) - -5. Opcionalmente, para crear un gist {% ifversion ghae %}interno{% else %}público{% endif %}, da clic en {% octicon "triangle-down" aria-label="The downwards triangle icon" %} y luego en **Crear gist {% ifversion ghae %}interno{% else %}público{% endif %}**. ![Menú desplegable para seleccionar la visibilidad de un gist]{% ifversion ghae %}(/assets/images/help/gist/gist-visibility-drop-down-ae.png){% else %}(/assets/images/help/gist/gist-visibility-drop-down.png){% endif %} - -6. Da clic en **Crear Gist Secreto** o en **Crear gist {% ifversion ghae %}interno{% else %}público{% endif %}**. ![Botón para crear gist](/assets/images/help/gist/create-secret-gist-button.png) diff --git a/translations/es-ES/content/github/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists.md b/translations/es-ES/content/github/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists.md deleted file mode 100644 index c71f320cdb..0000000000 --- a/translations/es-ES/content/github/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: Bifurcar y clonar gists -intro: 'Los gists son en realidad repositorios de Git, lo que significa que puedes bifurcar o clonar cualquier gist, aunque no seas el autor original. También puedes ver el historial completo de confirmaciones de un gist, incluidas las diferencias.' -permissions: '{% data reusables.enterprise-accounts.emu-permission-gist %}' -redirect_from: - - /articles/forking-and-cloning-gists - - /github/writing-on-github/forking-and-cloning-gists -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' ---- - -## Bifurcar gists - -Cada gist indica qué bifurcaciones tiene actividad, haciéndo más fácil el encontrar cambios interesantes de otras personas. - -![Bifurcaciones del gist](/assets/images/help/gist/gist_forks.png) - -## Clonar gists - -Si deseas hacer cambios locales en un gist y subirlos a la web, puedes clonar un gist y hacer confirmaciones de la misma manera que lo harías con cualquier repositorio de Git. Para obtener más información, consulta "[Clonar un repositorio](/articles/cloning-a-repository)". - -![Botón Clonar gist](/assets/images/help/gist/gist_clone_btn.png) - -## Ver el historial de confirmaciones de un gist - -Para ver el historial de confirmaciones completo de un gist, haz clic en la pestaña "Revisiones" en la parte superior de este. - -![Pestaña Revisiones de gist](/assets/images/help/gist/gist_revisions_tab.png) - -Verás el historial completo de confirmaciones del gist con sus diferencias. - -![Página de revisiones de gist](/assets/images/help/gist/gist_history.png) diff --git a/translations/es-ES/content/github/writing-on-github/editing-and-sharing-content-with-gists/index.md b/translations/es-ES/content/github/writing-on-github/editing-and-sharing-content-with-gists/index.md deleted file mode 100644 index cd1eadb86e..0000000000 --- a/translations/es-ES/content/github/writing-on-github/editing-and-sharing-content-with-gists/index.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: Editar y compartir contenido con gists -intro: '' -redirect_from: - - /categories/23/articles - - /categories/gists - - /articles/editing-and-sharing-content-with-gists -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -children: - - /creating-gists - - /forking-and-cloning-gists -shortTitle: Compartir el contenido con gists ---- - diff --git a/translations/es-ES/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/about-writing-and-formatting-on-github.md b/translations/es-ES/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/about-writing-and-formatting-on-github.md deleted file mode 100644 index 7436ea9f27..0000000000 --- a/translations/es-ES/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/about-writing-and-formatting-on-github.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: Acerca de escritura y formato en GitHub -intro: GitHub combina una sintáxis para el texto con formato llamado formato Markdown de GitHub con algunas características de escritura únicas. -redirect_from: - - /articles/about-writing-and-formatting-on-github - - /github/writing-on-github/about-writing-and-formatting-on-github -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -shortTitle: Escribir & formatear en GitHub ---- - -[Markdown](http://daringfireball.net/projects/markdown/) es una sintáxis fácil de leer y fácil de escribir para el texto simple con formato. - -Le hemos agregado alguna funcionalidad personalizada para crear el formato Markdown de {% data variables.product.prodname_dotcom %}, usado para dar formato a la prosa y al código en todo nuestro sitio. - -También puedes interactuar con otros usuarios en las solicitudes de extracción y las propuestas, usando funciones como [@menciones](/articles/basic-writing-and-formatting-syntax/#mentioning-people-and-teams), [propuesta y referencias PR](/articles/basic-writing-and-formatting-syntax/#referencing-issues-and-pull-requests) y [emoji](/articles/basic-writing-and-formatting-syntax/#using-emoji). - -## Barra de herramientas de formato de texto - -Cada campo de comentario en {% data variables.product.product_name %} contiene una barra de herramientas de formato de texto, lo que te permite dar formato a tu texto sin tener que aprender la sintáxis de Markdown. Además del formato de Markdown como la negrita y la cursiva y crear encabezados, enlaces y listados, la barra de herramientas incluye características específicas de {% data variables.product.product_name %}, como las @menciones, los listados de tareas y los enlaces a propuestas y solicitudes de extracción. - -{% if fixed-width-font-gfm-fields %} - -## Habilitar fuentes de ancho fijo en el editor - -Puedes habilitar las fuentes de ancho fijo en cada campo de comentario de {% data variables.product.product_name %}. Cada carácter en una fuente de ancho fijo o de monoespacio ocupa el mismo espacio horizontal, lo cual hace más fácil la edición de las estructuras de lenguaje de marcado, tales como tablas y fragmentos de código. - -![Captura de pantalla que muestra el campo de comentario de {% data variables.product.product_name %} con fuentes de ancho fijo habilitadas](/assets/images/help/writing/fixed-width-example.png) - -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.appearance-settings %} -1. Debajo de "Preferencia de fuente en el editor de lenguaje de marcado", selecciona **Utilizar una fuente de ancho fijo (monoespacio) al editar el lenguaje de marcado**. ![Captura de pantalla que muestra el campo de comentario de {% data variables.product.product_name %} con fuentes de ancho fijo habilitadas](/assets/images/help/writing/enable-fixed-width.png) - -{% endif %} - -## Leer más - -- [{% data variables.product.prodname_dotcom %} Especificaciones del formato Markdown](https://github.github.com/gfm/) -- [Sintaxis de escritura y formato básicos](/articles/basic-writing-and-formatting-syntax)" -- "[Trabajar con formato avanzado](/articles/working-with-advanced-formatting)" -- "[Dominar Markdown](https://guides.github.com/features/mastering-markdown/)" diff --git a/translations/es-ES/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md b/translations/es-ES/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md deleted file mode 100644 index f3c22ea38e..0000000000 --- a/translations/es-ES/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md +++ /dev/null @@ -1,342 +0,0 @@ ---- -title: Basic writing and formatting syntax -intro: Create sophisticated formatting for your prose and code on GitHub with simple syntax. -redirect_from: - - /articles/basic-writing-and-formatting-syntax - - /github/writing-on-github/basic-writing-and-formatting-syntax -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -shortTitle: Basic formatting syntax ---- -## Headings - -To create a heading, add one to six `#` symbols before your heading text. The number of `#` you use will determine the size of the heading. - -```markdown -# The largest heading -## The second largest heading -###### The smallest heading -``` - -![Rendered H1, H2, and H6 headings](/assets/images/help/writing/headings-rendered.png) - -## Styling text - -You can indicate emphasis with bold, italic, or strikethrough text in comment fields and `.md` files. - -| Style | Syntax | Keyboard shortcut | Example | Output | -| --- | --- | --- | --- | --- | -| Bold | `** **` or `__ __`| command/control + b | `**This is bold text**` | **This is bold text** | -| Italic | `* *` or `_ _`     | command/control + i | `*This text is italicized*` | *This text is italicized* | -| Strikethrough | `~~ ~~` | | `~~This was mistaken text~~` | ~~This was mistaken text~~ | -| Bold and nested italic | `** **` and `_ _` | | `**This text is _extremely_ important**` | **This text is _extremely_ important** | -| All bold and italic | `*** ***` | | `***All this text is important***` | ***All this text is important*** | - -## Quoting text - -You can quote text with a `>`. - -```markdown -Text that is not a quote - -> Text that is a quote -``` - -![Rendered quoted text](/assets/images/help/writing/quoted-text-rendered.png) - -{% tip %} - -**Tip:** When viewing a conversation, you can automatically quote text in a comment by highlighting the text, then typing `r`. You can quote an entire comment by clicking {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then **Quote reply**. For more information about keyboard shortcuts, see "[Keyboard shortcuts](/articles/keyboard-shortcuts/)." - -{% endtip %} - -## Quoting code - -You can call out code or a command within a sentence with single backticks. The text within the backticks will not be formatted.{% ifversion fpt or ghae or ghes > 3.1 or ghec %} You can also press the `command` or `Ctrl` + `e` keyboard shortcut to insert the backticks for a code block within a line of Markdown.{% endif %} - -```markdown -Use `git status` to list all new or modified files that haven't yet been committed. -``` - -![Rendered inline code block](/assets/images/help/writing/inline-code-rendered.png) - -To format code or text into its own distinct block, use triple backticks. - -
-Some basic Git commands are:
-```
-git status
-git add
-git commit
-```
-
- -![Rendered code block](/assets/images/help/writing/code-block-rendered.png) - -For more information, see "[Creating and highlighting code blocks](/articles/creating-and-highlighting-code-blocks)." - -{% data reusables.user_settings.enabling-fixed-width-fonts %} - -## Links - -You can create an inline link by wrapping link text in brackets `[ ]`, and then wrapping the URL in parentheses `( )`. {% ifversion fpt or ghae or ghes > 3.1 or ghec %}You can also use the keyboard shortcut `command + k` to create a link.{% endif %}{% ifversion fpt or ghae-issue-5434 or ghes > 3.3 or ghec %} When you have text selected, you can paste a URL from your clipboard to automatically create a link from the selection.{% endif %} - -`This site was built using [GitHub Pages](https://pages.github.com/).` - -![Rendered link](/assets/images/help/writing/link-rendered.png) - -{% tip %} - -**Tip:** {% data variables.product.product_name %} automatically creates links when valid URLs are written in a comment. For more information, see "[Autolinked references and URLs](/articles/autolinked-references-and-urls)." - -{% endtip %} - -## Section links - -{% data reusables.repositories.section-links %} - -## Relative links - -{% data reusables.repositories.relative-links %} - -## Images - -You can display an image by adding `!` and wrapping the alt text in`[ ]`. Then wrap the link for the image in parentheses `()`. - -`![This is an image](https://myoctocat.com/assets/images/base-octocat.svg)` - -![Rendered Image](/assets/images/help/writing/image-rendered.png) - -{% data variables.product.product_name %} supports embedding images into your issues, pull requests{% ifversion fpt or ghec %}, discussions{% endif %}, comments and `.md` files. You can display an image from your repository, add a link to an online image, or upload an image. For more information, see "[Uploading assets](#uploading-assets)." - -{% tip %} - -**Tip:** When you want to display an image which is in your repository, you should use relative links instead of absolute links. - -{% endtip %} - -Here are some examples for using relative links to display an image. - -| Context | Relative Link | -| ------ | -------- | -| In a `.md` file on the same branch | `/assets/images/electrocat.png` | -| In a `.md` file on another branch | `/../main/assets/images/electrocat.png` | -| In issues, pull requests and comments of the repository | `../blob/main/assets/images/electrocat.png` | -| In a `.md` file in another repository | `/../../../../github/docs/blob/main/assets/images/electrocat.png` | -| In issues, pull requests and comments of another repository | `../../../github/docs/blob/main/assets/images/electrocat.png?raw=true` | - -{% note %} - -**Note**: The last two relative links in the table above will work for images in a private repository only if the viewer has at least read access to the private repository which contains these images. - -{% endnote %} - -For more information, see "[Relative Links](#relative-links)." - -{% ifversion fpt or ghec or ghes > 3.3 or ghae-issue-5559 %} -### Specifying the theme an image is shown to - -You can specify the theme an image is displayed to by appending `#gh-dark-mode-only` or `#gh-light-mode-only` to the end of an image URL, in Markdown. - -We distinguish between light and dark color modes, so there are two options available. You can use these options to display images optimized for dark or light backgrounds. This is particularly helpful for transparent PNG images. - -| Context | URL | -|--------|--------| -| Dark Theme | `![GitHub Light](https://github.com/github-light.png#gh-dark-mode-only)` | -| Light Theme | `![GitHub Dark](https://github.com/github-dark.png#gh-light-mode-only)` | -{% endif %} - -## Lists - -You can make an unordered list by preceding one or more lines of text with `-` or `*`. - -```markdown -- George Washington -- John Adams -- Thomas Jefferson -``` - -![Rendered unordered list](/assets/images/help/writing/unordered-list-rendered.png) - -To order your list, precede each line with a number. - -```markdown -1. James Madison -2. James Monroe -3. John Quincy Adams -``` - -![Rendered ordered list](/assets/images/help/writing/ordered-list-rendered.png) - -### Nested Lists - -You can create a nested list by indenting one or more list items below another item. - -To create a nested list using the web editor on {% data variables.product.product_name %} or a text editor that uses a monospaced font, like [Atom](https://atom.io/), you can align your list visually. Type space characters in front of your nested list item, until the list marker character (`-` or `*`) lies directly below the first character of the text in the item above it. - -```markdown -1. First list item - - First nested list item - - Second nested list item -``` - -![Nested list with alignment highlighted](/assets/images/help/writing/nested-list-alignment.png) - -![List with two levels of nested items](/assets/images/help/writing/nested-list-example-1.png) - -To create a nested list in the comment editor on {% data variables.product.product_name %}, which doesn't use a monospaced font, you can look at the list item immediately above the nested list and count the number of characters that appear before the content of the item. Then type that number of space characters in front of the nested list item. - -In this example, you could add a nested list item under the list item `100. First list item` by indenting the nested list item a minimum of five spaces, since there are five characters (`100. `) before `First list item`. - -```markdown -100. First list item - - First nested list item -``` - -![List with a nested list item](/assets/images/help/writing/nested-list-example-3.png) - -You can create multiple levels of nested lists using the same method. For example, because the first nested list item has seven characters (`␣␣␣␣␣-␣`) before the nested list content `First nested list item`, you would need to indent the second nested list item by seven spaces. - -```markdown -100. First list item - - First nested list item - - Second nested list item -``` - -![List with two levels of nested items](/assets/images/help/writing/nested-list-example-2.png) - -For more examples, see the [GitHub Flavored Markdown Spec](https://github.github.com/gfm/#example-265). - -## Task lists - -{% data reusables.repositories.task-list-markdown %} - -If a task list item description begins with a parenthesis, you'll need to escape it with `\`: - -`- [ ] \(Optional) Open a followup issue` - -For more information, see "[About task lists](/articles/about-task-lists)." - -## Mentioning people and teams - -You can mention a person or [team](/articles/setting-up-teams/) on {% data variables.product.product_name %} by typing `@` plus their username or team name. This will trigger a notification and bring their attention to the conversation. People will also receive a notification if you edit a comment to mention their username or team name. For more information about notifications, see {% ifversion fpt or ghes or ghae or ghec %}"[About notifications](/github/managing-subscriptions-and-notifications-on-github/about-notifications){% else %}"[About notifications](/github/receiving-notifications-about-activity-on-github/about-notifications){% endif %}." - -`@github/support What do you think about these updates?` - -![Rendered @mention](/assets/images/help/writing/mention-rendered.png) - -When you mention a parent team, members of its child teams also receive notifications, simplifying communication with multiple groups of people. For more information, see "[About teams](/articles/about-teams)." - -Typing an `@` symbol will bring up a list of people or teams on a project. The list filters as you type, so once you find the name of the person or team you are looking for, you can use the arrow keys to select it and press either tab or enter to complete the name. For teams, enter the @organization/team-name and all members of that team will get subscribed to the conversation. - -The autocomplete results are restricted to repository collaborators and any other participants on the thread. - -## Referencing issues and pull requests - -You can bring up a list of suggested issues and pull requests within the repository by typing `#`. Type the issue or pull request number or title to filter the list, and then press either tab or enter to complete the highlighted result. - -For more information, see "[Autolinked references and URLs](/articles/autolinked-references-and-urls)." - -## Referencing external resources - -{% data reusables.repositories.autolink-references %} - -{% ifversion ghes < 3.4 %} -## Content attachments - -Some {% data variables.product.prodname_github_apps %} provide information in {% data variables.product.product_name %} for URLs that link to their registered domains. {% data variables.product.product_name %} renders the information provided by the app under the URL in the body or comment of an issue or pull request. - -![Content attachment](/assets/images/github-apps/content_reference_attachment.png) - -To see content attachments, you must have a {% data variables.product.prodname_github_app %} that uses the Content Attachments API installed on the repository.{% ifversion fpt or ghec %} For more information, see "[Installing an app in your personal account](/articles/installing-an-app-in-your-personal-account)" and "[Installing an app in your organization](/articles/installing-an-app-in-your-organization)."{% endif %} - -Content attachments will not be displayed for URLs that are part of a markdown link. - -For more information about building a {% data variables.product.prodname_github_app %} that uses content attachments, see "[Using Content Attachments](/apps/using-content-attachments)."{% endif %} - -## Uploading assets - -You can upload assets like images by dragging and dropping, selecting from a file browser, or pasting. You can upload assets to issues, pull requests, comments, and `.md` files in your repository. - -## Using emoji - -You can add emoji to your writing by typing `:EMOJICODE:`. - -`@octocat :+1: This PR looks great - it's ready to merge! :shipit:` - -![Rendered emoji](/assets/images/help/writing/emoji-rendered.png) - -Typing `:` will bring up a list of suggested emoji. The list will filter as you type, so once you find the emoji you're looking for, press **Tab** or **Enter** to complete the highlighted result. - -For a full list of available emoji and codes, check out [the Emoji-Cheat-Sheet](https://github.com/ikatyang/emoji-cheat-sheet/blob/master/README.md). - -## Paragraphs - -You can create a new paragraph by leaving a blank line between lines of text. - -{% ifversion fpt or ghae-issue-5180 or ghes > 3.2 or ghec %} -## Footnotes - -You can add footnotes to your content by using this bracket syntax: - -``` -Here is a simple footnote[^1]. - -A footnote can also have multiple lines[^2]. - -You can also use words, to fit your writing style more closely[^note]. - -[^1]: My reference. -[^2]: Every new line should be prefixed with 2 spaces. - This allows you to have a footnote with multiple lines. -[^note]: - Named footnotes will still render with numbers instead of the text but allow easier identification and linking. - This footnote also has been made with a different syntax using 4 spaces for new lines. -``` - -The footnote will render like this: - -![Rendered footnote](/assets/images/site/rendered-footnote.png) - -{% tip %} - -**Note**: The position of a footnote in your Markdown does not influence where the footnote will be rendered. You can write a footnote right after your reference to the footnote, and the footnote will still render at the bottom of the Markdown. - -{% endtip %} -{% endif %} - -## Hiding content with comments - -You can tell {% data variables.product.product_name %} to hide content from the rendered Markdown by placing the content in an HTML comment. - -
-<!-- This content will not appear in the rendered Markdown -->
-
- -## Ignoring Markdown formatting - -You can tell {% data variables.product.product_name %} to ignore (or escape) Markdown formatting by using `\` before the Markdown character. - -`Let's rename \*our-new-project\* to \*our-old-project\*.` - -![Rendered escaped character](/assets/images/help/writing/escaped-character-rendered.png) - -For more information, see Daring Fireball's "[Markdown Syntax](https://daringfireball.net/projects/markdown/syntax#backslash)." - -{% ifversion fpt or ghes > 3.2 or ghae-issue-5232 or ghec %} - -## Disabling Markdown rendering - -{% data reusables.repositories.disabling-markdown-rendering %} - -{% endif %} - -## Further reading - -- [{% data variables.product.prodname_dotcom %} Flavored Markdown Spec](https://github.github.com/gfm/) -- "[About writing and formatting on GitHub](/articles/about-writing-and-formatting-on-github)" -- "[Working with advanced formatting](/articles/working-with-advanced-formatting)" -- "[Mastering Markdown](https://guides.github.com/features/mastering-markdown/)" diff --git a/translations/es-ES/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/index.md b/translations/es-ES/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/index.md deleted file mode 100644 index 269c9a60e4..0000000000 --- a/translations/es-ES/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/index.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: Introducción a la escritura y el formato en GitHub -redirect_from: - - /articles/markdown-basics - - /articles/things-you-can-do-in-a-text-area-on-github - - /articles/getting-started-with-writing-and-formatting-on-github -intro: 'Puedes usar características simples para darles formato a tus comentarios e interactuar con otros en propuestas, solicitudes de extracción y wikis en GitHub.' -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -children: - - /about-writing-and-formatting-on-github - - /basic-writing-and-formatting-syntax -shortTitle: Comenzar a escribir en GitHub ---- - diff --git a/translations/es-ES/content/github/writing-on-github/index.md b/translations/es-ES/content/github/writing-on-github/index.md deleted file mode 100644 index 45e6e6b4bf..0000000000 --- a/translations/es-ES/content/github/writing-on-github/index.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -title: Escribir en GitHub -redirect_from: - - /categories/88/articles - - /articles/github-flavored-markdown - - /articles/writing-on-github - - /categories/writing-on-github -intro: 'Puedes estructurar la información que se comparte en {% data variables.product.product_name %} con varias opciones de formateo.' -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -children: - - /getting-started-with-writing-and-formatting-on-github - - /working-with-advanced-formatting - - /working-with-saved-replies - - /editing-and-sharing-content-with-gists ---- - diff --git a/translations/es-ES/content/github/writing-on-github/working-with-advanced-formatting/attaching-files.md b/translations/es-ES/content/github/writing-on-github/working-with-advanced-formatting/attaching-files.md deleted file mode 100644 index 7d547f5f81..0000000000 --- a/translations/es-ES/content/github/writing-on-github/working-with-advanced-formatting/attaching-files.md +++ /dev/null @@ -1,60 +0,0 @@ ---- -title: Adjuntar archivos -intro: Puedes transmitir información si adjuntas varios tipos de archivo a tus propuestas y solicitudes de cambio. -redirect_from: - - /github/managing-your-work-on-github/managing-your-work-with-issues-and-pull-requests/file-attachments-on-issues-and-pull-requests - - /articles/issue-attachments - - /articles/file-attachments-on-issues-and-pull-requests - - /github/managing-your-work-on-github/file-attachments-on-issues-and-pull-requests -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -topics: - - Pull requests ---- - -{% warning %} - -**Advertencia:** Si agregas una imagen {% ifversion fpt or ghes > 3.1 or ghae or ghec %} o video {% endif %} a un comentario de alguna propuesta o solicitud de cambios, cualquiera podrá ver la URL anonimizada sin autenticación, aún si la solicitud de cambios está en un repositorio privado{% ifversion ghes %}, o si se habilita el modo privado{% endif %}. Para mantener privados archivos de medios sensibles, estos se deben servir desde una red o servidor privados que requieran autenticación. {% ifversion fpt or ghec %}Para obtener más información sobre las URL anonimizadas, consulta la sección "[Acerca de las URL anonimizadas](/github/authenticating-to-github/about-anonymized-urls)".{% endif %} - -{% endwarning %} - -Para adjuntar un archivo a una propuesta o una conversación de una solicitud de extracción, arrástralo y suéltalo en el cuadro de comentarios. Como alternativa, puedes dar clic en la barra al final del recuadro de comentarios para buscar, seleccionar y agregar un archivo desde tu ordenador. - -![Seleccionar adjuntos desde el ordenador](/assets/images/help/pull_requests/select-bar.png) - -{% tip %} - -**Tip:** En varios buscadores, puedes copiar y pegar las imágenes directamente en el campo. - -{% endtip %} - -El tamaño máximo de archivo es: -- 10MB de imágenes y gifs{% ifversion fpt or ghec %} -- 10MB para videos que se suban a un repositorio que pertenezca a un usuario u organización en un plan gratuito de GitHub -- 100MB para videos que se suban a los repositorios que pertenezcan a un usuario u organización de un plan de pago de GitHub{% elsif fpt or ghes > 3.1 or ghae %} -- 100MB para videos{% endif %} -- 25MB para el resto de los archivos - -Archivos compatibles: - -* PNG (*.png*) -* GIF (*.gif*) -* JPEG (*.jpg*) -* Archivos de registro (*.log*) -* Documentos de Microsoft Word (*.docx*), Powerpoint (*.pptx*) y Excel (*.xlsx*) -* Archivos de texto (*.txt*) -* PDF (*.pdf*) -* ZIP (*.zip*, *.gz*){% ifversion fpt or ghes > 3.1 or ghae or ghec %} -* Video (*.mp4*, *.mov*) - -{% note %} - -**Nota:** La compatibilidad con los codecs de video es específica del buscador y es posible que un video que cargues en uno de los buscadores no se pueda ver en otro de ellos. Por el momento, recomendamos utilizar h.264 para una mejor compatibilidad. - -{% endnote %} -{% endif %} - -![GIF animados adjuntos](/assets/images/help/pull_requests/dragging_images.gif) diff --git a/translations/es-ES/content/github/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md b/translations/es-ES/content/github/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md deleted file mode 100644 index 3007314de5..0000000000 --- a/translations/es-ES/content/github/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md +++ /dev/null @@ -1,64 +0,0 @@ ---- -title: Referencias y direcciones URL autovinculadas -intro: 'Las referencias a las direcciones URL, propuestas, solicitudes de extracción y confirmaciones se acortan automáticamente y se convierten en vínculos.' -redirect_from: - - /articles/autolinked-references-and-urls - - /github/writing-on-github/autolinked-references-and-urls -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -shortTitle: Referencias auto-enlazadas ---- - -## Direcciones URL - -{% data variables.product.product_name %} automáticamente crea vínculos desde las direcciones URL estándar. - -`Visita https://github.com` - -![URL autovinculada presentada](/assets/images/help/writing/url-autolink-rendered.png) - -Para obtener información sobre cómo crear vínculos, consulta "[Sintaxis de escritura y formato básicos](/articles/basic-writing-and-formatting-syntax/#links)". - -## Propuestas y solicitudes de extracción - -Dentro de las conversaciones en {% data variables.product.product_name %}, las referencias a las propuestas y solicitudes de extracción se convierten automáticamente en vínculos acortados. - -{% note %} - -**Nota:** Las referencias autovinculadas no se crearon en páginas wikis o archivos en un repositorio. - -{% endnote %} - -| Tipo de referencia | Referencia en bruto | Vínculo acortado | -| --------------------------------------------------------------------------------------- | ---------------------------------------------- | ---------------------------------------------------------------------- | -| URL de propuesta o solicitud de extracción | https://github.com/jlord/sheetsee.js/issues/26 | [#26](https://github.com/jlord/sheetsee.js/issues/26) | -| `#` y número de propuesta o de solicitud de cambios | #26 | [#26](https://github.com/jlord/sheetsee.js/issues/26) | -| `GH` y número de propuesta y solicitud de extracción | GH-26 | [GH-26](https://github.com/jlord/sheetsee.js/issues/26) | -| `Nombre de usuario/N.º de repositorio` y número de propuesta o solicitud de extracción. | jlord/sheetsee.js#26 | [jlord/sheetsee.js#26](https://github.com/jlord/sheetsee.js/issues/26) | -| `Organization_name/Repository#` y número propuesta o solicitud de extracción | github/linguist#4039 | [github/linguist#4039](https://github.com/github/linguist/pull/4039) | - -{% ifversion fpt or ghec %} -Si referencias una propuesta, solicitud de cambios o debate en una lista, la referencia se desplegará para mostrar el título y el estado en su lugar. Para obtener más información acerca de las listas de tareas, consulta la sección "[Acerca de las listas de tareas](/issues/tracking-your-work-with-issues/creating-issues/about-task-lists)". -{% endif %} - -## Confirmar SHA - -Las referencias a un hash SHA de confirmación se convertirán automáticamente en enlaces acortados para la confirmación en {% data variables.product.product_name %}. - -| Tipo de referencia | Referencia en bruto | Vínculo acortado | -| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------- | -| URL de confirmación | [`https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e`](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | [a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | -| SHA | a5c3785ed8d6a35868bc169f07e40e889087fd2e | [a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | -| User@SHA | jlord@a5c3785ed8d6a35868bc169f07e40e889087fd2e | [jlord@a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | -| `Username/Repository@SHA` | `jlord/sheetsee.js@a5c3785ed8d6a35868bc169f07e40e889087fd2e` | [`jlord/sheetsee.js@a5c3785`](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | - -## Personalizar enlaces automáticos a recursos externos - -{% data reusables.repositories.autolink-references %} - -## Leer más - -- [Sintaxis de escritura y formato básicos](/articles/basic-writing-and-formatting-syntax)" diff --git a/translations/es-ES/content/github/writing-on-github/working-with-advanced-formatting/creating-a-permanent-link-to-a-code-snippet.md b/translations/es-ES/content/github/writing-on-github/working-with-advanced-formatting/creating-a-permanent-link-to-a-code-snippet.md deleted file mode 100644 index c1964ca388..0000000000 --- a/translations/es-ES/content/github/writing-on-github/working-with-advanced-formatting/creating-a-permanent-link-to-a-code-snippet.md +++ /dev/null @@ -1,49 +0,0 @@ ---- -title: Crear un enlace permanente a un fragmento de código -intro: Puedes crear un enlace permanente a una línea específica o a un rango de líneas de código en una versión específica de un archivo o de una solicitud de extracción. -redirect_from: - - /github/managing-your-work-on-github/managing-your-work-with-issues-and-pull-requests/creating-a-permanent-link-to-a-code-snippet - - /articles/creating-a-permanent-link-to-a-code-snippet - - /github/managing-your-work-on-github/creating-a-permanent-link-to-a-code-snippet -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -topics: - - Pull requests -shortTitle: Enlaces permanentes al código ---- - -## Vincular al código - -Este tipo de enlace permanente se presentará como un fragmento de código únicamente en el repositorio en el que se originó. En los demás repositorios, el fragmento de código de enlace permanente se presentará como una URL. - -![Fragmento de código que se presenta en un comentario](/assets/images/help/repository/rendered-code-snippet.png) - -{% tip %} - -**Sugerencia:** Para crear un enlace permanente para un archivo completo, consulta "[Obtener enlaces permanentes a los archivos](/articles/getting-permanent-links-to-files)". - -{% endtip %} - -{% data reusables.repositories.navigate-to-repo %} -2. Busca el código con el que deseas establecer el enlace: - - Para enlazar el código desde un archivo, dirígete hacia ese archivo. - - Para enlazar el código desde una solicitud de extracción, dirígete a la solicitud de extracción y haz clic en {% octicon "diff" aria-label="The file diff icon" %}**Archivos con cambios**. Luego, desplázate hasta el archivo que contiene el código que deseas incluir en tu comentario y haz clic en **Ver**. -{% data reusables.repositories.choose-line-or-range %} -4. A la izquierda de la línea o del rango de líneas, haz clic en {% octicon "kebab-horizontal" aria-label="The horizontal kebab octicon" %}. En el menú desplegable, haz clic en **Copiar enlace permanente**. ![Menú kebab con la opción de copiar un enlace permanente desde una línea seleccionada](/assets/images/help/repository/copy-permalink-specific-line.png) -5. Dirígete a la conversación en la que deseas enlazar el fragmento de código. -6. Pega tu enlace permanente en un comentario y haz clic en **Comentar**. ![Enlace permanente pegado en un comentario en el mismo repositorio](/assets/images/help/repository/code-snippet-permalink-in-comment.png) - -## Vincular al lenguaje de marcado - -Puedes vincular a líneas específicas en los archivos de lenguaje de marcado si cargas el archivo de lenguaje de marcado sin la interpretación de lenguaje de marcado. Para cargar un archivo de lenguaje de marcado sin interpretar, puedes utilizar el parámetro `?plain=1` al final de la url del archivo. Por ejemplo, `github.com///blob//README.md?plain=1`. - -Puedes vincular a una línea específica en el archivo de lenguaje de marcado de la misma forma en la que lo haces en el código. Anexa `#L` con el número o números de línea al final de la url. Por ejemplo, `github.com///blob//README.md?plain=1#L14` resaltará la línea 14 en el archivo README.md simple. - -## Leer más - -- [Crear una propuesta](/articles/creating-an-issue/)" -- "[Abrir una propuesta desde el código](/articles/opening-an-issue-from-code/)" -- "[Revisar los cambios en las solicitudes de extracción](/articles/reviewing-changes-in-pull-requests/)" diff --git a/translations/es-ES/content/github/writing-on-github/working-with-advanced-formatting/creating-and-highlighting-code-blocks.md b/translations/es-ES/content/github/writing-on-github/working-with-advanced-formatting/creating-and-highlighting-code-blocks.md deleted file mode 100644 index 5c19cd9632..0000000000 --- a/translations/es-ES/content/github/writing-on-github/working-with-advanced-formatting/creating-and-highlighting-code-blocks.md +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: Crear y resaltar bloques de código -intro: Compartir muestras de código con bloques de código cercados y habilitar el resaltado de la sintaxis -redirect_from: - - /articles/creating-and-highlighting-code-blocks - - /github/writing-on-github/creating-and-highlighting-code-blocks -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -shortTitle: Crear bloques de código ---- - -## Bloques de código cercados - -Puedes crear bloques de código cercados al colocar comillas simples triples \`\`\` antes y después del bloque de código. Te recomendamos dejar una línea en blanco antes y después de los bloques de código para facilitar la lectura del formato sin procesar. - -
-```
-function test() {
-  console.log("notice the blank line before this function?");
-}
-```
-
- -![Bloque de código cercado representado](/assets/images/help/writing/fenced-code-block-rendered.png) - -{% tip %} - -**Sugerencia:** Para preservar tu formato en una lista, asegúrate de dejar una sangría de ocho espacios para los bloques de código no cercados. - -{% endtip %} - -Para mostrar las comillas simples triples en un bloque de código cercado, enciérralas en comillas simples cuádruples. - - -
-```` 
-```
-Look! Puedes ver mis comillas inversas.
-```
-````
-
- -![Código cercado interpretado con un bloque de comillas inversas](/assets/images/help/writing/fenced-code-show-backticks-rendered.png) - -{% data reusables.user_settings.enabling-fixed-width-fonts %} - -## Resaltado de la sintaxis - - - -Puedes agregar un identificador opcional de idioma para habilitar el resaltado de la sintaxis en tu bloque de código cercado. - -Por ejemplo, para resaltar la sintaxis del código Ruby: - - ```ruby - require 'redcarpet' - markdown = Redcarpet.new("Hello World!") - puts markdown.to_html - puts markdown.to_html - ``` - -![Bloque de código cercado representado con sintaxis de Ruby resaltada](/assets/images/help/writing/code-block-syntax-highlighting-rendered.png) - -Usamos [Lingüista](https://github.com/github/linguist) para realizar la detección del idioma y seleccionar [gramáticas independientes](https://github.com/github/linguist/blob/master/vendor/README.md) para el resaltado de la sintaxis. Puedes conocer las palabra clave válidas en [el archivo YAML de idiomas](https://github.com/github/linguist/blob/master/lib/linguist/languages.yml). - -## Leer más - -- [{% data variables.product.prodname_dotcom %} Especificaciones del formato Markdown](https://github.github.com/gfm/) -- [Sintaxis de escritura y formato básicos](/articles/basic-writing-and-formatting-syntax)" diff --git a/translations/es-ES/content/github/writing-on-github/working-with-advanced-formatting/index.md b/translations/es-ES/content/github/writing-on-github/working-with-advanced-formatting/index.md deleted file mode 100644 index dc1cd1390e..0000000000 --- a/translations/es-ES/content/github/writing-on-github/working-with-advanced-formatting/index.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: Trabajar con formato avanzado -intro: 'Los formatos como tablas, resaltado de la sintaxis y enlace automático te permiten organizar la información compleja claramente en tus solicitudes de extracción, propuestas y comentarios.' -redirect_from: - - /articles/working-with-advanced-formatting -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -children: - - /organizing-information-with-tables - - /organizing-information-with-collapsed-sections - - /creating-and-highlighting-code-blocks - - /autolinked-references-and-urls - - /attaching-files - - /creating-a-permanent-link-to-a-code-snippet - - /using-keywords-in-issues-and-pull-requests -shortTitle: Trabajar con formato avanzado ---- - diff --git a/translations/es-ES/content/github/writing-on-github/working-with-advanced-formatting/organizing-information-with-collapsed-sections.md b/translations/es-ES/content/github/writing-on-github/working-with-advanced-formatting/organizing-information-with-collapsed-sections.md deleted file mode 100644 index 0f75b863bf..0000000000 --- a/translations/es-ES/content/github/writing-on-github/working-with-advanced-formatting/organizing-information-with-collapsed-sections.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Organizing information with collapsed sections -intro: You can streamline your Markdown by creating a collapsed section with the `
` tag. -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -shortTitle: Collapsed sections ---- - -## Creating a collapsed section - -You can temporarily obscure sections of your Markdown by creating a collapsed section that the reader can choose to expand. For example, when you want to include technical details in an issue comment that may not be relevant or interesting to every reader, you can put those details in a collapsed section. - -Any Markdown within the `
` block will be collapsed until the reader clicks {% octicon "triangle-right" aria-label="The right triange icon" %} to expand the details. Within the `
` block, use the `` tag to create a label to the right of {% octicon "triangle-right" aria-label="The right triange icon" %}. - -```markdown -
CLICK ME -

- -#### We can hide anything, even code! - - ```ruby - puts "Hello World" - ``` - -

```

- -The Markdown will be collapsed by default. - -![Rendered collapsed](/assets/images/help/writing/collapsed-section-view.png) - -After a reader clicks {% octicon "triangle-right" aria-label="The right triange icon" %}, the details are expanded. - -![Rendered open](/assets/images/help/writing/open-collapsed-section.png) - -## Leer más - -- [{% data variables.product.prodname_dotcom %} Especificaciones del formato Markdown](https://github.github.com/gfm/) -- [Sintaxis de escritura y formato básicos](/articles/basic-writing-and-formatting-syntax)" diff --git a/translations/es-ES/content/github/writing-on-github/working-with-advanced-formatting/organizing-information-with-tables.md b/translations/es-ES/content/github/writing-on-github/working-with-advanced-formatting/organizing-information-with-tables.md deleted file mode 100644 index 1b7b5022d1..0000000000 --- a/translations/es-ES/content/github/writing-on-github/working-with-advanced-formatting/organizing-information-with-tables.md +++ /dev/null @@ -1,82 +0,0 @@ ---- -title: Organizar la información en tablas -intro: 'Puedes construir tablas para organizar la información en comentarios, propuestas, solicitudes de extracción y wikis.' -redirect_from: - - /articles/organizing-information-with-tables - - /github/writing-on-github/organizing-information-with-tables -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -shortTitle: Datos organizados con tablas ---- - -## Crear una tabla - -Puede crear tablas con barras verticales `|` y guiones `-`. Los guiones se usan para crear el encabezado de cada columna, mientras que las barras verticales separan cada columna. Debes incluir una línea en blanco antes de tu tabla para que se representen correctamente. - -```markdown - -| Primer encabezado | Segundo encabezado | -| ------------- | ------------- | -| Contenido de la celda | Contenido de la celda | -| Contenido de la celda | Contenido de la celda | -``` - -![Tabla presentada](/assets/images/help/writing/table-basic-rendered.png) - -Las barras verticales en cada lado de la tabla son opcionales. - -Las celdas pueden variar en el ancho y no es necesario que estén perfectamente alineadas dentro de las columnas. Debe haber al menos tres guiones en cada columna de la línea de encabezamiento. - -```markdown -| Comando | Descripción | -| --- | --- | -| git status | Enumera todos los archivos nuevos o modificados | -| git diff | Muestra las diferencias de archivo que no han sido preparadas | -``` - -![Tabla presentada con ancho de celda variado](/assets/images/help/writing/table-varied-columns-rendered.png) - -{% data reusables.user_settings.enabling-fixed-width-fonts %} - -## Formatear el contenido dentro de tu tabla - -Puedes utilizar [formato](/articles/basic-writing-and-formatting-syntax) como enlaces, bloques de códigos insertados y el estilo de texto dentro de tu tabla: - -```markdown -| Comando | Descripción | -| --- | --- | -| `git status` | Enumera todos los archivos *nuevos o modificados* | -| `git diff` | Muestra las diferencias de archivo que **no han sido** preparadas | -``` - -![Tabla presentada con texto formateado](/assets/images/help/writing/table-inline-formatting-rendered.png) - -Puedes alinear el texto a la izquierda, la derecha o en el centro de una columna al incluir dos puntos `:` a la izquierda, la derecha, o en ambos lados de los guiones dentro de la línea de encabezamiento. - -```markdown -| Alineado a la izquierda | Alineado en el centro | Alineado a la derecha | -| :--- | :---: | ---: | -| git status | git status | git status | -| git diff | git diff | git diff | -``` - -![Tabla presentada con alineación de texto a la izquierda, a la derecha o al centro](/assets/images/help/writing/table-aligned-text-rendered.png) - -Para incluir una barra vertical `|` como contenido dentro de tu celda, utiliza una `\` antes de la barra: - -```markdown -| Nombre | Símbolo | -| --- | --- | -| Comilla simple | ` | -| Barra vertical | \| | -``` - -![Tabla presentada con una barra vertical liberada](/assets/images/help/writing/table-escaped-character-rendered.png) - -## Leer más - -- [{% data variables.product.prodname_dotcom %} Especificaciones del formato Markdown](https://github.github.com/gfm/) -- [Sintaxis de escritura y formato básicos](/articles/basic-writing-and-formatting-syntax)" diff --git a/translations/es-ES/content/github/writing-on-github/working-with-advanced-formatting/using-keywords-in-issues-and-pull-requests.md b/translations/es-ES/content/github/writing-on-github/working-with-advanced-formatting/using-keywords-in-issues-and-pull-requests.md deleted file mode 100644 index 0e68413a87..0000000000 --- a/translations/es-ES/content/github/writing-on-github/working-with-advanced-formatting/using-keywords-in-issues-and-pull-requests.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: Utilizar palabras clave en propuestas y solicitudes de cambio -intro: Utiliza las palabras clave para enlazar una propuesta y solicitud de cambios o para marcarlas como duplicadas. -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -topics: - - Issues - - Pull requests ---- - -## Vincular una solicitud de cambios a una propuesta - -Para enlazar una solicitud de cambios a una propuesta para{% ifversion fpt or ghes or ghae or ghec %} mostrar que una solución se encuentra en progreso y para{% endif %} cerrar la propuesta automáticamente cuando alguien fusiona la solicitud de cambios, teclea alguna de las siguientes palabras clave seguida de una referencia a la propuesta. Por ejemplo, `Closes #10` o `Fixes octo-org/octo-repo#100`. - -* close -* closes -* closed -* fix -* fixes -* fixed -* resolver -* resuelve -* resuelto - -Para obtener más información, consulta la sección "[Vincular una solicitud de extracción a un informe de problemas](/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue)". - -## Marcar una propuesta o solicitud de cambio como duplicada - -Para marcar una propuesta o solicitud de extracción como un duplicado, escribe "Duplicado de" seguido del número de propuesta o solicitud de extracción que se duplica en el cuerpo de un comentario nuevo. Para obtener más información, consulta la sección "[Marcar propuestas o solicitudes de cambio como duplicados](/issues/tracking-your-work-with-issues/marking-issues-or-pull-requests-as-a-duplicate)". diff --git a/translations/es-ES/content/github/writing-on-github/working-with-saved-replies/about-saved-replies.md b/translations/es-ES/content/github/writing-on-github/working-with-saved-replies/about-saved-replies.md deleted file mode 100644 index 02181b2bf3..0000000000 --- a/translations/es-ES/content/github/writing-on-github/working-with-saved-replies/about-saved-replies.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: Acerca de las respuestas guardadas -intro: Puedes usar una respuesta guardada para responder a una propuesta o una solicitud de extracción. -redirect_from: - - /articles/about-saved-replies - - /github/writing-on-github/about-saved-replies -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' ---- - -![Respuestas guardadas](/assets/images/help/settings/saved-replies.png) - -Las respuestas guardadas te permiten crear una respuesta reusable para las propuestas y las solicitudes de extracción. Ahorra tiempo creando una respuesta guardada para las respuestas que usas con mayor frecuencia. - -Una vez que has agregado una respuesta guardada, se puede usar tanto en las propuestas como en las solicitudes de extracción. Las respuestas guardadas están asociadas a tu cuenta de usuario. Una vez que son creadas, podrás usarlas en todos los repositorios y las organizaciones. - -Puedes crear un máximo de 100 respuestas guardadas. Si has alcanzado el límite máximo, puedes eliminar las respuestas guardadas que ya no usas o editar las respuestas guardadas existentes. - -También puedes usar la respuesta guardada "Duplicar propuesta" proporcionada por {% data variables.product.product_name %} para marcar una propuesta como un duplicado y hacerle un seguimiento con una propuesta similar. - -## Leer más - -- "[Crear una respuesta guardada](/articles/creating-a-saved-reply)" -- "[Usar respuestas guardadas](/articles/using-saved-replies)" -- "[Editar una respuesta guardada](/articles/editing-a-saved-reply)" -- "[Eliminar una respuesta guardada](/articles/deleting-a-saved-reply)" diff --git a/translations/es-ES/content/github/writing-on-github/working-with-saved-replies/creating-a-saved-reply.md b/translations/es-ES/content/github/writing-on-github/working-with-saved-replies/creating-a-saved-reply.md deleted file mode 100644 index 7932fad3b1..0000000000 --- a/translations/es-ES/content/github/writing-on-github/working-with-saved-replies/creating-a-saved-reply.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: Crear una respuesta guardada -intro: 'Si sueles agregar el mismo comentario una y otra vez, puedes crear una respuesta guardada.' -redirect_from: - - /articles/creating-a-saved-reply - - /github/writing-on-github/creating-a-saved-reply -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' ---- - -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.saved_replies %} -3. En "Agregar una respuesta guardada", agrega el título de tu respuesta guardada. ![Título de la respuesta guardada](/assets/images/help/settings/saved-replies-title.png) -4. En el campo "Escribir", agrega el contenido que deseas usar para la respuesta guardada. Para obtener más información acerca de la escritura en {% data variables.product.product_name %}, consulta "[Sintaxis de escritura y formato básicos](/articles/basic-writing-and-formatting-syntax)". ![Escribir una respuesta guardada](/assets/images/help/settings/saved-replies-settings-adding.png) -5. Para revisar tu respuesta, haz clic en **Vista previa**. ![Agregar una respuesta guardada](/assets/images/help/settings/saved-replies-preview.png) -6. Haz clic en **Agregar respuesta guardada**. ![Botón de "agregar respuesta guardada"](/assets/images/help/settings/saved-replies-add-button.png) - -## Leer más - -- "[Usar respuestas guardadas](/articles/using-saved-replies)" -- "[Editar una respuesta guardada](/articles/editing-a-saved-reply)" -- "[Eliminar una respuesta guardada](/articles/deleting-a-saved-reply)" diff --git a/translations/es-ES/content/github/writing-on-github/working-with-saved-replies/deleting-a-saved-reply.md b/translations/es-ES/content/github/writing-on-github/working-with-saved-replies/deleting-a-saved-reply.md deleted file mode 100644 index 6ec3a5e4e3..0000000000 --- a/translations/es-ES/content/github/writing-on-github/working-with-saved-replies/deleting-a-saved-reply.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: Eliminar una respuesta guardada -intro: 'Si adviertes que ya no usas una respuesta guardada, puedes eliminarla.' -redirect_from: - - /articles/deleting-a-saved-reply - - /github/writing-on-github/deleting-a-saved-reply -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' ---- - -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.saved_replies %} -3. En "Respuestas guardadas", junto a la respuesta guardada que deseas eliminar, haz clic en {% octicon "x" aria-label="The X" %}. - ![Eliminar respuesta guardada](/assets/images/help/settings/saved-replies-delete-existing.png) diff --git a/translations/es-ES/content/github/writing-on-github/working-with-saved-replies/editing-a-saved-reply.md b/translations/es-ES/content/github/writing-on-github/working-with-saved-replies/editing-a-saved-reply.md deleted file mode 100644 index b7cb99da6e..0000000000 --- a/translations/es-ES/content/github/writing-on-github/working-with-saved-replies/editing-a-saved-reply.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: Editar una respuesta guardada -intro: Puedes editar el título y el cuerpo de una respuesta guardada. -redirect_from: - - /articles/changing-a-saved-reply - - /articles/editing-a-saved-reply - - /github/writing-on-github/editing-a-saved-reply -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' ---- - -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.saved_replies %} -3. En "Respuestas guardadas", junto a la respuesta guardada que deseas editar, haz clic en {% octicon "pencil" aria-label="The pencil" %}. - ![Editar una respuesta guardada](/assets/images/help/settings/saved-replies-edit-existing.png) -4. En "Editar una respuesta guardada", puedes editar el título y el contenido de la respuesta guardada. ![Editar título y contenido](/assets/images/help/settings/saved-replies-edit-existing-content.png) -5. Haz clic en **Actualizar una respuesta guardada**. ![Actualizar una respuesta guardada](/assets/images/help/settings/saved-replies-save-edit.png) - -## Leer más - -- "[Crear una respuesta guardada](/articles/creating-a-saved-reply)" -- "[Eliminar una respuesta guardada](/articles/deleting-a-saved-reply)" -- "[Usar respuestas guardadas](/articles/using-saved-replies)" diff --git a/translations/es-ES/content/github/writing-on-github/working-with-saved-replies/index.md b/translations/es-ES/content/github/writing-on-github/working-with-saved-replies/index.md deleted file mode 100644 index c741926369..0000000000 --- a/translations/es-ES/content/github/writing-on-github/working-with-saved-replies/index.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: Trabajar con respuestas guardadas -intro: 'Para ahorrar tiempo y asegurarte de enviar un mensaje consistente, puedes agregar respuestas guardadas a las propuestas y los comentarios de la solicitud de extracción.' -redirect_from: - - /articles/working-with-saved-replies -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -children: - - /about-saved-replies - - /creating-a-saved-reply - - /editing-a-saved-reply - - /deleting-a-saved-reply - - /using-saved-replies -shortTitle: Trabaja con respuestas guardadas ---- - diff --git a/translations/es-ES/content/github/writing-on-github/working-with-saved-replies/using-saved-replies.md b/translations/es-ES/content/github/writing-on-github/working-with-saved-replies/using-saved-replies.md deleted file mode 100644 index 3bc71a36a3..0000000000 --- a/translations/es-ES/content/github/writing-on-github/working-with-saved-replies/using-saved-replies.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: Utilizar respuestas guardadas -intro: 'Cuando comentas una propuesta o solicitud de extracción, puedes agregar una respuesta guardada que ya hayas establecido. La respuesta guardada puede ser todo el comentario o, si quieres personalizarlo, puedes agregar o eliminar contenido.' -redirect_from: - - /articles/using-saved-replies - - /github/writing-on-github/using-saved-replies -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' ---- - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-issue-pr %} -2. Haz clic en la propuesta o solicitud de extracción deseada. -3. Para agregar una respuesta guardada, en el campo de comentarios, haz clic en {% octicon "reply" aria-label="The mail reply" %}. ![Botón Saved replies (Respuestas guardadas)](/assets/images/help/writing/saved-replies-button.png) -4. Desde la lista, selecciona la respuesta guardada que quieres agregar en el comentario. ![Respuestas guardadas](/assets/images/help/settings/saved-replies.png) - -{% tip %} - -**Tips:** -- Puedes utilizar un atajo del teclado para completar automáticamente el comentario con una respuesta guardada. Para obtener más información, consulta "[Atajos del teclado](/articles/keyboard-shortcuts/#comments)". -- Puedes filtrar la lista escribiendo el título de la respuesta guardada. - -{% endtip %} - -## Leer más - -- "[Crear una respuesta guardada](/articles/creating-a-saved-reply)" -- "[Editar una respuesta guardada](/articles/editing-a-saved-reply)" -- "[Eliminar una respuesta guardada](/articles/deleting-a-saved-reply)" diff --git a/translations/ja-JP/content/github/importing-your-projects-to-github/importing-source-code-to-github/about-github-importer.md b/translations/ja-JP/content/github/importing-your-projects-to-github/importing-source-code-to-github/about-github-importer.md deleted file mode 100644 index e9fd4a6459..0000000000 --- a/translations/ja-JP/content/github/importing-your-projects-to-github/importing-source-code-to-github/about-github-importer.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: GitHub Importerについて -intro: 'If you have source code in Subversion, Mercurial, Team Foundation Version Control (TFVC), or another Git repository, you can move it to GitHub using GitHub Importer.' -redirect_from: - - /articles/about-github-importer - - /github/importing-your-projects-to-github/about-github-importer -versions: - fpt: '*' - ghec: '*' ---- - -GitHub Importerは、コミットやリビジョン履歴を含めてソースコードリポジトリを素早くインポートしてくれます。 - -![リポジトリのインポートのgif](/assets/images/help/importer/github-importer.gif) - -インポートの間、インポート元のバージョン管理システムによって、リモートリポジトリでの認証、コミット作者の属性の更新、大きなファイルを持つリポジトリのインポート(あるいはGit Large File Storageを使いたくない場合は大きなファイルの削除)が行えます。 - -| インポートのアクション | Subversion | Mercurial | TFVC | Git | -|:--------------------------------------------------------------------------------- |:----------:|:---------:|:-----:|:-----:| -| リモートリポジトリでの認証 | **X** | **X** | **X** | **X** | -| [コミット作者の属性の更新](/articles/updating-commit-author-attribution-with-github-importer) | **X** | **X** | **X** | | -| 大きなファイルの[Git Large File Storage](/articles/about-git-large-file-storage)への移動 | **X** | **X** | **X** | | -| リポジトリからの大きなファイルの削除 | **X** | **X** | **X** | | - -## 参考リンク - -- [GitHub Importerでのリポジトリのインポート](/articles/importing-a-repository-with-github-importer) -- [GitHub Importerでのコミット作者の属性の更新](/articles/updating-commit-author-attribution-with-github-importer) -- [コマンドラインを使ったGitリポジトリのインポート](/articles/importing-a-git-repository-using-the-command-line) -- [ソースコードの移行ツール](/articles/source-code-migration-tools) diff --git a/translations/ja-JP/content/github/importing-your-projects-to-github/importing-source-code-to-github/adding-an-existing-project-to-github-using-the-command-line.md b/translations/ja-JP/content/github/importing-your-projects-to-github/importing-source-code-to-github/adding-an-existing-project-to-github-using-the-command-line.md deleted file mode 100644 index 44be668a86..0000000000 --- a/translations/ja-JP/content/github/importing-your-projects-to-github/importing-source-code-to-github/adding-an-existing-project-to-github-using-the-command-line.md +++ /dev/null @@ -1,158 +0,0 @@ ---- -title: コマンドラインを使った GitHub への既存のプロジェクトの追加 -intro: '既存の作業を {% data variables.product.product_name %}に置けば、多くの素晴らしい方法で共有とコラボレーションができます。' -redirect_from: - - /articles/add-an-existing-project-to-github - - /articles/adding-an-existing-project-to-github-using-the-command-line - - /github/importing-your-projects-to-github/adding-an-existing-project-to-github-using-the-command-line -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -shortTitle: Add a project locally ---- - -## About adding existing projects to {% data variables.product.product_name %} - -{% tip %} - -**ヒント:** ポイントアンドクリック型のユーザインターフェースに慣れている場合は、プロジェクトを {% data variables.product.prodname_desktop %}で追加してみてください。 詳しい情報については *{% data variables.product.prodname_desktop %}ヘルプ* 中の[ローカルコンピュータから GitHub Desktop へのリポジトリの追加](/desktop/guides/contributing-to-projects/adding-a-repository-from-your-local-computer-to-github-desktop)を参照してください。 - -{% endtip %} - -{% data reusables.repositories.sensitive-info-warning %} - -## Adding a project to {% data variables.product.product_name %} with {% data variables.product.prodname_cli %} - -{% data variables.product.prodname_cli %} は、コンピューターのコマンドラインから {% data variables.product.prodname_dotcom %} を使用するためのオープンソースツールです。 {% data variables.product.prodname_cli %} can simplify the process of adding an existing project to {% data variables.product.product_name %} using the command line. To learn more about {% data variables.product.prodname_cli %}, see "[About {% data variables.product.prodname_cli %}](/github-cli/github-cli/about-github-cli)." - -1. In the command line, navigate to the root directory of your project. -1. ローカルディレクトリを Git リポジトリとして初期化します。 - - ```shell - git init -b main - ``` - -1. Stage and commit all the files in your project - - ```shell - git add . && git commit -m "initial commit" - ``` - -1. To create a repository for your project on GitHub, use the `gh repo create` subcommand. When prompted, select **Push an existing local repository to GitHub** and enter the desired name for your repository. If you want your project to belong to an organization instead of your user account, specify the organization name and project name with `organization-name/project-name`. - -1. Follow the interactive prompts. To add the remote and push the repository, confirm yes when asked to add the remote and push the commits to the current branch. - -1. Alternatively, to skip all the prompts, supply the path to the repository with the `--source` flag and pass a visibility flag (`--public`, `--private`, or `--internal`). For example, `gh repo create --source=. --public`. Specify a remote with the `--remote` flag. To push your commits, pass the `--push` flag. For more information about possible arguments, see the [GitHub CLI manual](https://cli.github.com/manual/gh_repo_create). - -## Adding a project to {% data variables.product.product_name %} without {% data variables.product.prodname_cli %} - -{% mac %} - -1. {% data variables.product.product_location %}上で[新しいリポジトリを作成](/repositories/creating-and-managing-repositories/creating-a-new-repository)します。 エラーを避けるため、新しいリポジトリは*README*、ライセンス、あるいは `gitignore` で初期化しないでください。 これらのファイルは、プロジェクトを {% data variables.product.product_name %}にプッシュした後で追加できます。 ![[Create New Repository] ドロップダウン](/assets/images/help/repository/repo-create.png) -{% data reusables.command_line.open_the_multi_os_terminal %} -3. ワーキングディレクトリをローカルプロジェクトに変更します。 -4. ローカルディレクトリを Git リポジトリとして初期化します。 - ```shell - $ git init -b main - ``` -5. ファイルを新しいローカルリポジトリに追加します。 これで、それらのファイルが最初のコミットに備えてステージングされます。 - ```shell - $ git add . - # ローカルリポジトリにファイルを追加し、コミットに備えてステージします。 {% data reusables.git.unstage-codeblock %} - ``` -6. ローカルリポジトリでステージングしたファイルをコミットします。 - ```shell - $ git commit -m "First commit" - # 追跡された変更をコミットし、リモートリポジトリへのプッシュに備えます。 {% data reusables.git.reset-head-to-previous-commit-codeblock %} - ``` -7. At the top of your repository on {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %}'s Quick Setup page, click {% octicon "clippy" aria-label="The copy to clipboard icon" %} to copy the remote repository URL. ![リモートリポジトリの URL フィールドのコピー](/assets/images/help/repository/copy-remote-repository-url-quick-setup.png) -8. ターミナルで、ローカルリポジトリがプッシュされる[リモートリポジトリの URL を追加](/github/getting-started-with-github/managing-remote-repositories)してください。 - ```shell - $ git remote add origin <REMOTE_URL> - # 新しいリモートを設定する - $ git remote -v - # 新しいリモート URL を検証する - ``` -9. {% data variables.product.product_location %} へ、ローカルリポジトリの[変更をプッシュ](/github/getting-started-with-github/pushing-commits-to-a-remote-repository/)します。 - ```shell - $ git push -u origin main - # ローカルリポジトリの変更を、origin として指定したリモートリポジトリにプッシュする - ``` - -{% endmac %} - -{% windows %} - -1. {% data variables.product.product_location %}上で[新しいリポジトリを作成](/articles/creating-a-new-repository)します。 エラーを避けるため、新しいリポジトリは*README*、ライセンス、あるいは `gitignore` で初期化しないでください。 これらのファイルは、プロジェクトを {% data variables.product.product_name %}にプッシュした後で追加できます。 ![[Create New Repository] ドロップダウン](/assets/images/help/repository/repo-create.png) -{% data reusables.command_line.open_the_multi_os_terminal %} -3. ワーキングディレクトリをローカルプロジェクトに変更します。 -4. ローカルディレクトリを Git リポジトリとして初期化します。 - ```shell - $ git init -b main - ``` -5. ファイルを新しいローカルリポジトリに追加します。 これで、それらのファイルが最初のコミットに備えてステージングされます。 - ```shell - $ git add . - # ローカルリポジトリにファイルを追加し、コミットに備えてステージします。 {% data reusables.git.unstage-codeblock %} - ``` -6. ローカルリポジトリでステージングしたファイルをコミットします。 - ```shell - $ git commit -m "First commit" - # 追跡された変更をコミットし、リモートリポジトリへのプッシュに備えます。 {% data reusables.git.reset-head-to-previous-commit-codeblock %} - ``` -7. At the top of your repository on {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %}'s Quick Setup page, click {% octicon "clippy" aria-label="The copy to clipboard icon" %} to copy the remote repository URL. ![リモートリポジトリの URL フィールドのコピー](/assets/images/help/repository/copy-remote-repository-url-quick-setup.png) -8. コマンドプロンプトで、ローカルリポジトリのプッシュ先となる[リモートリポジトリの URL を追加](/github/getting-started-with-github/managing-remote-repositories)します。 - ```shell - $ git remote add origin <REMOTE_URL> - # 新しいリモートを設定する - $ git remote -v - # 新しいリモート URL を検証する - ``` -9. {% data variables.product.product_location %} へ、ローカルリポジトリの[変更をプッシュ](/github/getting-started-with-github/pushing-commits-to-a-remote-repository/)します。 - ```shell - $ git push origin main - # ローカルリポジトリの変更を、origin として指定したリモートリポジトリにプッシュする - ``` - -{% endwindows %} - -{% linux %} - -1. {% data variables.product.product_location %}上で[新しいリポジトリを作成](/articles/creating-a-new-repository)します。 エラーを避けるため、新しいリポジトリは*README*、ライセンス、あるいは `gitignore` で初期化しないでください。 これらのファイルは、プロジェクトを {% data variables.product.product_name %}にプッシュした後で追加できます。 ![[Create New Repository] ドロップダウン](/assets/images/help/repository/repo-create.png) -{% data reusables.command_line.open_the_multi_os_terminal %} -3. ワーキングディレクトリをローカルプロジェクトに変更します。 -4. ローカルディレクトリを Git リポジトリとして初期化します。 - ```shell - $ git init -b main - ``` -5. ファイルを新しいローカルリポジトリに追加します。 これで、それらのファイルが最初のコミットに備えてステージングされます。 - ```shell - $ git add . - # ローカルリポジトリにファイルを追加し、コミットに備えてステージします。 {% data reusables.git.unstage-codeblock %} - ``` -6. ローカルリポジトリでステージングしたファイルをコミットします。 - ```shell - $ git commit -m "First commit" - # 追跡された変更をコミットし、リモートリポジトリへのプッシュに備えます。 {% data reusables.git.reset-head-to-previous-commit-codeblock %} - ``` -7. At the top of your repository on {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %}'s Quick Setup page, click {% octicon "clippy" aria-label="The copy to clipboard icon" %} to copy the remote repository URL. ![リモートリポジトリの URL フィールドのコピー](/assets/images/help/repository/copy-remote-repository-url-quick-setup.png) -8. ターミナルで、ローカルリポジトリがプッシュされる[リモートリポジトリの URL を追加](/github/getting-started-with-github/managing-remote-repositories)してください。 - ```shell - $ git remote add origin <REMOTE_URL> - # 新しいリモートを設定する - $ git remote -v - # 新しいリモート URL を検証する - ``` -9. {% data variables.product.product_location %} へ、ローカルリポジトリの[変更をプッシュ](/github/getting-started-with-github/pushing-commits-to-a-remote-repository/)します。 - ```shell - $ git push origin main - # ローカルリポジトリの変更を、origin として指定したリモートリポジトリにプッシュする - ``` - -{% endlinux %} - -## 参考リンク - -- [リポジトリへのファイルの追加](/repositories/working-with-files/managing-files/adding-a-file-to-a-repository#adding-a-file-to-a-repository-using-the-command-line) diff --git a/translations/ja-JP/content/github/importing-your-projects-to-github/importing-source-code-to-github/importing-a-git-repository-using-the-command-line.md b/translations/ja-JP/content/github/importing-your-projects-to-github/importing-source-code-to-github/importing-a-git-repository-using-the-command-line.md deleted file mode 100644 index d14cc3081d..0000000000 --- a/translations/ja-JP/content/github/importing-your-projects-to-github/importing-source-code-to-github/importing-a-git-repository-using-the-command-line.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: コマンドラインを使った Git リポジトリのインポート -intro: '{% ifversion fpt %} 既存のコードがプライベートネットワークでホストされている場合など、[GitHub Importer](/articles/importing-a-repository-with-github-importer) が目的に適さない場合は、コマンドラインを使用してインポートすることをお勧めします。{% else %}コマンドラインを使用して Git プロジェクトをインポートすることは、既存のコードがプライベートネットワークでホストされている場合に適しています。{% endif %}' -redirect_from: - - /articles/importing-a-git-repository-using-the-command-line - - /github/importing-your-projects-to-github/importing-a-git-repository-using-the-command-line -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -shortTitle: Import repo locally ---- - -始める前に、以下をご確認ください: - -- お使いの {% data variables.product.product_name %}ユーザ名 -- 外部リポジトリのクローン URL。`https://external-host.com/user/repo.git`、`git://external-host.com/user/repo.git` など (ドメイン名 `external-host.com` の前に `user@` が付く場合もあります)。 - -{% tip %} - -デモでは、以下の情報を使用します: - -- 外部アカウント名 **extuser** -- 外部 Git ホスト `https://external-host.com` -- {% data variables.product.product_name %} の個人ユーザ アカウント **ghuser** -- A repository on {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %} named **repo.git** - -{% endtip %} - -1. [{% data variables.product.product_name %} に新しいリポジトリを作成](/articles/creating-a-new-repository)します。 この新しいリポジトリに、外部 Git リポジトリをインポートします。 -2. コマンドラインで、外部クローン URL を使用して、リポジトリの "ベア" クローンを作成します。 これはデータの完全なコピーですが、ファイル編集のためのワーキングディレクトリはコピーされず、古いデータすべてのクリーンな新しいエクスポートが作成されます。 - ```shell - $ git clone --bare https://external-host.com/extuser/repo.git - # ローカル リポジトリに、外部リポジトリのベア クローンを作成 - ``` -3. "mirror" オプションを使用して、ローカルにクローンされたリポジトリを {% data variables.product.product_name %} にプッシュします。インポートされたリポジトリには、ブランチやタグなどすべての参照がコピーされます。 - ```shell - $ cd repo.git - $ git push --mirror https://{% data variables.command_line.codeblock %}/ghuser/repo.git - # Pushes the mirror to the new repository on {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %} - ``` -4. 一時ローカル リポジトリを削除します。 - ```shell - $ cd .. - $ rm -rf repo.git - ``` diff --git a/translations/ja-JP/content/github/importing-your-projects-to-github/importing-source-code-to-github/importing-a-repository-with-github-importer.md b/translations/ja-JP/content/github/importing-your-projects-to-github/importing-source-code-to-github/importing-a-repository-with-github-importer.md deleted file mode 100644 index 259ed02777..0000000000 --- a/translations/ja-JP/content/github/importing-your-projects-to-github/importing-source-code-to-github/importing-a-repository-with-github-importer.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: GitHub Importer でリポジトリをインポートする -intro: 他のバージョン管理システムにホストされているプロジェクトがある場合は、GitHub Importer ツールを使って自動的に GitHub にインポートすることができます。 -redirect_from: - - /articles/importing-from-other-version-control-systems-to-github - - /articles/importing-a-repository-with-github-importer - - /github/importing-your-projects-to-github/importing-a-repository-with-github-importer -versions: - fpt: '*' - ghec: '*' -shortTitle: Use GitHub Importer ---- - -{% tip %} - -**ヒント:** GitHub Importer は、すべてのインポートに適しているわけではありません。 たとえば、既存のコードがプライベート ネットワークにホストされている場合、GitHub Importer はそれにアクセスできません。 このような場合、Git リポジトリであれば[コマンドラインを使用したインポート](/articles/importing-a-git-repository-using-the-command-line)、他のバージョン管理システムからインポートするプロジェクトであれば外部の[ソース コード移行ツール](/articles/source-code-migration-tools)をおすすめします。 - -{% endtip %} - -インポート中に、自分のリポジトリでのコミットを作者の GitHub ユーザ アカウントに一致させたい場合は、インポートを始める前に、リポジトリのコントリビューター全員が GitHub アカウントを持っていることを確認してください。 - -{% data reusables.repositories.repo-size-limit %} - -1. ページの右上角で {% octicon "plus" aria-label="Plus symbol" %} をクリックし、[**Import repository**] を選択します。 ![[New repository] メニューの [Import repository] オプション](/assets/images/help/importer/import-repository.png) -2. [Your old repository's clone URL] に、インポートするプロジェクトの URL を入力します。 ![インポートするリポジトリの URL を入力するテキスト フィールド](/assets/images/help/importer/import-url.png) -3. 自分のユーザ アカウント、またはリポジトリを所有する組織を選択し、GitHub 上のリポジトリの名前を入力します。 ![リポジトリの [Owner] メニューと、リポジトリ名フィールド](/assets/images/help/importer/import-repo-owner-name.png) -4. 新しいリポジトリを*パブリック*にするか*プライベート*にするかを指定します。 詳細は「[リポジトリの可視性を設定する](/articles/setting-repository-visibility)」を参照してください。 ![リポジトリの [Public] と [Private] を選択するラジオ ボタン](/assets/images/help/importer/import-public-or-private.png) -5. 入力した情報を確認し、[**Begin import**] をクリックします。 ![[Begin import] ボタン](/assets/images/help/importer/begin-import-button.png) -6. 既存のプロジェクトがパスワードで保護されている場合は、必要なログイン情報を入力して [**Submit**] をクリックします。 ![パスワード保護されているプロジェクトのパスワード入力フォームと [Submit] ボタン](/assets/images/help/importer/submit-old-credentials-importer.png) -7. 既存のプロジェクトのクローン URL で複数のプロジェクトがホストされいる場合は、インポートしたいプロジェクトを選択して [**Submit**] をクリックします。 ![インポートするプロジェクトのリストと [Submit] ボタン](/assets/images/help/importer/choose-project-importer.png) -8. プロジェクトに 100 MB を超えるファイルがある場合は、[Git Large File Storage](/articles/versioning-large-files) を使用して大きいファイルをインポートするかどうかを選択し、[**Continue**] をクリックします。 ![[Git Large File Storage] メニューと [Continue] ボタン](/assets/images/help/importer/select-gitlfs-importer.png) - -リポジトリのインポートが完了すると、メールが届きます。 - -## 参考リンク - -- [GitHub Importerでのコミット作者の属性の更新](/articles/updating-commit-author-attribution-with-github-importer) diff --git a/translations/ja-JP/content/github/importing-your-projects-to-github/importing-source-code-to-github/index.md b/translations/ja-JP/content/github/importing-your-projects-to-github/importing-source-code-to-github/index.md deleted file mode 100644 index 44e973bbd7..0000000000 --- a/translations/ja-JP/content/github/importing-your-projects-to-github/importing-source-code-to-github/index.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: GitHub にソースコードをインポートする -intro: 'リポジトリは、{% ifversion fpt %}GitHub Importer、コマンドライン、{% else %}コマンドライン{% endif %}、または外部移行ツールを使用して GitHub にインポートできます。' -redirect_from: - - /articles/importing-an-external-git-repository - - /articles/importing-from-bitbucket - - /articles/importing-an-external-git-repo - - /articles/importing-your-project-to-github - - /articles/importing-source-code-to-github -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -children: - - /about-github-importer - - /importing-a-repository-with-github-importer - - /updating-commit-author-attribution-with-github-importer - - /importing-a-git-repository-using-the-command-line - - /adding-an-existing-project-to-github-using-the-command-line - - /source-code-migration-tools -shortTitle: Import code to GitHub ---- - diff --git a/translations/ja-JP/content/github/importing-your-projects-to-github/importing-source-code-to-github/source-code-migration-tools.md b/translations/ja-JP/content/github/importing-your-projects-to-github/importing-source-code-to-github/source-code-migration-tools.md deleted file mode 100644 index 607b49a648..0000000000 --- a/translations/ja-JP/content/github/importing-your-projects-to-github/importing-source-code-to-github/source-code-migration-tools.md +++ /dev/null @@ -1,58 +0,0 @@ ---- -title: ソースコード移行ツール -intro: 外部ツールを使って、プロジェクトを GitHub に移動できます。 -redirect_from: - - /articles/importing-from-subversion - - /articles/source-code-migration-tools - - /github/importing-your-projects-to-github/source-code-migration-tools -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -shortTitle: Code migration tools ---- - -{% ifversion fpt or ghec %} - -We recommend using [GitHub Importer](/articles/about-github-importer) to import projects from Subversion, Mercurial, Team Foundation Version Control (TFVC), or another Git repository. これらの外部ツールを使って、プロジェクトを Git に変換することもできます。 - -{% endif %} - -## Subversion からインポートする - -一般的な Subversion の環境では、複数のプロジェクトが単一のルートリポジトリに保管されます。 GitHub 上では、一般的に、それぞれのプロジェクトはユーザアカウントや Organization の別々の Git リポジトリにマップします。 次の場合、Subversion リポジトリのそれぞれの部分を別々の GitHub リポジトリにインポートすることをおすすめします。 - -* コラボレーターが、他の部分とは別のプロジェクトの部分をチェックアウトまたはコミットする必要がある場合 -* それぞれの部分にアクセス許可を設定したい場合 - -Subversion リポジトリを Git にコンバートするには、これらのツールをおすすめします: - -- [`git-svn`](https://git-scm.com/docs/git-svn) -- [svn2git](https://github.com/nirvdrum/svn2git) - -## Mercurial からインポートする - -Mercurial リポジトリを Git にコンバートするには、 [hg-fast-export](https://github.com/frej/fast-export) をおすすめします。 - -## Importing from TFVC - -We recommend [git-tfs](https://github.com/git-tfs/git-tfs) for moving changes between TFVC and Git. - -For more information about moving from TFVC (a centralized version control system) to Git, see "[Plan your Migration to Git](https://docs.microsoft.com/devops/develop/git/centralized-to-git)" from the Microsoft docs site. - -{% tip %} - -**参考:** Git へのプロジェクトの変換が完了した後、[{% data variables.product.prodname_dotcom %} にプッシュできます。](/github/getting-started-with-github/pushing-commits-to-a-remote-repository/) - -{% endtip %} - -{% ifversion fpt or ghec %} - -## 参考リンク - -- 「[GitHub Importer について](/articles/about-github-importer)」 -- [GitHub Importerでのリポジトリのインポート](/articles/importing-a-repository-with-github-importer) -- [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}) - -{% endif %} diff --git a/translations/ja-JP/content/github/importing-your-projects-to-github/importing-source-code-to-github/updating-commit-author-attribution-with-github-importer.md b/translations/ja-JP/content/github/importing-your-projects-to-github/importing-source-code-to-github/updating-commit-author-attribution-with-github-importer.md deleted file mode 100644 index 706e6174ce..0000000000 --- a/translations/ja-JP/content/github/importing-your-projects-to-github/importing-source-code-to-github/updating-commit-author-attribution-with-github-importer.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: GitHub Importer でコミット作者属性を更新する -intro: インポートの間、コミット作者の GitHub アカウントのリポジトリのコミットにマッチングできます。 -redirect_from: - - /articles/updating-commit-author-attribution-with-github-importer - - /github/importing-your-projects-to-github/updating-commit-author-attribution-with-github-importer -versions: - fpt: '*' - ghec: '*' -shortTitle: Update author GitHub Importer ---- - -GitHub Importer は、インポートしているリポジトリのコミット作者のメールアドレスにマッチする GitHub ユーザを探します。 次に、お客様は、そのメールアドレスまたは作者の GitHub ユーザ名を使って、コミットをその作者に接続することができます。 - -## コミット作者を更新する - -1. リポジトリをインポートした後、インポートステータスページで [**Match authors**] をクリックします。 ![[Match authors] ボタン](/assets/images/help/importer/match-authors-button.png) -2. 更新したい情報のある作者の横にある [**Connect**] をクリックします。 ![コミット作者のリスト](/assets/images/help/importer/connect-commit-author.png) -3. 作者のメールアドレスまたは GitHub ユーザ名を入力し、**Enter** を押します。 - -## パブリックメールアドレスのある GitHub ユーザにコミットを属させる - -あなたがインポートしたリポジトリのコミット作者が、コミットを作成するのに使用したメールアドレスと関連する GitHub アカウントを持っている場合、かつ、[そのコミットメールアドレスをプライベートに設定](/articles/setting-your-commit-email-address)していない場合、GitHub Importer は、GitHub アカウントに関連付けられているパブリックメールアドレスを、コミットに関連付けられているメールアドレスにマッチングし、そのコミットを GitHub アカウントに属性付けします。 - -## パブリックメールアドレスのない GitHub ユーザにコミットを属させる - -あなたがインポートしたリポジトリのコミット作者が、GitHub プロフィールでパブリックメールアドレスを設定しておらず、かつ、[コミットメールアドレスをプライベートに設定](/articles/setting-your-commit-email-address)していない場合、GitHub Importer は、GitHub アカウントを、コミットに関連付けられているメールアドレスにマッチングできない場合があります。 - -このことを、コミット作者はメールアドレスをプライベートに設定することで解決できます。 コミットは、 `@users.noreply.github.com`に属するものとなり、インポートされたコミットは、GitHub アカウントに関連付けられます。 - -## メールアドレスを使ったコミットの属性付け - -作者のメールアドレスが GitHub アカウントに関連付けられていない場合、インポート後、[アカウントにアドレスを追加](/articles/adding-an-email-address-to-your-github-account)し、コミットを正しく属性付けできます。 - -作者が GitHub アカウントを所有していない場合、GitHub Importer は、コミットをコミットに関連するメールアドレスに属性付けできます。 - -## 参考リンク - -- 「[GitHub Importer について](/articles/about-github-importer)」 -- [GitHub Importerでのリポジトリのインポート](/articles/importing-a-repository-with-github-importer) -- 「[アカウントにメールアドレスを追加する](/articles/adding-an-email-address-to-your-github-account/)」 -- [コミットメールアドレスを設定する](/articles/setting-your-commit-email-address) diff --git a/translations/ja-JP/content/github/importing-your-projects-to-github/index.md b/translations/ja-JP/content/github/importing-your-projects-to-github/index.md deleted file mode 100644 index 48cd8fbb61..0000000000 --- a/translations/ja-JP/content/github/importing-your-projects-to-github/index.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: GitHub にプロジェクトをインポートする -intro: 'You can import your source code to {% data variables.product.product_name %} using a variety of different methods.' -shortTitle: プロジェクトのインポート -redirect_from: - - /categories/67/articles - - /categories/importing - - /categories/importing-your-projects-to-github -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -children: - - /importing-source-code-to-github - - /working-with-subversion-on-github ---- - diff --git a/translations/ja-JP/content/github/importing-your-projects-to-github/working-with-subversion-on-github/index.md b/translations/ja-JP/content/github/importing-your-projects-to-github/working-with-subversion-on-github/index.md deleted file mode 100644 index 9904bee678..0000000000 --- a/translations/ja-JP/content/github/importing-your-projects-to-github/working-with-subversion-on-github/index.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: GitHub で Subversion を使う -intro: GitHub と共に、Subversion クライアントといくつかの Subversion ワークフローおよびプロパティを使用できます。 -redirect_from: - - /articles/working-with-subversion-on-github -versions: - fpt: '*' - ghes: '*' - ghec: '*' -children: - - /what-are-the-differences-between-subversion-and-git - - /support-for-subversion-clients - - /subversion-properties-supported-by-github -shortTitle: Work with Subversion on GitHub ---- - diff --git a/translations/ja-JP/content/github/importing-your-projects-to-github/working-with-subversion-on-github/subversion-properties-supported-by-github.md b/translations/ja-JP/content/github/importing-your-projects-to-github/working-with-subversion-on-github/subversion-properties-supported-by-github.md deleted file mode 100644 index d282a8706b..0000000000 --- a/translations/ja-JP/content/github/importing-your-projects-to-github/working-with-subversion-on-github/subversion-properties-supported-by-github.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: GitHub がサポートする Subversion プロパティ -intro: '{% data variables.product.product_name %} 上の既存の機能に類似したいくつかの Subversion ワークフローやプロパティがあります。' -redirect_from: - - /articles/subversion-properties-supported-by-github - - /github/importing-your-projects-to-github/subversion-properties-supported-by-github -versions: - fpt: '*' - ghes: '*' - ghec: '*' -shortTitle: Properties supported by GitHub ---- - -## Executable ファイル (svn:executable) - -Git リポジトリに追加する前に、ファイルモードを直接更新することで、`svn:executable` プロパティを変換します。 - -## MIME タイプ (svn:mime-type) - -{% data variables.product.product_name %}は、ファイルの MIME タイププロパティ、およびそれを追加したコミットを追跡します。 - -## バージョンのないアイテムを無視する (svn:ignore) - -Subversion で無視されるようにファイルとディレクトリを設定している場合、{% data variables.product.product_name %} はそれらを内部的に追跡します。 Subversion のクライアントで無視されたファイルは、*.gitignore* ファイルのエントリとは全く別のものです。 - -## 現在サポートされていないプロパティ - -現在は、{% data variables.product.product_name %} は、`svn:externals`、`svn:global-ignores`、カスタムプロパティ、その他上記にないプロパティをサポートしていません。 diff --git a/translations/ja-JP/content/github/importing-your-projects-to-github/working-with-subversion-on-github/support-for-subversion-clients.md b/translations/ja-JP/content/github/importing-your-projects-to-github/working-with-subversion-on-github/support-for-subversion-clients.md deleted file mode 100644 index 0c8eddc9b5..0000000000 --- a/translations/ja-JP/content/github/importing-your-projects-to-github/working-with-subversion-on-github/support-for-subversion-clients.md +++ /dev/null @@ -1,133 +0,0 @@ ---- -title: Subversion クライアントのサポート -intro: GitHub リポジトリは、Git および Subversion (SVN) クライアントの両方からアクセスできます。 この記事では、GitHub 上での Subversion の使用および経験する可能性のあるいくつかの主な問題を取り上げます。 -redirect_from: - - /articles/support-for-subversion-clients - - /github/importing-your-projects-to-github/support-for-subversion-clients -versions: - fpt: '*' - ghes: '*' - ghec: '*' -shortTitle: Subversion クライアントのサポート ---- - -GitHubは、HTTPS プロコトルを介して Subversion クライアントをサポートします。 GitHub に svn コマンドを伝えるには、Subversion ブリッジを使います。 - -## GitHub 上でサポートされる Subversion の機能 - -### チェックアウト - -最初に Subversion チェックアウトを行いましょう。 Git クローンは、ワーキングディレクトリ (ファイルを編集する場所) をリポジトリデータと分けたままにします。そのため、この時点でワーキングディレクトリにはブランチが 1 つしかありません。 - -Subversion チェックアウトは違います。ワーキングディレクトリのリポジトリデータをミックスします。そのため、チェックアウトしたブランチおよびタグごとにワーキングディレクトリがあります。 たくさんのブランチとタグがあるリポジトリには、すべてをチェックアウトすることは帯域障害になる可能性があります。よって、部分的なチェックアウトから始めた方がよいです。 - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.copy-clone-url %} - -3. リポジトリのエンプティチェックアウトをします: - ```shell - $ svn co --depth empty https://github.com/user/repo - > Checked out revision 1. - $ cd repo - ``` - -4. `trunk` ブランチを取得します。 Subversion ブリッジは、トランクを Git の HEAD ブランチにマップします。 - ```shell - $ svn up trunk - > A trunk - > A trunk/README.md - > A trunk/gizmo.rb - > Updated to revision 1. - ``` - -5. `branches` ディレクトリのエンプティチェックアウトを取得します。 ここは、すべての `HEAD` でないブランチが存在し、かつ、フィーチャブランチを作成する場所です。 - ```shell - $ svn up --depth empty branches - Updated to revision 1. - ``` - -### ブランチを作成する - -Subversion ブリッジを使って GitHub にブランチを作成することもできます。 - -svn クライアントで `trunk` を更新して、デフォルトブランチが最新であることを確認します。 -```shell -$ svn up trunk -> At revision 1. -``` - -次に、`svn copy` を使用して新しいブランチを作成できます: -```shell -$ svn copy trunk branches/more_awesome -> A branches/more_awesome -$ svn commit -m 'Added more_awesome topic branch' -> Adding branches/more_awesome - -> Committed revision 2. -``` - -リポジトリのブランチドロップダウンに新しいブランチが存在することを確認できます: - -![ブランチスナップショット](/assets/images/help/branch/svnflow-branch-snapshot.png) - -コマンドラインで新しいブランチを確認することもできます: - -```shell -$ git fetch -> From https://github.com/user/repo/ -> * [new branch] more_awesome -> origin/more_awesome -``` - -### Subversion にコミットを作成する - -いくつかの機能を追加しバグを修正した後は、GitHub にこれらの変更をコミットしましょう。 この手順は、あなたが慣れ親しんだ Subversion と非常に似ています。 ファイルを編集してから、以下のように `svn commit` を使って変更を記録してください: - -```shell -$ svn status -> M gizmo.rb -$ svn commit -m 'Guard against known problems' -> Sending more_awesome/gizmo.rb -> Transmitting file data . -> Committed revision 3. -$ svn status -> ? test -$ svn add test -> A test -> A test/gizmo_test.rb -$ svn commit -m 'Test coverage for problems' -> Adding more_awesome/test -> Adding more_awesome/test/gizmo_test.rb -> Transmitting file data . -> Committed revision 4. -``` - -### ブランチ間の切り替え - -ブランチをスイッチするには、`trunk` のチェックアウトから始めることをお勧めします。 - -```shell -$ svn co --depth empty https://github.com/user/repo/trunk -``` - -次に、他のブランチにスイッチします: - -```shell -$ svn switch https://github.com/user/repo/branches/more_awesome -``` - -## Subversion コミットのために Git コミット SHA を検索する - -Github の Subversion サーバーは、Subversion コミットのために Git コミット SHA を開示します。 - -コミット SHA を表示するには、`git-commit` のバージョンのないリモートプロパティを要求する必要があります。 - -```shell -$ svn propget git-commit --revprop -r HEAD https://github.com/user/repo -05fcc584ed53d7b0c92e116cb7e64d198b13c4e3 -``` - -このコミット SHA によって、たとえば、GitHub 上の関連 Git コミットを検索できます。 - -## 参考リンク - -* [GitHub がサポートする Subversion プロパティ](/articles/subversion-properties-supported-by-github) diff --git a/translations/ja-JP/content/github/importing-your-projects-to-github/working-with-subversion-on-github/what-are-the-differences-between-subversion-and-git.md b/translations/ja-JP/content/github/importing-your-projects-to-github/working-with-subversion-on-github/what-are-the-differences-between-subversion-and-git.md deleted file mode 100644 index c5cd29f329..0000000000 --- a/translations/ja-JP/content/github/importing-your-projects-to-github/working-with-subversion-on-github/what-are-the-differences-between-subversion-and-git.md +++ /dev/null @@ -1,70 +0,0 @@ ---- -title: Subversion と Git の違い -intro: Subversion (SVN) リポジトリは、Git リポジトリに似ています。ですが、プロジェクトのアーキテクチャの点からいくつかの違いがあります。 -redirect_from: - - /articles/what-are-the-differences-between-svn-and-git - - /articles/what-are-the-differences-between-subversion-and-git - - /github/importing-your-projects-to-github/what-are-the-differences-between-subversion-and-git -versions: - fpt: '*' - ghes: '*' - ghec: '*' -shortTitle: Subversion & Git differences ---- - -## ディレクトリ構造 - -プロジェクトのそれぞれの *reference* やコミットのラベルスナップショットは、`trunk`、`branches`、`tags` などの特定のサブディレクトリにまとめられます。 たとえば、2 つの feature のある開発中の SVN プロジェクトは、このようになるでしょう: - - sample_project/trunk/README.md - sample_project/trunk/lib/widget.rb - sample_project/branches/new_feature/README.md - sample_project/branches/new_feature/lib/widget.rb - sample_project/branches/another_new_feature/README.md - sample_project/branches/another_new_feature/lib/widget.rb - -SVN のワークフローは以下のようになります: - -* `trunk` ディレクトリは、プロジェクトの最新の安定したリリースを表します。 -* アクティブな feature は、 `branches` の下のサブディレクトリで開発されます。 -* feature が完了した時、feature ディレクトリは `trunk` にマージされ消去されます。 - -Git プロジェクトも、単一のディレクトリに保管されます。 ですが、Gitは、reference を特別な *.git* ディレクトリに保管するため、その詳細は隠れています。 たとえば、2 つの feature のある開発中の Git プロジェクトは、このようになるでしょう: - - sample_project/.git - sample_project/README.md - sample_project/lib/widget.rb - -Git のワークフローは以下のようになります: - -* Git リポジトリは、ブランチおよびタグのすべての履歴を、*.git* ディレクトリ内に保管します。 -* 最新の安定したリリースは、デフォルトブランチに含まれています。 -* アクティブな feature は、別のブランチで開発されます。 -* feature が完了すると、フィーチャブランチはデフォルトブランチにマージされ、消去されます。 - -Git はディレクトリ構造は同じままですが、SVN とは違い、ファイルの変更内容はブランチベースです。 - -## サブプロジェクトを含める - -*サブプロジェクト*は、メインプロジェクト外で開発され管理されるプロジェクトです。 一般的に、自分でコードを管理する必要なく、プロジェクトに何らかの機能を加えるためにサブプロジェクトをインポートします。 サブプロジェクトがアップデートされる度、すべてを最新にするためにプロジェクトと同期できます。 - -SVN では、サブプロジェクトは、*SVN external* と呼ばれます。 Git では、*Git サブモジュール*と呼ばれます。 コンセプトは似ていますが、Git サブモジュールは自動では最新状態のままにはなりません。プロジェクトに新しいバージョンを取り込むためには、明示的に要求する必要があります。 - -For more information, see "[Git Tools Submodules](https://git-scm.com/book/en/Git-Tools-Submodules)" in the Git documentation. - -## 履歴を保存する - -SVN は、プロジェクトの履歴は変更されないものとして設定されています。 Git は、[`git rebase`](/github/getting-started-with-github/about-git-rebase) のようなツールを使って、過去のコミットや変更を修正できます。 - -{% tip %} - -[GitHub は Subversion クライアントをサポートしていますが、](/articles/support-for-subversion-clients)同じプロジェクトで Git と SVN の両方を使っている場合、予期しない結果となる可能性があります。 Git のコミット履歴を操作した場合、常に同じコミットが SVN の履歴に残ります。 機密データを誤ってコミットした場合、[Git の履歴から削除するために役立つ記事があります](/articles/removing-sensitive-data-from-a-repository). - -{% endtip %} - -## 参考リンク - -- [GitHub がサポートする Subversion プロパティ](/articles/subversion-properties-supported-by-github) -- [_Git SCM_ ブックの「ブランチおよびマージ」](https://git-scm.com/book/en/Git-Branching-Basic-Branching-and-Merging) -- 「[GitHub にソースコードをインポートする](/articles/importing-source-code-to-github)」 -- [ソースコードの移行ツール](/articles/source-code-migration-tools) diff --git a/translations/ja-JP/content/github/understanding-how-github-uses-and-protects-your-data/about-githubs-use-of-your-data.md b/translations/ja-JP/content/github/understanding-how-github-uses-and-protects-your-data/about-githubs-use-of-your-data.md deleted file mode 100644 index 3c6d90916e..0000000000 --- a/translations/ja-JP/content/github/understanding-how-github-uses-and-protects-your-data/about-githubs-use-of-your-data.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: GitHubによるユーザのデータの利用について -redirect_from: - - /articles/about-github-s-use-of-your-data - - /articles/about-githubs-use-of-your-data -intro: '{% data variables.product.product_name %}はユーザのリポジトリのデータを使い、ユーザを関連するツール、人々、プロジェクト、情報につなげます。' -versions: - fpt: '*' - ghec: '*' -topics: - - Policy - - Legal -shortTitle: GitHub's use of your data ---- - -## {% data variables.product.product_name %} によるユーザのデータの利用について - -{% data variables.product.product_name %}は、プロダクト内の一般化された知見を配信するために、メタデータを集約し、コンテンツのパターンをパースします。 パブリックリポジトリからのデータが利用され、リポジトリのオーナーがオプトインを通じて{% data variables.product.product_name %}とデータを共有するよう選択した場合、プライベートリポジトリからのメタデータが使われ、データが集約されます。 プライベートリポジトリのデータの利用をオプトインした場合、その指定されたプライベートリポジトリのリードオンリーの分析が行われます。 - -{% data reusables.repositories.about-github-archive-program %} 詳細は「[{% data variables.product.prodname_dotcom %} 上のコンテンツとデータのアーカイブ処理について](/github/creating-cloning-and-archiving-repositories/about-archiving-content-and-data-on-github#about-the-github-archive-program)」を参照してください。 - -{% data reusables.user_settings.export-data %}詳細は「[個人アカウントのデータのアーカイブをリクエストする](/articles/requesting-an-archive-of-your-personal-account-s-data)」を参照してください。 - -プライベートリポジトリのデータの利用をオプトインした場合でも、プライベートデータ、ソースコード、企業秘密は引き続き弊社の[利用規約](/free-pro-team@latest/github/site-policy/github-terms-of-service)の下で機密事項として扱われます。 弊社が知る情報は、集約されたデータからのみです。 詳しい情報については、「[プライベートリポジトリのデータ使用を管理する](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository)」を参照してください。 - -メタデータあるいは集約されたデータを使う大きな新機能は、[{% data variables.product.prodname_dotcom %}blog](https://github.com/blog)でアナウンスします。 - -## データによるセキュリティの推奨事項の改善 - -データの利用方法の例として、パブリックリポジトリの依存対象のセキュリティの脆弱性を検出し、アラートを出すことができます。 詳しい情報については、「[脆弱性のある依存関係に対するアラートについて](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)」を参照してください。 - -潜在的なセキュリティの脆弱性を検出するために、{% data variables.product.product_name %}は依存対象のマニフェストファイルの内容をスキャンし、プロジェクトの依存対象のリストを作成します。 - -{% data variables.product.product_name %}はまた、依存対象のマニフェストに加えられた変更についても知ります。 たとえばあなたが脆弱性のある依存対象をセキュリティアラートを受けた後で安全なバージョンにアップグレードして、他者も同じようにした場合、{% data variables.product.product_name %}はその脆弱性へのパッチの方法を学習し、影響を受けるリポジトリに同じパッチを推奨できます。 - -## プライバシーとデータ共有 - -プライベートリポジトリのデータはマシンによってスキャンされ、{% data variables.product.product_name %}のスタッフが読むことは決してありません。 弊社の[利用規約](/free-pro-team@latest/github/site-policy/github-terms-of-service#3-access)に記載されている場合を除き、人の眼はプライベートリポジトリの内容を見ることはありません。 - -あなたの個人データあるいはリポジトリデータがサードパーティと共有されることはありません。 弊社は、分析から得られた集約データをパートナーと共有することがあります。 diff --git a/translations/ja-JP/content/github/understanding-how-github-uses-and-protects-your-data/index.md b/translations/ja-JP/content/github/understanding-how-github-uses-and-protects-your-data/index.md deleted file mode 100644 index 5cb4966fb3..0000000000 --- a/translations/ja-JP/content/github/understanding-how-github-uses-and-protects-your-data/index.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: GitHub によるデータの利用方法と保護方法を理解する -redirect_from: - - /categories/understanding-how-github-uses-and-protects-your-data -versions: - fpt: '*' - ghec: '*' -children: - - /about-githubs-use-of-your-data - - /requesting-an-archive-of-your-personal-accounts-data - - /managing-data-use-settings-for-your-private-repository - - /opting-into-or-out-of-the-github-archive-program-for-your-public-repository -shortTitle: How GitHub protects data ---- - diff --git a/translations/ja-JP/content/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository.md b/translations/ja-JP/content/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository.md deleted file mode 100644 index e2b617a11c..0000000000 --- a/translations/ja-JP/content/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: Managing data use settings for your private repository -intro: 'To help {% data variables.product.product_name %} connect you to relevant tools, people, projects, and information, you can configure data use for your private repository.' -redirect_from: - - /articles/opting-into-or-out-of-data-use-for-your-private-repository - - /github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-data-use-for-your-private-repository -versions: - fpt: '*' - ghec: '*' -topics: - - Policy - - Legal -shortTitle: Manage data use for private repo ---- - -## About data use for your private repository - -When you enable data use for your private repository, you'll be able to access the dependency graph, where you can track your repository's dependencies and receive {% data variables.product.prodname_dependabot_alerts %} when {% data variables.product.product_name %} detects vulnerable dependencies. For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies#dependabot-alerts-for-vulnerable-dependencies)." - -## Enabling or disabling data use features - -{% data reusables.security.security-and-analysis-features-enable-read-only %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -{% data reusables.repositories.navigate-to-security-and-analysis %} -4. Under "Configure security and analysis features", to the right of the feature, click **Disable** or **Enable**.{% ifversion fpt %} - !["Enable" or "Disable" button for "Configure security and analysis" features](/assets/images/help/repository/security-and-analysis-disable-or-enable-fpt-private.png){% elsif ghec %} - !["Enable" or "Disable" button for "Configure security and analysis" features](/assets/images/help/repository/security-and-analysis-disable-or-enable-ghec-private.png){% endif %} - -## Further reading - -- "[About {% data variables.product.prodname_dotcom %}'s use of your data](/articles/about-github-s-use-of-your-data)" -- "[Viewing and updating vulnerable dependencies in your repository](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository)" -- "[Managing security and analysis settings for your repository](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository)" diff --git a/translations/ja-JP/content/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-the-github-archive-program-for-your-public-repository.md b/translations/ja-JP/content/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-the-github-archive-program-for-your-public-repository.md deleted file mode 100644 index f33e80bd55..0000000000 --- a/translations/ja-JP/content/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-the-github-archive-program-for-your-public-repository.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: パブリックリポジトリ用の GitHub Archive Program のオプトインまたはオプトアウト -intro: '世界のオープンソースソフトウェアを長期的に維持できるように、{% data variables.product.prodname_dotcom %} で {% data variables.product.prodname_archive %} にパブリックリポジトリを含めるかどうかを管理できます。' -permissions: 'People with admin permissions to a public repository can opt into or out of the {% data variables.product.prodname_archive %}.' -versions: - fpt: '*' - ghec: '*' -topics: - - Policy - - Legal -shortTitle: GitHub Archive program ---- - -{% data reusables.repositories.about-github-archive-program %} 詳細は「[{% data variables.product.prodname_dotcom %} 上のコンテンツとデータのアーカイブ処理について](/github/creating-cloning-and-archiving-repositories/about-archiving-content-and-data-on-github#about-the-github-archive-program)」を参照してください。 - -リポジトリについて {% data variables.product.prodname_archive %} からオプトアウトすると、そのリポジトリは今後 {% data variables.product.prodname_dotcom %} で作成される可能性がある長期的なアーカイブから除外されます。 リポジトリをデータから削除するよう、各パートナー Organization にリクエストを送ることもできます。 - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -3. [Features] で、[**Preserve this repository**] を選択または選択解除します。 ![{% data variables.product.prodname_dotcom %} が {% data variables.product.prodname_archive %} にコードを含めることを許可するチェックボックス](/assets/images/help/repository/github-archive-program-checkbox.png) - -## 参考リンク -- [{% data variables.product.prodname_archive %} FAQ](https://archiveprogram.github.com/faq/) diff --git a/translations/ja-JP/content/github/understanding-how-github-uses-and-protects-your-data/requesting-an-archive-of-your-personal-accounts-data.md b/translations/ja-JP/content/github/understanding-how-github-uses-and-protects-your-data/requesting-an-archive-of-your-personal-accounts-data.md deleted file mode 100644 index 998dfb45cd..0000000000 --- a/translations/ja-JP/content/github/understanding-how-github-uses-and-protects-your-data/requesting-an-archive-of-your-personal-accounts-data.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: 個人アカウントのデータのアーカイブをリクエストする -redirect_from: - - /articles/requesting-an-archive-of-your-personal-account-s-data - - /articles/requesting-an-archive-of-your-personal-accounts-data -intro: '{% data reusables.user_settings.export-data %}' -versions: - fpt: '*' - ghec: '*' -topics: - - Policy - - Legal -shortTitle: Request account archive ---- - -{% data variables.product.product_name %} は、個人アカウントの活動からリポジトリとプロファイルのメタデータを保存します。 個人アカウントのデータは、{% data variables.product.prodname_dotcom_the_website %} での設定または User Migration API によりエクスポートできます。 - -{% data variables.product.product_name %} が保存するエクスポート用に使用できるデータの詳細については、「[ユーザー移行アーカイブをダウンロードする](/rest/reference/migrations#download-a-user-migration-archive)」と「[{% data variables.product.product_name %} のデータの使用について](/articles/about-github-s-use-of-your-data)」を参照してください。 - -{% data variables.product.prodname_dotcom_the_website %} での設定により個人データのエクスポートをリクエストする場合、{% data variables.product.product_name %} は個人データを `tar.gz` ファイルにパッケージ化し、ダウンロードリンクを記載したメールをお使いのプライマリ メール アドレスに送信します。 - -デフォルトでは、ダウンロードリンクは 7 日後に期限切れになります。 ダウンロードリンクが期限切れになる前ならばいつでも、ユーザ設定からリンクを無効にすることができます。 詳細は「[個人アカウントのデータのアーカイブへのアクセスを削除する](/articles/requesting-an-archive-of-your-personal-account-s-data/#deleting-access-to-an-archive-of-your-personal-accounts-data)」を参照してください。 - -`tar.gz` ファイルを解凍する機能が、お使いのオペレーティングシステムに備わっていない場合は、サードパーティ製のツールを使用して解凍してください。 詳細は Opensource.com で「[tar.gz ファイルを解凍する方法](https://opensource.com/article/17/7/how-unzip-targz-file)」を参照してください。 - -生成された `tar.gz` ファイルには、データのエクスポートを開始したときに保存されたデータが反映されます。 - -## 個人アカウントのデータのアーカイブをダウンロードする - -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.account_settings %} -3. [Export account data] で、[**Start export**] または [**New export**] をクリックします。 ![強調表示された [Start export] ボタン](/assets/images/help/repository/export-personal-data.png) ![強調表示された [New export] ボタン](/assets/images/help/repository/new-export.png) -4. エクスポートをダウンロードする準備が整ったら、{% data variables.product.product_name %} はお使いのプライマリメールアドレスにダウンロード リンクを送信します。 -5. メール内のダウンロードリンクをクリックし、要求されたらパスワードを再入力します。 -6. ダウンロードできる `tar.gz` ファイルにリダイレクトされます。 - -## 個人アカウントのデータのアーカイブへのアクセスを削除する - -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.account_settings %} -3. メールに送信されたダウンロードリンクを有効期限が切れる前に無効にするには、[Export account data] で無効にするデータエクスポートのダウンロードを探し、[**Delete**] をクリックします。 ![強調表示された [Delete personal data export package] ボタン](/assets/images/help/repository/delete-export-personal-account-data.png) diff --git a/translations/ja-JP/content/github/writing-on-github/editing-and-sharing-content-with-gists/creating-gists.md b/translations/ja-JP/content/github/writing-on-github/editing-and-sharing-content-with-gists/creating-gists.md deleted file mode 100644 index d52fb36e48..0000000000 --- a/translations/ja-JP/content/github/writing-on-github/editing-and-sharing-content-with-gists/creating-gists.md +++ /dev/null @@ -1,84 +0,0 @@ ---- -title: Creating gists -intro: 'You can create two kinds of gists: {% ifversion ghae %}internal{% else %}public{% endif %} and secret. Create {% ifversion ghae %}an internal{% else %}a public{% endif %} gist if you''re ready to share your ideas with {% ifversion ghae %}enterprise members{% else %}the world{% endif %} or a secret gist if you''re not.' -permissions: '{% data reusables.enterprise-accounts.emu-permission-gist %}' -redirect_from: - - /articles/about-gists - - /articles/cannot-delete-an-anonymous-gist - - /articles/deleting-an-anonymous-gist - - /articles/creating-gists - - /github/writing-on-github/creating-gists -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' ---- -## About gists - -Every gist is a Git repository, which means that it can be forked and cloned. {% ifversion not ghae %}If you are signed in to {% data variables.product.product_name %} when{% else %}When{% endif %} you create a gist, the gist will be associated with your account and you will see it in your list of gists when you navigate to your {% data variables.gists.gist_homepage %}. - -Gists can be {% ifversion ghae %}internal{% else %}public{% endif %} or secret. {% ifversion ghae %}Internal{% else %}Public{% endif %} gists show up in {% data variables.gists.discover_url %}, where {% ifversion ghae %}enterprise members{% else %}people{% endif %} can browse new gists as they're created. They're also searchable, so you can use them if you'd like other people to find and see your work. - -Secret gists don't show up in {% data variables.gists.discover_url %} and are not searchable. Secret gists aren't private. If you send the URL of a secret gist to {% ifversion ghae %}another enterprise member{% else %}a friend{% endif %}, they'll be able to see it. However, if {% ifversion ghae %}any other enterprise member{% else %}someone you don't know{% endif %} discovers the URL, they'll also be able to see your gist. If you need to keep your code away from prying eyes, you may want to [create a private repository](/articles/creating-a-new-repository) instead. - -{% data reusables.gist.cannot-convert-public-gists-to-secret %} - -{% ifversion ghes %} - -If your site administrator has disabled private mode, you can also use anonymous gists, which can be public or secret. - -{% data reusables.gist.anonymous-gists-cannot-be-deleted %} - -{% endif %} - -You'll receive a notification when: -- You are the author of a gist. -- Someone mentions you in a gist. -- You subscribe to a gist, by clicking **Subscribe** at the top of any gist. - -{% ifversion fpt or ghes or ghec %} - -You can pin gists to your profile so other people can see them easily. For more information, see "[Pinning items to your profile](/articles/pinning-items-to-your-profile)." - -{% endif %} - -You can discover {% ifversion ghae %}internal{% else %}public{% endif %} gists others have created by going to the {% data variables.gists.gist_homepage %} and clicking **All Gists**. This will take you to a page of all gists sorted and displayed by time of creation or update. You can also search gists by language with {% data variables.gists.gist_search_url %}. Gist search uses the same search syntax as [code search](/search-github/searching-on-github/searching-code). - -Since gists are Git repositories, you can view their full commit history, complete with diffs. You can also fork or clone gists. For more information, see ["Forking and cloning gists"](/articles/forking-and-cloning-gists). - -You can download a ZIP file of a gist by clicking the **Download ZIP** button at the top of the gist. You can embed a gist in any text field that supports Javascript, such as a blog post. To get the embed code, click the clipboard icon next to the **Embed** URL of a gist. To embed a specific gist file, append the **Embed** URL with `?file=FILENAME`. - -{% ifversion fpt or ghec %} - -Gist supports mapping GeoJSON files. These maps are displayed in embedded gists, so you can easily share and embed maps. For more information, see "[Working with non-code files](/repositories/working-with-files/using-files/working-with-non-code-files#mapping-geojson-files-on-github)." - -{% endif %} - -## Creating a gist - -Follow the steps below to create a gist. - -{% ifversion fpt or ghes or ghae or ghec %} -{% note %} - -You can also create a gist using the {% data variables.product.prodname_cli %}. For more information, see "[`gh gist create`](https://cli.github.com/manual/gh_gist_create)" in the {% data variables.product.prodname_cli %} documentation. - -Alternatively, you can drag and drop a text file from your desktop directly into the editor. - -{% endnote %} -{% endif %} - -1. Sign in to {% data variables.product.product_name %}. -2. Navigate to your {% data variables.gists.gist_homepage %}. -3. Type an optional description and name for your gist. -![Gist name description](/assets/images/help/gist/gist_name_description.png) - -4. Type the text of your gist into the gist text box. -![Gist text box](/assets/images/help/gist/gist_text_box.png) - -5. Optionally, to create {% ifversion ghae %}an internal{% else %}a public{% endif %} gist, click {% octicon "triangle-down" aria-label="The downwards triangle icon" %}, then click **Create {% ifversion ghae %}internal{% else %}public{% endif %} gist**. -![Drop-down menu to select gist visibility]{% ifversion ghae %}(/assets/images/help/gist/gist-visibility-drop-down-ae.png){% else %}(/assets/images/help/gist/gist-visibility-drop-down.png){% endif %} - -6. Click **Create secret Gist** or **Create {% ifversion ghae %}internal{% else %}public{% endif %} gist**. - ![Button to create gist](/assets/images/help/gist/create-secret-gist-button.png) diff --git a/translations/ja-JP/content/github/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists.md b/translations/ja-JP/content/github/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists.md deleted file mode 100644 index 0c6f5271c8..0000000000 --- a/translations/ja-JP/content/github/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: Gistのフォークとクローン -intro: Gists は Git リポジトリです。つまり、オリジナルの作者でなくても Gist をフォークしたりクローンしたりできます。 diff など、Gist の完全なコミット履歴を見ることもできます。 -permissions: '{% data reusables.enterprise-accounts.emu-permission-gist %}' -redirect_from: - - /articles/forking-and-cloning-gists - - /github/writing-on-github/forking-and-cloning-gists -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' ---- - -## Gist をフォークする - -各 Gist はどのフォークにアクティビティがあるのかを示すため、他のユーザによる興味深い変更を簡単に確認できます。 - -![Gist フォーク](/assets/images/help/gist/gist_forks.png) - -## Gist をクローンする - -Gist にローカルの変更を加え、ウェブにプッシュしたい場合は、Gist をクローンして Git リポジトリと同様にコミットを行えます。 詳しい情報については[リポジトリのクローン](/articles/cloning-a-repository)を参照してください。 - -![Gist クローンボタン](/assets/images/help/gist/gist_clone_btn.png) - -## Gist のコミットの履歴を見る - -To view a gist's full commit history, click the "Revisions" tab at the top of the gist. - -![Gist [revisions] タブ](/assets/images/help/gist/gist_revisions_tab.png) - -Gist の完全なコミットの履歴が diff とともに表示されます。 - -![Gist [revisions] ページ](/assets/images/help/gist/gist_history.png) diff --git a/translations/ja-JP/content/github/writing-on-github/editing-and-sharing-content-with-gists/index.md b/translations/ja-JP/content/github/writing-on-github/editing-and-sharing-content-with-gists/index.md deleted file mode 100644 index 2cc71b9eb7..0000000000 --- a/translations/ja-JP/content/github/writing-on-github/editing-and-sharing-content-with-gists/index.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: Gist でコンテンツを編集・共有する -intro: '' -redirect_from: - - /categories/23/articles - - /categories/gists - - /articles/editing-and-sharing-content-with-gists -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -children: - - /creating-gists - - /forking-and-cloning-gists -shortTitle: Share content with gists ---- - diff --git a/translations/ja-JP/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/about-writing-and-formatting-on-github.md b/translations/ja-JP/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/about-writing-and-formatting-on-github.md deleted file mode 100644 index 0e02e86edf..0000000000 --- a/translations/ja-JP/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/about-writing-and-formatting-on-github.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: GitHub 上での執筆とフォーマットについて -intro: GitHubは、GitHub Flavored Markdown と呼ばれるテキストフォーマットの構文を、いくつかのユニークな執筆用の機能と組み合わせています。 -redirect_from: - - /articles/about-writing-and-formatting-on-github - - /github/writing-on-github/about-writing-and-formatting-on-github -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -shortTitle: Write & format on GitHub ---- - -[Markdown](http://daringfireball.net/projects/markdown/) は、プレーンテキストをフォーマットするための読みやすく書きやすい構文です。 - -サイトで文章とコードをフォーマットするのに使われる {% data variables.product.prodname_dotcom %}Flavored Markdown を作り出すために、弊社ではカスタムの機能をいくつか追加しました。 - -また、[@メンション](/articles/basic-writing-and-formatting-syntax/#mentioning-people-and-teams)、[Issue や PR の参照](/articles/basic-writing-and-formatting-syntax/#referencing-issues-and-pull-requests)、[絵文字](/articles/basic-writing-and-formatting-syntax/#using-emoji)などの機能を使って、プルリクエストや Issue で他のユーザーとやりとりできます。 - -## テキストフォーマット用のツールバー - -{% data variables.product.product_name %}のすべてのコメントフィールドには、テキストフォーマット用のツールバーが含まれており、Markdown の構文を学ばなくてもテキストをフォーマットできます。 太字や斜体といったスタイルなどの Markdown のフォーマットやヘッダ、リンク、リストの作成といったことに加えて、このツールバーには @メンション、タスクリスト、Issue およびプルリクエストへのリンクといった {% data variables.product.product_name %}固有の機能があります。 - -{% if fixed-width-font-gfm-fields %} - -## Enabling fixed-width fonts in the editor - -You can enable a fixed-width font in every comment field on {% data variables.product.product_name %}. Each character in a fixed-width, or monospace, font occupies the same horizontal space which can make it easier to edit advanced Markdown structures such as tables and code snippets. - -![Screenshot showing the {% data variables.product.product_name %} comment field with fixed-width fonts enabled](/assets/images/help/writing/fixed-width-example.png) - -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.appearance-settings %} -1. Under "Markdown editor font preference", select **Use a fixed-width (monospace) font when editing Markdown**. ![Screenshot showing the {% data variables.product.product_name %} comment field with fixed width fonts enabled](/assets/images/help/writing/enable-fixed-width.png) - -{% endif %} - -## 参考リンク - -- [{% data variables.product.prodname_dotcom %} Flavored Markdown の仕様](https://github.github.com/gfm/) -- [基本的な書き方とフォーマットの構文](/articles/basic-writing-and-formatting-syntax) -- [高度なフォーマットを使用して作業する](/articles/working-with-advanced-formatting) -- [Markdown をマスターする](https://guides.github.com/features/mastering-markdown/) diff --git a/translations/ja-JP/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md b/translations/ja-JP/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md deleted file mode 100644 index 692b51ad5e..0000000000 --- a/translations/ja-JP/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md +++ /dev/null @@ -1,343 +0,0 @@ ---- -title: 基本的な書き方とフォーマットの構文 -intro: シンプルな構文を使い、GitHub 上で文章やコードに洗練されたフォーマットを作り出してください。 -redirect_from: - - /articles/basic-writing-and-formatting-syntax - - /github/writing-on-github/basic-writing-and-formatting-syntax -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -shortTitle: Basic formatting syntax ---- - -## ヘッディング - -ヘッディングを作成するには、1 つから 6 つの `#` シンボルをヘッディングのテキストの前に追加します。 使用する `#` の数によって、ヘッディングのサイズが決まります。 - -```markdown -# The largest heading (最大のヘッディング) -## The second largest heading (2番目に大きなヘッディング) -###### The smallest heading (最も小さいヘッディング) -``` - -![表示された H1、H2、H6 のヘッディング](/assets/images/help/writing/headings-rendered.png) - -## スタイル付きテキスト - -コメントフィールドと `.md` ファイルでは、太字、斜体、または取り消し線のテキストで強調を示すことができます。 - -| スタイル | 構文 | キーボードショートカット | サンプル | 出力 | -| ------------- | ------------------- | ------------------- | ------------------------- | ----------------------- | -| 太字 | `** **`もしくは`__ __` | command/control + b | `**これは太字のテキストです**` | **これは太字のテキストです** | -| 斜体 | `* *`あるいは`_ _`      | command/control + i | `*このテキストは斜体です*` | *このテキストは斜体です* | -| 取り消し線 | `~~ ~~` | | `~~これは間違ったテキストでした~~` | ~~これは間違ったテキストでした~~ | -| 太字および太字中にある斜体 | `** **`及び`_ _` | | `**このテキストは_きわめて_ 重要です**` | **このテキストは_きわめて_重要です** | -| 全体が太字かつ斜体 | `*** ***` | | `***すべてのテキストがきわめて重要です***` | ***すべてのテキストがきわめて重要です*** | - -## テキストの引用 - -テキストは`>`で引用できます。 - -```markdown -Text that is not a quote - -> Text that is a quote -``` - -![表示された引用テキスト](/assets/images/help/writing/quoted-text-rendered.png) - -{% tip %} - -**ヒント:** 会話を見る場合、コメントをハイライトして `r` と入力することで、コメント中のテキストを自動的に引用できます。 {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} に続いて [** Quote reply**] をクリックすれば、コメント全体を引用できます。 キーボードショートカットに関する詳しい情報については、「[キーボードショートカット](/articles/keyboard-shortcuts/)」を参照してください。 - -{% endtip %} - -## コードの引用 - -単一のバッククォートで文章内のコードやコマンドを引用できます。 The text within the backticks will not be formatted.{% ifversion fpt or ghae or ghes > 3.1 or ghec %} You can also press the `command` or `Ctrl` + `e` keyboard shortcut to insert the backticks for a code block within a line of Markdown.{% endif %} - -```markdown -コミットされていない新しいもしくは修正されたすべてのファイルをリストするには `git status` を使ってください。 -``` - -![表示されたインラインのコードブロック](/assets/images/help/writing/inline-code-rendered.png) - -独立したブロック内にコードあるいはテキストをフォーマットするには、3 重のバッククォートを使用します。 - -
-いくつかの基本的な Git コマンド:
-```
-git status
-git add
-git commit
-```
-
- -![表示されたコードブロック](/assets/images/help/writing/code-block-rendered.png) - -詳しい情報については[コードブロックの作成とハイライト](/articles/creating-and-highlighting-code-blocks)を参照してください。 - -{% data reusables.user_settings.enabling-fixed-width-fonts %} - -## リンク - -リンクのテキストをブラケット `[ ]` で囲み、URL をカッコ `( )` で囲めば、インラインのリンクを作成できます。 {% ifversion fpt or ghae or ghes > 3.1 or ghec %}You can also use the keyboard shortcut `command + k` to create a link.{% endif %}{% ifversion fpt or ghae-issue-5434 or ghes > 3.3 or ghec %} When you have text selected, you can paste a URL from your clipboard to automatically create a link from the selection.{% endif %} - -`このサイトは [GitHub Pages](https://pages.github.com/) を使って構築されています。` - -![表示されたリンク](/assets/images/help/writing/link-rendered.png) - -{% tip %} - -**ヒント:** {% data variables.product.product_name %}は、コメント中に適正な URL が書かれていれば自動的にリンクを生成します。 詳しい情報については[自動リンクされた参照と URL](/articles/autolinked-references-and-urls) を参照してください。 - -{% endtip %} - -## セクションリンク - -{% data reusables.repositories.section-links %} - -## 相対リンク - -{% data reusables.repositories.relative-links %} - -## Images - -You can display an image by adding `!` and wrapping the alt text in`[ ]`. Then wrap the link for the image in parentheses `()`. - -`![This is an image](https://myoctocat.com/assets/images/base-octocat.svg)` - -![Rendered Image](/assets/images/help/writing/image-rendered.png) - -{% data variables.product.product_name %} supports embedding images into your issues, pull requests{% ifversion fpt or ghec %}, discussions{% endif %}, comments and `.md` files. You can display an image from your repository, add a link to an online image, or upload an image. For more information, see "[Uploading assets](#uploading-assets)." - -{% tip %} - -**Tip:** When you want to display an image which is in your repository, you should use relative links instead of absolute links. - -{% endtip %} - -Here are some examples for using relative links to display an image. - -| コンテキスト | Relative Link | -| ----------------------------------------------------------- | ---------------------------------------------------------------------- | -| In a `.md` file on the same branch | `/assets/images/electrocat.png` | -| In a `.md` file on another branch | `/../main/assets/images/electrocat.png` | -| In issues, pull requests and comments of the repository | `../blob/main/assets/images/electrocat.png` | -| In a `.md` file in another repository | `/../../../../github/docs/blob/main/assets/images/electrocat.png` | -| In issues, pull requests and comments of another repository | `../../../github/docs/blob/main/assets/images/electrocat.png?raw=true` | - -{% note %} - -**Note**: The last two relative links in the table above will work for images in a private repository only if the viewer has at least read access to the private repository which contains these images. - -{% endnote %} - -For more information, see "[Relative Links](#relative-links)." - -{% ifversion fpt or ghec or ghes > 3.3 or ghae-issue-5559 %} -### Specifying the theme an image is shown to - -You can specify the theme an image is displayed to by appending `#gh-dark-mode-only` or `#gh-light-mode-only` to the end of an image URL, in Markdown. - -We distinguish between light and dark color modes, so there are two options available. You can use these options to display images optimized for dark or light backgrounds. This is particularly helpful for transparent PNG images. - -| コンテキスト | URL | -| ----------- | ------------------------------------------------------------------------ | -| Dark Theme | `![GitHub Light](https://github.com/github-light.png#gh-dark-mode-only)` | -| Light Theme | `![GitHub Dark](https://github.com/github-dark.png#gh-light-mode-only)` | -{% endif %} - -## リスト - -1 つ以上の行の前に `-` または `*` を置くことで、順序なしリストを作成できます。 - -```markdown -- George Washington -- John Adams -- Thomas Jefferson -``` - -![表示された順序なしリスト](/assets/images/help/writing/unordered-list-rendered.png) - -リストを順序付けするには、各行の前に数字を置きます。 - -```markdown -1. James Madison -2. James Monroe -3. John Quincy Adams -``` - -![表示された順序付きリスト](/assets/images/help/writing/ordered-list-rendered.png) - -### 入れ子になったリスト - -1 つ以上のリストアイテムを他のアイテムの下にインデントすることで、入れ子になったリストを作成できます。 - -{% data variables.product.product_name %}上の Web のエディタあるいは [Atom](https://atom.io/) のようなモノスペースフォントを使うテキストエディタを使って入れ子になったリストを作成するには、リストが揃って見えるように編集します。 入れ子になったリストアイテムの前に空白を、リストマーカーの文字 (`-` または `*`) が直接上位のアイテム内のテキストの一文字目の下に来るように入力してください。 - -```markdown -1. 最初のリストアイテム - - 最初の入れ子になったリストアイテム - - 2 番目の入れ子になったリストアイテム -``` - -![並びがハイライトされた入れ子になったリスト](/assets/images/help/writing/nested-list-alignment.png) - -![2 レベルの入れ子になったアイテムを持つリスト](/assets/images/help/writing/nested-list-example-1.png) - -モノスペースフォントを使っていない {% data variables.product.product_name %}のコメントエディタで入れ子になったリストを作成するには、入れ子になったリストのすぐ上にあるリストアイテムを見て、そのアイテムの内容の前にある文字数を数えます。 そして、その数だけ空白を入れ子になったリストアイテムの前に入力します。 - -この例では、入れ子になったリストアイテムをリストアイテム `100. 最初のリストアイテム` の下に、最低 5 つの空白で入れ子になったリストアイテムをインデントさせることで追加できます。これは、`最初のリストアイテム`の前に 5 文字 (`100. `) があるからです。 - -```markdown -100. 最初のリストアイテム - - 最初の入れ子になったリストアイテム -``` - -![入れ子になったリストアイテムを持つリスト](/assets/images/help/writing/nested-list-example-3.png) - -同じ方法で、複数レベルの入れ子になったリストを作成できます。 For example, because the first nested list item has seven characters (`␣␣␣␣␣-␣`) before the nested list content `First nested list item`, you would need to indent the second nested list item by seven spaces. - -```markdown -100. 最初のリストアイテム - - 最初の入れ子になったリストアイテム - - 2 番目の入れ子になったリストアイテム -``` - -![2 レベルの入れ子になったアイテムを持つリスト](/assets/images/help/writing/nested-list-example-2.png) - -[GitHub Flavored Markdown の仕様](https://github.github.com/gfm/#example-265)には、もっと多くのサンプルがあります。 - -## タスクリスト - -{% data reusables.repositories.task-list-markdown %} - -タスクリストアイテムの説明がカッコから始まるのであれば、`\` でエスケープしなければなりません。 - -`- [ ] \(オプション) フォローアップの Issue のオープン` - -詳しい情報については[タスクリストについて](/articles/about-task-lists)を参照してください。 - -## 人や Team のメンション - -{% data variables.product.product_name %}上の人あるいは [Team](/articles/setting-up-teams/) は、`@` に加えてユーザ名もしくは Team 名を入力することでメンションできます。 これにより通知がトリガーされ、会話に注意が向けられます。 コメントを編集してユーザ名や Team 名をメンションすれば、人々に通知を受信してもらえます。 通知の詳細は、{% ifversion fpt or ghes or ghae or ghec %}「[通知について](/github/managing-subscriptions-and-notifications-on-github/about-notifications){% else %}「[通知について](/github/receiving-notifications-about-activity-on-github/about-notifications){% endif %}」を参照してください。 - -`@github/support これらのアップデートについてどう思いますか?` - -![表示された @メンション](/assets/images/help/writing/mention-rendered.png) - -親チームにメンションすると、その子チームのメンバーも通知を受けることになり、複数のグループの人々とのコミュニケーションがシンプルになります。 詳しい情報については[Team について](/articles/about-teams)を参照してください。 - -`@` シンボルを入力すると、プロジェクト上の人々あるいは Team のリストが現れます。 このリストは入力していくにつれて絞り込まれていくので、探している人あるいは Team の名前が見つかり次第、矢印キーを使ってその名前を選択し、Tab キーまたは Enter キーを押して名前の入力を完了できます。 Team については、@organization/team-name と入力すればそのチームの全メンバーにその会話をサブスクライブしてもらえます。 - -オートコンプリートの結果は、リポジトリのコラボレータとそのスレッドのその他の参加者に限定されます。 - -## Issue およびプルリクエストの参照 - -`#` を入力して、リポジトリ内のサジェストされた Issue およびプルリクエストのリストを表示させることができます。 Issue あるいはプルリクエストの番号あるいはタイトルを入力してリストをフィルタリングし、Tab キーまたは Enter キーを押して、ハイライトされた結果の入力を完了してください。 - -詳しい情報については[自動リンクされた参照と URL](/articles/autolinked-references-and-urls) を参照してください。 - -## 外部リソースの参照 - -{% data reusables.repositories.autolink-references %} - -{% ifversion ghes < 3.4 %} -## コンテンツの添付 - -Some {% data variables.product.prodname_github_apps %} provide information in {% data variables.product.product_name %} for URLs that link to their registered domains. {% data variables.product.product_name %} は、アプリケーションが提供した情報を Issue あるいはプルリクエストのボディもしくはコメント中の URL の下に表示します。 - -![コンテンツの添付](/assets/images/github-apps/content_reference_attachment.png) - -コンテンツの添付を見るには、リポジトリにインストールされた Content Attachments API を使う {% data variables.product.prodname_github_app %} が必要です。{% ifversion fpt or ghec %}詳細は「[個人アカウントでアプリケーションをインストールする](/articles/installing-an-app-in-your-personal-account)」および「[Organization でアプリケーションをインストールする](/articles/installing-an-app-in-your-organization)」を参照してください。{% endif %} - -コンテンツの添付は、Markdown のリンクの一部になっている URL には表示されません。 - -For more information about building a {% data variables.product.prodname_github_app %} that uses content attachments, see "[Using Content Attachments](/apps/using-content-attachments)."{% endif %} - -## アセットをアップロードする - -ドラッグアンドドロップ、ファイルブラウザから選択、または貼り付けることにより、画像などのアセットをアップロードできます。 アセットをリポジトリ内の Issue、プルリクエスト、コメント、および `.md` ファイルにアップロードできます。 - -## 絵文字の利用 - -`:EMOJICODE:` を入力して、書き込みに絵文字を追加できます。 - -`@octocat :+1: このPRは素晴らしいです - マージできますね! :shipit:` - -![表示された絵文字](/assets/images/help/writing/emoji-rendered.png) - -`:` を入力すると、絵文字のサジェストリストが表示されます。 このリストは、入力を進めるにつれて絞り込まれていくので、探している絵文字が見つかったら、**Tab** または **Enter** を押すと、ハイライトされているものが入力されます。 - -利用可能な絵文字とコードの完全なリストについては、[絵文字チートシート](https://github.com/ikatyang/emoji-cheat-sheet/blob/master/README.md)を参照してください。 - -## パラグラフ - -テキスト行の間に空白行を残すことで、新しいパラグラフを作成できます。 - -{% ifversion fpt or ghae-issue-5180 or ghes > 3.2 or ghec %} -## Footnotes - -You can add footnotes to your content by using this bracket syntax: - -``` -Here is a simple footnote[^1]. - -A footnote can also have multiple lines[^2]. - -You can also use words, to fit your writing style more closely[^note]. - -[^1]: My reference. -[^2]: Every new line should be prefixed with 2 spaces. - This allows you to have a footnote with multiple lines. -[^note]: - Named footnotes will still render with numbers instead of the text but allow easier identification and linking. - This footnote also has been made with a different syntax using 4 spaces for new lines. -``` - -The footnote will render like this: - -![Rendered footnote](/assets/images/site/rendered-footnote.png) - -{% tip %} - -**Note**: The position of a footnote in your Markdown does not influence where the footnote will be rendered. You can write a footnote right after your reference to the footnote, and the footnote will still render at the bottom of the Markdown. - -{% endtip %} -{% endif %} - -## Hiding content with comments - -You can tell {% data variables.product.product_name %} to hide content from the rendered Markdown by placing the content in an HTML comment. - -
-<!-- This content will not appear in the rendered Markdown -->
-
- -## Markdown のフォーマットの無視 - -{% data variables.product.product_name %}に対し、Markdown のキャラクタの前に `\` を使うことで、Markdown のフォーマットを無視 (エスケープ) させることができます。 - -`\*新しいプロジェクト\* を \*古いプロジェクト\* にリネームしましょう` - -![表示されたエスケープキャラクタ](/assets/images/help/writing/escaped-character-rendered.png) - -詳しい情報については Daring Fireball の [Markdown Syntax](https://daringfireball.net/projects/markdown/syntax#backslash) を参照してください。 - -{% ifversion fpt or ghes > 3.2 or ghae-issue-5232 or ghec %} - -## Disabling Markdown rendering - -{% data reusables.repositories.disabling-markdown-rendering %} - -{% endif %} - -## 参考リンク - -- [{% data variables.product.prodname_dotcom %} Flavored Markdown の仕様](https://github.github.com/gfm/) -- [GitHub 上での書き込みと書式設定について](/articles/about-writing-and-formatting-on-github) -- [高度なフォーマットを使用して作業する](/articles/working-with-advanced-formatting) -- [Markdown をマスターする](https://guides.github.com/features/mastering-markdown/) diff --git a/translations/ja-JP/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/index.md b/translations/ja-JP/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/index.md deleted file mode 100644 index ea5bd1d80c..0000000000 --- a/translations/ja-JP/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/index.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: GitHub で書き、フォーマットしてみる -redirect_from: - - /articles/markdown-basics - - /articles/things-you-can-do-in-a-text-area-on-github - - /articles/getting-started-with-writing-and-formatting-on-github -intro: GitHub の Issue、プルリクエスト、およびウィキでは、シンプルな機能を使用してコメントをフォーマットしたり他のユーザとやりとりしたりできます。 -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -children: - - /about-writing-and-formatting-on-github - - /basic-writing-and-formatting-syntax -shortTitle: Start writing on GitHub ---- - diff --git a/translations/ja-JP/content/github/writing-on-github/index.md b/translations/ja-JP/content/github/writing-on-github/index.md deleted file mode 100644 index b8e1602180..0000000000 --- a/translations/ja-JP/content/github/writing-on-github/index.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -title: GitHub での執筆 -redirect_from: - - /categories/88/articles - - /articles/github-flavored-markdown - - /articles/writing-on-github - - /categories/writing-on-github -intro: 'You can structure the information shared on {% data variables.product.product_name %} with various formatting options.' -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -children: - - /getting-started-with-writing-and-formatting-on-github - - /working-with-advanced-formatting - - /working-with-saved-replies - - /editing-and-sharing-content-with-gists ---- - diff --git a/translations/ja-JP/content/github/writing-on-github/working-with-advanced-formatting/attaching-files.md b/translations/ja-JP/content/github/writing-on-github/working-with-advanced-formatting/attaching-files.md deleted file mode 100644 index b9d860ff80..0000000000 --- a/translations/ja-JP/content/github/writing-on-github/working-with-advanced-formatting/attaching-files.md +++ /dev/null @@ -1,60 +0,0 @@ ---- -title: Attaching files -intro: You can convey information by attaching a variety of file types to your issues and pull requests. -redirect_from: - - /github/managing-your-work-on-github/managing-your-work-with-issues-and-pull-requests/file-attachments-on-issues-and-pull-requests - - /articles/issue-attachments - - /articles/file-attachments-on-issues-and-pull-requests - - /github/managing-your-work-on-github/file-attachments-on-issues-and-pull-requests -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -topics: - - Pull requests ---- - -{% warning %} - -**Warning:** If you add an image{% ifversion fpt or ghes > 3.1 or ghae or ghec %} or video{% endif %} to a pull request or issue comment, anyone can view the anonymized URL without authentication, even if the pull request is in a private repository{% ifversion ghes %}, or if private mode is enabled{% endif %}. To keep sensitive media files private, serve them from a private network or server that requires authentication. {% ifversion fpt or ghec %}For more information on anonymized URLs see "[About anonymized URLs](/github/authenticating-to-github/about-anonymized-urls)".{% endif %} - -{% endwarning %} - -Issue やプルリクエストの会話にファイルを添付するには、コメントボックスにファイルをドラッグアンドドロップします。 または、コメントボックスの下部にあるバーをクリックしてコンピュータからファイルを参照、選択、追加することもできます。 - -![コンピュータから添付ファイルを選択する](/assets/images/help/pull_requests/select-bar.png) - -{% tip %} - -**ヒント:** 多くのブラウザでは、画像をコピーして直接ボックスに貼り付けることができます。 - -{% endtip %} - -The maximum file size is: -- 10MB for images and gifs{% ifversion fpt or ghec %} -- 10MB for videos uploaded to a repository owned by a user or organization on a free GitHub plan -- 100MB for videos uploaded to a repository owned by a user or organization on a paid GitHub plan{% elsif fpt or ghes > 3.1 or ghae %} -- 100MB for videos{% endif %} -- 25MB for all other files - -以下のファイルがサポートされています: - -* PNG (*.png*) -* GIF (*.gif*) -* JPEG (*.jpg*) -* ログファイル (*.log*) -* Microsoft Word (*.docx*)、Powerpoint (*.pptx*)、および Excel (*.xlsx*) 文書 -* テキストファイル (*.txt*) -* PDF (*.pdf*) -* ZIP (*.zip*, *.gz*){% ifversion fpt or ghes > 3.1 or ghae or ghec %} -* ビデオ(*.mp4*, *.mov*) - -{% note %} - -**Note:** Video codec compatibility is browser specific, and it's possible that a video you upload to one browser is not viewable on another browser. At the moment we recommend using h.264 for greatest compatibility. - -{% endnote %} -{% endif %} - -![添付アニメーション GIF](/assets/images/help/pull_requests/dragging_images.gif) diff --git a/translations/ja-JP/content/github/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md b/translations/ja-JP/content/github/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md deleted file mode 100644 index 900425c509..0000000000 --- a/translations/ja-JP/content/github/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md +++ /dev/null @@ -1,64 +0,0 @@ ---- -title: 自動リンクされた参照と URL -intro: URL、Issue、プルリクエスト、コミットへの参照は、自動的に短縮されてリンクに変換されます。 -redirect_from: - - /articles/autolinked-references-and-urls - - /github/writing-on-github/autolinked-references-and-urls -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -shortTitle: Auto linked references ---- - -## URL - -{% data variables.product.product_name %}は自動的に標準的な URL からリンクを生成します。 - -`Visit https://github.com` - -![変換された自動リンク URL](/assets/images/help/writing/url-autolink-rendered.png) - -リンクの生成に関する詳しい情報については[基本的な書き方とフォーマットの構文](/articles/basic-writing-and-formatting-syntax/#links)を参照してください。 - -## Issue およびプルリクエスト - -{% data variables.product.product_name %} 上の会話の中では、Issue やプルリクエストへの参照は自動的に短縮リンクに変換されます。 - -{% note %} - -**メモ:** 自動リンクされた参照は、ウィキやリポジトリ中のファイルでは生成されません。 - -{% endnote %} - -| 参照タイプ | RAW 参照 | 短縮リンク | -| --------------------------------------------- | ---------------------------------------------- | ---------------------------------------------------------------------- | -| Issue またはプルリクエストの URL | https://github.com/jlord/sheetsee.js/issues/26 | [#26](https://github.com/jlord/sheetsee.js/issues/26) | -| `#` and issue or pull request number | #26 | [#26](https://github.com/jlord/sheetsee.js/issues/26) | -| `GH` および Issue またはプルリクエスト番号 | GH-26 | [GH-26](https://github.com/jlord/sheetsee.js/issues/26) | -| `ユーザ名/リポジトリ#` および Issue またはプルリクエスト番号 | jlord/sheetsee.js#26 | [jlord/sheetsee.js#26](https://github.com/jlord/sheetsee.js/issues/26) | -| `Organization 名/リポジトリ#`および Issue またはプルリクエスト番号 | github/linguist#4039 | [github/linguist#4039](https://github.com/github/linguist/pull/4039) | - -{% ifversion fpt or ghec %} -If you reference an issue, pull request, or discussion in a list, the reference will unfurl to show the title and state instead. For more information about task lists, see "[About task lists](/issues/tracking-your-work-with-issues/creating-issues/about-task-lists)." -{% endif %} - -## コミット SHA - -コミットの SHA ハッシュへの参照は、{% data variables.product.product_name %}上のコミットへの短縮リンクに自動的に変換されます。 - -| 参照タイプ | RAW 参照 | 短縮リンク | -| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------- | -| コミット URL | [`https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e`](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | [a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | -| SHA | a5c3785ed8d6a35868bc169f07e40e889087fd2e | [a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | -| ユーザ@SHA | jlord@a5c3785ed8d6a35868bc169f07e40e889087fd2e | [jlord@a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | -| `ユーザ名/リポジトリ@SHA` | `jlord/sheetsee.js@a5c3785ed8d6a35868bc169f07e40e889087fd2e` | [`jlord/sheetsee.js@a5c3785`](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | - -## 外部リソースへのカスタム自動リンク - -{% data reusables.repositories.autolink-references %} - -## 参考リンク - -- [基本的な書き方とフォーマットの構文](/articles/basic-writing-and-formatting-syntax) diff --git a/translations/ja-JP/content/github/writing-on-github/working-with-advanced-formatting/creating-a-permanent-link-to-a-code-snippet.md b/translations/ja-JP/content/github/writing-on-github/working-with-advanced-formatting/creating-a-permanent-link-to-a-code-snippet.md deleted file mode 100644 index eb62ef8a8c..0000000000 --- a/translations/ja-JP/content/github/writing-on-github/working-with-advanced-formatting/creating-a-permanent-link-to-a-code-snippet.md +++ /dev/null @@ -1,49 +0,0 @@ ---- -title: コードスニペットへのパーマリンクを作成する -intro: 特定バージョンのファイルやプルリクエストにある特定のコード行やコード行の範囲へのパーマリンクを作成できます。 -redirect_from: - - /github/managing-your-work-on-github/managing-your-work-with-issues-and-pull-requests/creating-a-permanent-link-to-a-code-snippet - - /articles/creating-a-permanent-link-to-a-code-snippet - - /github/managing-your-work-on-github/creating-a-permanent-link-to-a-code-snippet -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -topics: - - Pull requests -shortTitle: Permanent links to code ---- - -## Linking to code - -このタイプのパーマリンクは、元々作成された場所であるリポジトリでのみ、コードスニペットとして表示されます。 それ以外のリポジトリでは、パーマリンクのコードスニペットは URL として表示されます。 - -![コメントに表示されたコードスニペット](/assets/images/help/repository/rendered-code-snippet.png) - -{% tip %} - -**ヒント:** ファイル全体に対してパーマリンクを作成する方法は、「[ファイルにパーマリンクを張る](/articles/getting-permanent-links-to-files)」を参照してください。 - -{% endtip %} - -{% data reusables.repositories.navigate-to-repo %} -2. リンクしたいコードを特定します: - - ファイルからコードにリンクするには、対象のファイルに移動します。 - - プルリクエストからコードにリンクするには、対象のプルリクエストに移動して {% octicon "diff" aria-label="The file diff icon" %}[**Files changed**] をクリックします。 次に、コメントに含めたいコードを持っているファイルを探し、[**View**] をクリックします。 -{% data reusables.repositories.choose-line-or-range %} -4. 行または行範囲の左にある {% octicon "kebab-horizontal" aria-label="The horizontal kebab octicon" %}をクリックします。 ドロップダウンメニューで [**Copy permalink**] をクリックします。 ![選択された行のパーマリンクをコピーするオプションのあるケバブメニュー](/assets/images/help/repository/copy-permalink-specific-line.png) -5. コードスニペットにリンクさせたい会話に移動します。 -6. コメントにパーマリンクを貼り付け、[**Comment**] をクリックします。 ![同じリポジトリ内のコメントに貼り付けられたパーマリンク](/assets/images/help/repository/code-snippet-permalink-in-comment.png) - -## Linking to Markdown - -You can link to specific lines in Markdown files by loading the Markdown file without Markdown rendering. To load a Markdown file without rendering, you can use the `?plain=1` parameter at the end of the url for the file. For example, `github.com///blob//README.md?plain=1`. - -You can link to a specific line in the Markdown file the same way you can in code. Append `#L` with the line number or numbers at the end of the url. For example, `github.com///blob//README.md?plain=1#L14` will highlight line 14 in the plain README.md file. - -## 参考リンク - -- "[Issue の作成](/articles/creating-an-issue/)" -- "[コードから Issue を開く](/articles/opening-an-issue-from-code/)" -- 「[プルリクエスト内の変更をレビューする](/articles/reviewing-changes-in-pull-requests/)」 diff --git a/translations/ja-JP/content/github/writing-on-github/working-with-advanced-formatting/creating-and-highlighting-code-blocks.md b/translations/ja-JP/content/github/writing-on-github/working-with-advanced-formatting/creating-and-highlighting-code-blocks.md deleted file mode 100644 index 8cd0f7d346..0000000000 --- a/translations/ja-JP/content/github/writing-on-github/working-with-advanced-formatting/creating-and-highlighting-code-blocks.md +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: コードブロックの作成と強調表示 -intro: コードのサンプルをコードブロックにし、構文を強調表示して共有しましょう。 -redirect_from: - - /articles/creating-and-highlighting-code-blocks - - /github/writing-on-github/creating-and-highlighting-code-blocks -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -shortTitle: Create code blocks ---- - -## コードブロック - -三連バッククォート \`\`\` をコードのブロック前後に入力すると、コードブロックを作成できます。 ソースコードを読みやすくするために、コードブロックの前後に空の行を入れることをお勧めします。 - -
-```
-function test() {
-  console.log("この関数の前に空白行があるのがわかりますか?");
-}
-```
-
- -![表示されたコードブロック](/assets/images/help/writing/fenced-code-block-rendered.png) - -{% tip %} - -**ヒント:** リスト内でフォーマットを保持するために、フェンスされていないコードのブロックをスペース 8 つでインデントしてください。 - -{% endtip %} - -To display triple backticks in a fenced code block, wrap them inside quadruple backticks. - - -
-```` 
-```
-Look! You can see my backticks.
-```
-````
-
- -![Rendered fenced code with backticks block](/assets/images/help/writing/fenced-code-show-backticks-rendered.png) - -{% data reusables.user_settings.enabling-fixed-width-fonts %} - -## 構文の強調表示 - - - -言語識別子を追加して、コードブロックの構文を強調表示することができます。 - -たとえば、Ruby コードの構文を強調表示するには: - - ```ruby - require 'redcarpet' - markdown = Redcarpet.new("Hello World!") - puts markdown.to_html - ``` - -![Ruby の構文を強調して表示されたコードブロック](/assets/images/help/writing/code-block-syntax-highlighting-rendered.png) - -構文強調表示のための言語検出の実行や[サードパーティの文法](https://github.com/github/linguist/blob/master/vendor/README.md)の選択には [Linguist](https://github.com/github/linguist) を使用します。 どのキーワードが有効かについては[言語 YAML ファイル](https://github.com/github/linguist/blob/master/lib/linguist/languages.yml)でご覧いただけます。 - -## 参考リンク - -- [{% data variables.product.prodname_dotcom %} Flavored Markdown の仕様](https://github.github.com/gfm/) -- [基本的な書き方とフォーマットの構文](/articles/basic-writing-and-formatting-syntax) diff --git a/translations/ja-JP/content/github/writing-on-github/working-with-advanced-formatting/index.md b/translations/ja-JP/content/github/writing-on-github/working-with-advanced-formatting/index.md deleted file mode 100644 index 211d3351c7..0000000000 --- a/translations/ja-JP/content/github/writing-on-github/working-with-advanced-formatting/index.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: 高度なフォーマットを使用して作業する -intro: テーブルのようなフォーマット、構文の強調表示、および自動リンキングを使用すると、プルリクエスト、Issue、およびコメントに複雑な情報を明確に配置できます。 -redirect_from: - - /articles/working-with-advanced-formatting -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -children: - - /organizing-information-with-tables - - /organizing-information-with-collapsed-sections - - /creating-and-highlighting-code-blocks - - /autolinked-references-and-urls - - /attaching-files - - /creating-a-permanent-link-to-a-code-snippet - - /using-keywords-in-issues-and-pull-requests -shortTitle: Work with advanced formatting ---- - diff --git a/translations/ja-JP/content/github/writing-on-github/working-with-advanced-formatting/organizing-information-with-collapsed-sections.md b/translations/ja-JP/content/github/writing-on-github/working-with-advanced-formatting/organizing-information-with-collapsed-sections.md deleted file mode 100644 index 854821d2fa..0000000000 --- a/translations/ja-JP/content/github/writing-on-github/working-with-advanced-formatting/organizing-information-with-collapsed-sections.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Organizing information with collapsed sections -intro: You can streamline your Markdown by creating a collapsed section with the `
` tag. -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -shortTitle: Collapsed sections ---- - -## Creating a collapsed section - -You can temporarily obscure sections of your Markdown by creating a collapsed section that the reader can choose to expand. For example, when you want to include technical details in an issue comment that may not be relevant or interesting to every reader, you can put those details in a collapsed section. - -Any Markdown within the `
` block will be collapsed until the reader clicks {% octicon "triangle-right" aria-label="The right triange icon" %} to expand the details. Within the `
` block, use the `` tag to create a label to the right of {% octicon "triangle-right" aria-label="The right triange icon" %}. - -```markdown -
CLICK ME -

- -#### We can hide anything, even code! - - ```ruby - puts "Hello World" - ``` - -

```

- -The Markdown will be collapsed by default. - -![Rendered collapsed](/assets/images/help/writing/collapsed-section-view.png) - -After a reader clicks {% octicon "triangle-right" aria-label="The right triange icon" %}, the details are expanded. - -![Rendered open](/assets/images/help/writing/open-collapsed-section.png) - -## 参考リンク - -- [{% data variables.product.prodname_dotcom %} Flavored Markdown の仕様](https://github.github.com/gfm/) -- [基本的な書き方とフォーマットの構文](/articles/basic-writing-and-formatting-syntax) diff --git a/translations/ja-JP/content/github/writing-on-github/working-with-advanced-formatting/organizing-information-with-tables.md b/translations/ja-JP/content/github/writing-on-github/working-with-advanced-formatting/organizing-information-with-tables.md deleted file mode 100644 index fb938aa2bd..0000000000 --- a/translations/ja-JP/content/github/writing-on-github/working-with-advanced-formatting/organizing-information-with-tables.md +++ /dev/null @@ -1,82 +0,0 @@ ---- -title: 情報を表に編成する -intro: 表を作成して、コメント、Issue、プルリクエスト、ウィキの情報を編成できます。 -redirect_from: - - /articles/organizing-information-with-tables - - /github/writing-on-github/organizing-information-with-tables -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -shortTitle: Organized data with tables ---- - -## 表を作成する - -表は、パイプ文字 (`|`) とハイフン (`-`) を使って作成できます。 ハイフンでヘッダを作成し、パイプ文字で各列を分けます。 正しく表示されるように、表の前には空白行を 1 行追加してください。 - -```markdown - -| ヘッダ 1 | ヘッダ 2 | -| ------------- | ------------- | -| 内容セル | 内容セル | -| 内容セル | 内容セル | -``` - -![レンダリングされた表](/assets/images/help/writing/table-basic-rendered.png) - -表の両側のパイプ文字はオプションです。 - -セルの幅は変わるので、列がぴったり一致する必要はありません。 各列のヘッダ行には、ハイフンを 3 つ以上使用してください。 - -```markdown -| Command | Description | -| --- | --- | -| git status | List all new or modified files | -| git diff | Show file differences that haven't been staged | -``` - -![異なるセル幅で表示された表](/assets/images/help/writing/table-varied-columns-rendered.png) - -{% data reusables.user_settings.enabling-fixed-width-fonts %} - -## 表の内容をフォーマットする - -表では、リンク、インラインのコードブロック、テキストスタイルなどの[フォーマット](/articles/basic-writing-and-formatting-syntax)を使用できます。 - -```markdown -| Command | Description | -| --- | --- | -| `git status` | List all *new or modified* files | -| `git diff` | Show file differences that **haven't been** staged | -``` - -![テキストをフォーマットして表示された表](/assets/images/help/writing/table-inline-formatting-rendered.png) - -ヘッダー行でハイフンの左、右、両側にコロン (`:`) を使うと、列でテキストを左寄せ、右寄せ、センタリングすることができます。 - -```markdown -| Left-aligned | Center-aligned | Right-aligned | -| :--- | :---: | ---: | -| git status | git status | git status | -| git diff | git diff | git diff | -``` - -![テキストを左寄せ、右寄せ、センタリングして表示された表](/assets/images/help/writing/table-aligned-text-rendered.png) - -セルでパイプ文字 (`|`) を使用するには、パイプ文字の前に `\` を追加します。 - -```markdown -| Name | Character | -| --- | --- | -| Backtick | ` | -| Pipe | \| | -``` - -![パイプ文字をエスケープして表示された表](/assets/images/help/writing/table-escaped-character-rendered.png) - -## 参考リンク - -- [{% data variables.product.prodname_dotcom %} Flavored Markdown の仕様](https://github.github.com/gfm/) -- [基本的な書き方とフォーマットの構文](/articles/basic-writing-and-formatting-syntax) diff --git a/translations/ja-JP/content/github/writing-on-github/working-with-advanced-formatting/using-keywords-in-issues-and-pull-requests.md b/translations/ja-JP/content/github/writing-on-github/working-with-advanced-formatting/using-keywords-in-issues-and-pull-requests.md deleted file mode 100644 index eeed68533e..0000000000 --- a/translations/ja-JP/content/github/writing-on-github/working-with-advanced-formatting/using-keywords-in-issues-and-pull-requests.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: Using keywords in issues and pull requests -intro: Use keywords to link an issue and pull request or to mark an issue or pull request as a duplicate. -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -topics: - - Issues - - Pull requests ---- - -## プルリクエストをIssueにリンクする - -To link a pull request to an issue to{% ifversion fpt or ghes or ghae or ghec %} show that a fix is in progress and to{% endif %} automatically close the issue when someone merges the pull request, type one of the following keywords followed by a reference to the issue. For example, `Closes #10` or `Fixes octo-org/octo-repo#100`. - -* close -* closes -* closed -* fix -* fixes -* fixed -* 解決 -* resolves -* resolved - -詳しい情報については「[プルリクエストのIssueへのリンク](/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue)」を参照してください。 - -## Marking an issue or pull request as a duplicate - -Issueあるいはプルリクエストに重複としてマーク付けをするには、新たなコメントの本文に"Duplicate of"に続けて重複のIssueあるいはプルリクエストの番号を入力してください。 For more information, see "[Marking issues or pull requests as a duplicate](/issues/tracking-your-work-with-issues/marking-issues-or-pull-requests-as-a-duplicate)." diff --git a/translations/ja-JP/content/github/writing-on-github/working-with-saved-replies/about-saved-replies.md b/translations/ja-JP/content/github/writing-on-github/working-with-saved-replies/about-saved-replies.md deleted file mode 100644 index d0f96a4018..0000000000 --- a/translations/ja-JP/content/github/writing-on-github/working-with-saved-replies/about-saved-replies.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: 返信テンプレートについて -intro: Issue やプルリクエストに返信する際に返信テンプレートを利用できます。 -redirect_from: - - /articles/about-saved-replies - - /github/writing-on-github/about-saved-replies -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' ---- - -![返信テンプレート](/assets/images/help/settings/saved-replies.png) - -返信テンプレートを使うと、Issue やプルリクエストへの再利用可能な返信を作成できます。 頻繁に使う返信用に返信テンプレートを作成して、時間を節約してください。 - -追加した返信テンプレートは、Issue でもプルリクエストでも利用できます。 返信テンプレートはユーザアカウントに結びつけられます。 作成した返信テンプレートは、リポジトリや Organization にまたがって利用できます。 - -返信テンプレートは最大で 100 個作成できます。 上限に達した場合、使わなくなった返信テンプレートを削除したり、既存の返信テンプレートを編集したりすることができます。 - -また、{% data variables.product.product_name %}が提供する "Duplicate issue" 返信テンプレートを使い、Issue を重複としてマークして、類似 Issue と合わせて追跡できます。 - -## 参考リンク - -- [返信テンプレートの作成](/articles/creating-a-saved-reply) -- 「[返信テンプレートを利用する](/articles/using-saved-replies)」 -- 「[返信テンプレートを編集する](/articles/editing-a-saved-reply)」 -- [返信テンプレートの削除](/articles/deleting-a-saved-reply) diff --git a/translations/ja-JP/content/github/writing-on-github/working-with-saved-replies/creating-a-saved-reply.md b/translations/ja-JP/content/github/writing-on-github/working-with-saved-replies/creating-a-saved-reply.md deleted file mode 100644 index df9fdb6097..0000000000 --- a/translations/ja-JP/content/github/writing-on-github/working-with-saved-replies/creating-a-saved-reply.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: 返信テンプレートの作成 -intro: 同じコメントを何度も頻繁に追加する場合は、返信テンプレートを作成しておくと便利です。 -redirect_from: - - /articles/creating-a-saved-reply - - /github/writing-on-github/creating-a-saved-reply -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' ---- - -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.saved_replies %} -3. [Add a saved reply] の下に返信テンプレートのタイトルを追加します。 ![返信テンプレートタイトル](/assets/images/help/settings/saved-replies-title.png) -4. [Write] フィールドに、返信テンプレートに使用するコンテンツを追加します。 {% data variables.product.product_name %} での書き方に関する詳しい情報については「[基本的な書き方とフォーマットの構文](/articles/basic-writing-and-formatting-syntax)」を参照してください。 ![返信テンプレートを書く](/assets/images/help/settings/saved-replies-settings-adding.png) -5. 返信をレビューするには、[**Preview**] をクリックします。 ![返信テンプレートの追加](/assets/images/help/settings/saved-replies-preview.png) -6. [**Add saved reply**] をクリックします。 !["Add saved reply" button](/assets/images/help/settings/saved-replies-add-button.png) - -## 参考リンク - -- 「[返信テンプレートを利用する](/articles/using-saved-replies)」 -- 「[返信テンプレートを編集する](/articles/editing-a-saved-reply)」 -- [返信テンプレートの削除](/articles/deleting-a-saved-reply) diff --git a/translations/ja-JP/content/github/writing-on-github/working-with-saved-replies/deleting-a-saved-reply.md b/translations/ja-JP/content/github/writing-on-github/working-with-saved-replies/deleting-a-saved-reply.md deleted file mode 100644 index 02ce851196..0000000000 --- a/translations/ja-JP/content/github/writing-on-github/working-with-saved-replies/deleting-a-saved-reply.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: 返信テンプレートの削除 -intro: 使用しなくなった返信テンプレートは削除できます。 -redirect_from: - - /articles/deleting-a-saved-reply - - /github/writing-on-github/deleting-a-saved-reply -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' ---- - -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.saved_replies %} -3. [Saved replies] で、削除対象の返信テンプレートの隣にある {% octicon "x" aria-label="The X" %} をクリックします。 - ![返信テンプレートを削除する](/assets/images/help/settings/saved-replies-delete-existing.png) diff --git a/translations/ja-JP/content/github/writing-on-github/working-with-saved-replies/editing-a-saved-reply.md b/translations/ja-JP/content/github/writing-on-github/working-with-saved-replies/editing-a-saved-reply.md deleted file mode 100644 index 3eb54fea9c..0000000000 --- a/translations/ja-JP/content/github/writing-on-github/working-with-saved-replies/editing-a-saved-reply.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: 返信テンプレートを編集する -intro: 返信テンプレートのタイトルと本文を編集できます。 -redirect_from: - - /articles/changing-a-saved-reply - - /articles/editing-a-saved-reply - - /github/writing-on-github/editing-a-saved-reply -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' ---- - -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.saved_replies %} -3. [Saved replies] で、編集対象の返信テンプレートの隣にある {% octicon "pencil" aria-label="The pencil" %} をクリックします。 - ![返信テンプレートの編集](/assets/images/help/settings/saved-replies-edit-existing.png) -4. [Edit saved reply] で、返信テンプレートのタイトルと内容を編集できます。 ![タイトルと内容を編集](/assets/images/help/settings/saved-replies-edit-existing-content.png) -5. [**Update saved reply**] をクリックします。 ![返信テンプレートの更新](/assets/images/help/settings/saved-replies-save-edit.png) - -## 参考リンク - -- [返信テンプレートの作成](/articles/creating-a-saved-reply) -- [返信テンプレートの削除](/articles/deleting-a-saved-reply) -- 「[返信テンプレートを利用する](/articles/using-saved-replies)」 diff --git a/translations/ja-JP/content/github/writing-on-github/working-with-saved-replies/index.md b/translations/ja-JP/content/github/writing-on-github/working-with-saved-replies/index.md deleted file mode 100644 index 9bd88fd129..0000000000 --- a/translations/ja-JP/content/github/writing-on-github/working-with-saved-replies/index.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: 返信テンプレートを使って作業する -intro: 時間を節約し、一貫したメッセージを配信していることを確認するために、返信テンプレートを Issue およびプルリクエストのコメントに追加できます。 -redirect_from: - - /articles/working-with-saved-replies -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -children: - - /about-saved-replies - - /creating-a-saved-reply - - /editing-a-saved-reply - - /deleting-a-saved-reply - - /using-saved-replies -shortTitle: Work with saved replies ---- - diff --git a/translations/ja-JP/content/github/writing-on-github/working-with-saved-replies/using-saved-replies.md b/translations/ja-JP/content/github/writing-on-github/working-with-saved-replies/using-saved-replies.md deleted file mode 100644 index 41478aa834..0000000000 --- a/translations/ja-JP/content/github/writing-on-github/working-with-saved-replies/using-saved-replies.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: 返信テンプレートを使う -intro: Issue またはプルリクエストにコメントするときは、すでに設定した 返信テンプレートを追加できます。 返信テンプレートをコメント全体にすることも、カスタマイズしたい場合はコンテンツを追加または削除することもできます。 -redirect_from: - - /articles/using-saved-replies - - /github/writing-on-github/using-saved-replies -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' ---- - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-issue-pr %} -2. 希望する Issue またはプルリクエストをクリックします。 -3. 返信テンプレートを追加するには、コメントフィールドで、{% octicon "reply" aria-label="The mail reply" %} をクリックします。 ![[Saved replies] ボタン](/assets/images/help/writing/saved-replies-button.png) -4. リストから、コメントに追加したい返信テンプレートを選択します。 ![返信テンプレート](/assets/images/help/settings/saved-replies.png) - -{% tip %} - -**参考:** -- キーボードショートカットを使用して、返信テンプレートをコメントに自動入力できます。 詳細は「[キーボードのショートカット](/articles/keyboard-shortcuts/#comments)」を参照してください。 -- 返信テンプレートのタイトルを入力して、フィルタリングすることができます。 - -{% endtip %} - -## 参考リンク - -- [返信テンプレートの作成](/articles/creating-a-saved-reply) -- 「[返信テンプレートを編集する](/articles/editing-a-saved-reply)」 -- [返信テンプレートの削除](/articles/deleting-a-saved-reply) diff --git a/translations/pt-BR/content/github/importing-your-projects-to-github/importing-source-code-to-github/about-github-importer.md b/translations/pt-BR/content/github/importing-your-projects-to-github/importing-source-code-to-github/about-github-importer.md deleted file mode 100644 index eb16ce7657..0000000000 --- a/translations/pt-BR/content/github/importing-your-projects-to-github/importing-source-code-to-github/about-github-importer.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: Sobre o Importador do GitHub -intro: 'Se você tiver o código-fonte no Subversion, Mercurial, Controle de versões do Team Foundation (TFVC) ou outro repositório Git, você poderá movê-lo para o GitHub usando o Importador do GitHub.' -redirect_from: - - /articles/about-github-importer - - /github/importing-your-projects-to-github/about-github-importer -versions: - fpt: '*' - ghec: '*' ---- - -O Importador do GitHub é uma ferramenta que importa rapidamente repositórios do código-fonte, incluindo commits e histórico de revisão, para o GitHub. - -![Importar um gif do repositório](/assets/images/help/importer/github-importer.gif) - -Durante uma importação, dependendo do sistema de controle de versão do qual você está fazendo a importação, é possível autenticar com seu repositório remoto, atualizar a atribuição do autor do commit e importar repositórios com arquivos grandes (ou remover arquivos grandes se não desejar usar o Armazenamento de arquivos grandes do Git). - -| Ação de importação | Subversion | Mercurial | TFVC | Git | -|:---------------------------------------------------------------------------------------------------------------- |:----------:|:---------:|:-----:|:-----:| -| Autenticar com repositório remoto | **X** | **X** | **X** | **X** | -| [Atualizar atribuição do autor do commit](/articles/updating-commit-author-attribution-with-github-importer) | **X** | **X** | **X** | | -| Mover arquivos grandes para o [Armazenamento de arquivos grandes do Git](/articles/about-git-large-file-storage) | **X** | **X** | **X** | | -| Remover arquivos grandes do repositório | **X** | **X** | **X** | | - -## Leia mais - -- "[Importar um repositório com o Importador do GitHub](/articles/importing-a-repository-with-github-importer)" -- "[Atualizar a atribuição do autor do commit com o Importador do GitHub](/articles/updating-commit-author-attribution-with-github-importer)" -- "[Importar um repositório Git usando a linha de comando](/articles/importing-a-git-repository-using-the-command-line)" -- "[Ferramentas de migração do código-fonte](/articles/source-code-migration-tools)" diff --git a/translations/pt-BR/content/github/importing-your-projects-to-github/importing-source-code-to-github/adding-an-existing-project-to-github-using-the-command-line.md b/translations/pt-BR/content/github/importing-your-projects-to-github/importing-source-code-to-github/adding-an-existing-project-to-github-using-the-command-line.md deleted file mode 100644 index d388534711..0000000000 --- a/translations/pt-BR/content/github/importing-your-projects-to-github/importing-source-code-to-github/adding-an-existing-project-to-github-using-the-command-line.md +++ /dev/null @@ -1,158 +0,0 @@ ---- -title: Adicionar um projeto existente ao GitHub usando a linha de comando -intro: 'Colocar um trabalho que já existe no {% data variables.product.product_name %} pode permitir que você compartilhe e colabore de muitas maneiras.' -redirect_from: - - /articles/add-an-existing-project-to-github - - /articles/adding-an-existing-project-to-github-using-the-command-line - - /github/importing-your-projects-to-github/adding-an-existing-project-to-github-using-the-command-line -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -shortTitle: Adicionar um projeto localmente ---- - -## Sobre a adição de projetos existentes para {% data variables.product.product_name %} - -{% tip %} - -**Dica:** se estiver mais familiarizado com uma interface de usuário de apontar e clicar, tente adicionar seu projeto com o {% data variables.product.prodname_desktop %}. Para obter mais informações, consulte "[Adicionar um repositório do seu computador local ao GitHub Desktop](/desktop/guides/contributing-to-projects/adding-a-repository-from-your-local-computer-to-github-desktop)" na Ajuda do *{% data variables.product.prodname_desktop %}*. - -{% endtip %} - -{% data reusables.repositories.sensitive-info-warning %} - -## Adicionando um projeto a {% data variables.product.product_name %} com {% data variables.product.prodname_cli %} - -{% data variables.product.prodname_cli %} é uma ferramenta de código aberto para usar {% data variables.product.prodname_dotcom %} a partir da linha de comando do seu computador. {% data variables.product.prodname_cli %} pode simplificar o processo de adicionar um projeto existente a {% data variables.product.product_name %} usando a linha de comando. Para saber mais sobre {% data variables.product.prodname_cli %}, consulte "[Sobre {% data variables.product.prodname_cli %}](/github-cli/github-cli/about-github-cli)." - -1. Na linha de comando, acesse o diretório raiz do seu projeto. -1. Inicialize o diretório local como um repositório Git. - - ```shell - git init -b main - ``` - -1. Faça o teste e commit de todos os arquivos do seu projeto - - ```shell - git add . && git commit -m "initial commit" - ``` - -1. Para criar um repositório para o seu projeto no GitHub, use o subcomando `gh repo create`. Quando solicitado, selecione **Fazer push de um repositório local existente para o GitHub** e digite o nome desejado para o repositório. Se você quiser que o seu projeto pertença a uma organização em vez de sua conta de usuário, especifique o nome da organização e o nome do projeto com `organization-name/project-name`. - -1. Siga as instruções interativas. Para adicionar o controle remoto e fazer push do repositório, confirme sim quando solicitado para adicionar o controle remoto e enviar os commits para o branch atual. - -1. Como alternativa, para pular todas as instruções, fornecer o caminho do repositório com o sinalizador `--source` e passar um sinalizador de visibilidade (`--public`, `--privado` ou `--interno`). Por exemplo, `gh repo create --source=. --public`. Especifique um controle remoto com o o sinalizador `--remote`. Para fazer push dos seus commits, passe o sinalizador `--push`. Para obter mais informações sobre possíveis argumentos, consulte o [manual da CLI do GitHub](https://cli.github.com/manual/gh_repo_create). - -## Adicionando um projeto a {% data variables.product.product_name %} sem {% data variables.product.prodname_cli %} - -{% mac %} - -1. [Crie um repositório ](/repositories/creating-and-managing-repositories/creating-a-new-repository) no {% data variables.product.product_location %}. Para evitar erros, não inicialize o novo repositório com os arquivos *README*, de licença ou `gitignore`. É possível adicionar esses arquivos após push do projeto no {% data variables.product.product_name %}. ![Menu suspenso Create New Repository (Criar novo repositório)](/assets/images/help/repository/repo-create.png) -{% data reusables.command_line.open_the_multi_os_terminal %} -3. Altere o diretório de trabalho atual referente ao seu projeto local. -4. Inicialize o diretório local como um repositório Git. - ```shell - $ git init -b main - ``` -5. Adicione os arquivos ao novo repositório local. Isso faz stage deles para o primeiro commit. - ```shell - $ git add . - # Adiciona os arquivos no repositório local e faz stage deles para commit. {% data reusables.git.unstage-codeblock %} - ``` -6. Faça commit dos arquivos com stage em seu repositório local. - ```shell - $ git commit -m "First commit" - # Commits the tracked changes and prepares them to be pushed to a remote repository. {% data reusables.git.reset-head-to-previous-commit-codeblock %} - ``` -7. Na parte superior do seu repositório na página de Configuração Rápida de {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %}, clique em {% octicon "clippy" aria-label="The copy to clipboard icon" %} para copiar a URL do repositório remoto. ![Campo Copy remote repository URL (Copiar URL do repositório remote)](/assets/images/help/repository/copy-remote-repository-url-quick-setup.png) -8. No Terminal, [adicione a URL para o repositório remote](/github/getting-started-with-github/managing-remote-repositories) onde será feito push do seu repositório local. - ```shell - $ git remote add origin <REMOTE_URL> - # Sets the new remote - $ git remote -v - # Verifies the new remote URL - ``` -9. [Push the changes](/github/getting-started-with-github/pushing-commits-to-a-remote-repository/) (Faça push das alterações no seu repositório local para o {% data variables.product.product_location %}. - ```shell - $ git push -u origin main - # Pushes the changes in your local repository up to the remote repository you specified as the origin - ``` - -{% endmac %} - -{% windows %} - -1. [Crie um repositório ](/articles/creating-a-new-repository) no {% data variables.product.product_location %}. Para evitar erros, não inicialize o novo repositório com os arquivos *README*, de licença ou `gitignore`. É possível adicionar esses arquivos após push do projeto no {% data variables.product.product_name %}. ![Menu suspenso Create New Repository (Criar novo repositório)](/assets/images/help/repository/repo-create.png) -{% data reusables.command_line.open_the_multi_os_terminal %} -3. Altere o diretório de trabalho atual referente ao seu projeto local. -4. Inicialize o diretório local como um repositório Git. - ```shell - $ git init -b main - ``` -5. Adicione os arquivos ao novo repositório local. Isso faz stage deles para o primeiro commit. - ```shell - $ git add . - # Adiciona os arquivos no repositório local e faz stage deles para commit. {% data reusables.git.unstage-codeblock %} - ``` -6. Faça commit dos arquivos com stage em seu repositório local. - ```shell - $ git commit -m "First commit" - # Commits the tracked changes and prepares them to be pushed to a remote repository. {% data reusables.git.reset-head-to-previous-commit-codeblock %} - ``` -7. Na parte superior do seu repositório na página de Configuração Rápida de {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %}, clique em {% octicon "clippy" aria-label="The copy to clipboard icon" %} para copiar a URL do repositório remoto. ![Campo Copy remote repository URL (Copiar URL do repositório remote)](/assets/images/help/repository/copy-remote-repository-url-quick-setup.png) -8. No prompt de comando, [adicione a URL para o repositório remote](/github/getting-started-with-github/managing-remote-repositories) onde será feito push do seu repositório local. - ```shell - $ git remote add origin <REMOTE_URL> - # Sets the new remote - $ git remote -v - # Verifies the new remote URL - ``` -9. [Push the changes](/github/getting-started-with-github/pushing-commits-to-a-remote-repository/) (Faça push das alterações no seu repositório local para o {% data variables.product.product_location %}. - ```shell - $ git push origin main - # Pushes the changes in your local repository up to the remote repository you specified as the origin - ``` - -{% endwindows %} - -{% linux %} - -1. [Crie um repositório ](/articles/creating-a-new-repository) no {% data variables.product.product_location %}. Para evitar erros, não inicialize o novo repositório com os arquivos *README*, de licença ou `gitignore`. É possível adicionar esses arquivos após push do projeto no {% data variables.product.product_name %}. ![Menu suspenso Create New Repository (Criar novo repositório)](/assets/images/help/repository/repo-create.png) -{% data reusables.command_line.open_the_multi_os_terminal %} -3. Altere o diretório de trabalho atual referente ao seu projeto local. -4. Inicialize o diretório local como um repositório Git. - ```shell - $ git init -b main - ``` -5. Adicione os arquivos ao novo repositório local. Isso faz stage deles para o primeiro commit. - ```shell - $ git add . - # Adiciona os arquivos no repositório local e faz stage deles para commit. {% data reusables.git.unstage-codeblock %} - ``` -6. Faça commit dos arquivos com stage em seu repositório local. - ```shell - $ git commit -m "First commit" - # Commits the tracked changes and prepares them to be pushed to a remote repository. {% data reusables.git.reset-head-to-previous-commit-codeblock %} - ``` -7. Na parte superior do seu repositório na página de Configuração Rápida de {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %}, clique em {% octicon "clippy" aria-label="The copy to clipboard icon" %} para copiar a URL do repositório remoto. ![Campo Copy remote repository URL (Copiar URL do repositório remote)](/assets/images/help/repository/copy-remote-repository-url-quick-setup.png) -8. No Terminal, [adicione a URL para o repositório remote](/github/getting-started-with-github/managing-remote-repositories) onde será feito push do seu repositório local. - ```shell - $ git remote add origin <REMOTE_URL> - # Sets the new remote - $ git remote -v - # Verifies the new remote URL - ``` -9. [Push the changes](/github/getting-started-with-github/pushing-commits-to-a-remote-repository/) (Faça push das alterações no seu repositório local para o {% data variables.product.product_location %}. - ```shell - $ git push origin main - # Pushes the changes in your local repository up to the remote repository you specified as the origin - ``` - -{% endlinux %} - -## Leia mais - -- "[Adicionar um arquivo a um repositório](/repositories/working-with-files/managing-files/adding-a-file-to-a-repository#adding-a-file-to-a-repository-using-the-command-line)" diff --git a/translations/pt-BR/content/github/importing-your-projects-to-github/importing-source-code-to-github/importing-a-git-repository-using-the-command-line.md b/translations/pt-BR/content/github/importing-your-projects-to-github/importing-source-code-to-github/importing-a-git-repository-using-the-command-line.md deleted file mode 100644 index 1982830ff7..0000000000 --- a/translations/pt-BR/content/github/importing-your-projects-to-github/importing-source-code-to-github/importing-a-git-repository-using-the-command-line.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: Importar um repositório Git usando a linha de comando -intro: '{% ifversion fpt %}Se [Importador do GitHub](/articles/importing-a-repository-with-github-importer) não for adequado para os seus propósitos como se o seu código existente estivesse hospedado em uma rede privada, recomendamos realizar a importação usando a linha de comando.{% else %}Importar projetos do Git usando a linha de comando é adequado quando seu código existente está hospedado em uma rede privada.{% endif %}' -redirect_from: - - /articles/importing-a-git-repository-using-the-command-line - - /github/importing-your-projects-to-github/importing-a-git-repository-using-the-command-line -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -shortTitle: Importar o repositório localmente ---- - -Antes de iniciar, certifique-se de que sabe: - -- Seu nome de usuário {% data variables.product.product_name %} -- A URL clone para o repositório externo, como `https://external-host.com/user/repo.git` ou `git://external-host.com/user/repo.git` (talvez com um `usuário@` na frente do nome do domínio `external-host.com`) - -{% tip %} - -Como demonstração, usaremos: - -- Uma conta externa denominada **extuser** -- Um host Git externo denominado `https://external-host.com` -- Uma conta de usuário {% data variables.product.product_name %} pessoal denominada **ghuser** -- Um repositório em {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %} chamado **repo.git** - -{% endtip %} - -1. [Crie um novo repositório em {% data variables.product.product_name %}](/articles/creating-a-new-repository). Você importará o repositório Git externo para este novo repositório. -2. Na linha de comando, faça um clone "vazio" do repositório usando a URL clone externo. Isso criará uma cópia integral dos dados, mas sem um diretório de trabalho para editar arquivos, e garantirá uma exportação limpa e recente de todos os dados antigos. - ```shell - $ git clone --bare https://external-host.com/extuser/repo.git - # Makes a bare clone of the external repository in a local directory - ``` -3. Faça o push do repositório clonado localmente em {% data variables.product.product_name %} usando a opção "mirror" (espelho), que assegura que todas as referências, como branches e tags, são copiadas para o repositório importado. - ```shell - $ cd repo.git - $ git push --mirror https://{% data variables.command_line.codeblock %}/ghuser/repo.git - # Pushes the mirror to the new repository on {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %} - ``` -4. Remova o repositório local temporário. - ```shell - $ cd .. - $ rm -rf repo.git - ``` diff --git a/translations/pt-BR/content/github/importing-your-projects-to-github/importing-source-code-to-github/importing-a-repository-with-github-importer.md b/translations/pt-BR/content/github/importing-your-projects-to-github/importing-source-code-to-github/importing-a-repository-with-github-importer.md deleted file mode 100644 index f2d2dfeed1..0000000000 --- a/translations/pt-BR/content/github/importing-your-projects-to-github/importing-source-code-to-github/importing-a-repository-with-github-importer.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: Importar um repositório usando o Importador do GitHub -intro: 'Caso tenha um projeto hospedado em outro sistema de controle de versão, é possível importá-lo automaticamente para o GitHub usando a ferramenta Importador do GitHub.' -redirect_from: - - /articles/importing-from-other-version-control-systems-to-github - - /articles/importing-a-repository-with-github-importer - - /github/importing-your-projects-to-github/importing-a-repository-with-github-importer -versions: - fpt: '*' - ghec: '*' -shortTitle: Use Importador do GitHub ---- - -{% tip %} - -**Dica:** o Importador do GitHub não é indicado para todas as importações. Por exemplo, se o código existente está hospedado em uma rede privada, sua ferramenta não conseguirá acessá-lo. Nesses casos, recomendamos [importar usando a linha de comando](/articles/importing-a-git-repository-using-the-command-line) para repositórios Git ou uma [ferramenta de migração de código-fonte](/articles/source-code-migration-tools) externa para projetos importados por outros sistemas de controle de versões. - -{% endtip %} - -Se você quiser combinar os commits de seu repositório com as contas de usuário GitHub do autor durante a importação, garanta que cada contribuidor de seu repositório tem uma conta GitHub antes de você começar a importação. - -{% data reusables.repositories.repo-size-limit %} - -1. No canto superior direito de qualquer página, clique em {% octicon "plus" aria-label="Plus symbol" %} e depois clique em **Import repository** (Importar repositório). ![Opção Import repository (Importar repositório) no menu New repository (Repositório novo)](/assets/images/help/importer/import-repository.png) -2. Embaixo de "Your old repository's clone URL" (URL clone de seu antigo repositório), digite a URL do projeto que quer importar. ![Campo de texto para URL de repositório importado](/assets/images/help/importer/import-url.png) -3. Escolha sua conta de usuário ou uma organização para ser proprietária do repositório e digite um nome para o repositório no GitHub. ![Menu Repository owner (Proprietário do repositório) e campo repository name (nome do repositório)](/assets/images/help/importer/import-repo-owner-name.png) -4. Especifique se o novo repositório deve ser *público* ou *privado*. Para obter mais informações, consulte "[Configurar visibilidade do repositório](/articles/setting-repository-visibility)". ![Botões de rádio Public or private repository (Repositório público ou privado)](/assets/images/help/importer/import-public-or-private.png) -5. Revise a informação que digitou e clique em **Begin import** (Iniciar importação). ![Botão Begin import (Iniciar importação)](/assets/images/help/importer/begin-import-button.png) -6. Caso seu projeto antigo esteja protegido por uma senha, digite sua informação de login para aquele projeto e clique em **Submit** (Enviar). ![Formulário de senha e botão Submit (Enviar) para projetos protegidos por senha](/assets/images/help/importer/submit-old-credentials-importer.png) -7. Se houver vários projetos hospedados na URL clone de seu projeto antigo, selecione o projeto que você quer importar e clique em **Submit** (Enviar). ![Lista de projetos para importar e botão Submit (Enviar)](/assets/images/help/importer/choose-project-importer.png) -8. Se seu projeto contiver arquivos maiores que 100 MB, selecione se quer importar os arquivos maiores usando o [Git Large File Storage](/articles/versioning-large-files) e clique em **Continue** (Continuar). ![Menu do Git Large File Storage e botão Continue (Continuar)](/assets/images/help/importer/select-gitlfs-importer.png) - -Você receberá um e-mail quando o repositório for totalmente importado. - -## Leia mais - -- "[Atualizar a atribuição do autor do commit com o Importador do GitHub](/articles/updating-commit-author-attribution-with-github-importer)" diff --git a/translations/pt-BR/content/github/importing-your-projects-to-github/importing-source-code-to-github/index.md b/translations/pt-BR/content/github/importing-your-projects-to-github/importing-source-code-to-github/index.md deleted file mode 100644 index d57a022ff4..0000000000 --- a/translations/pt-BR/content/github/importing-your-projects-to-github/importing-source-code-to-github/index.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: Importar código-fonte para o GitHub -intro: 'É possível importar repositórios para o GitHub com o {% ifversion fpt %}Importador do GitHub, linha de comando,{% else %}linha de comando{% endif %} ou ferramentas externas de migração.' -redirect_from: - - /articles/importing-an-external-git-repository - - /articles/importing-from-bitbucket - - /articles/importing-an-external-git-repo - - /articles/importing-your-project-to-github - - /articles/importing-source-code-to-github -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -children: - - /about-github-importer - - /importing-a-repository-with-github-importer - - /updating-commit-author-attribution-with-github-importer - - /importing-a-git-repository-using-the-command-line - - /adding-an-existing-project-to-github-using-the-command-line - - /source-code-migration-tools -shortTitle: Importar código para o GitHub ---- - diff --git a/translations/pt-BR/content/github/importing-your-projects-to-github/importing-source-code-to-github/source-code-migration-tools.md b/translations/pt-BR/content/github/importing-your-projects-to-github/importing-source-code-to-github/source-code-migration-tools.md deleted file mode 100644 index 8e04b51619..0000000000 --- a/translations/pt-BR/content/github/importing-your-projects-to-github/importing-source-code-to-github/source-code-migration-tools.md +++ /dev/null @@ -1,58 +0,0 @@ ---- -title: Ferramentas de migração de código-fonte -intro: Você pode usar ferramentas externas para mover seus projetos para o GitHub. -redirect_from: - - /articles/importing-from-subversion - - /articles/source-code-migration-tools - - /github/importing-your-projects-to-github/source-code-migration-tools -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -shortTitle: Ferramentas de migração de código ---- - -{% ifversion fpt or ghec %} - -Recomendamos usar o [Importador do GitHub](/articles/about-github-importer) para importar projetos de Subversion, Mercurial, Controle de versão do Team Foundation (TFVC) ou outro repositório Git. Você também pode usar essas ferramentas externas para converter o projeto em Git. - -{% endif %} - -## Importar do Subversion - -Em um ambiente típico do Subversion, vários projetos são armazenados em um único repositório raiz. No GitHub, cada um desses projetos é associado a um repositório do Git separado para uma conta de usuário ou organização. Sugerimos que você importe cada parte do repositório do Subversion para um repositório separado do GitHub se: - -* Os colaboradores precisarem fazer checkout ou commit na parte do projeto separada de outras partes -* Desejar que diferentes partes tenham suas próprias permissões de acesso - -Recomendamos estas ferramentas para converter repositórios do Subversion em Git: - -- [`git-svn`](https://git-scm.com/docs/git-svn) -- [svn2git](https://github.com/nirvdrum/svn2git) - -## Importar do Mercurial - -Recomendamos o [hg-fast-export](https://github.com/frej/fast-export) para converter repositórios do Mercurial em Git. - -## Importando do TFVC - -Recomendamos [git-tfs](https://github.com/git-tfs/git-tfs) para transferir alterações entre TFVC e Git. - -Para obter mais informações sobre como mudar do TFVC (um sistema centralizado de controle de versão) para o Git, consulte "[Planeje sua migração para o Git](https://docs.microsoft.com/devops/develop/git/centralized-to-git)" no site da documentação da Microsoft. - -{% tip %} - -**Dica:** depois de converter com sucesso o projeto em Git, você poderá [fazer push dele para o {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/pushing-commits-to-a-remote-repository/). - -{% endtip %} - -{% ifversion fpt or ghec %} - -## Leia mais - -- "[Sobre o Importador do GitHub](/articles/about-github-importer)" -- "[Importar um repositório com o Importador do GitHub](/articles/importing-a-repository-with-github-importer)" -- [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}) - -{% endif %} diff --git a/translations/pt-BR/content/github/importing-your-projects-to-github/importing-source-code-to-github/updating-commit-author-attribution-with-github-importer.md b/translations/pt-BR/content/github/importing-your-projects-to-github/importing-source-code-to-github/updating-commit-author-attribution-with-github-importer.md deleted file mode 100644 index 088835053e..0000000000 --- a/translations/pt-BR/content/github/importing-your-projects-to-github/importing-source-code-to-github/updating-commit-author-attribution-with-github-importer.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: Atualizar atribuição de autor do commit com o Importador do GitHub -intro: 'Durante uma importação, é possível corresponder os commits no repositório com a conta do GitHub do autor do commit.' -redirect_from: - - /articles/updating-commit-author-attribution-with-github-importer - - /github/importing-your-projects-to-github/updating-commit-author-attribution-with-github-importer -versions: - fpt: '*' - ghec: '*' -shortTitle: Atualizar o autor do Importador do GitHub ---- - -O Importador do GitHub procura usuários do GitHub cujos endereços de e-mail correspondam aos autores dos commits no repositório que está sendo importado. Você poderá então conectar um commit ao seu autor usando o endereço de e-mail dele ou o nome de usuário do autor no GitHub. - -## Atualizar autores do commit - -1. Depois que você tiver importado o repositório, clique em **Match authors** (Corresponder autores) na página de status de importação. ![Botão Match authors (Corresponder autores)](/assets/images/help/importer/match-authors-button.png) -2. Clique em **Connect** (Conectar) ao lado do autor cujas informações você deseja atualizar. ![Lista de autores do commit](/assets/images/help/importer/connect-commit-author.png) -3. Digite o endereço de e-mail ou o nome de usuário do autor no GitHub e pressione **Enter**. - -## Atribuir commits a um usuário do GitHub com endereço de e-mail público - -Se o autor de um commit no repositório importado tiver uma conta do GitHub associada ao endereço de e-mail usado para criar os commits e ele não tiver [definido o endereço de e-mail do commit como privado](/articles/setting-your-commit-email-address), o Importador do GitHub corresponderá o endereço de e-mail associado ao commit com o endereço de e-mail público associado à conta dele no GitHub e atribuirá o commit a ela. - -## Atribuir commits a um usuário do GitHub sem endereço de e-mail público - -Se o autor de um commit no repositório importado não tiver definindo um endereço de e-mail público no perfil dele no GitHub nem [definido o endereço de e-mail do commit como privado](/articles/setting-your-commit-email-address), talvez o Importador do GitHub não consiga corresponder o endereço de e-mail associado ao commit com a conta dele no GitHub. - -O autor do commit pode resolver isso definindo o endereço de e-mail dele como privado. Os commits passarão a ser atribuídos a `@users.noreply.github.com`, e os commits importados serão associados à conta dele no GitHub. - -## Atribuir commits usando um endereço de e-mail - -Se o endereço de e-mail do autor não estiver associado à conta dele no GitHub, o autor poderá [adicionar o endereço à conta dele](/articles/adding-an-email-address-to-your-github-account) após a importação, e os commits serão atribuídos corretamente. - -Caso o autor não tenha uma conta do GitHub, o Importador do GitHub atribuirá os commits dele ao endereço de e-mail associado aos commits. - -## Leia mais - -- "[Sobre o Importador do GitHub](/articles/about-github-importer)" -- "[Importar um repositório com o Importador do GitHub](/articles/importing-a-repository-with-github-importer)" -- "[Adicionar um endereço de e-mail à sua conta](/articles/adding-an-email-address-to-your-github-account/)" -- "[Configurar endereço de e-mail do commit](/articles/setting-your-commit-email-address)" diff --git a/translations/pt-BR/content/github/importing-your-projects-to-github/index.md b/translations/pt-BR/content/github/importing-your-projects-to-github/index.md deleted file mode 100644 index b6f8a62250..0000000000 --- a/translations/pt-BR/content/github/importing-your-projects-to-github/index.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: Importar projetos para o GitHub -intro: 'Você pode importar seu código-fonte para {% data variables.product.product_name %} usando uma série de métodos diferentes.' -shortTitle: Importar seus projetos -redirect_from: - - /categories/67/articles - - /categories/importing - - /categories/importing-your-projects-to-github -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -children: - - /importing-source-code-to-github - - /working-with-subversion-on-github ---- - diff --git a/translations/pt-BR/content/github/importing-your-projects-to-github/working-with-subversion-on-github/index.md b/translations/pt-BR/content/github/importing-your-projects-to-github/working-with-subversion-on-github/index.md deleted file mode 100644 index 007174cb1d..0000000000 --- a/translations/pt-BR/content/github/importing-your-projects-to-github/working-with-subversion-on-github/index.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: Trabalhar com o Subversion no GitHub -intro: É possível usar clientes do Subversion e alguns fluxos de trabalho e propriedades do Subversion com o GitHub. -redirect_from: - - /articles/working-with-subversion-on-github -versions: - fpt: '*' - ghes: '*' - ghec: '*' -children: - - /what-are-the-differences-between-subversion-and-git - - /support-for-subversion-clients - - /subversion-properties-supported-by-github -shortTitle: Trabalhar com Subversion no GitHub ---- - diff --git a/translations/pt-BR/content/github/importing-your-projects-to-github/working-with-subversion-on-github/subversion-properties-supported-by-github.md b/translations/pt-BR/content/github/importing-your-projects-to-github/working-with-subversion-on-github/subversion-properties-supported-by-github.md deleted file mode 100644 index 293b009b78..0000000000 --- a/translations/pt-BR/content/github/importing-your-projects-to-github/working-with-subversion-on-github/subversion-properties-supported-by-github.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: Propriedades do Subversion com suporte no GitHub -intro: 'Existem vários fluxos de trabalho e propriedades do Subversion que são semelhantes a funções existentes no {% data variables.product.product_name %}.' -redirect_from: - - /articles/subversion-properties-supported-by-github - - /github/importing-your-projects-to-github/subversion-properties-supported-by-github -versions: - fpt: '*' - ghes: '*' - ghec: '*' -shortTitle: Propriedades compatíveis com o GitHub ---- - -## Arquivos executáveis (svn:executable) - -Nós convertemos propriedades `svn:executable` atualizando o modo de arquivo diretamente antes de adicioná-lo ao repositório Git. - -## Tipos MIME (svn:mime-type) - -O {% data variables.product.product_name %} monitora internamente as propriedades tipo MIME de arquivos e os commits que as adicionaram. - -## Ignorar itens sem controle de versão (svn:ignore) - -Se você tiver definido arquivos e diretórios para serem ignorados no Subversion, eles serão monitorados internamente pelo {% data variables.product.product_name %}. Os arquivos ignorados por clientes do Subversion são completamente distintos das entradas em um arquivo *.gitignore*. - -## Propriedades sem suporte atualmente - -O {% data variables.product.product_name %} não oferece suporte atualmente a `svn:externals`, `svn:global-ignores` ou qualquer propriedade que não esteja listada acima, inclusive propriedades personalizadas. diff --git a/translations/pt-BR/content/github/importing-your-projects-to-github/working-with-subversion-on-github/support-for-subversion-clients.md b/translations/pt-BR/content/github/importing-your-projects-to-github/working-with-subversion-on-github/support-for-subversion-clients.md deleted file mode 100644 index f4352154c7..0000000000 --- a/translations/pt-BR/content/github/importing-your-projects-to-github/working-with-subversion-on-github/support-for-subversion-clients.md +++ /dev/null @@ -1,133 +0,0 @@ ---- -title: Suporte para clientes do Subversion -intro: Os repositórios GitHub podem ser acessados por meio do Git e de clientes do Subversion (SVN). Este artigo aborda o uso de um cliente do Subversion no GitHub e alguns problemas comuns que podem ocorrer. -redirect_from: - - /articles/support-for-subversion-clients - - /github/importing-your-projects-to-github/support-for-subversion-clients -versions: - fpt: '*' - ghes: '*' - ghec: '*' -shortTitle: Suporte para clientes do Subversion ---- - -O GitHub oferece suporte a clientes do Subversion por meio do protocolo HTTPS. Usamos uma ponte do Subversion para comunicar comandos svn ao GitHub. - -## Recursos do Subversion com suporte no GitHub - -### Fazer checkout - -A primeira ação a ser executada é um checkout do Subversion. Como os clones do Git mantêm o diretório de trabalho (onde você edita os arquivos) separado dos dados do repositório, há apenas um branch no diretório de trabalho de cada vez. - -Os checkouts do Subversion são diferentes: eles combinam os dados do repositório nos diretórios de trabalho, por isso há um diretório de trabalho para cada branch e tag de que tenha sido feito checkout. Em repositórios com muitos branches e tags, fazer checkout de tudo pode sobrecarregar a largura de banda, por isso é recomendável começar com um checkout parcial. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.copy-clone-url %} - -3. Faça um checkout vazio do repositório: - ```shell - $ svn co --depth empty https://github.com/user/repo - > Checked out revision 1. - $ cd repo - ``` - -4. Obtenha o branch `trunk`. A ponte do Subversion mapeia o trunk com o branch HEAD do Git. - ```shell - $ svn up trunk - > A trunk - > A trunk/README.md - > A trunk/gizmo.rb - > Updated to revision 1. - ``` - -5. Obtenha um checkout vazio do diretório `branches`. É aqui que ficam todos os branches diferentes de `HEAD` e onde você fará branches de recurso. - ```shell - $ svn up --depth empty branches - Updated to revision 1. - ``` - -### Criar branches - -É possível criar branches usando a ponte do Subversion para o GitHub. - -A partir de seu cliente svn, certifique-se de que o "master" é atual atualizando o `trunk`: -```shell -$ svn up trunk -> At revision 1. -``` - -Em seguida, use `svn copy` para criar um novo branch: -```shell -$ svn copy trunk branches/more_awesome -> A branches/more_awesome -$ svn commit -m 'Branch de tópico more_awesome adicionado' -> Adicionando branches/more_awesome - -> Commit da revisão 2 concluído. -``` - -É possível confirmar a existência do novo branch na lista suspensa de branches do repositório: - -![branch-snapshot](/assets/images/help/branch/svnflow-branch-snapshot.png) - -Você também pode confirmar o novo branch por meio da linha de comando: - -```shell -$ git fetch -> Em https://github.com/user/repo/ -> * [novo branch] more_awesome -> origin/more_awesome -``` - -### Fazer commits no Subversion - -Depois que você tiver adicionado alguns recursos e corrigido alguns erros, vai querer fazer commit dessas alterações no GitHub. O procedimento é exatamente igual ao do Subversion, com o qual você já está acostumado. Edite os arquivos e use `svn commit` para registrar as alterações: - -```shell -$ svn status -> M gizmo.rb -$ svn commit -m 'Proteção contra problemas conhecidos' -> Enviando more_awesome/gizmo.rb -> Transmitindo dados do arquivo. -> Commit da revisão 3 concluído. -$ svn status -> ? test -$ svn add test -> A test -> A test/gizmo_test.rb -$ svn commit -m 'Alcance do teste para problemas' -> Adicionando more_awesome/test -> Adicionando more_awesome/test/gizmo_test.rb -> Transmitindo dados do arquivo. -> Commit da revisão 4 concluído. -``` - -### Alternar entre branches - -Para alternar entre branches, você provavelmente vai querer começar com um checkout de `trunk`: - -```shell -$ svn co --depth empty https://github.com/user/repo/trunk -``` - -E depois alternar para outro branch: - -```shell -$ svn switch https://github.com/user/repo/branches/more_awesome -``` - -## Localizar o SHA do commit do Git para um commit do Subversion - -O servidor do Subversion do GitHub expõe o SHA do commit do Git referente a cada commit do Subversion. - -Para ver o SHA do commit, você deve solicitar a propriedade remota sem controle de versão `git-commit`. - -```shell -$ svn propget git-commit --revprop -r HEAD https://github.com/user/repo -05fcc584ed53d7b0c92e116cb7e64d198b13c4e3 -``` - -Com esse SHA do commit, é possível, por exemplo, procurar o commit do Git no GitHub. - -## Leia mais - -* "[Propriedades do Subversion com suporte no GitHub](/articles/subversion-properties-supported-by-github)" diff --git a/translations/pt-BR/content/github/importing-your-projects-to-github/working-with-subversion-on-github/what-are-the-differences-between-subversion-and-git.md b/translations/pt-BR/content/github/importing-your-projects-to-github/working-with-subversion-on-github/what-are-the-differences-between-subversion-and-git.md deleted file mode 100644 index 3d98edd818..0000000000 --- a/translations/pt-BR/content/github/importing-your-projects-to-github/working-with-subversion-on-github/what-are-the-differences-between-subversion-and-git.md +++ /dev/null @@ -1,70 +0,0 @@ ---- -title: Diferenças entre o Subversion e o Git -intro: 'Os repositórios do Subversion (SVN) são semelhantes aos do Git, mas com várias diferenças em relação à arquitetura dos projetos.' -redirect_from: - - /articles/what-are-the-differences-between-svn-and-git - - /articles/what-are-the-differences-between-subversion-and-git - - /github/importing-your-projects-to-github/what-are-the-differences-between-subversion-and-git -versions: - fpt: '*' - ghes: '*' - ghec: '*' -shortTitle: Subversão & diferenças do Git ---- - -## Estrutura do diretório - -Cada *referência* ou instantâneo etiquetado de um commit em um projeto é organizado em subdiretórios específicos, como `trunk`, `branches` e `tags`. Por exemplo, um projeto do SVN com dois recursos em desenvolvimento pode ter esta aparência: - - sample_project/trunk/README.md - sample_project/trunk/lib/widget.rb - sample_project/branches/new_feature/README.md - sample_project/branches/new_feature/lib/widget.rb - sample_project/branches/another_new_feature/README.md - sample_project/branches/another_new_feature/lib/widget.rb - -Um fluxo de trabalho do SVN fica assim: - -* O diretório `trunk` representa a versão estável mais recente de um projeto. -* O trabalho de recurso ativo é desenvolvido com subdiretórios em `branches`. -* Quando um recurso é concluído, o diretório dele passa por merge em `trunk` e é removido. - -Os projetos do Git também são armazenados em um único diretório. No entanto, o Git obscurece os detalhes das referências armazenando-os em um diretório *.git* especial. Por exemplo, um projeto do Git com dois recursos em desenvolvimento pode ter esta aparência: - - sample_project/.git - sample_project/README.md - sample_project/lib/widget.rb - -Um fluxo de trabalho do Git fica assim: - -* Um repositório do Git armazena o histórico completo de todos os branches e tags dentro do diretório *.git*. -* A última versão estável está contida no branch-padrão. -* O trabalho de recurso ativo é desenvolvido em branches separados. -* Quando um recurso é concluído, o branch de recurso é mesclado no branch-padrão e excluído. - -Ao contrário do SVN, a estrutura de diretórios no Git permanece a mesma, mas o conteúdo dos arquivos é alterado de acordo com o branch que você possui. - -## Incluir subprojetos - -Um *subprojeto* é um projeto desenvolvido e gerenciado em algum lugar fora do projeto principal. Normalmente, você importa um subprojeto para adicionar alguma funcionalidade ao seu projeto sem precisar manter o código por conta própria. Sempre que o subprojeto é atualizado, você pode sincronizá-lo com o projeto para garantir que tudo esteja atualizado. - -No SVN, um subprojeto é chamado de *SVN externo*. No Git, ele é chamado de *submódulo do Git*. Embora conceitualmente semelhantes, os submódulos do Git não são mantidos atualizados de forma automática. É preciso solicitar explicitamente que uma nova versão seja trazida para o projeto. - -Para obter mais informações, consulte "[Submódulos das ferramentas do Git](https://git-scm.com/book/en/Git-Tools-Submodules)" na documentação do Git. - -## Preservar o histórico - -O SVN está configurado para pressupor que o histórico de um projeto nunca é alterado. O Git permite modificar alterações e commits anteriores usando ferramentas como [`git rebase`](/github/getting-started-with-github/about-git-rebase). - -{% tip %} - -[O GitHub oferece suporte a clientes do Subversion](/articles/support-for-subversion-clients), o que pode produzir alguns resultados inesperados se você está usando o Git e o SVN no mesmo projeto. Se você tiver manipulado o histórico de commits do Git, esses mesmos commits permanecerão para sempre no histórico do SVN. Caso tenha feito commit acidentalmente em alguns dados confidenciais, temos [um artigo para ajudar você a removê-lo do histórico do Git](/articles/removing-sensitive-data-from-a-repository). - -{% endtip %} - -## Leia mais - -- "[Propriedades do Subversion com suporte no GitHub](/articles/subversion-properties-supported-by-github)" -- ["Fazer branch e merge" no livro _Git SCM_ book](https://git-scm.com/book/en/Git-Branching-Basic-Branching-and-Merging) -- "[Importar código-fonte para o GitHub](/articles/importing-source-code-to-github)" -- "[Ferramentas de migração do código-fonte](/articles/source-code-migration-tools)" diff --git a/translations/pt-BR/content/github/understanding-how-github-uses-and-protects-your-data/about-githubs-use-of-your-data.md b/translations/pt-BR/content/github/understanding-how-github-uses-and-protects-your-data/about-githubs-use-of-your-data.md deleted file mode 100644 index 9401bfbcef..0000000000 --- a/translations/pt-BR/content/github/understanding-how-github-uses-and-protects-your-data/about-githubs-use-of-your-data.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: Sobre o uso dos seus dados pelo GitHub -redirect_from: - - /articles/about-github-s-use-of-your-data - - /articles/about-githubs-use-of-your-data -intro: 'O {% data variables.product.product_name %} usa os dados do seu repositório para conectar você a ferramentas, pessoas, projetos e informações relevantes.' -versions: - fpt: '*' - ghec: '*' -topics: - - Policy - - Legal -shortTitle: Uso dos seus dados pelo GitHub ---- - -## Sobre o uso dos seus dados de {% data variables.product.product_name %} - -O {% data variables.product.product_name %} agrega metadados e analisa padrões de conteúdo com a finalidade de fornecer insights genéricos sobre o produto. Ele usa dados de repositórios públicos, além de usar metadados e agregar dados de repositórios privados quando o proprietário de um repositório opta por compartilhar os dados com o {% data variables.product.product_name %} por meio de aceitação. Se você optar por um repositório privado no uso de dados, será feita uma análise somente leitura desse repositório privado específico. - -{% data reusables.repositories.about-github-archive-program %} Para mais informações, consulte "[Sobre arquivar conteúdo e dados no {% data variables.product.prodname_dotcom %}](/github/creating-cloning-and-archiving-repositories/about-archiving-content-and-data-on-github#about-the-github-archive-program)." - -{% data reusables.user_settings.export-data %} Para obter mais informações, consulte "[Solicitar um arquivamento dos dados da sua conta pessoal](/articles/requesting-an-archive-of-your-personal-account-s-data)". - -Se você aceitar o uso de dados para um repositório privado, continuaremos tratando seus dados privados, código-fonte ou segredos comerciais como confidenciais e privados em conformidade com nossos [Termos de Serviço](/free-pro-team@latest/github/site-policy/github-terms-of-service). As informações apreendidas são provenientes apenas de dados agregados. Para obter mais informações, consulte "[Gerenciando configurações do uso de dados de seu repositório privado](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository)". - -Anunciaremos novos recursos importantes que usam metadados ou dados agregados no [blog do {% data variables.product.prodname_dotcom %}](https://github.com/blog). - -## Como os dados melhoram as recomendações de segurança - -Para dar um exemplo de como os dados podem ser usados, podemos detectar e alertar você para uma vulnerabilidade de segurança nas dependências do seu repositório público. Para obter mais informações, consulte "[Sobre alertas para dependências vulneráveis](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)" - -Para detectar possíveis vulnerabilidades de segurança, o {% data variables.product.product_name %} verifica o conteúdo do arquivo de manifesto de dependência para extrair uma lista de dependências do seu projeto. - -O {% data variables.product.product_name %} também aprende com as alterações que você faz no manifesto de dependência. Por exemplo, se você atualizar uma dependência vulnerável para uma versão segura após receber um alerta de segurança e outras pessoas fizerem o mesmo, o {% data variables.product.product_name %} aprenderá como corrigir a vulnerabilidade e poderá recomendar um patch semelhante aos repositórios afetados. - -## Compartilhamento de dados e privacidade - -Os dados do repositório privada são verificados por máquina e nunca lidos pela equipe do {% data variables.product.product_name %}. Os olhos humanos nunca verão o conteúdo dos repositórios privados, exceto conforme descrito em nossos [Termos de serviço](/free-pro-team@latest/github/site-policy/github-terms-of-service#3-access). - -Os dados pessoais e individuais ou do seu repositório não serão compartilhados com terceiros. Podemos compartilhar dados agregados apreendidos por nossa análise com nossos parceiros. diff --git a/translations/pt-BR/content/github/understanding-how-github-uses-and-protects-your-data/index.md b/translations/pt-BR/content/github/understanding-how-github-uses-and-protects-your-data/index.md deleted file mode 100644 index be680a0f2b..0000000000 --- a/translations/pt-BR/content/github/understanding-how-github-uses-and-protects-your-data/index.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: Como o GitHub usa e protege seus dados -redirect_from: - - /categories/understanding-how-github-uses-and-protects-your-data -versions: - fpt: '*' - ghec: '*' -children: - - /about-githubs-use-of-your-data - - /requesting-an-archive-of-your-personal-accounts-data - - /managing-data-use-settings-for-your-private-repository - - /opting-into-or-out-of-the-github-archive-program-for-your-public-repository -shortTitle: Como o GitHub protege os dados ---- - diff --git a/translations/pt-BR/content/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository.md b/translations/pt-BR/content/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository.md deleted file mode 100644 index be00f786ff..0000000000 --- a/translations/pt-BR/content/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository.md +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: Gerenciando configurações de uso de dados para seu repositório privado -intro: 'Para ajudar o {% data variables.product.product_name %} a conectar você a ferramentas, pessoas, projetos e informações relevantes, você pode configurar o uso de dados de seu repositório privado.' -redirect_from: - - /articles/opting-into-or-out-of-data-use-for-your-private-repository - - /github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-data-use-for-your-private-repository -versions: - fpt: '*' - ghec: '*' -topics: - - Policy - - Legal -shortTitle: Gerenciar o uso de dados para repositório privado ---- - -## Sobre o uso de dados para seu repositório privado - -Ao habilitar o uso de dados para seu repositório privado, poderá acessar o gráfico de dependências, em que você pode acompanhar as dependências do repositório e receber {% data variables.product.prodname_dependabot_alerts %} quando o {% data variables.product.product_name %} detectar dependências vulneráveis. Para obter mais informações, consulte "[Sobre alertas para dependências vulneráveis](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies#dependabot-alerts-for-vulnerable-dependencies)" - -## Habilitar ou desabilitar os recursos de uso de dados - -{% data reusables.security.security-and-analysis-features-enable-read-only %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -{% data reusables.repositories.navigate-to-security-and-analysis %} -4. Em "Configurar funcionalidades de segurança e análise", à direita do recurso, clique em **Desabilitar** ou **Habilitar**.{% ifversion fpt %} !["Enable" or "Disable" button for "Configure security and analysis" features](/assets/images/help/repository/security-and-analysis-disable-or-enable-fpt-private.png){% elsif ghec %} -!["Enable" or "Disable" button for "Configure security and analysis" features](/assets/images/help/repository/security-and-analysis-disable-or-enable-ghec-private.png){% endif %} - -## Leia mais - -- "[Sobre o uso de seus dados pelo {% data variables.product.prodname_dotcom %}](/articles/about-github-s-use-of-your-data)" -- "[Visualizar e atualizar dependências vulneráveis no seu repositório](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository)" -- "[Gerenciar as configurações de segurança e análise para o seu repositório](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository)" diff --git a/translations/pt-BR/content/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-the-github-archive-program-for-your-public-repository.md b/translations/pt-BR/content/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-the-github-archive-program-for-your-public-repository.md deleted file mode 100644 index a84d479118..0000000000 --- a/translations/pt-BR/content/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-the-github-archive-program-for-your-public-repository.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: Optando por entrar ou sair do Programa de Arquivos do GitHub para seu repositório público -intro: 'Você pode gerenciar se {% data variables.product.prodname_dotcom %} inclui seu repositório público no {% data variables.product.prodname_archive %} para ajudar a garantir a preservação, no longo prazo, do software de código aberto mundial.' -permissions: 'People with admin permissions to a public repository can opt into or out of the {% data variables.product.prodname_archive %}.' -versions: - fpt: '*' - ghec: '*' -topics: - - Policy - - Legal -shortTitle: Programa arquivo do GitHub ---- - -{% data reusables.repositories.about-github-archive-program %} Para mais informações, consulte "[Sobre arquivar conteúdo e dados no {% data variables.product.prodname_dotcom %}](/github/creating-cloning-and-archiving-repositories/about-archiving-content-and-data-on-github#about-the-github-archive-program)." - -Se você optar por não participar do {% data variables.product.prodname_archive %} de um repositório, o repositório será excluído de qualquer arquivo de longo prazo que {% data variables.product.prodname_dotcom %} possa criar no futuro. Também enviaremos uma solicitação a cada uma das organizações parceiras para remover o repositório de seus dados. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -3. Em "Recursos", selecione ou retire a seleção de **Preservar este repositório**. ![Caixa de seleção para permitir que {% data variables.product.prodname_dotcom %} inclua seu código no {% data variables.product.prodname_archive %}](/assets/images/help/repository/github-archive-program-checkbox.png) - -## Leia mais -- [{% data variables.product.prodname_archive %} FAQ](https://archiveprogram.github.com/faq/) diff --git a/translations/pt-BR/content/github/understanding-how-github-uses-and-protects-your-data/requesting-an-archive-of-your-personal-accounts-data.md b/translations/pt-BR/content/github/understanding-how-github-uses-and-protects-your-data/requesting-an-archive-of-your-personal-accounts-data.md deleted file mode 100644 index dec7a0d021..0000000000 --- a/translations/pt-BR/content/github/understanding-how-github-uses-and-protects-your-data/requesting-an-archive-of-your-personal-accounts-data.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Solicitar um arquivo dos dados da conta pessoal -redirect_from: - - /articles/requesting-an-archive-of-your-personal-account-s-data - - /articles/requesting-an-archive-of-your-personal-accounts-data -intro: '{% data reusables.user_settings.export-data %}' -versions: - fpt: '*' - ghec: '*' -topics: - - Policy - - Legal -shortTitle: Solicitar arquivo da conta ---- - -O {% data variables.product.product_name %} os metadados de repositório e de perfil da atividade da conta pessoal. Você pode exportar os dados da conta pessoal por meio das configurações do {% data variables.product.prodname_dotcom_the_website %} ou com a API de migração de usuários. - -Para obter mais informações sobre os dados que {% data variables.product.product_name %} armazena e que estão disponíveis para exportação, consulte "[Fazer download do arquivo de migração de usuário](/rest/reference/migrations#download-a-user-migration-archive)" e "[Sobre o uso dos seus dados pelo {% data variables.product.product_name %}](/articles/about-github-s-use-of-your-data). - -Quando você solicita a exportação dos seus dados pessoais por meio das configurações do {% data variables.product.prodname_dotcom_the_website %}, o {% data variables.product.product_name %} empacota seus dados pessoais em um arquivo `tar.gz` e envia um e-mail para seu endereço de e-mail principal com um link para download. - -Por padrão, o link para download expira depois de sete dias. Você pode desabilitar o link para download a qualquer momento nas suas configurações de usuário. Para obter mais informações, consulte "[Excluir o acesso a um arquivo de dados da conta pessoal](/articles/requesting-an-archive-of-your-personal-account-s-data/#deleting-access-to-an-archive-of-your-personal-accounts-data)". - -Se seu sistema operacional não conseguir descompactar o arquivo `tar.gz`, use uma ferramenta de terceiros para extrair os arquivos compactados. Para obter mais informações, consulte "[How to unzip a tar.gz file](https://opensource.com/article/17/7/how-unzip-targz-file)" (Como descompactar um arquivo tar.gz) em Opensource.com. - -O arquivo `tar.gz` gerado reflete os dados armazenados no momento que você iniciou a exportação dos dados. - -## Fazer download de um arquivo dos dados da conta pessoal - -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.account_settings %} -3. Em "Export account data" (Exportar dados da conta), clique em **Start export** (Iniciar exportação) ou **New export** (Nova exportação). ![Botão de início da exportação de dados pessoais em destaque](/assets/images/help/repository/export-personal-data.png) ![Botão de nova exportação de dados pessoais em destaque](/assets/images/help/repository/new-export.png) -4. Quando a exportação estiver pronta para download, o {% data variables.product.product_name %} enviará um link para download ao seu endereço de e-mail principal. -5. Clique no link para download no e-mail e insira novamente a senha quando solicitado. -6. Você será redirecionado para um arquivo `tar.gz` disponível para download. - -## Excluir o acesso a um arquivo de dados da conta pessoal - -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.account_settings %} -3. Para desabilitar o link para download enviado para seu e-mail antes da data da expiração, em "Export account data" (Exportar dados da conta), encontre o download de exportação de dados que deseja desabilitar e clique em **Delete** (Excluir). ![Botão de exclusão do pacote de exportação de dados pessoais em destaque](/assets/images/help/repository/delete-export-personal-account-data.png) diff --git a/translations/pt-BR/content/github/writing-on-github/editing-and-sharing-content-with-gists/creating-gists.md b/translations/pt-BR/content/github/writing-on-github/editing-and-sharing-content-with-gists/creating-gists.md deleted file mode 100644 index 1f5c3658db..0000000000 --- a/translations/pt-BR/content/github/writing-on-github/editing-and-sharing-content-with-gists/creating-gists.md +++ /dev/null @@ -1,81 +0,0 @@ ---- -title: Criar gists -intro: 'Você pode criar dois tipos de gists: {% ifversion ghae %}internos{% else %}públicos{% endif %} e secretos. Crie um gist {% ifversion ghae %}interno{% else %}um público{% endif %} se você estiver pronto para compartilhar suas ideias com {% ifversion ghae %}os integrantes corporativos{% else %}o mundo{% endif %} ou um gist secreto se você não estiver pronto.' -permissions: '{% data reusables.enterprise-accounts.emu-permission-gist %}' -redirect_from: - - /articles/about-gists - - /articles/cannot-delete-an-anonymous-gist - - /articles/deleting-an-anonymous-gist - - /articles/creating-gists - - /github/writing-on-github/creating-gists -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' ---- - -## Sobre gists - -Cada gist é um repositório Git, o que significa que ele pode ser bifurcado e clonado. {% ifversion not ghae %}Se você estiver conectado em {% data variables.product.product_name %} quando{% else %}Quando{% endif %} você criar um gist, este será associado à sua conta e você irá vê-lo na sua lista de gists ao acessar o seu {% data variables.gists.gist_homepage %}. - -Os gists podem ser {% ifversion ghae %}internos{% else %}públicos{% endif %} ou segredo. Gists{% ifversion ghae %}Internos{% else %}Públicos{% endif %} aparecem em {% data variables.gists.discover_url %}, em que os {% ifversion ghae %}integrantes da empresa{% else %}pessoas{% endif %} podem pesquisar novos gists criados. Eles também são pesquisáveis, de modo que é possível usá-los se desejar que outras pessoas encontrem e vejam seu trabalho. - -Os gists secretos não aparecem em {% data variables.gists.discover_url %} e não são pesquisáveis. Os grupos de segredos não são privados. Se você enviar a URL de um gist do segredo para {% ifversion ghae %}outro integrante da empresa{% else %}um amigo{% endif %}, eles poderão vê-la. No entanto, se {% ifversion ghae %}qualquer outro integrante corporativo{% else %}alguém que você não conhece{% endif %} descobrir a URL, essa pessoa também poderá ver o seu gist. Se precisar manter seu código longe de olhares curiosos, pode ser mais conveniente [criar um repositório privado](/articles/creating-a-new-repository). - -{% data reusables.gist.cannot-convert-public-gists-to-secret %} - -{% ifversion ghes %} - -Se o administrador do site tiver desabilitado o modo privado, você também poderá usar gists anônimos, que podem ser públicos ou secretos. - -{% data reusables.gist.anonymous-gists-cannot-be-deleted %} - -{% endif %} - -Você receberá uma notificação quando: -- Você for o autor de um gist. -- Alguém mencionar você em um gist. -- Você assinar um gist, clicando em **Assinar** na parte superior de qualquer gist. - -{% ifversion fpt or ghes or ghec %} - -Você pode fixar os gists no seu perfil para que outras pessoas possam vê-los facilmente. Para obter mais informações, consulte "[Fixar itens ao seu perfil](/articles/pinning-items-to-your-profile)". - -{% endif %} - -Você pode descobrir gists {% ifversion ghae %}internos{% else %}públicos{% endif %} que outros criaram, acessando {% data variables.gists.gist_homepage %} e clicando em **Todos os Gists**. Isso levará você a uma página com todos os gists classificados e exibidos por data de criação ou atualização. Também é possível pesquisar gists por linguagem com {% data variables.gists.gist_search_url %}. A pesquisa de gist usa a mesma sintaxe de pesquisa que a [pesquisa de código](/search-github/searching-on-github/searching-code). - -Uma vez que os gists são repositórios Git, você pode exibir o histórico completo de commits deles, com diffs. Também é possível bifurcar ou clonar gists. Para obter mais informações, consulte ["Bifurcar e clonar gists"](/articles/forking-and-cloning-gists). - -Você pode baixar um arquivo ZIP de um gist clicando no botão **Download ZIP** (Baixar ZIP) no topo do gist. É possível inserir um gist em qualquer campo de texto que aceite Javascript, como uma postagem de blog. Para inserir código, clique no ícone de área de transferência ao lado de **Embed** URL de um gist. Para inserir um arquivo de gist específico, acrescente **Embed** URL com `?file=FILENAME`. - -{% ifversion fpt or ghec %} - -O gist permite mapeamento de arquivos geoJSON. Esses mapas são exibidos em gists inseridos, de modo que você pode compartilhar e inserir mapas facilmente. Para obter mais informações, consulte "[Trabalhando com arquivos sem código](/repositories/working-with-files/using-files/working-with-non-code-files#mapping-geojson-files-on-github)". - -{% endif %} - -## Criar um gist - -Siga os passos abaixo para criar um gist. - -{% ifversion fpt or ghes or ghae or ghec %} -{% note %} - -Você também pode criar um gist usando o {% data variables.product.prodname_cli %}. Para obter mais informações, consulte "[`gh gist cria`](https://cli.github.com/manual/gh_gist_create)" na documentação do {% data variables.product.prodname_cli %}. - -Como alternativa, você pode arrastar e soltar um arquivo de texto da sua área de trabalho diretamente no editor. - -{% endnote %} -{% endif %} - -1. Entre no {% data variables.product.product_name %}. -2. Navegue até sua {% data variables.gists.gist_homepage %}. -3. Digite uma descrição opcional e o nome do seu gist. ![Descrição do nome do gist](/assets/images/help/gist/gist_name_description.png) - -4. Digite o texto do seu gist na caixa de texto do gist. ![Caixa de texto do gist](/assets/images/help/gist/gist_text_box.png) - -5. Opcionalmente, para criar um gist {% ifversion ghae %}interno{% else %}público{% endif %}, clique em {% octicon "triangle-down" aria-label="The downwards triangle icon" %} e, em seguida, clique em **Criar {% ifversion ghae %}interno{% else %}público{% endif %} gist**. ![Menu suspenso para selecionar a visibilidade do gist]{% ifversion ghae %}(/assets/images/help/gist/gist-visibility-drop-down-ae.png){% else %}(/assets/images/help/gist/gist-visibility-drop-down.png){% endif %} - -6. Clique em **Criar Gist secreto** ou **Criar gist{% ifversion ghae %}interno{% else %}público{% endif %}**. ![Botão para criar gist](/assets/images/help/gist/create-secret-gist-button.png) diff --git a/translations/pt-BR/content/github/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists.md b/translations/pt-BR/content/github/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists.md deleted file mode 100644 index 0d7d85fd74..0000000000 --- a/translations/pt-BR/content/github/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: Bifurcar e clonar gists -intro: 'Gists são repositórios Git. Isso significa que é posível bifurcar ou clonar qualquer gist, mesmo não sendo o autor original. Também é possível visualizar o histórico completo de commits do gist, inclusive os diffs.' -permissions: '{% data reusables.enterprise-accounts.emu-permission-gist %}' -redirect_from: - - /articles/forking-and-cloning-gists - - /github/writing-on-github/forking-and-cloning-gists -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' ---- - -## Bifurcar gists - -Cada gist indica quais bifurcações têm atividade, facilitando o processo de encontrar mudanças interessantes de outros. - -![Bifurcações gist](/assets/images/help/gist/gist_forks.png) - -## Clonar gists - -Para fazer modificações locais em um gist e fazer o push delas na Web, é possível clonar um gist e fazer commits, assim como em qualquer repositório Git. Para obter mais informações, consulte "[Clonar um repositório](/articles/cloning-a-repository)". - -![Botão gist clone (clonar)](/assets/images/help/gist/gist_clone_btn.png) - -## Visualizar o histórico de commits do gist - -Para visualizar o histórico completo de commit de um gist, clique na aba "Revisões" na parte superior do gist. - -![Aba gist revisions (revisões)](/assets/images/help/gist/gist_revisions_tab.png) - -Você verá o histórico completo do gist com os diffs. - -![Página gist revisions (revisões)](/assets/images/help/gist/gist_history.png) diff --git a/translations/pt-BR/content/github/writing-on-github/editing-and-sharing-content-with-gists/index.md b/translations/pt-BR/content/github/writing-on-github/editing-and-sharing-content-with-gists/index.md deleted file mode 100644 index 74e095762c..0000000000 --- a/translations/pt-BR/content/github/writing-on-github/editing-and-sharing-content-with-gists/index.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: Editar e compartilhar conteúdo com gists -intro: '' -redirect_from: - - /categories/23/articles - - /categories/gists - - /articles/editing-and-sharing-content-with-gists -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -children: - - /creating-gists - - /forking-and-cloning-gists -shortTitle: Compartilhar conteúdo com gists ---- - diff --git a/translations/pt-BR/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/about-writing-and-formatting-on-github.md b/translations/pt-BR/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/about-writing-and-formatting-on-github.md deleted file mode 100644 index 33229ee6b0..0000000000 --- a/translations/pt-BR/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/about-writing-and-formatting-on-github.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: Sobre gravação e formatação no GitHub -intro: O GitHub combina uma sintaxe para formatar texto chamada markdown em estilo GitHub com alguns recursos de escrita exclusivos. -redirect_from: - - /articles/about-writing-and-formatting-on-github - - /github/writing-on-github/about-writing-and-formatting-on-github -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -shortTitle: Escrever & formatar no GitHub ---- - -[Markdown](http://daringfireball.net/projects/markdown/) é uma sintaxe de leitura e gravação fáceis para formatação de texto sem formatação. - -Adicionamos algumas funcionalidades personalizadas para criar o markdown em estilo {% data variables.product.prodname_dotcom %}, usadas para formatar prosa e código em nosso site. - -Você também pode interagir com outros usuários em pull requests e problemas usando recursos como [@menções](/articles/basic-writing-and-formatting-syntax/#mentioning-people-and-teams), [referências a problemas e pull request](/articles/basic-writing-and-formatting-syntax/#referencing-issues-and-pull-requests) e [emoji](/articles/basic-writing-and-formatting-syntax/#using-emoji). - -## Barra de ferramentas de formatação de texto - -Cada campo de comentário no {% data variables.product.product_name %} contém uma barra de ferramentas de formatação de texto, permitindo que você formate texto sem precisar aprender a sintaxe markdown. Além da formatação markdown, como os estilos negrito e itálico e criação de headers, links e listas, a barra de ferramentas inclui recursos específicos do {% data variables.product.product_name %}, como @menções, listas de tarefas e links para problemas e pull requests. - -{% if fixed-width-font-gfm-fields %} - -## Habilitando fontes de largura fixa no editor - -Você pode habilitar uma fonte de largura fixa em cada campo de comentário em {% data variables.product.product_name %}. Each character in a fixed-width, or monospace, font occupies the same horizontal space which can make it easier to edit advanced Markdown structures such as tables and code snippets. - -![Captura de tela que mostra o campo comentário de {% data variables.product.product_name %} com as fontes de largura fixa habilitadas](/assets/images/help/writing/fixed-width-example.png) - -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.appearance-settings %} -1. Em "Preferência do editor Markdown, selecione **Usar uma fonte de largura fixa (monospace) ao editar o Markdown**. ![Captura de tela que mostra o campo comentário de {% data variables.product.product_name %} com as fontes de largura fixa habilitadas](/assets/images/help/writing/enable-fixed-width.png) - -{% endif %} - -## Leia mais - -- [Especificações de markdown em estilo {% data variables.product.prodname_dotcom %}](https://github.github.com/gfm/) -- "[Sintaxe básica de gravação e formatação](/articles/basic-writing-and-formatting-syntax)" -- "[Trabalhar com formatação avançada](/articles/working-with-advanced-formatting)" -- "[Dominar o markdown](https://guides.github.com/features/mastering-markdown/)" diff --git a/translations/pt-BR/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md b/translations/pt-BR/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md deleted file mode 100644 index 9105cb55d6..0000000000 --- a/translations/pt-BR/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md +++ /dev/null @@ -1,343 +0,0 @@ ---- -title: Sintaxe básica de escrita e formatação no GitHub -intro: Crie formatação sofisticada para narração e código no GitHub com sintaxe simples. -redirect_from: - - /articles/basic-writing-and-formatting-syntax - - /github/writing-on-github/basic-writing-and-formatting-syntax -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -shortTitle: Sintaxe de formatação básica ---- - -## Títulos - -Para criar um título, adicione de um a seis símbolos `#` antes do texto do título. O número de `#` que você usa determinará o tamanho do título. - -```markdown -# O título maior -## O segundo maior título -###### O título menor -``` - -![Títulos H1, H2 e H6 renderizados](/assets/images/help/writing/headings-rendered.png) - -## Estilizar texto - -Você pode indicar ênfase com texto em negrito, itálico ou riscado em campos de comentários e arquivos de `.md`. - -| Estilo | Sintaxe | Atalho | Exemplo | Resultado | -| -------------------------- | ------------------- | ------------------- | -------------------------------------------- | ------------------------------------------ | -| Negrito | `** **` ou `__ __` | command/control + b | `**Esse texto está em negrito**` | **Esse texto está em negrito** | -| Itálico | `* *` ou `_ _`      | command/control + i | `*Esse texto está em itálico*` | *Esse texto está em itálico* | -| Tachado | `~~ ~~` | | `~~Esse texto estava errado~~` | ~~Esse texto estava errado~~ | -| Negrito e itálico aninhado | `** **` e `_ _` | | `**Esse texto é _extremamente_ importante**` | **Esse texto é _extremamente_ importante** | -| Todo em negrito e itálico | `*** ***` | | `***Todo esse texto é importante***` | ***Todo esse texto é importante*** | - -## Citar texto - -Você pode citar texto com um `>`. - -```markdown -Texto que não é uma citação - -> Texto que é uma citação -``` - -![Texto citado renderizado](/assets/images/help/writing/quoted-text-rendered.png) - -{% tip %} - -**Dica:** ao exibir uma conversa, você pode citar textos automaticamente em um comentário destacando o texto e digitando `r`. É possível citar um comentário inteiro clicando em {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} e em **Quote reply** (Resposta à citação). Para obter mais informações sobre atalhos de teclado, consulte "[Atalhos de teclado](/articles/keyboard-shortcuts/)". - -{% endtip %} - -## Citar código - -Você pode chamar código ou um comando em uma frase com aspas simples. O texto entre aspas simples não será formatado.{% ifversion fpt or ghae or ghes > 3.1 or ghec %} Você também pode pressionar o comando `` ou `Ctrl` + `e` o atalho do teclado para inserir as aspas simples para um bloco de código dentro de uma linha de Markdown.{% endif %} - -```markdown -Use 'git status' para listar todos os arquivos novos ou modificados que ainda não receberam commit. -``` - -![Bloco de código inline renderizado](/assets/images/help/writing/inline-code-rendered.png) - -Para formatar código ou texto no próprio bloco distinto, use aspas triplas. - -
-Alguns comandos Git básicos são:
-```
-git status
-git add
-git commit
-```
-
- -![Bloco de código renderizado](/assets/images/help/writing/code-block-rendered.png) - -Para obter mais informações, consulte "[Criar e destacar blocos de código](/articles/creating-and-highlighting-code-blocks)". - -{% data reusables.user_settings.enabling-fixed-width-fonts %} - -## Links - -Você pode criar um link inline colocando o texto do link entre colchetes `[ ]` e, em seguida, o URL entre parênteses `( )`. {% ifversion fpt or ghae or ghes > 3.1 or ghec %}Você também pode usar o comando `de atalho de teclado + k` para criar um link.{% endif %}{% ifversion fpt or ghae-issue-5434 or ghes > 3.3 or ghec %} Ao selecionar o texto, você poderá colar uma URL da sua área de transferência para criar automaticamente um link a partir da seleção.{% endif %} - -`Este site foi construído usando [GitHub Pages](https://pages.github.com/).` - -![Link renderizado](/assets/images/help/writing/link-rendered.png) - -{% tip %} - -**Dica:** o {% data variables.product.product_name %} cria links automaticamente quando URLs válidos são escritos em um comentário. Para obter mais informações, consulte "[Referências e URLs vinculados automaticamente](/articles/autolinked-references-and-urls)". - -{% endtip %} - -## Links de seção - -{% data reusables.repositories.section-links %} - -## Links relativos - -{% data reusables.repositories.relative-links %} - -## Imagens - -Você pode exibir uma imagem adicionando `!` e por o texto alternativo em`[ ]`. Em seguida, coloque o link da imagem entre parênteses `()`. - -`![Isso é uma imagem](https://myoctocat.com/assets/images/base-octocat.svg)` - -![Imagem interpretada](/assets/images/help/writing/image-rendered.png) - -{% data variables.product.product_name %} é compatível com a incorporação de imagens nos seus problemas, pull requests{% ifversion fpt or ghec %}, discussões{% endif %}, comentários e arquivos `.md`. Você pode exibir uma imagem do seu repositório, adicionar um link para uma imagem on-line ou fazer o upload de uma imagem. Para obter mais informações, consulte[Fazer o upload de ativos](#uploading-assets)". - -{% tip %} - -**Dica:** quando você quiser exibir uma imagem que está no seu repositório, você deverá usar links relativos em vez de links absolutos. - -{% endtip %} - -Aqui estão alguns exemplos para usar links relativos para exibir uma imagem. - -| Contexto | Link relativo | -| -------------------------------------------------------------- | ---------------------------------------------------------------------- | -| Em um arquivo `.md` no mesmo branch | `/assets/images/electrocat.png` | -| Em um arquivo `.md` em outro branch | `/../main/assets/images/electrocat.png` | -| Em problemas, pull requests e comentários do repositório | `../blob/main/assets/images/electrocat.png` | -| Em um arquivo `.md` em outro repositório | `/../../../../github/docs/blob/main/assets/images/electrocat.png` | -| Em problemas, pull requests e comentários de outro repositório | `../../../github/docs/blob/main/assets/images/electrocat.png?raw=true` | - -{% note %} - -**Observação**: Os dois últimos links relativos na tabela acima funcionarão para imagens em um repositório privado somente se o visualizador tiver pelo menos acesso de leitura ao repositório privado que contém essas imagens. - -{% endnote %} - -Para obter mais informações, consulte[Links relativos,](#relative-links)." - -{% ifversion fpt or ghec or ghes > 3.3 or ghae-issue-5559 %} -### Especificando o tema para o qual uma imagem será exibida - -Você pode especificar o tema para o qual uma imagem é exibida acrescentando `#gh-dark-mode-only` ou `#gh-light-mode-only` no final de uma URL da imagem, em Markdown. - -Nós distinguimos entre os modos de cores claro e escuro. Portanto, há duas opções disponíveis. Você pode usar essas opções para exibir imagens otimizadas para fundos escuros ou claros. Isso é particularmente útil para imagens PNG transparentes. - -| Contexto | URL | -| ----------- | ------------------------------------------------------------------------ | -| Tema escuro | `![GitHub Light](https://github.com/github-light.png#gh-dark-mode-only)` | -| Tema claro | `![GitHub Dark](https://github.com/github-dark.png#gh-light-mode-only)` | -{% endif %} - -## Listas - -Você pode criar uma lista não ordenada precedendo uma ou mais linhas de texto com `-` ou `*`. - -```markdown -- George Washington -- John Adams -- Thomas Jefferson -``` - -![Lista não ordenada renderizada](/assets/images/help/writing/unordered-list-rendered.png) - -Para ordenar a lista, coloque um número na frente de cada linha. - -```markdown -1. James Madison -2. James Monroe -3. John Quincy Adams -``` - -![Lista ordenada renderizada](/assets/images/help/writing/ordered-list-rendered.png) - -### Listas aninhadas - -Você pode criar uma lista aninhada recuando um ou mais itens da lista abaixo de outro item. - -Para criar uma lista aninhada usando o editor web do {% data variables.product.product_name %} ou um editor de texto que usa uma fonte monoespaçada, como o [Atom](https://atom.io/), você pode alinhar sua lista visualmente. Digite caracteres de espaço na fonte do item da lista aninhada, até que o caractere de marcador da lista (`-` ou `*`) fique diretamente abaixo do primeiro caractere do texto no item acima dele. - -```markdown -1. Primeiro item da lista - - Primeiro item de lista aninhado - - Segundo item de lista aninhada -``` - -![Lista aninhada com alinhamento destacado](/assets/images/help/writing/nested-list-alignment.png) - -![Lista com dois níveis de itens aninhados](/assets/images/help/writing/nested-list-example-1.png) - -Para criar uma lista aninhada no editor de comentários do {% data variables.product.product_name %}, que não usa uma fonte monoespaçada, você pode observar o item da lista logo acima da lista aninhada e contar o número de caracteres que aparecem antes do conteúdo do item. Em seguida, digite esse número de caracteres de espaço na fonte do item da linha aninhada. - -Neste exemplo, você pode adicionar um item de lista aninhada abaixo do item de lista `100. Primeiro item da lista` recuando o item da lista aninhada com no mínimo cinco espaços, uma vez que há cinco caracteres (`100.`) antes de `Primeiro item da lista`. - -```markdown -100. Primeiro item da lista - - Primeiro item da lista aninhada -``` - -![Lista com um item de lista aninhada](/assets/images/help/writing/nested-list-example-3.png) - -Você pode criar vários níveis de listas aninhadas usando o mesmo método. Por exemplo, como o primeiro item da lista aninhada tem sete caracteres (`␣␣␣␣␣-␣`) antes do conteúdo da lista aninhada `Primeiro item da lista aninhada`, você precisaria recuar o segundo item da lista aninhada com sete espaços. - -```markdown -100. Primeiro item da lista - - Primeiro item da lista aninhada - - Segundo item da lista aninhada -``` - -![Lista com dois níveis de itens aninhados](/assets/images/help/writing/nested-list-example-2.png) - -Para obter mais exemplos, consulte a [Especificação de markdown em estilo GitHub](https://github.github.com/gfm/#example-265). - -## Listas de tarefas - -{% data reusables.repositories.task-list-markdown %} - -Se a descrição de um item da lista de tarefas começar com parênteses, você precisará usar a `\` para escape: - -`- [ ] \(Optional) Abrir um problema de acompanhamento` - -Para obter mais informações, consulte "[Sobre listas de tarefas](/articles/about-task-lists)". - -## Mencionar pessoas e equipes - -Você pode mencionar uma pessoa ou [equipe](/articles/setting-up-teams/) no {% data variables.product.product_name %} digitando `@` mais o nome de usuário ou nome da equipe. Isto desencadeará uma notificação e chamará a sua atenção para a conversa. As pessoas também receberão uma notificação se você editar um comentário para mencionar o respectivo nome de usuário ou da equipe. Para obter mais informações, sobre notificações, consulte {% ifversion fpt or ghes or ghae or ghec %}"[Sobre notificações](/github/managing-subscriptions-and-notifications-on-github/about-notifications){% else %}"[Sobre notificações](/github/receiving-notifications-about-activity-on-github/about-notifications)"{% endif %}." - -`@github/suporte O que você acha dessas atualizações?` - -![@menção renderizada](/assets/images/help/writing/mention-rendered.png) - -Quando você menciona uma equipe principal, os integrantes de suas equipes secundárias também recebem notificações, simplificando a comunicação com vários grupos de pessoas. Para obter mais informações, consulte "[Sobre equipes](/articles/about-teams)". - -Digitar um símbolo `@` chamará uma lista de pessoas ou equipes em um projeto. A lista é filtrada à medida que você digita. Portanto, assim que você achar o nome da pessoa ou da equipe que está procurando, use as teclas de seta para selecioná-lo e pressione tab ou enter para completar o nome. Para equipes, digite nome da @organização/equipe e todos os integrantes dessa equipe serão inscritos na conversa. - -Os resultados do preenchimento automático são restritos aos colaboradores do repositório e qualquer outro participante no thread. - -## Fazer referências a problemas e pull requests - -Você pode trazer à tona uma lista de problemas e pull requests sugeridos no repositório digitando `#`. Digite o número ou o título do problema ou da pull request para filtrar a lista e, em seguida, pressione tab ou enter para completar o resultado destacado. - -Para obter mais informações, consulte "[Referências e URLs vinculados automaticamente](/articles/autolinked-references-and-urls)". - -## Fazer referência a recursos externos - -{% data reusables.repositories.autolink-references %} - -{% ifversion ghes < 3.4 %} -## Anexos de conteúdo - -Alguns {% data variables.product.prodname_github_apps %} fornecem informações em {% data variables.product.product_name %} para URLs vinculadas aos seus domínios registrados. O {% data variables.product.product_name %} renderiza as informações fornecidas pelo app sob o URL no texto ou comentário de um problema ou uma pull request. - -![Anexo de conteúdo](/assets/images/github-apps/content_reference_attachment.png) - -Para visualizar anexos de conteúdo, você deverá ter um {% data variables.product.prodname_github_app %} que use a API de Anexos de Conteúdo instalada no repositório.{% ifversion fpt or ghec %} Para obter mais informações, consulte "[Instalar um aplicativo na sua conta pessoal](/articles/installing-an-app-in-your-personal-account)" e "[Instalar um aplicativo na sua organização](/articles/installing-an-app-in-your-organization)".{% endif %} - -Os anexos de conteúdo não serão exibidos para URLs que fazem parte de um link markdown. - -Para obter mais informações sobre a construção de um {% data variables.product.prodname_github_app %} que usa anexos de conteúdo, consulte "[Usando anexos de conteúdo](/apps/using-content-attachments)."{% endif %} - -## Fazer upload de ativos - -Você pode fazer upload de ativos como imagens, arrastando e soltando, fazendo a seleção a partir de um navegador de arquivos ou colando. É possível fazer o upload de recursos para problemas, pull requests, comentários e arquivos `.md` no seu repositório. - -## Usar emoji - -Você pode adicionar emoji à sua escrita digitando `:EMOJICODE:`. - -`@octocat :+1: Este PR parece ótimo - está pronto para o merge! :shipit:` - -![Emoji renderizado](/assets/images/help/writing/emoji-rendered.png) - -Digitar `:` trará à tona uma lista de emojis sugeridos. A lista será filtrada à medida que você digita. Portanto, assim que encontrar o emoji que estava procurando, pressione **Tab** ou **Enter** para completar o resultado destacado. - -Para obter uma lista completa dos emojis e códigos disponíveis, confira [a lista de emojis](https://github.com/ikatyang/emoji-cheat-sheet/blob/master/README.md). - -## Parágrafos - -Você pode criar um parágrafo deixando uma linha em branco entre as linhas de texto. - -{% ifversion fpt or ghae-issue-5180 or ghes > 3.2 or ghec %} -## Notas de rodapé - -Você pode adicionar notas de rodapé ao seu conteúdo usando esta sintaxe entre colchetes: - -``` -Essa é uma simples nota de rodapé[^1]. - -Uma nota de rodapé também pode ter várias linhas[^2]. - -Você também pode usar palavras, para se adequar melhor ao seu estilo de escrita[^note]. - -[^1]: Minha referência. -[^2]: Cada nova linha deve ser precedida de 2 espaços. - Isso permite que você tenha uma nota de rodapé com várias linhas. -[^note]: - Named footnotes will still render with numbers instead of the text but allow easier identification and linking. - Essa nota de rodapé também foi feita com uma sintaxe diferente usando 4 espaços para novas linhas. -``` - -A nota de rodapé será interpretada da seguinte forma: - -![Nota de rodapé interpretada](/assets/images/site/rendered-footnote.png) - -{% tip %} - -**Observação**: A posição de uma nota de rodapé no seu Markdown não influencia o lugar onde a nota de rodapé será interpretada. Você pode escrever uma nota de rodapé logo após sua referência à nota de rodapé, e ela continuará sendo interpretada na parte inferior do Markdown. - -{% endtip %} -{% endif %} - -## Ocultando o conteúdo com comentários - -Você pode dizer a {% data variables.product.product_name %} para ocultar o conteúdo do markdown interpretado, colocando o conteúdo em um comentário HTML. - -
-<!-- This content will not appear in the rendered Markdown -->
-
- -## Ignorar formatação markdown - -Você pode informar o {% data variables.product.product_name %} para ignorar (ou usar escape) a formatação markdown usando `\` antes do caractere markdown. - -`Vamos renomear \*our-new-project\* para \*our-old-project\*.` - -![Caractere com escape renderizado](/assets/images/help/writing/escaped-character-rendered.png) - -Para obter mais informações, consulte "[Sintaxe markdown](https://daringfireball.net/projects/markdown/syntax#backslash)" de Daring Fireball. - -{% ifversion fpt or ghes > 3.2 or ghae-issue-5232 or ghec %} - -## Desabilitando a interpretação do Markdown - -{% data reusables.repositories.disabling-markdown-rendering %} - -{% endif %} - -## Leia mais - -- [Especificações de markdown em estilo {% data variables.product.prodname_dotcom %}](https://github.github.com/gfm/) -- "[Sobre escrita e formatação no GitHub](/articles/about-writing-and-formatting-on-github)" -- "[Trabalhar com formatação avançada](/articles/working-with-advanced-formatting)" -- "[Dominar o markdown](https://guides.github.com/features/mastering-markdown/)" diff --git a/translations/pt-BR/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/index.md b/translations/pt-BR/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/index.md deleted file mode 100644 index fe81648a93..0000000000 --- a/translations/pt-BR/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/index.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: Introdução à escrita e formatação no GitHub -redirect_from: - - /articles/markdown-basics - - /articles/things-you-can-do-in-a-text-area-on-github - - /articles/getting-started-with-writing-and-formatting-on-github -intro: 'No GitHub, com recursos simples você pode formatar seus comentários e interagir com problemas, pull requests e wikis.' -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -children: - - /about-writing-and-formatting-on-github - - /basic-writing-and-formatting-syntax -shortTitle: Comece a escrever no GitHub ---- - diff --git a/translations/pt-BR/content/github/writing-on-github/index.md b/translations/pt-BR/content/github/writing-on-github/index.md deleted file mode 100644 index afa43d67e8..0000000000 --- a/translations/pt-BR/content/github/writing-on-github/index.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -title: Gravar no GitHub -redirect_from: - - /categories/88/articles - - /articles/github-flavored-markdown - - /articles/writing-on-github - - /categories/writing-on-github -intro: 'Você pode estruturar as informações compartilhadas em {% data variables.product.product_name %} com várias opções de formatação.' -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -children: - - /getting-started-with-writing-and-formatting-on-github - - /working-with-advanced-formatting - - /working-with-saved-replies - - /editing-and-sharing-content-with-gists ---- - diff --git a/translations/pt-BR/content/github/writing-on-github/working-with-advanced-formatting/attaching-files.md b/translations/pt-BR/content/github/writing-on-github/working-with-advanced-formatting/attaching-files.md deleted file mode 100644 index 1180eb3bdb..0000000000 --- a/translations/pt-BR/content/github/writing-on-github/working-with-advanced-formatting/attaching-files.md +++ /dev/null @@ -1,60 +0,0 @@ ---- -title: Anexando arquivos -intro: Você pode transmitir informações anexando vários tipos de arquivo aos seus problemas e pull requests. -redirect_from: - - /github/managing-your-work-on-github/managing-your-work-with-issues-and-pull-requests/file-attachments-on-issues-and-pull-requests - - /articles/issue-attachments - - /articles/file-attachments-on-issues-and-pull-requests - - /github/managing-your-work-on-github/file-attachments-on-issues-and-pull-requests -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -topics: - - Pull requests ---- - -{% warning %} - -**Aviso:** Se você adicionar uma imagem{% ifversion fpt or ghes > 3.1 or ghae or ghec %} ou vídeo{% endif %} a um comentário de pull request ou problema, qualquer um poderá ver a URL anônima sem autenticação, mesmo se o pull request estiver em um repositório privado{% ifversion ghes %} ou se o modo privado estiver habilitado{% endif %}. Para manter arquivos de mídia confidenciais privados, forneça-os a partir de uma rede privada ou servidor que exige autenticação. {% ifversion fpt or ghec %}Para mais informações sobre URLs anônimas, consulte "[Sobre URLs anônimas](/github/authenticating-to-github/about-anonymized-urls)".{% endif %} - -{% endwarning %} - -Para anexar um arquivo a uma conversa sobre um problema ou pull request, arraste-o e solte-o dentro da caixa de comentários. Como alternativa, você pode clicar na barra na parte inferior da caixa de comentários para navegar, selecionar e adicionar um arquivo do seu computador. - -![Selecionar anexos do computador](/assets/images/help/pull_requests/select-bar.png) - -{% tip %} - -**Dica:** Em muitos navegadores, você pode copiar e colar imagens diretamente na caixa. - -{% endtip %} - -O tamanho máximo do arquivo é: -- 10MB para imagens e gifs{% ifversion fpt or ghec %} -- 10MB para vídeos enviados para um repositório pertencentes a um usuário ou organização em um plano grátis do GitHub -- 100MB para vídeos enviados para um repositório pertencente a um usuário ou organização em um plano pago do GitHub{% elsif fpt or ghes > 3.1 or ghae %} -- 100MB para vídeos{% endif %} -- 25MB para todos os outros arquivos - -Arquivos compatíveis: - -* PNG (*.png*) -* GIF (*.gif*) -* JPEG (*.jpg*) -* Arquivos log (*.log*) -* Documentos do Microsoft Word (*.docx*), Powerpoint (*.pptx*), e Excel (*.xlsx*) -* Arquivos de texto (*.txt*) -* PDFs (*.pdf*) -* ZIP (*.zip*, *.gz*){% ifversion fpt or ghes > 3.1 or ghae or ghec %} -* Vídeo (*.mp4*, *.mov*) - -{% note %} - -**Observação:** A compatibilidade do codec de vídeo é específica do navegador, e é possível que um vídeo que você suba para um navegador não possa ser visualizado em outro navegador. No momento, recomendamos o uso do h.264 para maior compatibilidade. - -{% endnote %} -{% endif %} - -![Anexos GIF animados](/assets/images/help/pull_requests/dragging_images.gif) diff --git a/translations/pt-BR/content/github/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md b/translations/pt-BR/content/github/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md deleted file mode 100644 index 9fb4715457..0000000000 --- a/translations/pt-BR/content/github/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md +++ /dev/null @@ -1,64 +0,0 @@ ---- -title: Referências e URLs vinculados automaticamente -intro: 'As referências a URLs, problemas, pull requests e commits são automaticamente reduzidas e convertidas em links.' -redirect_from: - - /articles/autolinked-references-and-urls - - /github/writing-on-github/autolinked-references-and-urls -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -shortTitle: Referências vinculadas automaticamente ---- - -## URLs - -O {% data variables.product.product_name %} cria links automaticamente de URLs padrão. - -`Visite https://github.com` - -![URL vinculado automaticamente renderizado](/assets/images/help/writing/url-autolink-rendered.png) - -Para obter mais informações sobre como criar links, consulte "[Sintaxe básica de gravação e formatação](/articles/basic-writing-and-formatting-syntax/#links)". - -## Problemas e pull requests - -Nas conversas do {% data variables.product.product_name %}, as referências a problemas e pull request são convertidas automaticamente em links curtos. - -{% note %} - -**Observação:** as referências vinculadas automaticamente não são criadas em wikis nem arquivos em um repositório. - -{% endnote %} - -| Tipo de referência | Referência bruta | Link curto | -| ----------------------------------------------------------------------- | ---------------------------------------------- | ---------------------------------------------------------------------- | -| URL do problema ou da pull request | https://github.com/jlord/sheetsee.js/issues/26 | [#26](https://github.com/jlord/sheetsee.js/issues/26) | -| `#` e o problema ou o número de pull request | #26 | [#26](https://github.com/jlord/sheetsee.js/issues/26) | -| `GH-` e número do problema ou da pull request | GH-26 | [GH-26](https://github.com/jlord/sheetsee.js/issues/26) | -| `Username/Repository#` e número do problema ou da pull request | jlord/sheetsee.js#26 | [jlord/sheetsee.js#26](https://github.com/jlord/sheetsee.js/issues/26) | -| `Organization_name/Repository#` e número do problema ou da pull request | github/linguist#4039 | [github/linguist#4039](https://github.com/github/linguist/pull/4039) | - -{% ifversion fpt or ghec %} -Se você fizer referência a um problema, pull request ou discussão em uma lista, a referência irá desenrolar-se para mostrar o título e o estado. Para obter mais informações sobre listas de tarefas, consulte "[Sobre listas de tarefas](/issues/tracking-your-work-with-issues/creating-issues/about-task-lists)". -{% endif %} - -## SHAs de commit - -As referências em um hash SHA de commit são convertidas automaticamente em links curtos para o commit no {% data variables.product.product_name %}. - -| Tipo de referência | Referência bruta | Link curto | -| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------- | -| URL do commit | [`https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e`](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | [a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | -| SHA | a5c3785ed8d6a35868bc169f07e40e889087fd2e | [a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | -| User@SHA | jlord@a5c3785ed8d6a35868bc169f07e40e889087fd2e | [jlord@a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | -| `Username/Repository@SHA` | `jlord/sheetsee.js@a5c3785ed8d6a35868bc169f07e40e889087fd2e` | [`jlord/sheetsee.js@a5c3785`](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | - -## Links automáticos personalizados para recursos externos - -{% data reusables.repositories.autolink-references %} - -## Leia mais - -- "[Sintaxe básica de gravação e formatação](/articles/basic-writing-and-formatting-syntax)" diff --git a/translations/pt-BR/content/github/writing-on-github/working-with-advanced-formatting/creating-a-permanent-link-to-a-code-snippet.md b/translations/pt-BR/content/github/writing-on-github/working-with-advanced-formatting/creating-a-permanent-link-to-a-code-snippet.md deleted file mode 100644 index fa3c051d1e..0000000000 --- a/translations/pt-BR/content/github/writing-on-github/working-with-advanced-formatting/creating-a-permanent-link-to-a-code-snippet.md +++ /dev/null @@ -1,49 +0,0 @@ ---- -title: Criar um link permanente em um trecho de código -intro: É possível criar um link permanente em uma linha específica ou conjunto de linhas de código de uma determinada versão de arquivo ou pull request. -redirect_from: - - /github/managing-your-work-on-github/managing-your-work-with-issues-and-pull-requests/creating-a-permanent-link-to-a-code-snippet - - /articles/creating-a-permanent-link-to-a-code-snippet - - /github/managing-your-work-on-github/creating-a-permanent-link-to-a-code-snippet -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -topics: - - Pull requests -shortTitle: Links permanentes para o código ---- - -## Vinculando ao código - -Esse tipo de link permanente será renderizado como um trecho de código somente no repositório em que ele foi originado. Em outros repositórios, o trecho de código permalink será renderizado como uma URL. - -![Trecho de código renderizado em um comentário](/assets/images/help/repository/rendered-code-snippet.png) - -{% tip %} - -**Dica:** para criar um permalink para um arquivo inteiro, consulte "[Obter links permanentes para arquivos](/articles/getting-permanent-links-to-files)". - -{% endtip %} - -{% data reusables.repositories.navigate-to-repo %} -2. Localize o código ao qual deseja vincular: - - Para vincular de um arquivo para o código, navegue até o arquivo. - - Para vincular de uma pull request para o código, navegue até a pull request e clique em {% octicon "diff" aria-label="The file diff icon" %} **Files changed** (Arquivos alterados). Depois, vá até o arquivo que contém o código que você quer incluir em seu comentário e clique em **View** (Visualizar). -{% data reusables.repositories.choose-line-or-range %} -4. À esquerda da linha ou do conjunto de linhas, clique em {% octicon "kebab-horizontal" aria-label="The horizontal kebab octicon" %}. No menu suspenso, clique em **Copy permalink** (Copiar permalink). ![Menu Kebab com opção para copiar um link permanente para uma linha selecionada](/assets/images/help/repository/copy-permalink-specific-line.png) -5. Navegue até a conversa em que deseja vincular ao trecho de código. -6. Cole seu permalink em um comentário e clique em **Comment** (Comentário). ![Permalink colado em um comentário no mesmo repositório](/assets/images/help/repository/code-snippet-permalink-in-comment.png) - -## Vinculando ao Markdown - -Você pode vincular a linhas específicas em arquivos Markdown carregando o arquivo Markdown sem a interpretação do Markdown. Para carregar um arquivo Markdown sem interpretação, você pode usar o parâmetro `?plain=1` no final da url para o arquivo. Por exemplo, `github.com///blob//README.md?plain=1`. - -Você pode vincular a uma linha específica no arquivo Markdown da mesma forma que você pode vincular no código. Acrescente `#L` com o número da linha ou números no final da url. Por exemplo, `github.com///blob//README.md?plain=1#L14` irá destacar a linha 14 no arquivo simples README.md. - -## Leia mais - -- "[Criar um problema](/articles/creating-an-issue/)" -- "[Abrir um problema a partir de código](/articles/opening-an-issue-from-code/)" -- "[Revisar alterações em pull requests](/articles/reviewing-changes-in-pull-requests/)" diff --git a/translations/pt-BR/content/github/writing-on-github/working-with-advanced-formatting/creating-and-highlighting-code-blocks.md b/translations/pt-BR/content/github/writing-on-github/working-with-advanced-formatting/creating-and-highlighting-code-blocks.md deleted file mode 100644 index 4ecad87a12..0000000000 --- a/translations/pt-BR/content/github/writing-on-github/working-with-advanced-formatting/creating-and-highlighting-code-blocks.md +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: Criar e realçar blocos de código -intro: Compartilhe amostras de código com blocos de código isolados e habilitando o realce da sintaxe. -redirect_from: - - /articles/creating-and-highlighting-code-blocks - - /github/writing-on-github/creating-and-highlighting-code-blocks -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -shortTitle: Crie blocos de código ---- - -## Blocos de código isolados - -Você pode criar blocos de código isolados colocando aspas triplas \`\`\` antes e depois do bloco de código. É recomendável colocar uma linha em branco antes e depois dos blocos de código para facilitar a leitura da formação bruta. - -
-```
-function test() {
-  console.log("notice the blank line before this function?");
-}
-```
-
- -![Bloco de código isolado renderizado](/assets/images/help/writing/fenced-code-block-rendered.png) - -{% tip %} - -**Dica:** para preservar sua formatação em uma lista, certifique-se de recuar blocos de código não isolados em oito espaços. - -{% endtip %} - -Para mostrar aspas tripas em um bloco de código isolado, envolva-os dentro de aspas quádruplas. - - -
-```` 
-```
-Look! Você pode ver minhas aspas.
-```
-````
-
- -![Código isolado interpretado como um bloco de aspas inversas](/assets/images/help/writing/fenced-code-show-backticks-rendered.png) - -{% data reusables.user_settings.enabling-fixed-width-fonts %} - -## Realce de sintaxe - - - -Você pode adicionar um identificador de linguagem opcional para habilitar o realce de sintaxe no bloco de código isolado. - -Por exemplo, para código Ruby do realce de sintaxe: - - ```ruby - require 'redcarpet' - markdown = Redcarpet.new("Hello World!") - puts markdown.to_html - coloca markdown.to_html - ``` - -![Bloco de código renderizado com realce de sintaxe Ruby](/assets/images/help/writing/code-block-syntax-highlighting-rendered.png) - -Usamos [Linguist](https://github.com/github/linguist) para executar a detecção de linguagem e selecionar [gramáticas de terceiros](https://github.com/github/linguist/blob/master/vendor/README.md) para realce de sintaxe. Você pode descobrir quais palavras-chave são válidas no [arquivo YAML de linguagem](https://github.com/github/linguist/blob/master/lib/linguist/languages.yml). - -## Leia mais - -- [Especificações de markdown em estilo {% data variables.product.prodname_dotcom %}](https://github.github.com/gfm/) -- "[Sintaxe básica de gravação e formatação](/articles/basic-writing-and-formatting-syntax)" diff --git a/translations/pt-BR/content/github/writing-on-github/working-with-advanced-formatting/index.md b/translations/pt-BR/content/github/writing-on-github/working-with-advanced-formatting/index.md deleted file mode 100644 index 4c6cffc771..0000000000 --- a/translations/pt-BR/content/github/writing-on-github/working-with-advanced-formatting/index.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: Trabalhar com formatação avançada -intro: 'A formatação (como tabelas, realce de sintaxe e vinculação automática) permite organizar informações complexas de forma clara em pull requests, problemas e comentários.' -redirect_from: - - /articles/working-with-advanced-formatting -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -children: - - /organizing-information-with-tables - - /organizing-information-with-collapsed-sections - - /creating-and-highlighting-code-blocks - - /autolinked-references-and-urls - - /attaching-files - - /creating-a-permanent-link-to-a-code-snippet - - /using-keywords-in-issues-and-pull-requests -shortTitle: Trabalhar com formatação avançada ---- - diff --git a/translations/pt-BR/content/github/writing-on-github/working-with-advanced-formatting/organizing-information-with-collapsed-sections.md b/translations/pt-BR/content/github/writing-on-github/working-with-advanced-formatting/organizing-information-with-collapsed-sections.md deleted file mode 100644 index 36c31df4e6..0000000000 --- a/translations/pt-BR/content/github/writing-on-github/working-with-advanced-formatting/organizing-information-with-collapsed-sections.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Organizando informações com seções recolhidas -intro: Você pode simplificar seu Markdown criando uma seção colapsada com a tag '
'. -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -shortTitle: Seções colapsadas ---- - -## Creating a collapsed section - -You can temporarily obscure sections of your Markdown by creating a collapsed section that the reader can choose to expand. For example, when you want to include technical details in an issue comment that may not be relevant or interesting to every reader, you can put those details in a collapsed section. - -Any Markdown within the `
` block will be collapsed until the reader clicks {% octicon "triangle-right" aria-label="The right triange icon" %} to expand the details. Within the `
` block, use the `` tag to create a label to the right of {% octicon "triangle-right" aria-label="The right triange icon" %}. - -```markdown -
CLICK ME -

- -#### We can hide anything, even code! - - ```ruby - puts "Hello World" - ``` - -

```

- -The Markdown will be collapsed by default. - -![Rendered collapsed](/assets/images/help/writing/collapsed-section-view.png) - -After a reader clicks {% octicon "triangle-right" aria-label="The right triange icon" %}, the details are expanded. - -![Rendered open](/assets/images/help/writing/open-collapsed-section.png) - -## Leia mais - -- [Especificações de markdown em estilo {% data variables.product.prodname_dotcom %}](https://github.github.com/gfm/) -- "[Sintaxe básica de gravação e formatação](/articles/basic-writing-and-formatting-syntax)" diff --git a/translations/pt-BR/content/github/writing-on-github/working-with-advanced-formatting/organizing-information-with-tables.md b/translations/pt-BR/content/github/writing-on-github/working-with-advanced-formatting/organizing-information-with-tables.md deleted file mode 100644 index 7120919b7c..0000000000 --- a/translations/pt-BR/content/github/writing-on-github/working-with-advanced-formatting/organizing-information-with-tables.md +++ /dev/null @@ -1,82 +0,0 @@ ---- -title: Organizar informações com tabelas -intro: 'Você pode criar tabelas para organizar as informações em comentários, problemas, pull requests e wikis.' -redirect_from: - - /articles/organizing-information-with-tables - - /github/writing-on-github/organizing-information-with-tables -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -shortTitle: Dados organizados com tabelas ---- - -## Criar uma tabela - -Você pode criar tabelas com barras verticais `|` e hifens `-`. Os hifens são usados para criar o cabeçalho das colunas e as barras verticais, para separar as colunas. Você deve incluir uma linha em branco antes da tabela para ela ser construída corretamente. - -```markdown - -| Primeiro cabeçalho | Segundo cabeçalho | -| ------------------- | ------------------- | -| Célula de conteúdo | Célula de conteúdo | -| Célula de conteúdo | Célula de conteúdo | -``` - -![Tabela construída](/assets/images/help/writing/table-basic-rendered.png) - -As barras verticais em cada extremo da tabela são opcionais. - -As células podem ter largura variada e não precisam estar alinhadas perfeitamente com as colunas. Deve ter no mínimo três hifens em cada coluna da linha do cabeçalho. - -```markdown -| Comando | Descrição | -| --- | --- | -| git status | Lista de todos os arquivos modificados ou novos | -| git diff | Mostra as diferenças do arquivo que não foram preparadas | -``` - -![Tabela construída com largura de célula variada](/assets/images/help/writing/table-varied-columns-rendered.png) - -{% data reusables.user_settings.enabling-fixed-width-fonts %} - -## Formatar conteúdo dentro da tabela - -Você pode usar [formatação](/articles/basic-writing-and-formatting-syntax), como links, blocos de código em linhas e estilos de texto em sua tabela: - -```markdown -| Comando | Descrição | -| --- | --- | -| `git status` | Lista de todos os arquivos *modificados ou novos* | -| `git diff` | Mostra as diferenças do arquivo que **não foram** preparadas | -``` - -![Tabela construída com texto formatado](/assets/images/help/writing/table-inline-formatting-rendered.png) - -Você pode alinhar o texto à esquerda, direita ou centralizar uma coluna incluindo dois pontos `:` à esquerda, direita ou nos dois lados dos hifens que estão dentro da linha de cabeçalho. - -```markdown -| Esquerda | Centralizado | Direita | -| :--- | :---: | ---: | -| git status | git status | git status | -| git diff | git diff | git diff | -``` - -![Tabela construída com alinhamento de texto à esquerda, centralizado e à direita](/assets/images/help/writing/table-aligned-text-rendered.png) - -Para incluir uma barra vertical `|` como conteúdo dentro de sua célula, use `\` antes da barra vertical: - -```markdown -| Nome | Caractere | -| --- | --- | -| Crase | ` | -| Barra | \| | -``` - -![Tabela construída com barra vertical solta](/assets/images/help/writing/table-escaped-character-rendered.png) - -## Leia mais - -- [Especificações de markdown em estilo {% data variables.product.prodname_dotcom %}](https://github.github.com/gfm/) -- "[Sintaxe básica de gravação e formatação](/articles/basic-writing-and-formatting-syntax)" diff --git a/translations/pt-BR/content/github/writing-on-github/working-with-advanced-formatting/using-keywords-in-issues-and-pull-requests.md b/translations/pt-BR/content/github/writing-on-github/working-with-advanced-formatting/using-keywords-in-issues-and-pull-requests.md deleted file mode 100644 index e219acb9b5..0000000000 --- a/translations/pt-BR/content/github/writing-on-github/working-with-advanced-formatting/using-keywords-in-issues-and-pull-requests.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: Usando palavras-chave em problemas e pull requests -intro: Use palavras-chave para vincular um problema e um pull request ou para marcar um problema ou pull request como um duplicado. -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -topics: - - Issues - - Pull requests ---- - -## Vinculando uma pull request a um problema - -Para vincular um pull request a um problema a{% ifversion fpt or ghes or ghae or ghec %} mostre que uma correção está em andamento e {% endif %} para fechar o problema automaticamente quando alguém fizer merge do pull request, digite uma das palavras-chave a seguir seguida de uma referência ao problema. Por exemplo, `Closes #10` ou `Fixes octo-org/octo-repo#100`. - -* close -* closes -* closed -* fix -* fixes -* fixed -* resolver -* resolve -* resolved - -Para obter mais informações, consulte "[Vincular um pull request a um problema](/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue)." - -## Marcando um problema ou pull request como duplicado - -Para marcar um problema ou uma pull request como uma duplicata, digite "Duplicata de" seguido pelo número do problema ou da pull request que ele duplica no texto de um novo comentário. Para obter mais informações, consulte "[Marcando problemas ou pull requests como duplicado](/issues/tracking-your-work-with-issues/marking-issues-or-pull-requests-as-a-duplicate)." diff --git a/translations/pt-BR/content/github/writing-on-github/working-with-saved-replies/about-saved-replies.md b/translations/pt-BR/content/github/writing-on-github/working-with-saved-replies/about-saved-replies.md deleted file mode 100644 index 5f57eebe53..0000000000 --- a/translations/pt-BR/content/github/writing-on-github/working-with-saved-replies/about-saved-replies.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: Sobre respostas salvas -intro: Você pode usar uma resposta salva para responder a um problema ou uma pull request. -redirect_from: - - /articles/about-saved-replies - - /github/writing-on-github/about-saved-replies -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' ---- - -![Respostas salvas](/assets/images/help/settings/saved-replies.png) - -As respostas salvas permitem criar uma resposta reutilizável para problemas e pull requests. Ganhe tempo criando uma resposta salva para as respostas que você usa com mais frequência. - -Depois que uma resposta salva é adicionada, ela pode ser usada em problemas e pull requests. As respostas salvas são associadas a sua conta de usuário. Depois que forem criadas, você poderá usá-las nos repositórios e organizações. - -É possível criar, no máximo, 100 respostas salvas. Se atingir o limite máximo, você poderá excluir respostas salvas que não usa mais ou editar as existentes. - -Também é possível usar a resposta salva "Duplicate issue" (Problema duplicado) fornecida pelo {% data variables.product.product_name %} para marcar um problema como duplicação e rastreá-lo com um problema semelhante. - -## Leia mais - -- "[Criar uma resposta salva](/articles/creating-a-saved-reply)" -- "[Usar respostas salvas](/articles/using-saved-replies)" -- "[Editar uma resposta salva](/articles/editing-a-saved-reply)" -- "[Excluir uma resposta salva](/articles/deleting-a-saved-reply)" diff --git a/translations/pt-BR/content/github/writing-on-github/working-with-saved-replies/creating-a-saved-reply.md b/translations/pt-BR/content/github/writing-on-github/working-with-saved-replies/creating-a-saved-reply.md deleted file mode 100644 index fed7fa856d..0000000000 --- a/translations/pt-BR/content/github/writing-on-github/working-with-saved-replies/creating-a-saved-reply.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: Criar uma resposta salva -intro: 'Se você está sempre adicionando o mesmo comentário repetidamente, é possível criar uma resposta salva.' -redirect_from: - - /articles/creating-a-saved-reply - - /github/writing-on-github/creating-a-saved-reply -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' ---- - -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.saved_replies %} -3. Em "Add a saved reply" (Adicionar uma resposta salva), adicione o título da resposta salva. ![Título da resposta salva](/assets/images/help/settings/saved-replies-title.png) -4. No campo "Write" (Gravar), adicione o conteúdo que deseja usar para a resposta salva. Para obter mais informações sobre como gravar no {% data variables.product.product_name %}, consulte "[Sintaxe básica de gravação e formatação](/articles/basic-writing-and-formatting-syntax)". ![Gravar uma resposta salva](/assets/images/help/settings/saved-replies-settings-adding.png) -5. Para revisar sua resposta, clique em **Preview** (Visualizar). ![Adicionar uma resposta salva](/assets/images/help/settings/saved-replies-preview.png) -6. Clique em **Add saved reply** (Adicionar resposta salva). ![Botão "Adicionar resposta salva"](/assets/images/help/settings/saved-replies-add-button.png) - -## Leia mais - -- "[Usar respostas salvas](/articles/using-saved-replies)" -- "[Editar uma resposta salva](/articles/editing-a-saved-reply)" -- "[Excluir uma resposta salva](/articles/deleting-a-saved-reply)" diff --git a/translations/pt-BR/content/github/writing-on-github/working-with-saved-replies/deleting-a-saved-reply.md b/translations/pt-BR/content/github/writing-on-github/working-with-saved-replies/deleting-a-saved-reply.md deleted file mode 100644 index e5e5997fab..0000000000 --- a/translations/pt-BR/content/github/writing-on-github/working-with-saved-replies/deleting-a-saved-reply.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: Excluir uma resposta salva -intro: 'Se você não estiver mais usando uma resposta salva, exclua-a.' -redirect_from: - - /articles/deleting-a-saved-reply - - /github/writing-on-github/deleting-a-saved-reply -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' ---- - -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.saved_replies %} -3. Em "Saved replies" (Respostas salvas), ao lado da resposta salva que deseja excluir, clique em {% octicon "x" aria-label="The X" %}. - ![Excluir resposta salva](/assets/images/help/settings/saved-replies-delete-existing.png) diff --git a/translations/pt-BR/content/github/writing-on-github/working-with-saved-replies/editing-a-saved-reply.md b/translations/pt-BR/content/github/writing-on-github/working-with-saved-replies/editing-a-saved-reply.md deleted file mode 100644 index 77b0b40cf3..0000000000 --- a/translations/pt-BR/content/github/writing-on-github/working-with-saved-replies/editing-a-saved-reply.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: Editar uma resposta salva -intro: Você pode editar o título e o corpo de uma resposta salva. -redirect_from: - - /articles/changing-a-saved-reply - - /articles/editing-a-saved-reply - - /github/writing-on-github/editing-a-saved-reply -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' ---- - -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.saved_replies %} -3. Em "Saved replies" (Respostas salvas), ao lado da resposta salva que deseja editar, clique em {% octicon "pencil" aria-label="The pencil" %}. - ![Editar resposta salva](/assets/images/help/settings/saved-replies-edit-existing.png) -4. Em "Edit saved reply" (Editar resposta salva), é possível editar o título e o conteúdo da resposta salva. ![Editar título e conteúdo](/assets/images/help/settings/saved-replies-edit-existing-content.png) -5. Clique em **Update saved reply** (Atualizar resposta salva). ![Atualizar resposta salva](/assets/images/help/settings/saved-replies-save-edit.png) - -## Leia mais - -- "[Criar uma resposta salva](/articles/creating-a-saved-reply)" -- "[Excluir uma resposta salva](/articles/deleting-a-saved-reply)" -- "[Usar respostas salvas](/articles/using-saved-replies)" diff --git a/translations/pt-BR/content/github/writing-on-github/working-with-saved-replies/index.md b/translations/pt-BR/content/github/writing-on-github/working-with-saved-replies/index.md deleted file mode 100644 index fe248b9437..0000000000 --- a/translations/pt-BR/content/github/writing-on-github/working-with-saved-replies/index.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: Trabalhar com respostas salvas -intro: 'Para economizar tempo e garantir a entrega de uma mensagem consistente, adicione respostas salvas a comentários de problemas de pull requests.' -redirect_from: - - /articles/working-with-saved-replies -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -children: - - /about-saved-replies - - /creating-a-saved-reply - - /editing-a-saved-reply - - /deleting-a-saved-reply - - /using-saved-replies -shortTitle: Trabalhar com respostas salvas ---- - diff --git a/translations/pt-BR/content/github/writing-on-github/working-with-saved-replies/using-saved-replies.md b/translations/pt-BR/content/github/writing-on-github/working-with-saved-replies/using-saved-replies.md deleted file mode 100644 index 65b8e29054..0000000000 --- a/translations/pt-BR/content/github/writing-on-github/working-with-saved-replies/using-saved-replies.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: Usar respostas salvas -intro: 'Ao comentar uma pull request ou um problema, você pode adicionar uma resposta salva que já tenha configurado. A resposta salva pode ser o comentário inteiro. Caso você queira personalizá-lo, adicione ou exclua conteúdo.' -redirect_from: - - /articles/using-saved-replies - - /github/writing-on-github/using-saved-replies -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' ---- - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-issue-pr %} -2. Clique na pull request ou no problema desejado. -3. Para adicionar uma resposta salva, clique em {% octicon "reply" aria-label="The mail reply" %} no campo de comentários. ![Botão Saved replies (Respostas salvas)](/assets/images/help/writing/saved-replies-button.png) -4. Na lista, selecione a resposta salva à qual deseja adicionar seu comentário. ![Respostas salvas](/assets/images/help/settings/saved-replies.png) - -{% tip %} - -**Dicas:** -- Você pode usar um atalho de teclado para preencher automaticamente o comentário com uma resposta salva. Para obter mais informações, consulte "[Atalhos de teclado](/articles/keyboard-shortcuts/#comments)". -- Você pode filtrar a lista digitando o título da resposta salva. - -{% endtip %} - -## Leia mais - -- "[Criar uma resposta salva](/articles/creating-a-saved-reply)" -- "[Editar uma resposta salva](/articles/editing-a-saved-reply)" -- "[Excluir uma resposta salva](/articles/deleting-a-saved-reply)" diff --git a/translations/zh-CN/content/github/importing-your-projects-to-github/importing-source-code-to-github/about-github-importer.md b/translations/zh-CN/content/github/importing-your-projects-to-github/importing-source-code-to-github/about-github-importer.md deleted file mode 100644 index 309478a0cb..0000000000 --- a/translations/zh-CN/content/github/importing-your-projects-to-github/importing-source-code-to-github/about-github-importer.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: 关于 GitHub 导入工具 -intro: 如果您在 Subversion、Mercurial、Team Foundation Version Control (TFVC) 或其他 Git 仓库中有源代码,可使用 GitHub 导入工具将其移至 GitHub。 -redirect_from: - - /articles/about-github-importer - - /github/importing-your-projects-to-github/about-github-importer -versions: - fpt: '*' - ghec: '*' ---- - -GitHub 导入工具是一种可快速将源代码仓库(包括提交和修订记录)导入 GitHub 的工具。 - -![导入仓库 gif](/assets/images/help/importer/github-importer.gif) - -在导入过程中,根据导入来源的版本控制系统,您可以向远程仓库进行身份验证,更新提交作者属性,以及导入包含大文件的仓库(如果不想使用 Git Large File Storage,也可删除大文件)。 - -| 导入操作 | 子版本,Subversion | Mercurial | TFVC | Git | -|:----------------------------------------------------------------------------- |:--------------:|:---------:|:-----:|:-----:| -| 向远程仓库进行身份验证 | **X** | **X** | **X** | **X** | -| [更新提交作者属性](/articles/updating-commit-author-attribution-with-github-importer) | **X** | **X** | **X** | | -| 将大文件移至 [Git Large 文件存储](/articles/about-git-large-file-storage) | **X** | **X** | **X** | | -| 从仓库删除大文件 | **X** | **X** | **X** | | - -## 延伸阅读 - -- "[使用 GitHub 导入工具导入仓库](/articles/importing-a-repository-with-github-importer)" -- "[使用 GitHub 导入工具更新提交作者属性](/articles/updating-commit-author-attribution-with-github-importer)" -- "[使用命令行导入 Git 仓库](/articles/importing-a-git-repository-using-the-command-line)" -- "[源代码迁移工具](/articles/source-code-migration-tools)" diff --git a/translations/zh-CN/content/github/importing-your-projects-to-github/importing-source-code-to-github/adding-an-existing-project-to-github-using-the-command-line.md b/translations/zh-CN/content/github/importing-your-projects-to-github/importing-source-code-to-github/adding-an-existing-project-to-github-using-the-command-line.md deleted file mode 100644 index 575a38144d..0000000000 --- a/translations/zh-CN/content/github/importing-your-projects-to-github/importing-source-code-to-github/adding-an-existing-project-to-github-using-the-command-line.md +++ /dev/null @@ -1,164 +0,0 @@ ---- -title: Adding an existing project to GitHub using the command line -intro: 'Putting your existing work on {% data variables.product.product_name %} can let you share and collaborate in lots of great ways.' -redirect_from: - - /articles/add-an-existing-project-to-github - - /articles/adding-an-existing-project-to-github-using-the-command-line - - /github/importing-your-projects-to-github/adding-an-existing-project-to-github-using-the-command-line -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -shortTitle: Add a project locally ---- - -## About adding existing projects to {% data variables.product.product_name %} - -{% tip %} - -**Tip:** If you're most comfortable with a point-and-click user interface, try adding your project with {% data variables.product.prodname_desktop %}. For more information, see "[Adding a repository from your local computer to GitHub Desktop](/desktop/guides/contributing-to-projects/adding-a-repository-from-your-local-computer-to-github-desktop)" in the *{% data variables.product.prodname_desktop %} Help*. - -{% endtip %} - -{% data reusables.repositories.sensitive-info-warning %} - -## Adding a project to {% data variables.product.product_name %} with {% data variables.product.prodname_cli %} - -{% data variables.product.prodname_cli %} is an open source tool for using {% data variables.product.prodname_dotcom %} from your computer's command line. {% data variables.product.prodname_cli %} can simplify the process of adding an existing project to {% data variables.product.product_name %} using the command line. To learn more about {% data variables.product.prodname_cli %}, see "[About {% data variables.product.prodname_cli %}](/github-cli/github-cli/about-github-cli)." - -1. In the command line, navigate to the root directory of your project. -1. Initialize the local directory as a Git repository. - - ```shell - git init -b main - ``` - -1. Stage and commit all the files in your project - - ```shell - git add . && git commit -m "initial commit" - ``` - -1. To create a repository for your project on GitHub, use the `gh repo create` subcommand. When prompted, select **Push an existing local repository to GitHub** and enter the desired name for your repository. If you want your project to belong to an organization instead of your user account, specify the organization name and project name with `organization-name/project-name`. - -1. Follow the interactive prompts. To add the remote and push the repository, confirm yes when asked to add the remote and push the commits to the current branch. - -1. Alternatively, to skip all the prompts, supply the path to the repository with the `--source` flag and pass a visibility flag (`--public`, `--private`, or `--internal`). For example, `gh repo create --source=. --public`. Specify a remote with the `--remote` flag. To push your commits, pass the `--push` flag. For more information about possible arguments, see the [GitHub CLI manual](https://cli.github.com/manual/gh_repo_create). - -## Adding a project to {% data variables.product.product_name %} without {% data variables.product.prodname_cli %} - -{% mac %} - -1. [Create a new repository](/repositories/creating-and-managing-repositories/creating-a-new-repository) on {% data variables.product.product_location %}. To avoid errors, do not initialize the new repository with *README*, license, or `gitignore` files. You can add these files after your project has been pushed to {% data variables.product.product_name %}. - ![Create New Repository drop-down](/assets/images/help/repository/repo-create.png) -{% data reusables.command_line.open_the_multi_os_terminal %} -3. Change the current working directory to your local project. -4. Initialize the local directory as a Git repository. - ```shell - $ git init -b main - ``` -5. Add the files in your new local repository. This stages them for the first commit. - ```shell - $ git add . - # Adds the files in the local repository and stages them for commit. {% data reusables.git.unstage-codeblock %} - ``` -6. Commit the files that you've staged in your local repository. - ```shell - $ git commit -m "First commit" - # Commits the tracked changes and prepares them to be pushed to a remote repository. {% data reusables.git.reset-head-to-previous-commit-codeblock %} - ``` -7. At the top of your repository on {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %}'s Quick Setup page, click {% octicon "clippy" aria-label="The copy to clipboard icon" %} to copy the remote repository URL. - ![Copy remote repository URL field](/assets/images/help/repository/copy-remote-repository-url-quick-setup.png) -8. In Terminal, [add the URL for the remote repository](/github/getting-started-with-github/managing-remote-repositories) where your local repository will be pushed. - ```shell - $ git remote add origin <REMOTE_URL> - # Sets the new remote - $ git remote -v - # Verifies the new remote URL - ``` -9. [Push the changes](/github/getting-started-with-github/pushing-commits-to-a-remote-repository/) in your local repository to {% data variables.product.product_location %}. - ```shell - $ git push -u origin main - # Pushes the changes in your local repository up to the remote repository you specified as the origin - ``` - -{% endmac %} - -{% windows %} - -1. [Create a new repository](/articles/creating-a-new-repository) on {% data variables.product.product_location %}. To avoid errors, do not initialize the new repository with *README*, license, or `gitignore` files. You can add these files after your project has been pushed to {% data variables.product.product_name %}. - ![Create New Repository drop-down](/assets/images/help/repository/repo-create.png) -{% data reusables.command_line.open_the_multi_os_terminal %} -3. Change the current working directory to your local project. -4. Initialize the local directory as a Git repository. - ```shell - $ git init -b main - ``` -5. Add the files in your new local repository. This stages them for the first commit. - ```shell - $ git add . - # Adds the files in the local repository and stages them for commit. {% data reusables.git.unstage-codeblock %} - ``` -6. Commit the files that you've staged in your local repository. - ```shell - $ git commit -m "First commit" - # Commits the tracked changes and prepares them to be pushed to a remote repository. {% data reusables.git.reset-head-to-previous-commit-codeblock %} - ``` -7. At the top of your repository on {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %}'s Quick Setup page, click {% octicon "clippy" aria-label="The copy to clipboard icon" %} to copy the remote repository URL. - ![Copy remote repository URL field](/assets/images/help/repository/copy-remote-repository-url-quick-setup.png) -8. In the Command prompt, [add the URL for the remote repository](/github/getting-started-with-github/managing-remote-repositories) where your local repository will be pushed. - ```shell - $ git remote add origin <REMOTE_URL> - # Sets the new remote - $ git remote -v - # Verifies the new remote URL - ``` -9. [Push the changes](/github/getting-started-with-github/pushing-commits-to-a-remote-repository/) in your local repository to {% data variables.product.product_location %}. - ```shell - $ git push origin main - # Pushes the changes in your local repository up to the remote repository you specified as the origin - ``` - -{% endwindows %} - -{% linux %} - -1. [Create a new repository](/articles/creating-a-new-repository) on {% data variables.product.product_location %}. To avoid errors, do not initialize the new repository with *README*, license, or `gitignore` files. You can add these files after your project has been pushed to {% data variables.product.product_name %}. - ![Create New Repository drop-down](/assets/images/help/repository/repo-create.png) -{% data reusables.command_line.open_the_multi_os_terminal %} -3. Change the current working directory to your local project. -4. Initialize the local directory as a Git repository. - ```shell - $ git init -b main - ``` -5. Add the files in your new local repository. This stages them for the first commit. - ```shell - $ git add . - # Adds the files in the local repository and stages them for commit. {% data reusables.git.unstage-codeblock %} - ``` -6. Commit the files that you've staged in your local repository. - ```shell - $ git commit -m "First commit" - # Commits the tracked changes and prepares them to be pushed to a remote repository. {% data reusables.git.reset-head-to-previous-commit-codeblock %} - ``` -7. At the top of your repository on {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %}'s Quick Setup page, click {% octicon "clippy" aria-label="The copy to clipboard icon" %} to copy the remote repository URL. - ![Copy remote repository URL field](/assets/images/help/repository/copy-remote-repository-url-quick-setup.png) -8. In Terminal, [add the URL for the remote repository](/github/getting-started-with-github/managing-remote-repositories) where your local repository will be pushed. - ```shell - $ git remote add origin <REMOTE_URL> - # Sets the new remote - $ git remote -v - # Verifies the new remote URL - ``` -9. [Push the changes](/github/getting-started-with-github/pushing-commits-to-a-remote-repository/) in your local repository to {% data variables.product.product_location %}. - ```shell - $ git push origin main - # Pushes the changes in your local repository up to the remote repository you specified as the origin - ``` - -{% endlinux %} - -## Further reading - -- "[Adding a file to a repository](/repositories/working-with-files/managing-files/adding-a-file-to-a-repository#adding-a-file-to-a-repository-using-the-command-line)" diff --git a/translations/zh-CN/content/github/importing-your-projects-to-github/importing-source-code-to-github/importing-a-git-repository-using-the-command-line.md b/translations/zh-CN/content/github/importing-your-projects-to-github/importing-source-code-to-github/importing-a-git-repository-using-the-command-line.md deleted file mode 100644 index 99e097c21e..0000000000 --- a/translations/zh-CN/content/github/importing-your-projects-to-github/importing-source-code-to-github/importing-a-git-repository-using-the-command-line.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: 使用命令行导入 Git 仓库 -intro: '{% ifversion fpt %}如果 [GitHub Importer](/articles/importing-a-repository-with-github-importer) 不适用于您的目的,例如,如果您现有的代码托管在私有网络上,则我们建议使用命令行导入。{% else %}当您现有的代码托管在私有网络上时,适合使用命令行导入 Git 项目。{% endif %}' -redirect_from: - - /articles/importing-a-git-repository-using-the-command-line - - /github/importing-your-projects-to-github/importing-a-git-repository-using-the-command-line -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -shortTitle: 本地导入仓库 ---- - -在开始之前,请确保您知道: - -- 您的 {% data variables.product.product_name %} 用户名 -- 外部仓库的克隆 URL,如 `https://external-host.com/user/repo.git` 或 `git://external-host.com/user/repo.git`(或许 `external-host.com` 域名前面是 `user@`) - -{% tip %} - -为便于示范,我们将使用: - -- 外部帐户 **extuser** -- 外部 Git 主机 `https://external-host.com` -- {% data variables.product.product_name %} 个人用户帐户 **ghuser** -- {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %} 上名为 **repo.git** 的仓库 - -{% endtip %} - -1. [在 {% data variables.product.product_name %} 上创建新仓库](/articles/creating-a-new-repository)。 您将在此新仓库中导入外部 Git 仓库。 -2. 在命令行上,使用外部克隆 URL 创建仓库的“裸”克隆。 这会创建数据的完整副本,但没有编辑文件的工作目录,并确保干净、新鲜地导出所有旧数据。 - ```shell - $ git clone --bare https://external-host.com/extuser/repo.git - # Makes a bare clone of the external repository in a local directory - ``` -3. 使用“镜像”选项将本地克隆的仓库推送到 {% data variables.product.product_name %},以确保所有引用(如分支和标记)都复制到导入的仓库。 - ```shell - $ cd repo.git - $ git push --mirror https://{% data variables.command_line.codeblock %}/ghuser/repo.git - # Pushes the mirror to the new repository on {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %} - ``` -4. 删除临时本地仓库。 - ```shell - $ cd .. - $ rm -rf repo.git - ``` diff --git a/translations/zh-CN/content/github/importing-your-projects-to-github/importing-source-code-to-github/importing-a-repository-with-github-importer.md b/translations/zh-CN/content/github/importing-your-projects-to-github/importing-source-code-to-github/importing-a-repository-with-github-importer.md deleted file mode 100644 index 7f2ef1c8dc..0000000000 --- a/translations/zh-CN/content/github/importing-your-projects-to-github/importing-source-code-to-github/importing-a-repository-with-github-importer.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: 使用 GitHub 导入工具导入仓库 -intro: 如果您有项目托管在另一个版本控制系统上,可以使用 GitHub 导入工具将其自动导入到 GitHub。 -redirect_from: - - /articles/importing-from-other-version-control-systems-to-github - - /articles/importing-a-repository-with-github-importer - - /github/importing-your-projects-to-github/importing-a-repository-with-github-importer -versions: - fpt: '*' - ghec: '*' -shortTitle: 使用 GitHub 导入工具 ---- - -{% tip %} - -**提示:**GitHub 导入工具不适用于所有导入。 例如,如果您现有的代码托管在私有网络上,我们的工具便无法访问。 在这些情况下,我们建议对 Git 仓库[使用命令行导入](/articles/importing-a-git-repository-using-the-command-line),或者对导入自其他版本控制系统的项目使用[源代码迁移工具](/articles/source-code-migration-tools)。 - -{% endtip %} - -如果在导入时要将仓库中的提交匹配到作者的 GitHub 用户帐户,请确保在开始导入之前,仓库的每个贡献者都有 GitHub 帐户。 - -{% data reusables.repositories.repo-size-limit %} - -1. 在任何页面的右上角,单击 {% octicon "plus" aria-label="Plus symbol" %},然后单击 **Import repository(导入仓库)**。 ![新仓库菜单中的导入仓库选项](/assets/images/help/importer/import-repository.png) -2. 在 "Your old repository's clone URL"(您的旧仓库的克隆 URL)下,输入要导入的项目的 URL。 ![导入的仓库 URL 对应的文本字段](/assets/images/help/importer/import-url.png) -3. 选择拥有仓库的用户帐户或组织,然后输入 GitHub 上帐户的名称。 ![仓库所有者菜单和仓库名称字段](/assets/images/help/importer/import-repo-owner-name.png) -4. 指定新仓库是*公共*还是*私有*。 更多信息请参阅“[设置仓库可见性](/articles/setting-repository-visibility)”。 ![公共或私有仓库单选按钮](/assets/images/help/importer/import-public-or-private.png) -5. 检查您输入的信息,然后单击 **Begin import(开始导入)**。 ![开始导入按钮](/assets/images/help/importer/begin-import-button.png) -6. 如果您的旧项目有密码保护,请输入该项目的登录信息,然后单击 **Submit(提交)**。 ![有密码保护项目的密码表单和提交按钮](/assets/images/help/importer/submit-old-credentials-importer.png) -7. 如果有多个项目托管于旧项目的克隆 URL 上,请选择要导入的项目,然后单击 **Submit(提交)**。 ![要导入的项目列表和提交按钮](/assets/images/help/importer/choose-project-importer.png) -8. 如果项目包含超过 100 MB 的大文件,请选择是否使用 [Git Large File Storage](/articles/versioning-large-files) 导入大文件,然后单击 **Continue(继续)**。 ![Git Large File Storage 菜单和继续按钮](/assets/images/help/importer/select-gitlfs-importer.png) - -在仓库完成导入时,您会收到一封电子邮件。 - -## 延伸阅读 - -- "[使用 GitHub 导入工具更新提交作者属性](/articles/updating-commit-author-attribution-with-github-importer)" diff --git a/translations/zh-CN/content/github/importing-your-projects-to-github/importing-source-code-to-github/index.md b/translations/zh-CN/content/github/importing-your-projects-to-github/importing-source-code-to-github/index.md deleted file mode 100644 index 121ed4f0f3..0000000000 --- a/translations/zh-CN/content/github/importing-your-projects-to-github/importing-source-code-to-github/index.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: 将源代码导入到 GitHub -intro: '您可以使用 {% ifversion fpt %}GitHub 导入工具、命令行、{% else %}命令行{% endif %}或外部迁移工具将仓库导入到 GitHub。' -redirect_from: - - /articles/importing-an-external-git-repository - - /articles/importing-from-bitbucket - - /articles/importing-an-external-git-repo - - /articles/importing-your-project-to-github - - /articles/importing-source-code-to-github -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -children: - - /about-github-importer - - /importing-a-repository-with-github-importer - - /updating-commit-author-attribution-with-github-importer - - /importing-a-git-repository-using-the-command-line - - /adding-an-existing-project-to-github-using-the-command-line - - /source-code-migration-tools -shortTitle: 导入代码到 GitHub ---- - diff --git a/translations/zh-CN/content/github/importing-your-projects-to-github/importing-source-code-to-github/source-code-migration-tools.md b/translations/zh-CN/content/github/importing-your-projects-to-github/importing-source-code-to-github/source-code-migration-tools.md deleted file mode 100644 index f9d1b085f7..0000000000 --- a/translations/zh-CN/content/github/importing-your-projects-to-github/importing-source-code-to-github/source-code-migration-tools.md +++ /dev/null @@ -1,58 +0,0 @@ ---- -title: 源代码迁移工具 -intro: 您可以使用外部工具将项目移动到 GitHub。 -redirect_from: - - /articles/importing-from-subversion - - /articles/source-code-migration-tools - - /github/importing-your-projects-to-github/source-code-migration-tools -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -shortTitle: 代码迁移工具 ---- - -{% ifversion fpt or ghec %} - -我们建议使用 [GitHub 导入工具](/articles/about-github-importer)从 Subversion、Mercurial、Team Foundation Version Control (TFVC) 或其他 Git 仓库导入项目。 您还可以使用这些外部工具将项目转换为 Git。 - -{% endif %} - -## 从 Subversion 导入 - -在典型 Subversion 环境中,多个项目存储在一个根仓库中。 在 GitHub 上,这些项目的每一个通常都将映射到用户帐户或组织的单独 Git 仓库。 以下情况时,我们建议将 Subversion 仓库的每一部分导入到单独的 GitHub 仓库: - -* 协作者需要检出或提交到独立于项目其他部分的部分 -* 您想要不同的部分有其自己的访问权限 - -我们建议使用以下工具将 Subversion 仓库转换为 Git: - -- [`git-svn`](https://git-scm.com/docs/git-svn) -- [svn2git](https://github.com/nirvdrum/svn2git) - -## 从 Mercurial 导入 - -我们建议使用 [hg-fast-export](https://github.com/frej/fast-export) 将 Mercurial 仓库转换为 Git。 - -## 从 TFVC 导入 - -我们建议 [git-tfs](https://github.com/git-tfs/git-tfs) 用于在TFVC 和 Git 之间移动更改。 - -For more information about moving from TFVC (a centralized version control system) to Git, see "[Plan your Migration to Git](https://docs.microsoft.com/devops/develop/git/centralized-to-git)" from the Microsoft docs site. - -{% tip %} - -**提示:**在成功地将项目转换为 Git 后,您可以[将其推送到 {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/pushing-commits-to-a-remote-repository/)。 - -{% endtip %} - -{% ifversion fpt or ghec %} - -## 延伸阅读 - -- “[关于 GitHub 导入工具](/articles/about-github-importer)” -- "[使用 GitHub 导入工具导入仓库](/articles/importing-a-repository-with-github-importer)" -- [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}) - -{% endif %} diff --git a/translations/zh-CN/content/github/importing-your-projects-to-github/importing-source-code-to-github/updating-commit-author-attribution-with-github-importer.md b/translations/zh-CN/content/github/importing-your-projects-to-github/importing-source-code-to-github/updating-commit-author-attribution-with-github-importer.md deleted file mode 100644 index bef00e857a..0000000000 --- a/translations/zh-CN/content/github/importing-your-projects-to-github/importing-source-code-to-github/updating-commit-author-attribution-with-github-importer.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: 使用 GitHub 导入工具更新提交作者归属 -intro: 导入期间,您可以将仓库中的提交匹配提交作者的 GitHub 帐户。 -redirect_from: - - /articles/updating-commit-author-attribution-with-github-importer - - /github/importing-your-projects-to-github/updating-commit-author-attribution-with-github-importer -versions: - fpt: '*' - ghec: '*' -shortTitle: 更新作者 GitHub 导入工具 ---- - -GitHub 导入工具查找其电子邮件地址匹配您所导入仓库中提交作者的 GitHub 用户。 然后,您可以使用其电子邮件地址或作者的 GitHub 用户名将提交连接到其作者。 - -## 更新提交作者 - -1. 导入仓库后,在导入状态页面上,单击 **Match authors(匹配作者)**。 ![匹配作者按钮](/assets/images/help/importer/match-authors-button.png) -2. 在您想要更新其信息的作者旁边,单击 **Connect(连接)**。 ![提交作者列表](/assets/images/help/importer/connect-commit-author.png) -3. 输入作者的电子邮件地址或 GitHub 用户名,然后按 **Enter** 键。 - -## 将提交归于具有公共电子邮件地址的 GitHub 用户 - -如果导入的仓库中的提交作者具有与其用于创作提交的电子邮件地址关联的 GitHub 帐户,并且他们没有[将其提交电子邮件地址设为私有](/articles/setting-your-commit-email-address),则 GitHub 导入工具会将与提交关联的电子邮件地址匹配与其 GitHub 帐户关联的公共电子邮件地址,并将提交归于其 GitHub 帐户。 - -## 将提交归于没有公共电子邮件地址的 GitHub 用户 - -如果导入的仓库中的提交作者既没有在其 GitHub 个人资料中设置公共电子邮件地址,也没有[将其提交电子邮件地址设为私有](/articles/setting-your-commit-email-address),则 GitHub 导入工具可能无法将与提交关联的电子邮件地址匹配其 GitHub 帐户。 - -提交作者可通过将其电子邮件地址设为私有来解决此问题。 其提交随后归于 `@users.noreply.github.com`,导入的提交将与其 GitHub 帐户关联。 - -## 使用电子邮件地址归属提交 - -如果作者的电子邮件地址没有与其 GitHub 帐户关联,他们可以在导入后[将地址添加到其帐户](/articles/adding-an-email-address-to-your-github-account),然后即可正确归属提交。 - -如果作者没有 GitHub 帐户,则 GitHub 导入工具会将其提交归于与提交关联的电子邮件地址。 - -## 延伸阅读 - -- “[关于 GitHub 导入工具](/articles/about-github-importer)” -- "[使用 GitHub 导入工具导入仓库](/articles/importing-a-repository-with-github-importer)" -- “[将电子邮件地址添加到您的帐户](/articles/adding-an-email-address-to-your-github-account/)” -- "[设置提交电子邮件地址](/articles/setting-your-commit-email-address)" diff --git a/translations/zh-CN/content/github/importing-your-projects-to-github/index.md b/translations/zh-CN/content/github/importing-your-projects-to-github/index.md deleted file mode 100644 index 903266ce71..0000000000 --- a/translations/zh-CN/content/github/importing-your-projects-to-github/index.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: 将项目导入到 GitHub -intro: '您可以使用多种不同方法将源代码导入到 {% data variables.product.product_name %}。' -shortTitle: 导入项目 -redirect_from: - - /categories/67/articles - - /categories/importing - - /categories/importing-your-projects-to-github -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -children: - - /importing-source-code-to-github - - /working-with-subversion-on-github ---- - diff --git a/translations/zh-CN/content/github/importing-your-projects-to-github/working-with-subversion-on-github/index.md b/translations/zh-CN/content/github/importing-your-projects-to-github/working-with-subversion-on-github/index.md deleted file mode 100644 index 3fed28bb39..0000000000 --- a/translations/zh-CN/content/github/importing-your-projects-to-github/working-with-subversion-on-github/index.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: 在 GitHub 上使用 Subversion -intro: 您可以将 Subversion 客户端以及一些 Subversion 工作流程和属性与 GitHub 一起使用。 -redirect_from: - - /articles/working-with-subversion-on-github -versions: - fpt: '*' - ghes: '*' - ghec: '*' -children: - - /what-are-the-differences-between-subversion-and-git - - /support-for-subversion-clients - - /subversion-properties-supported-by-github -shortTitle: 在 GitHub 上使用 Subversion ---- - diff --git a/translations/zh-CN/content/github/importing-your-projects-to-github/working-with-subversion-on-github/subversion-properties-supported-by-github.md b/translations/zh-CN/content/github/importing-your-projects-to-github/working-with-subversion-on-github/subversion-properties-supported-by-github.md deleted file mode 100644 index ab1be9f87d..0000000000 --- a/translations/zh-CN/content/github/importing-your-projects-to-github/working-with-subversion-on-github/subversion-properties-supported-by-github.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: GitHub 支持的 Subversion 属性 -intro: '有几个 Subversion 工作流和属性与 {% data variables.product.product_name %} 上现有的功能类似。' -redirect_from: - - /articles/subversion-properties-supported-by-github - - /github/importing-your-projects-to-github/subversion-properties-supported-by-github -versions: - fpt: '*' - ghes: '*' - ghec: '*' -shortTitle: GitHub 支持的属性 ---- - -## 可执行文件 (svn:executable) - -我们通过在将文件模式添加到 Git 仓库之前直接进行更新来转换 `svn:executable` 属性。 - -## MIME 类型 (svn:mime-type) - -{% data variables.product.product_name %} 内部跟踪文件的 mime 类型和添加它们的提交。 - -## 忽略未版本化的项目 (svn:ignore) - -如果您已设置要在 Subversion 中忽略的文件和目录,{% data variables.product.product_name %} 将在内部跟踪它们。 Subversion 客户端忽略的文件与 *.gitignore* 文件中的条目完全不同。 - -## 目前不支持的属性 - -{% data variables.product.product_name %} 目前不支持 `svn:externals`、`svn:global-ignores` 或上面未列出的任何属性,包括自定义属性。 diff --git a/translations/zh-CN/content/github/importing-your-projects-to-github/working-with-subversion-on-github/support-for-subversion-clients.md b/translations/zh-CN/content/github/importing-your-projects-to-github/working-with-subversion-on-github/support-for-subversion-clients.md deleted file mode 100644 index 195a4547b7..0000000000 --- a/translations/zh-CN/content/github/importing-your-projects-to-github/working-with-subversion-on-github/support-for-subversion-clients.md +++ /dev/null @@ -1,133 +0,0 @@ ---- -title: Subversion 客户端支持 -intro: GitHub 仓库可从 Git 和 Subversion (SVN) 客户端进行访问。 本文介绍如何在 GitHub 上使用 Subversion 客户端以及您可能遇到的一些常见问题。 -redirect_from: - - /articles/support-for-subversion-clients - - /github/importing-your-projects-to-github/support-for-subversion-clients -versions: - fpt: '*' - ghes: '*' - ghec: '*' -shortTitle: Subversion 客户端支持 ---- - -GitHub 通过 HTTPS 协议支持 Subversion 客户端。 我们使用 Subversion 网桥将 svn 命令传递给 GitHub。 - -## GitHub 上支持的 Subversion 功能 - -### 检出 - -您首先要进行 Subversion 检出。 由于 Git 克隆将工作目录(您编辑文件的位置)与仓库数据分开,因此工作目录中一次只有一个分支。 - -Subversion 检出则不同:它们混合工作目录中的仓库数据,因此存在用于您已检出的每个分支和标记的工作目录。 对于具有许多分支和标记的仓库,检出所有内容可能会造成带宽负担,因此应从部分检出开始。 - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.copy-clone-url %} - -3. 进行仓库的空检出: - ```shell - $ svn co --depth empty https://github.com/user/repo - > Checked out revision 1. - $ cd repo - ``` - -4. 获取 `trunk` 分支。 Subversion 网桥将主干映射到 Git HEAD 分支。 - ```shell - $ svn up trunk - > A trunk - > A trunk/README.md - > A trunk/gizmo.rb - > Updated to revision 1. - ``` - -5. 获取 `branches` 目录的空检出。 这是所有非 `HEAD` 分支所在的位置,您将在此处进行功能分支。 - ```shell - $ svn up --depth empty branches - Updated to revision 1. - ``` - -### 创建分支 - -您还可以使用到 GitHub 的 Subversion 网桥创建分支。 - -从 svn 客户端更新 `trunk`,以确保 "master" 是最新的: -```shell -$ svn up trunk -> At revision 1. -``` - -接下来,您可以使用 `svn copy` 创建新分支: -```shell -$ svn copy trunk branches/more_awesome -> A branches/more_awesome -$ svn commit -m 'Added more_awesome topic branch' -> Adding branches/more_awesome - -> Committed revision 2. -``` - -您可以在仓库的分支下拉菜单中确认存在新分支: - -![分支快照](/assets/images/help/branch/svnflow-branch-snapshot.png) - -您还可以通过命令行确认新分支: - -```shell -$ git fetch -> From https://github.com/user/repo/ -> * [new branch] more_awesome -> origin/more_awesome -``` - -### 对 Subversion 进行提交 - -添加一些功能并修复一些漏洞后,您想要将这些更改提交到 GitHub。 此工作正如您惯用的 Subversion 一样。 编辑文件,然后使用 `svn commit` 记录您的更改: - -```shell -$ svn status -> M gizmo.rb -$ svn commit -m 'Guard against known problems' -> Sending more_awesome/gizmo.rb -> Transmitting file data . -> Committed revision 3. -$ svn status -> ? test -$ svn add test -> A test -> A test/gizmo_test.rb -$ svn commit -m 'Test coverage for problems' -> Adding more_awesome/test -> Adding more_awesome/test/gizmo_test.rb -> Transmitting file data . -> Committed revision 4. -``` - -### 在分支间切换 - -要在分支之间切换,您可能想要从 `trunk` 的检出开始: - -```shell -$ svn co --depth empty https://github.com/user/repo/trunk -``` - -然后,您可以切换到另一个分支: - -```shell -$ svn switch https://github.com/user/repo/branches/more_awesome -``` - -## 为 Subversion 提交查找 Git 提交 SHA - -GitHub 的 Subversion 服务器公开每个 Subversion 提交的 Git 提交 sha。 - -要查看提交 SHA,应请求 `git-commit` 未版本化的远程属性。 - -```shell -$ svn propget git-commit --revprop -r HEAD https://github.com/user/repo -05fcc584ed53d7b0c92e116cb7e64d198b13c4e3 -``` - -使用此提交 SHA,举例来说,您可以在 GitHub 上查找相应的 Git 提交。 - -## 延伸阅读 - -* “[GitHub 支持的 Subversion 属性](/articles/subversion-properties-supported-by-github)” diff --git a/translations/zh-CN/content/github/importing-your-projects-to-github/working-with-subversion-on-github/what-are-the-differences-between-subversion-and-git.md b/translations/zh-CN/content/github/importing-your-projects-to-github/working-with-subversion-on-github/what-are-the-differences-between-subversion-and-git.md deleted file mode 100644 index 5aa5b2f33c..0000000000 --- a/translations/zh-CN/content/github/importing-your-projects-to-github/working-with-subversion-on-github/what-are-the-differences-between-subversion-and-git.md +++ /dev/null @@ -1,70 +0,0 @@ ---- -title: Subversion 和 Git 有哪些区别? -intro: Subversion (SVN) 仓库与 Git 仓库类似,但涉及项目架构时有一些区别。 -redirect_from: - - /articles/what-are-the-differences-between-svn-and-git - - /articles/what-are-the-differences-between-subversion-and-git - - /github/importing-your-projects-to-github/what-are-the-differences-between-subversion-and-git -versions: - fpt: '*' - ghes: '*' - ghec: '*' -shortTitle: Subversion 与 Git 差异 ---- - -## 目录结构 - -项目中的每个*引用*或标记的提交快照均在特定子目录中组织,例如 `trunk`、`branches` 和 `tags`。 例如,具有两项正在开发的功能的 SVN 项目可能类似如下: - - sample_project/trunk/README.md - sample_project/trunk/lib/widget.rb - sample_project/branches/new_feature/README.md - sample_project/branches/new_feature/lib/widget.rb - sample_project/branches/another_new_feature/README.md - sample_project/branches/another_new_feature/lib/widget.rb - -SVN 工作流程可能类似如下: - -* `trunk` 目录表示项目的最新稳定发行版。 -* 活动功能工作在 `branches` 下的子目录内进行开发。 -* 功能完成后,该功能目录将合并到 `trunk` 中并删除。 - -Git 项目也存储在一个目录中。 不过,Git 通过将其引用存储在一个特殊的 *.git* 目录中来模糊其详细信息。 例如,具有两项正在开发的功能的 Git 项目可能类似如下: - - sample_project/.git - sample_project/README.md - sample_project/lib/widget.rb - -Git 工作流程可能类似如下: - -* Git 仓库在 *.git* 目录中存储所有其分支和标记的完整历史记录。 -* 最新稳定发行版包含在默认分支中。 -* 活动功能工作在单独的分支中进行开发。 -* 功能完成后,该功能分支将合并到默认分支中并删除。 - -与 SVN 不同的是,使用 Git 时目录结构保持不变,但文件内容会根据您的分支而变化。 - -## 包括子项目 - -*子项目*是在主项目之外的某个位置开发和管理的项目。 您通常导入子项目以将一些功能添加到您的项目,而无需自行维护代码。 每当子项目更新时,您可以将其与您的项目同步,以确保所有内容都是最新的。 - -在 SVN 中,子项目称为 *SVN 外部*。 在 Git 中,它称为 *Git 子模块*。 尽管在概念上类似,但 Git 子模块不会自动保持最新状态;您必须明确要求才能将新版本带入您的项目。 - -更多信息请参阅 Git 文档中的“[Git 工具子模块](https://git-scm.com/book/en/Git-Tools-Submodules)”。 - -## 保留历史记录 - -SVN 配置为假设项目的历史记录永不更改。 Git 允许您使用 [`git rebase`](/github/getting-started-with-github/about-git-rebase) 等工具修改以前的提交和更改。 - -{% tip %} - -[GitHub 支持 Subversion 客户端](/articles/support-for-subversion-clients),如果您在同一项目内同时使用 Git 和 SVN,可能会产生一些意外的结果。 如果您操纵了 Git 的提交历史记录,这些相同的提交在 SVN 的历史记录中将始终保留。 如果意外提交了一些敏感数据,我们有[一篇文章可帮助您将其从 Git 的历史中删除](/articles/removing-sensitive-data-from-a-repository)。 - -{% endtip %} - -## 延伸阅读 - -- “[GitHub 支持的 Subversion 属性](/articles/subversion-properties-supported-by-github)” -- [_Git SCM_ 书籍中的“分支与合并”](https://git-scm.com/book/en/Git-Branching-Basic-Branching-and-Merging) -- “[将源代码导入到 GitHub](/articles/importing-source-code-to-github)” -- "[源代码迁移工具](/articles/source-code-migration-tools)" diff --git a/translations/zh-CN/content/github/understanding-how-github-uses-and-protects-your-data/about-githubs-use-of-your-data.md b/translations/zh-CN/content/github/understanding-how-github-uses-and-protects-your-data/about-githubs-use-of-your-data.md deleted file mode 100644 index acd8ce5b78..0000000000 --- a/translations/zh-CN/content/github/understanding-how-github-uses-and-protects-your-data/about-githubs-use-of-your-data.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: 关于 GitHub 使用您的数据 -redirect_from: - - /articles/about-github-s-use-of-your-data - - /articles/about-githubs-use-of-your-data -intro: '{% data variables.product.product_name %} 使用您的仓库数据来将您连接到相关工具、人员、项目和信息。' -versions: - fpt: '*' - ghec: '*' -topics: - - Policy - - Legal -shortTitle: GitHub 对您的数据的使用 ---- - -## 关于 {% data variables.product.product_name %} 使用您的数据 - -{% data variables.product.product_name %} 汇总元数据并剖析内容模式,以在产品中提交一般化的见解。 它使用公共仓库中的数据,当仓库所有者选择与 {% data variables.product.product_name %} 共享数据时还会使用私有仓库中的元数据并汇总数据。 如果选择使用私有仓库的数据,它会对特定私有仓库执行只读分析。 - -{% data reusables.repositories.about-github-archive-program %} 更多信息请参阅“[关于在 {% data variables.product.prodname_dotcom %} 上存档内容](/github/creating-cloning-and-archiving-repositories/about-archiving-content-and-data-on-github#about-the-github-archive-program)”。 - -{% data reusables.user_settings.export-data %} 更多信息请参阅“[请求个人帐户数据的存档](/articles/requesting-an-archive-of-your-personal-account-s-data)”。 - -如果您选择使用私人仓库的数据,我们将继续按照[服务条款](/free-pro-team@latest/github/site-policy/github-terms-of-service),将您的私人数据、源代码或商业秘密视为机密和私密。 我们了解的信息只来自汇总的数据。 更多信息请参阅“[管理私有仓库的数据使用设置](/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository)”。 - -我们会在 [{% data variables.product.prodname_dotcom %} 博客](https://github.com/blog)中宣布使用元数据或汇总数据的重要新功能。 - -## 数据如何改进安全建议 - -例如,在使用您的数据时,我们可能会检测您的公共仓库依赖项中的安全漏洞并提醒您。 更多信息请参阅“[关于易受攻击的依赖项的警报](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)”。 - -为检测潜在安全漏洞,{% data variables.product.product_name %} 会扫描依赖项清单文件的内容,以列出项目的依赖项。 - -{% data variables.product.product_name %} 还会获知您对依赖项清单所做的更改。 例如,如果您在获得安全警报后将有漏洞的依赖项升级到安全版本,其他人也执行同样的操作,{% data variables.product.product_name %} 就会了解如何修补漏洞,并对受影响的仓库推荐类似的补丁。 - -## 隐私和数据共享 - -私有仓库数据由电脑扫描,{% data variables.product.product_name %} 员工不能查看。 除了我们[服务条款](/free-pro-team@latest/github/site-policy/github-terms-of-service#3-access)中所述的内容之外,绝不会有人查看私有仓库的内容。 - -您的个别人员或仓库数据不会与第三方共享。 我们可能与合作伙伴共享分析后获得的汇总数据。 diff --git a/translations/zh-CN/content/github/understanding-how-github-uses-and-protects-your-data/index.md b/translations/zh-CN/content/github/understanding-how-github-uses-and-protects-your-data/index.md deleted file mode 100644 index 3b3edc6b2b..0000000000 --- a/translations/zh-CN/content/github/understanding-how-github-uses-and-protects-your-data/index.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: 了解 GitHub 如何使用和保护数据 -redirect_from: - - /categories/understanding-how-github-uses-and-protects-your-data -versions: - fpt: '*' - ghec: '*' -children: - - /about-githubs-use-of-your-data - - /requesting-an-archive-of-your-personal-accounts-data - - /managing-data-use-settings-for-your-private-repository - - /opting-into-or-out-of-the-github-archive-program-for-your-public-repository -shortTitle: GitHub 如何保护数据 ---- - diff --git a/translations/zh-CN/content/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository.md b/translations/zh-CN/content/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository.md deleted file mode 100644 index e2b617a11c..0000000000 --- a/translations/zh-CN/content/github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: Managing data use settings for your private repository -intro: 'To help {% data variables.product.product_name %} connect you to relevant tools, people, projects, and information, you can configure data use for your private repository.' -redirect_from: - - /articles/opting-into-or-out-of-data-use-for-your-private-repository - - /github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-data-use-for-your-private-repository -versions: - fpt: '*' - ghec: '*' -topics: - - Policy - - Legal -shortTitle: Manage data use for private repo ---- - -## About data use for your private repository - -When you enable data use for your private repository, you'll be able to access the dependency graph, where you can track your repository's dependencies and receive {% data variables.product.prodname_dependabot_alerts %} when {% data variables.product.product_name %} detects vulnerable dependencies. For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies#dependabot-alerts-for-vulnerable-dependencies)." - -## Enabling or disabling data use features - -{% data reusables.security.security-and-analysis-features-enable-read-only %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -{% data reusables.repositories.navigate-to-security-and-analysis %} -4. Under "Configure security and analysis features", to the right of the feature, click **Disable** or **Enable**.{% ifversion fpt %} - !["Enable" or "Disable" button for "Configure security and analysis" features](/assets/images/help/repository/security-and-analysis-disable-or-enable-fpt-private.png){% elsif ghec %} - !["Enable" or "Disable" button for "Configure security and analysis" features](/assets/images/help/repository/security-and-analysis-disable-or-enable-ghec-private.png){% endif %} - -## Further reading - -- "[About {% data variables.product.prodname_dotcom %}'s use of your data](/articles/about-github-s-use-of-your-data)" -- "[Viewing and updating vulnerable dependencies in your repository](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository)" -- "[Managing security and analysis settings for your repository](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository)" diff --git a/translations/zh-CN/content/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-the-github-archive-program-for-your-public-repository.md b/translations/zh-CN/content/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-the-github-archive-program-for-your-public-repository.md deleted file mode 100644 index 162ddd5d33..0000000000 --- a/translations/zh-CN/content/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-the-github-archive-program-for-your-public-repository.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: 选择加入或退出公共仓库的 GitHub 存档计划 -intro: '您可以管理 {% data variables.product.prodname_dotcom %} 是否将您的公共仓库包含在 {% data variables.product.prodname_archive %} 中,以帮助确保长期保存世界的开源软件。' -permissions: 'People with admin permissions to a public repository can opt into or out of the {% data variables.product.prodname_archive %}.' -versions: - fpt: '*' - ghec: '*' -topics: - - Policy - - Legal -shortTitle: GitHub 存档计划 ---- - -{% data reusables.repositories.about-github-archive-program %} 更多信息请参阅“[关于在 {% data variables.product.prodname_dotcom %} 上存档内容](/github/creating-cloning-and-archiving-repositories/about-archiving-content-and-data-on-github#about-the-github-archive-program)”。 - -如果您对仓库选择退出 {% data variables.product.prodname_archive %},该仓库将被排除在 {% data variables.product.prodname_dotcom %} 未来可能创建的任何长期存档之外。 我们还会向每个合作伙伴组织发送请求,请求从他们的数据中删除该仓库。 - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -3. 在“Features(功能)”下,选择或取消选择 **Preserve this repository(保存此仓库)**。 ![允许 {% data variables.product.prodname_dotcom %} 在 {% data variables.product.prodname_archive %} 中包含您的代码的复选框](/assets/images/help/repository/github-archive-program-checkbox.png) - -## 延伸阅读 -- [{% data variables.product.prodname_archive %} 常见问题](https://archiveprogram.github.com/faq/) diff --git a/translations/zh-CN/content/github/understanding-how-github-uses-and-protects-your-data/requesting-an-archive-of-your-personal-accounts-data.md b/translations/zh-CN/content/github/understanding-how-github-uses-and-protects-your-data/requesting-an-archive-of-your-personal-accounts-data.md deleted file mode 100644 index 49fa585881..0000000000 --- a/translations/zh-CN/content/github/understanding-how-github-uses-and-protects-your-data/requesting-an-archive-of-your-personal-accounts-data.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: 请求个人帐户数据的存档 -redirect_from: - - /articles/requesting-an-archive-of-your-personal-account-s-data - - /articles/requesting-an-archive-of-your-personal-accounts-data -intro: '{% data reusables.user_settings.export-data %}' -versions: - fpt: '*' - ghec: '*' -topics: - - Policy - - Legal -shortTitle: 请求帐户存档 ---- - -{% data variables.product.product_name %} 存储您个人帐户活动的仓库和个人资料元数据。 您可以通过 {% data variables.product.prodname_dotcom_the_website %} 上的设置或使用用户迁移 API 导出个人帐户的数据。 - -有关可供导出的数据 {% data variables.product.product_name %} 存储的更多信息,请参阅“[下载用户迁移存档](/rest/reference/migrations#download-a-user-migration-archive)”和“[关于 {% data variables.product.product_name %} 对数据的使用](/articles/about-github-s-use-of-your-data)”。 - -当您通过 {% data variables.product.prodname_dotcom_the_website %} 上的设置请求导出个人数据时,{% data variables.product.product_name %} 会将您的个人数据打包到 `tar.gz` 文件中,并向您的主电子邮件地址发送含有下载链接的电子邮件。 - -默认情况下,下载链接会在七天后过期。 在下载链接过期之前的任何时候,您都可以从用户设置中禁用该链接。 更多信息请参阅“[删除对个人帐户数据存档的访问权限](/articles/requesting-an-archive-of-your-personal-account-s-data/#deleting-access-to-an-archive-of-your-personal-accounts-data)”。 - -如果您的操作系统无法本机解压缩 `tar.gz` 文件,则可以使用第三方工具解压缩存档的文件。 更多信息请参阅 Opensource.com 上的“[如何解压缩 tar.gz 文件](https://opensource.com/article/17/7/how-unzip-targz-file)”。 - -生成的 `tar.gz` 文件在您开始数据导出时反映存储的数据。 - -## 下载个人帐户数据的存档 - -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.account_settings %} -3. 在“Export account data(导出帐户数据)”下,单击 **Start export(开始导出)**或 **New export(新导出)**。 ![开始个人数据导出按钮突出显示](/assets/images/help/repository/export-personal-data.png) ![新个人数据导出按钮突出显示](/assets/images/help/repository/new-export.png) -4. 导出准备好供下载后,{% data variables.product.product_name %} 将发送下载链接到您的主电子邮件地址。 -5. 单击电子邮件中的下载链接并在提示时重新输入密码。 -6. 您将被重定向到可以下载的 `tar.gz` 文件。 - -## 删除个人帐户数据存档的访问权限 - -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.account_settings %} -3. 要在其过期之前禁用发送到您电子邮件的下载链接,请在“Export account data(导出帐户数据)”下,找到您想要禁用的数据导出下载,然后单击 **Delete(删除)**。 ![删除个人数据导出包按钮突出显示](/assets/images/help/repository/delete-export-personal-account-data.png) diff --git a/translations/zh-CN/content/github/writing-on-github/editing-and-sharing-content-with-gists/creating-gists.md b/translations/zh-CN/content/github/writing-on-github/editing-and-sharing-content-with-gists/creating-gists.md deleted file mode 100644 index d52fb36e48..0000000000 --- a/translations/zh-CN/content/github/writing-on-github/editing-and-sharing-content-with-gists/creating-gists.md +++ /dev/null @@ -1,84 +0,0 @@ ---- -title: Creating gists -intro: 'You can create two kinds of gists: {% ifversion ghae %}internal{% else %}public{% endif %} and secret. Create {% ifversion ghae %}an internal{% else %}a public{% endif %} gist if you''re ready to share your ideas with {% ifversion ghae %}enterprise members{% else %}the world{% endif %} or a secret gist if you''re not.' -permissions: '{% data reusables.enterprise-accounts.emu-permission-gist %}' -redirect_from: - - /articles/about-gists - - /articles/cannot-delete-an-anonymous-gist - - /articles/deleting-an-anonymous-gist - - /articles/creating-gists - - /github/writing-on-github/creating-gists -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' ---- -## About gists - -Every gist is a Git repository, which means that it can be forked and cloned. {% ifversion not ghae %}If you are signed in to {% data variables.product.product_name %} when{% else %}When{% endif %} you create a gist, the gist will be associated with your account and you will see it in your list of gists when you navigate to your {% data variables.gists.gist_homepage %}. - -Gists can be {% ifversion ghae %}internal{% else %}public{% endif %} or secret. {% ifversion ghae %}Internal{% else %}Public{% endif %} gists show up in {% data variables.gists.discover_url %}, where {% ifversion ghae %}enterprise members{% else %}people{% endif %} can browse new gists as they're created. They're also searchable, so you can use them if you'd like other people to find and see your work. - -Secret gists don't show up in {% data variables.gists.discover_url %} and are not searchable. Secret gists aren't private. If you send the URL of a secret gist to {% ifversion ghae %}another enterprise member{% else %}a friend{% endif %}, they'll be able to see it. However, if {% ifversion ghae %}any other enterprise member{% else %}someone you don't know{% endif %} discovers the URL, they'll also be able to see your gist. If you need to keep your code away from prying eyes, you may want to [create a private repository](/articles/creating-a-new-repository) instead. - -{% data reusables.gist.cannot-convert-public-gists-to-secret %} - -{% ifversion ghes %} - -If your site administrator has disabled private mode, you can also use anonymous gists, which can be public or secret. - -{% data reusables.gist.anonymous-gists-cannot-be-deleted %} - -{% endif %} - -You'll receive a notification when: -- You are the author of a gist. -- Someone mentions you in a gist. -- You subscribe to a gist, by clicking **Subscribe** at the top of any gist. - -{% ifversion fpt or ghes or ghec %} - -You can pin gists to your profile so other people can see them easily. For more information, see "[Pinning items to your profile](/articles/pinning-items-to-your-profile)." - -{% endif %} - -You can discover {% ifversion ghae %}internal{% else %}public{% endif %} gists others have created by going to the {% data variables.gists.gist_homepage %} and clicking **All Gists**. This will take you to a page of all gists sorted and displayed by time of creation or update. You can also search gists by language with {% data variables.gists.gist_search_url %}. Gist search uses the same search syntax as [code search](/search-github/searching-on-github/searching-code). - -Since gists are Git repositories, you can view their full commit history, complete with diffs. You can also fork or clone gists. For more information, see ["Forking and cloning gists"](/articles/forking-and-cloning-gists). - -You can download a ZIP file of a gist by clicking the **Download ZIP** button at the top of the gist. You can embed a gist in any text field that supports Javascript, such as a blog post. To get the embed code, click the clipboard icon next to the **Embed** URL of a gist. To embed a specific gist file, append the **Embed** URL with `?file=FILENAME`. - -{% ifversion fpt or ghec %} - -Gist supports mapping GeoJSON files. These maps are displayed in embedded gists, so you can easily share and embed maps. For more information, see "[Working with non-code files](/repositories/working-with-files/using-files/working-with-non-code-files#mapping-geojson-files-on-github)." - -{% endif %} - -## Creating a gist - -Follow the steps below to create a gist. - -{% ifversion fpt or ghes or ghae or ghec %} -{% note %} - -You can also create a gist using the {% data variables.product.prodname_cli %}. For more information, see "[`gh gist create`](https://cli.github.com/manual/gh_gist_create)" in the {% data variables.product.prodname_cli %} documentation. - -Alternatively, you can drag and drop a text file from your desktop directly into the editor. - -{% endnote %} -{% endif %} - -1. Sign in to {% data variables.product.product_name %}. -2. Navigate to your {% data variables.gists.gist_homepage %}. -3. Type an optional description and name for your gist. -![Gist name description](/assets/images/help/gist/gist_name_description.png) - -4. Type the text of your gist into the gist text box. -![Gist text box](/assets/images/help/gist/gist_text_box.png) - -5. Optionally, to create {% ifversion ghae %}an internal{% else %}a public{% endif %} gist, click {% octicon "triangle-down" aria-label="The downwards triangle icon" %}, then click **Create {% ifversion ghae %}internal{% else %}public{% endif %} gist**. -![Drop-down menu to select gist visibility]{% ifversion ghae %}(/assets/images/help/gist/gist-visibility-drop-down-ae.png){% else %}(/assets/images/help/gist/gist-visibility-drop-down.png){% endif %} - -6. Click **Create secret Gist** or **Create {% ifversion ghae %}internal{% else %}public{% endif %} gist**. - ![Button to create gist](/assets/images/help/gist/create-secret-gist-button.png) diff --git a/translations/zh-CN/content/github/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists.md b/translations/zh-CN/content/github/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists.md deleted file mode 100644 index 54be9fcc66..0000000000 --- a/translations/zh-CN/content/github/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: 复刻和克隆 Gist -intro: Gist 实际上是 Git 仓库,这意味着即使您不是原作者,也可以复刻或克隆任何 Gist。 还可以查看 Gist 的完整提交历史记录,包括差异。 -permissions: '{% data reusables.enterprise-accounts.emu-permission-gist %}' -redirect_from: - - /articles/forking-and-cloning-gists - - /github/writing-on-github/forking-and-cloning-gists -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' ---- - -## 复刻 Gist - -每个 Gist 都指示哪些复刻中有活动,使您更容易找到他人的有趣更改。 - -![Gist 复刻](/assets/images/help/gist/gist_forks.png) - -## 克隆 Gist - -如果要对 Gist 进行本地更改然后将其推送到 web 上,您可以克隆 Gist 然后进行提交,与使用任何 Git 仓库的方法一样。 更多信息请参阅“[克隆仓库](/articles/cloning-a-repository)”。 - -![Gist 克隆按钮](/assets/images/help/gist/gist_clone_btn.png) - -## 查看 Gist 提交历史记录 - -To view a gist's full commit history, click the "Revisions" tab at the top of the gist. - -![Gist 版本选项卡](/assets/images/help/gist/gist_revisions_tab.png) - -您将看到该 Gist 的完整提交历史记录及其差异。 - -![Gist 版本页面](/assets/images/help/gist/gist_history.png) diff --git a/translations/zh-CN/content/github/writing-on-github/editing-and-sharing-content-with-gists/index.md b/translations/zh-CN/content/github/writing-on-github/editing-and-sharing-content-with-gists/index.md deleted file mode 100644 index 195f655ddf..0000000000 --- a/translations/zh-CN/content/github/writing-on-github/editing-and-sharing-content-with-gists/index.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: 编辑内容以及与 gist 共享内容 -intro: '' -redirect_from: - - /categories/23/articles - - /categories/gists - - /articles/editing-and-sharing-content-with-gists -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -children: - - /creating-gists - - /forking-and-cloning-gists -shortTitle: 与 gists 共享内容 ---- - diff --git a/translations/zh-CN/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/about-writing-and-formatting-on-github.md b/translations/zh-CN/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/about-writing-and-formatting-on-github.md deleted file mode 100644 index 9d1d83cb56..0000000000 --- a/translations/zh-CN/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/about-writing-and-formatting-on-github.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: 关于在 GitHub 上编写和设置格式 -intro: GitHub 结合了用于格式化文字的语法,称为 GitHub Flavored Markdown,具有一些独特的写作功能。 -redirect_from: - - /articles/about-writing-and-formatting-on-github - - /github/writing-on-github/about-writing-and-formatting-on-github -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -shortTitle: 在 GitHub 上编写和格式化 ---- - -[Markdown](http://daringfireball.net/projects/markdown/) 是一种易于阅读和编写的语法,用于格式化纯文本。 - -我们添加了一些自定义功能来创建 {% data variables.product.prodname_dotcom %} Flavored Markdown,用于格式化网站中的散文和代码。 - -您也可以在拉取请求和议题中使用 [@提及](/articles/basic-writing-and-formatting-syntax/#mentioning-people-and-teams)、[议题和 PR 参考](/articles/basic-writing-and-formatting-syntax/#referencing-issues-and-pull-requests)和[表情符号](/articles/basic-writing-and-formatting-syntax/#using-emoji)等功能与其他用户交互。 - -## 文本格式工具栏 - -{% data variables.product.product_name %} 上的每个评论字段都包含文本格式工具栏,用于格式化文本,而无需了解 Markdown 语法。 除了 Markdown 格式(如粗体和斜体样式)和创建标题、链接及列表等之外,工具栏还包括 {% data variables.product.product_name %} 特定的功能,如 @提及、任务列表以及链接到议题和拉取请求。 - -{% if fixed-width-font-gfm-fields %} - -## Enabling fixed-width fonts in the editor - -You can enable a fixed-width font in every comment field on {% data variables.product.product_name %}. Each character in a fixed-width, or monospace, font occupies the same horizontal space which can make it easier to edit advanced Markdown structures such as tables and code snippets. - -![Screenshot showing the {% data variables.product.product_name %} comment field with fixed-width fonts enabled](/assets/images/help/writing/fixed-width-example.png) - -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.appearance-settings %} -1. Under "Markdown editor font preference", select **Use a fixed-width (monospace) font when editing Markdown**. ![Screenshot showing the {% data variables.product.product_name %} comment field with fixed width fonts enabled](/assets/images/help/writing/enable-fixed-width.png) - -{% endif %} - -## 延伸阅读 - -- [{% data variables.product.prodname_dotcom %} Flavored Markdown 规格](https://github.github.com/gfm/) -- "[基本撰写和格式语法](/articles/basic-writing-and-formatting-syntax)" -- "[使用高级格式](/articles/working-with-advanced-formatting)" -- "[熟悉 Markdown](https://guides.github.com/features/mastering-markdown/)" diff --git a/translations/zh-CN/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md b/translations/zh-CN/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md deleted file mode 100644 index 6297e453be..0000000000 --- a/translations/zh-CN/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md +++ /dev/null @@ -1,343 +0,0 @@ ---- -title: 基本撰写和格式语法 -intro: 使用简单的语法在 GitHub 上为您的散文和代码创建复杂的格式。 -redirect_from: - - /articles/basic-writing-and-formatting-syntax - - /github/writing-on-github/basic-writing-and-formatting-syntax -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -shortTitle: 基本格式语法 ---- - -## 标题 - -要创建标题,请在标题文本前添加一至六个 `#` 符号。 您使用的 `#` 数量将决定标题的大小。 - -```markdown -# 最大标题 -## 第二大标题 -###### 最小标题 -``` - -![渲染的 H1、H2 和 H6 标题](/assets/images/help/writing/headings-rendered.png) - -## 样式文本 - -您可以在评论字段和 `.md` 文件中以粗体、斜体或删除线的文字表示强调。 - -| 样式 | 语法 | 键盘快捷键 | 示例 | 输出 | -| -------- | ------------------ | ---------- | ------------------ | ---------------- | -| 粗体 | `** **` 或 `__ __` | 命令/控制键 + b | `**这是粗体文本**` | **这是粗体文本** | -| 斜体 | `* *` 或 `_ _`      | 命令/控制键 + i | `*这是斜体文本*` | *这是斜体文本* | -| 删除线 | `~~ ~~` | | `~~这是错误文本~~` | ~~这是错误文本~~ | -| 粗体和嵌入的斜体 | `** **` 和 `_ _` | | `**此文本 _非常_ 重要**` | **此文本_非常_重要** | -| 全部粗体和斜体 | `*** ***` | | `***所有这些文本都很重要***` | ***所有这些文本都是斜体*** | - -## 引用文本 - -您可以使用 `>` 来引用文本。 - -```markdown -Text that is not a quote - -> Text that is a quote -``` - -![渲染的引用文本](/assets/images/help/writing/quoted-text-rendered.png) - -{% tip %} - -**提示:**在查看转换时,您可以突出显示文本,然后输入代码 `r`,以自动引用评论中的文本。 您可以单击 {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} 和 **Quote reply(引用回复)**引用整个评论。 有关键盘快捷键的更多信息,请参阅“[键盘快捷键](/articles/keyboard-shortcuts/)”。 - -{% endtip %} - -## 引用代码 - -使用单反引号可标注句子中的代码或命令。 倒引号中的文本不会被格式化。{% ifversion fpt or ghae or ghes > 3.1 or ghec %} 您也可以按 `command` 或 `Ctrl` + `e` 键盘快捷键将代码块的倒引号插入到 Markdown 一行中。{% endif %} - -```markdown -使用 `git status` 列出尚未提交的所有新文件或已修改文件。 -``` - -![渲染的内联代码块](/assets/images/help/writing/inline-code-rendered.png) - -要将代码或文本格式化为各自的不同块,请使用三反引号。 - -
-一些基本的 Git 命令为:
-```
-git status
-git add
-git commit
-```
-
- -![渲染的代码块](/assets/images/help/writing/code-block-rendered.png) - -更多信息请参阅“[创建和突出显示代码块](/articles/creating-and-highlighting-code-blocks)”。 - -{% data reusables.user_settings.enabling-fixed-width-fonts %} - -## 链接 - -通过将链接文本包含在方括号 `[ ]` 内,然后将 URL 包含在括号 `( )` 内,可创建内联链接。 {% ifversion fpt or ghae or ghes > 3.1 or ghec %}You can also use the keyboard shortcut `command + k` to create a link.{% endif %}{% ifversion fpt or ghae-issue-5434 or ghes > 3.3 or ghec %} When you have text selected, you can paste a URL from your clipboard to automatically create a link from the selection.{% endif %} - -`本站点是使用 [GitHub Pages](https://pages.github.com/) 构建的。` - -![渲染的链接](/assets/images/help/writing/link-rendered.png) - -{% tip %} - -**提示:**当评论中写入了有效 URL 时,{% data variables.product.product_name %} 会自动创建链接。 更多信息请参阅“[自动链接的引用和 URL](/articles/autolinked-references-and-urls)”。 - -{% endtip %} - -## 章节链接 - -{% data reusables.repositories.section-links %} - -## 相对链接 - -{% data reusables.repositories.relative-links %} - -## 图像 - -您可以通过添加 `!` 并在`[ ]`中包装 alt 文本来显示图像。 然后将图像链接包装在括号 `()` 中。 - -`![This is an image](https://myoctocat.com/assets/images/base-octocat.svg)` - -![渲染的图像](/assets/images/help/writing/image-rendered.png) - -{% data variables.product.product_name %} 支持将图像嵌入到您的议题、拉取请求{% ifversion fpt or ghec %}、讨论{% endif %}、评论和 `.md` 文件中。 您可以从仓库显示图像、添加在线图像链接或上传图像。 更多信息请参阅“[上传资产](#uploading-assets)”。 - -{% tip %} - -**提示:**想要显示仓库中的图像时,应该使用相对链接而不是绝对链接。 - -{% endtip %} - -下面是一些使用相对链接显示图像的示例。 - -| 上下文 | 相对链接 | -| ------------------ | ---------------------------------------------------------------------- | -| 在同一个分支上的 `.md` 文件中 | `/assets/images/electrocat.png` | -| 在另一个分支的 `.md` 文件中 | `/../main/assets/images/electrocat.png` | -| 在仓库的议题、拉取请求和评论中 | `../blob/main/assets/images/electrocat.png` | -| 在另一个仓库的 `.md` 文件中 | `/../../../../github/docs/blob/main/assets/images/electrocat.png` | -| 在另一个仓库的议题、拉取请求和评论中 | `../../../github/docs/blob/main/assets/images/electrocat.png?raw=true` | - -{% note %} - -**注意**:上表中的最后两个相对链接只有在查看者至少能够读取包含这些图像的私有仓库时,才可用于私有仓库中的图像。 - -{% endnote %} - -更多信息请参阅“[相对链接](#relative-links)”。 - -{% ifversion fpt or ghec or ghes > 3.3 or ghae-issue-5559 %} -### Specifying the theme an image is shown to - -You can specify the theme an image is displayed to by appending `#gh-dark-mode-only` or `#gh-light-mode-only` to the end of an image URL, in Markdown. - -We distinguish between light and dark color modes, so there are two options available. You can use these options to display images optimized for dark or light backgrounds. This is particularly helpful for transparent PNG images. - -| 上下文 | URL | -| ----------- | ------------------------------------------------------------------------ | -| Dark Theme | `![GitHub Light](https://github.com/github-light.png#gh-dark-mode-only)` | -| Light Theme | `![GitHub Dark](https://github.com/github-dark.png#gh-light-mode-only)` | -{% endif %} - -## 列表 - -通过在一行或多行文本前面添加 `-` 或 `*` 可创建无序列表。 - -```markdown -- George Washington -- John Adams -- Thomas Jefferson -``` - -![渲染的无序列表](/assets/images/help/writing/unordered-list-rendered.png) - -要对列表排序,请在每行前面添加一个编号。 - -```markdown -1. James Madison -2. James Monroe -3. John Quincy Adams -``` - -![渲染的有序列表](/assets/images/help/writing/ordered-list-rendered.png) - -### 嵌套列表 - -通过在一个列表项下面缩进一个或多个其他列表项,可创建嵌套列表。 - -要通过 {% data variables.product.product_name %} 上的 web 编辑器或使用等宽字体的文本编辑器(例如 [Atom](https://atom.io/))创建嵌套列表,您可以直观地对齐列表。 在嵌套列表项的前面键入空格字符,直至列表标记字符(`-` 或 `*`)位于其上方条目中第一个文本字符的正下方。 - -```markdown -1. 第一个列表项 - - 第一个嵌套列表项 - - 第二个嵌套列表项 -``` - -![突出显示对齐的嵌套列表](/assets/images/help/writing/nested-list-alignment.png) - -![含两级嵌套项的列表](/assets/images/help/writing/nested-list-example-1.png) - -要在 {% data variables.product.product_name %} 上的评论编辑器中创建嵌套列表(不使用等宽字体),您可以查看嵌套列表正上方的列表项,并计算该条目内容前面的字符数量。 然后在嵌套列表项的前面键入该数量的空格字符。 - -在此例中,您可以通过缩进嵌套列表项至少五个空格,在列表项 `100. 第一个列表项`的下面添加一个嵌套列表项,因为在`第一个列表项`的前面有五个字符 (`100.`) 。 - -```markdown -100. 第一个列表项 - - 第一个嵌套列表项 -``` - -![含一个嵌套列表项的列表](/assets/images/help/writing/nested-list-example-3.png) - -您可以使用相同的方法创建多层级嵌套列表。 例如,由于在第一个嵌套列表项中,嵌套列表项内容`第一个嵌套列表项`之前有七个字符 (`␣␣␣␣␣-␣`),因此需要将第二个嵌套列表项缩进七个空格。 - -```markdown -100. 第一个列表项 - - 第一个嵌套列表项 - - 第二个嵌套列表项 -``` - -![含两级嵌套项的列表](/assets/images/help/writing/nested-list-example-2.png) - -更多示例请参阅 [GitHub Flavored Markdown 规范](https://github.github.com/gfm/#example-265)。 - -## 任务列表 - -{% data reusables.repositories.task-list-markdown %} - -如果任务列表项说明以括号开头,则需要使用 `\` 进行规避: - -`- [ ] \(Optional) 打开后续议题` - -更多信息请参阅“[关于任务列表](/articles/about-task-lists)”。 - -## 提及人员和团队 - -您可以在 {% data variables.product.product_name %} 上提及人员或[团队](/articles/setting-up-teams/),方法是键入 `@` 加上其用户名或团队名称。 这将触发通知并提请他们注意对话。 如果您在编辑的评论中提及某人的用户名或团队名称,该用户也会收到通知。 有关通知的更多信息,请参阅{% ifversion fpt or ghes or ghae or ghec %}"[关于通知](/github/managing-subscriptions-and-notifications-on-github/about-notifications){% else %}“[关于通知](/github/receiving-notifications-about-activity-on-github/about-notifications){% endif %}”。 - -`@github/support 您如何看待这些更新?` - -![渲染的 @提及](/assets/images/help/writing/mention-rendered.png) - -当您提及父团队时,其子团队的成员也会收到通知,这简化了与多个人员团队的沟通。 更多信息请参阅“[关于团队](/articles/about-teams)”。 - -键入 `@` 符号将显示项目中的人员或团队列表。 列表会在您键入时进行过滤,因此一旦找到所需人员或团队的名称,您可以使用箭头键选择它,然后按 Tab 或 Enter 键以填写名称。 提及团队时,请输入 @组织/团队名称,该团队的所有成员将收到关注对话的提醒。 - -自动填写结果仅限于仓库协作者和该线程上的任何其他参与者。 - -## 引用议题和拉取请求 - -通过键入 `#` 可显示仓库中建议的议题和拉取请求列表。 键入议题或拉取请求的编号或标题以过滤列表,然后按 Tab 或 Enter 键以填写选中的结果。 - -更多信息请参阅“[自动链接的引用和 URL](/articles/autolinked-references-and-urls)”。 - -## 引用外部资源 - -{% data reusables.repositories.autolink-references %} - -{% ifversion ghes < 3.4 %} -## 内容附件 - -有些 {% data variables.product.prodname_github_apps %} 在 {% data variables.product.product_name %} 中提供链接到其注册域名的 URL 信息。 {% data variables.product.product_name %} 可渲染应用程序在正文或者议题或拉取请求的评论中的 URL 下提供的信息。 - -![内容附件](/assets/images/github-apps/content_reference_attachment.png) - -要查看内容附件,您必须拥有使用仓库中安装的内容附件 API 的 {% data variables.product.prodname_github_app %}。{% ifversion fpt or ghec %} 更多信息请参阅“[在个人帐户中安装应用程序](/articles/installing-an-app-in-your-personal-account)”和“[在组织中安装应用程序](/articles/installing-an-app-in-your-organization)”。{% endif %} - -内容附件不会显示在属于 markdown 链接的 URL 中。 - -For more information about building a {% data variables.product.prodname_github_app %} that uses content attachments, see "[Using Content Attachments](/apps/using-content-attachments)."{% endif %} - -## 上传资产 - -您可以通过拖放、从文件浏览器中选择或粘贴来上传图像等资产。 您可以将资产上传到议题、拉取请求、评论和仓库中的 `.md` 文件。 - -## 使用表情符号 - -通过键入 `:EMOJICODE:` 可在您的写作中添加表情符号。 - -`@octocat :+1: 这个 PR 看起来很棒 - 可以合并了! :shipit:` - -![渲染的表情符号](/assets/images/help/writing/emoji-rendered.png) - -键入 `:` 将显示建议的表情符号列表。 列表将在您键入时进行过滤,因此一旦找到所需表情符号,请按 **Tab** 或 **Enter** 键以填写选中的结果。 - -有关可用表情符号和代码的完整列表,请查看[表情符号备忘清单](https://github.com/ikatyang/emoji-cheat-sheet/blob/master/README.md)。 - -## 段落 - -通过在文本行之间留一个空白行,可创建新段落。 - -{% ifversion fpt or ghae-issue-5180 or ghes > 3.2 or ghec %} -## 脚注 - -您可以使用此括号语法为您的内容添加脚注: - -``` -Here is a simple footnote[^1]. - -A footnote can also have multiple lines[^2]. - -You can also use words, to fit your writing style more closely[^note]. - -[^1]: My reference. -[^2]: Every new line should be prefixed with 2 spaces. - This allows you to have a footnote with multiple lines. -[^note]: - Named footnotes will still render with numbers instead of the text but allow easier identification and linking. - This footnote also has been made with a different syntax using 4 spaces for new lines. -``` - -脚注将呈现如下: - -![渲染的脚注](/assets/images/site/rendered-footnote.png) - -{% tip %} - -**注意**:Markdown 中脚注的位置不会影响该脚注的呈现位置。 您可以在引用脚注后立即写脚注,脚注仍将呈现在 Markdown 的底部。 - -{% endtip %} -{% endif %} - -## 隐藏有评论的内容 - -您可以通过在 HTML 评论中加入内容来指示 {% data variables.product.product_name %} 隐藏渲染的 Markdown 中的内容。 - -
-<!-- This content will not appear in the rendered Markdown -->
-
- -## 忽略 Markdown 格式 - -通过在 Markdown 字符前面输入 `\`,可告诉 {% data variables.product.product_name %} 忽略(或规避)Markdown 格式。 - -`让我们将 \*our-new-project\* 重命名为 \*our-old-project\*。` - -![渲染的规避字符](/assets/images/help/writing/escaped-character-rendered.png) - -更多信息请参阅 Daring Fireball 的“[Markdown 语法](https://daringfireball.net/projects/markdown/syntax#backslash)”。 - -{% ifversion fpt or ghes > 3.2 or ghae-issue-5232 or ghec %} - -## 禁用 Markdown 渲染 - -{% data reusables.repositories.disabling-markdown-rendering %} - -{% endif %} - -## 延伸阅读 - -- [{% data variables.product.prodname_dotcom %} Flavored Markdown 规格](https://github.github.com/gfm/) -- “[关于 GitHub 上的撰写和格式](/articles/about-writing-and-formatting-on-github)” -- "[使用高级格式](/articles/working-with-advanced-formatting)" -- "[熟悉 Markdown](https://guides.github.com/features/mastering-markdown/)" diff --git a/translations/zh-CN/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/index.md b/translations/zh-CN/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/index.md deleted file mode 100644 index 96fcf4df47..0000000000 --- a/translations/zh-CN/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/index.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: 开始在 GitHub 上编写和格式化 -redirect_from: - - /articles/markdown-basics - - /articles/things-you-can-do-in-a-text-area-on-github - - /articles/getting-started-with-writing-and-formatting-on-github -intro: 您可以在 GitHub 上使用简单的功能格式化您的评论,与他人交流议题、拉取请求和 wiki。 -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -children: - - /about-writing-and-formatting-on-github - - /basic-writing-and-formatting-syntax -shortTitle: 开始在 GitHub 上写入 ---- - diff --git a/translations/zh-CN/content/github/writing-on-github/index.md b/translations/zh-CN/content/github/writing-on-github/index.md deleted file mode 100644 index 5a54388fd3..0000000000 --- a/translations/zh-CN/content/github/writing-on-github/index.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -title: 在 GitHub 上编写 -redirect_from: - - /categories/88/articles - - /articles/github-flavored-markdown - - /articles/writing-on-github - - /categories/writing-on-github -intro: '您可以通过各种格式选项构建 {% data variables.product.product_name %} 共享的信息。' -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -children: - - /getting-started-with-writing-and-formatting-on-github - - /working-with-advanced-formatting - - /working-with-saved-replies - - /editing-and-sharing-content-with-gists ---- - diff --git a/translations/zh-CN/content/github/writing-on-github/working-with-advanced-formatting/attaching-files.md b/translations/zh-CN/content/github/writing-on-github/working-with-advanced-formatting/attaching-files.md deleted file mode 100644 index c47c20d0c5..0000000000 --- a/translations/zh-CN/content/github/writing-on-github/working-with-advanced-formatting/attaching-files.md +++ /dev/null @@ -1,60 +0,0 @@ ---- -title: 附加文件 -intro: 您可以通过将各种文件类型附加到议题和拉取请求来传达信息。 -redirect_from: - - /github/managing-your-work-on-github/managing-your-work-with-issues-and-pull-requests/file-attachments-on-issues-and-pull-requests - - /articles/issue-attachments - - /articles/file-attachments-on-issues-and-pull-requests - - /github/managing-your-work-on-github/file-attachments-on-issues-and-pull-requests -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -topics: - - Pull requests ---- - -{% warning %} - -**Warning:** If you add an image{% ifversion fpt or ghes > 3.1 or ghae or ghec %} or video{% endif %} to a pull request or issue comment, anyone can view the anonymized URL without authentication, even if the pull request is in a private repository{% ifversion ghes %}, or if private mode is enabled{% endif %}. 要对敏感媒体文件保密,请从需要身份验证的私有网络或服务器提供它们。 {% ifversion fpt or ghec %}有关匿名 URL 的更多信息,请参阅“[关于匿名 URL](/github/authenticating-to-github/about-anonymized-urls)”。{% endif %} - -{% endwarning %} - -要将文件附加到议题或拉取请求对话,请将它拖放到评论框中。 或者,您也可以单击评论框底部的栏来浏览、选择和添加计算机中的文件。 - -![从计算机选择附件](/assets/images/help/pull_requests/select-bar.png) - -{% tip %} - -**提示:**在许多浏览器中,您可以将图像直接复制并粘贴到该框中。 - -{% endtip %} - -最大文件大小为: -- 10MB for images and gifs{% ifversion fpt or ghec %} -- 10MB,对于上传到使用免费 GitHub 计划的用户或组织所拥有仓库的视频 -- 100MB,对于上传到使用付费 GitHub 计划的用户或组织所拥有仓库的视频{% elsif fpt or ghes > 3.1 or ghae %} -- 100MB for videos{% endif %} -- 25MB,对于所有其他文件 - -我们支持这些文件: - -* PNG (*.png*) -* GIF (*.gif*) -* JPEG (*.jpg*) -* 日志文件 (*.log*) -* Microsoft Word (*.docx*)、Powerpoint (*.pptx*) 和 Excel (*.xlsx*) 文档 -* 文本文件 (*.txt*) -* PDF (*.pdf*) -* ZIP(*.zip*、*.gz*){% ifversion fpt or ghes > 3.1 or ghae or ghec %} -* 视频(*.mp4*、*.mov*) - -{% note %} - -**注意:** 视频编解码器兼容性是浏览器特定的,上传到一个浏览器的视频可能无法在另一个浏览器上查看。 目前,我们建议使用 h.264 实现最大兼容性。 - -{% endnote %} -{% endif %} - -![附件动画 GIF](/assets/images/help/pull_requests/dragging_images.gif) diff --git a/translations/zh-CN/content/github/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md b/translations/zh-CN/content/github/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md deleted file mode 100644 index f34587cd22..0000000000 --- a/translations/zh-CN/content/github/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md +++ /dev/null @@ -1,64 +0,0 @@ ---- -title: 自动链接的引用和 URL -intro: 对 URL、议题、拉取请求和提交的引用会自动缩短并转换为链接。 -redirect_from: - - /articles/autolinked-references-and-urls - - /github/writing-on-github/autolinked-references-and-urls -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -shortTitle: 自动链接的引用 ---- - -## URL - -{% data variables.product.product_name %} 自动从标准 URL 创建链接。 - -`访问 https://github.com` - -![显示的自动链接的 URL](/assets/images/help/writing/url-autolink-rendered.png) - -有关创建链接的更多信息,请参阅“[基本撰写和格式语法](/articles/basic-writing-and-formatting-syntax/#links)”。 - -## 议题和拉取请求 - -在 {% data variables.product.product_name %} 上的对话中,对议题和拉取请求的引用将自动转换为缩短的链接。 - -{% note %} - -**注:**在仓库的 wiki 或文件中无法创建自动链接的引用。 - -{% endnote %} - -| 引用类型 | 源引用 | 短链接 | -| ------------------------------------------ | ---------------------------------------------- | ---------------------------------------------------------------------- | -| 议题或拉取请求 URL | https://github.com/jlord/sheetsee.js/issues/26 | [#26](https://github.com/jlord/sheetsee.js/issues/26) | -| `#` 和议题或拉取请求编号 | #26 | [#26](https://github.com/jlord/sheetsee.js/issues/26) | -| `GH-` 和议题或拉取请求编号 | GH-26 | [GH-26](https://github.com/jlord/sheetsee.js/issues/26) | -| `Username/Repository#` 和议题或拉取请求编号 | jlord/sheetsee.js#26 | [jlord/sheetsee.js#26](https://github.com/jlord/sheetsee.js/issues/26) | -| `Organization_name/Repository#` 和议题或拉取请求编号 | github/linguist#4039 | [github/linguist#4039](https://github.com/github/linguist/pull/4039) | - -{% ifversion fpt or ghec %} -如果您在列表中引用议题、拉取请求或讨论,则引用将展开以显示标题和状态。 有关任务列表的更多信息,请参阅“[关于任务列表](/issues/tracking-your-work-with-issues/creating-issues/about-task-lists)”。 -{% endif %} - -## 提交 SHA - -对提交 SHA 哈希的引用会自动转换为指向 {% data variables.product.product_name %} 上提交的短链接。 - -| 引用类型 | 源引用 | 短链接 | -| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------- | -| 提交 URL | [`https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e`](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | [a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | -| SHA | a5c3785ed8d6a35868bc169f07e40e889087fd2e | [a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | -| User@SHA | jlord@a5c3785ed8d6a35868bc169f07e40e889087fd2e | [jlord@a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | -| `Username/Repository@SHA` | `jlord/sheetsee.js@a5c3785ed8d6a35868bc169f07e40e889087fd2e` | [`jlord/sheetsee.js@a5c3785`](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | - -## 自定义外部资源的自动链接 - -{% data reusables.repositories.autolink-references %} - -## 延伸阅读 - -- "[基本撰写和格式语法](/articles/basic-writing-and-formatting-syntax)" diff --git a/translations/zh-CN/content/github/writing-on-github/working-with-advanced-formatting/creating-a-permanent-link-to-a-code-snippet.md b/translations/zh-CN/content/github/writing-on-github/working-with-advanced-formatting/creating-a-permanent-link-to-a-code-snippet.md deleted file mode 100644 index accb54395f..0000000000 --- a/translations/zh-CN/content/github/writing-on-github/working-with-advanced-formatting/creating-a-permanent-link-to-a-code-snippet.md +++ /dev/null @@ -1,49 +0,0 @@ ---- -title: 创建指向代码段的永久链接 -intro: 您可以创建指向特定版本的文件或拉取请求中特定代码行或行范围的永久链接。 -redirect_from: - - /github/managing-your-work-on-github/managing-your-work-with-issues-and-pull-requests/creating-a-permanent-link-to-a-code-snippet - - /articles/creating-a-permanent-link-to-a-code-snippet - - /github/managing-your-work-on-github/creating-a-permanent-link-to-a-code-snippet -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -topics: - - Pull requests -shortTitle: 代码的永久链接 ---- - -## 链接到代码 - -此类永久链接仅在其起源仓库中呈现为代码段。 在其他仓库中,永久链接代码段将呈现为 URL。 - -![评论中呈现的代码段](/assets/images/help/repository/rendered-code-snippet.png) - -{% tip %} - -**提示:**要创建整个文件的永久链接,请参阅“[获取文件的永久链接](/articles/getting-permanent-links-to-files)”。 - -{% endtip %} - -{% data reusables.repositories.navigate-to-repo %} -2. 找到要链接的代码: - - 要链接到文件中的代码,请导航到该文件。 - - 要链接到拉取请求中的代码,请导航到该拉取请求并单击 {% octicon "diff" aria-label="The file diff icon" %} **Files changed(已更改文件)**。 然后浏览到含有要包含在评论中的代码的文件,并单击 **View(查看)**。 -{% data reusables.repositories.choose-line-or-range %} -4. 在代码行或行范围的左侧,单击 {% octicon "kebab-horizontal" aria-label="The horizontal kebab octicon" %}。 在下拉菜单中,单击 **Copy permalink(复制永久链接)**。 ![可选择复制所选行的永久链接的 Kebab 菜单](/assets/images/help/repository/copy-permalink-specific-line.png) -5. 导航到要链接到代码段的对话。 -6. 将永久链接粘贴到评论中,然后单击 **Comment(评论)**。 ![粘贴在同一个仓库的评论中的永久链接](/assets/images/help/repository/code-snippet-permalink-in-comment.png) - -## 链接到 Markdown - -您可以通过加载 Markdown 文件而不进行 Markdown 渲染来链接到 Markdown 文件中的特定行。 要在不渲染的情况下加载 Markdown 文件,您可以在文件的 url 末尾使用 `?plain=1` 参数。 例如 `github.com///blob//README.md?plain=1`。 - -您可以在代码中以同样的方式链接到 Markdown 文件中的特定行。 在 url 末尾的行号附加 `#L`。 例如,`github.com///blob//README.md?plain=1#L14` 将在纯文本文件 README.md 中突出显示第 14 行。 - -## 延伸阅读 - -- “[创建议题](/articles/creating-an-issue/)” -- “[从代码打开议题](/articles/opening-an-issue-from-code/)” -- “[审查拉取请求中的更改](/articles/reviewing-changes-in-pull-requests/)” diff --git a/translations/zh-CN/content/github/writing-on-github/working-with-advanced-formatting/creating-and-highlighting-code-blocks.md b/translations/zh-CN/content/github/writing-on-github/working-with-advanced-formatting/creating-and-highlighting-code-blocks.md deleted file mode 100644 index 2c84b98158..0000000000 --- a/translations/zh-CN/content/github/writing-on-github/working-with-advanced-formatting/creating-and-highlighting-code-blocks.md +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: 创建和突显代码块 -intro: 通过围栏代码块和启用语法突显来分享代码样本 -redirect_from: - - /articles/creating-and-highlighting-code-blocks - - /github/writing-on-github/creating-and-highlighting-code-blocks -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -shortTitle: 创建代码块 ---- - -## 围栏代码块 - -通过在代码块的前后输入三反引号 \`\`\`,可创建围栏代码块。 我们建议在代码块的前后各留一个空白行,使原始格式更易辨读。 - -
-```
-function test() {
-  console.log("notice the blank line before this function?");
-}
-```
-
- -![渲染的围栏代码块](/assets/images/help/writing/fenced-code-block-rendered.png) - -{% tip %} - -**提示:**要在列表中保留格式,请确保将非围栏代码块缩进八个空格。 - -{% endtip %} - -要在围栏代码块中显示三重倒引号,请将其包在四个倒引号内。 - - -
-```` 
-```
-Look! You can see my backticks.
-```
-````
-
- -![使用倒引号块呈现的围栏代码](/assets/images/help/writing/fenced-code-show-backticks-rendered.png) - -{% data reusables.user_settings.enabling-fixed-width-fonts %} - -## 语法突显 - - - -您可以添加可选的语言标识符,以在围栏代码块中启用语法突显。 - -例如,要语法突显 Ruby 代码: - - ```ruby - require 'redcarpet' - markdown = Redcarpet.new("Hello World!") - puts markdown.to_html - puts markdown.to_html - ``` - -![渲染的启用 Ruby 语法突显的代码块](/assets/images/help/writing/code-block-syntax-highlighting-rendered.png) - -我们使用 [Linguist](https://github.com/github/linguist) 来执行语言检测并选择[第三方语法](https://github.com/github/linguist/blob/master/vendor/README.md)进行语法突显。 您可以在[语言 YAML 文件](https://github.com/github/linguist/blob/master/lib/linguist/languages.yml)中找出哪些关键词有效。 - -## 延伸阅读 - -- [{% data variables.product.prodname_dotcom %} Flavored Markdown 规格](https://github.github.com/gfm/) -- "[基本撰写和格式语法](/articles/basic-writing-and-formatting-syntax)" diff --git a/translations/zh-CN/content/github/writing-on-github/working-with-advanced-formatting/index.md b/translations/zh-CN/content/github/writing-on-github/working-with-advanced-formatting/index.md deleted file mode 100644 index c8bc3b3f5d..0000000000 --- a/translations/zh-CN/content/github/writing-on-github/working-with-advanced-formatting/index.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: 使用高级格式 -intro: 表格、语法突出显示和自动链接等格式设置可让您在拉取请求、议题和评论中清楚地布置复杂的信息。 -redirect_from: - - /articles/working-with-advanced-formatting -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -children: - - /organizing-information-with-tables - - /organizing-information-with-collapsed-sections - - /creating-and-highlighting-code-blocks - - /autolinked-references-and-urls - - /attaching-files - - /creating-a-permanent-link-to-a-code-snippet - - /using-keywords-in-issues-and-pull-requests -shortTitle: 使用高级格式 ---- - diff --git a/translations/zh-CN/content/github/writing-on-github/working-with-advanced-formatting/organizing-information-with-collapsed-sections.md b/translations/zh-CN/content/github/writing-on-github/working-with-advanced-formatting/organizing-information-with-collapsed-sections.md deleted file mode 100644 index 1ac11b43d3..0000000000 --- a/translations/zh-CN/content/github/writing-on-github/working-with-advanced-formatting/organizing-information-with-collapsed-sections.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Organizing information with collapsed sections -intro: You can streamline your Markdown by creating a collapsed section with the `
` tag. -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -shortTitle: Collapsed sections ---- - -## Creating a collapsed section - -You can temporarily obscure sections of your Markdown by creating a collapsed section that the reader can choose to expand. For example, when you want to include technical details in an issue comment that may not be relevant or interesting to every reader, you can put those details in a collapsed section. - -Any Markdown within the `
` block will be collapsed until the reader clicks {% octicon "triangle-right" aria-label="The right triange icon" %} to expand the details. Within the `
` block, use the `` tag to create a label to the right of {% octicon "triangle-right" aria-label="The right triange icon" %}. - -```markdown -
CLICK ME -

- -#### We can hide anything, even code! - - ```ruby - puts "Hello World" - ``` - -

```

- -The Markdown will be collapsed by default. - -![Rendered collapsed](/assets/images/help/writing/collapsed-section-view.png) - -After a reader clicks {% octicon "triangle-right" aria-label="The right triange icon" %}, the details are expanded. - -![Rendered open](/assets/images/help/writing/open-collapsed-section.png) - -## 延伸阅读 - -- [{% data variables.product.prodname_dotcom %} Flavored Markdown 规格](https://github.github.com/gfm/) -- "[基本撰写和格式语法](/articles/basic-writing-and-formatting-syntax)" diff --git a/translations/zh-CN/content/github/writing-on-github/working-with-advanced-formatting/organizing-information-with-tables.md b/translations/zh-CN/content/github/writing-on-github/working-with-advanced-formatting/organizing-information-with-tables.md deleted file mode 100644 index 0235a11b08..0000000000 --- a/translations/zh-CN/content/github/writing-on-github/working-with-advanced-formatting/organizing-information-with-tables.md +++ /dev/null @@ -1,82 +0,0 @@ ---- -title: 使用表格组织信息 -intro: 您可以创建表格来组织评论、议题、拉取请求和 wiki 中的信息。 -redirect_from: - - /articles/organizing-information-with-tables - - /github/writing-on-github/organizing-information-with-tables -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -shortTitle: 使用表格组织的数据 ---- - -## 创建表格 - -您可以用竖线 `|` 和横线 `-` 创建表格。 横线用于创建每列的标题,而竖线用于分隔每列。 必须在表格前包含空白链接,以便其正确呈现。 - -```markdown - -| First Header | Second Header | -| ------------- | ------------- | -| Content Cell | Content Cell | -| Content Cell | Content Cell | -``` - -![呈现的表格](/assets/images/help/writing/table-basic-rendered.png) - -表格末尾的竖线可选。 - -单元格的宽度可以不同,无需在列内准确对齐。 标题行的第一列中必须至少有三个横线。 - -```markdown -| Command | Description | -| --- | --- | -| git status | List all new or modified files | -| git diff | Show file differences that haven't been staged | -``` - -![呈现的单元格宽度不同的表格](/assets/images/help/writing/table-varied-columns-rendered.png) - -{% data reusables.user_settings.enabling-fixed-width-fonts %} - -## 格式化表格中的内容 - -您可以在表格中使用[格式](/articles/basic-writing-and-formatting-syntax),如链接、内联代码块和文本样式: - -```markdown -| Command | Description | -| --- | --- | -| `git status` | List all *new or modified* files | -| `git diff` | Show file differences that **haven't been** staged | -``` - -![呈现的带格式化文本的表格](/assets/images/help/writing/table-inline-formatting-rendered.png) - -您可以在标头行中横线的左侧、右侧或两侧加入冒号 `:`,靠左、靠右或居中对齐列中的文本。 - -```markdown -| Left-aligned | Center-aligned | Right-aligned | -| :--- | :---: | ---: | -| git status | git status | git status | -| git diff | git diff | git diff | -``` - -![呈现的文本靠左、居中和靠右对齐的表格](/assets/images/help/writing/table-aligned-text-rendered.png) - -要包含竖线 `|` 作为单元格中的内容,请在竖线前使用 `\`: - -```markdown -| Name | Character | -| --- | --- | -| Backtick | ` | -| Pipe | \| | -``` - -![呈现的带逸出竖线字符的表格](/assets/images/help/writing/table-escaped-character-rendered.png) - -## 延伸阅读 - -- [{% data variables.product.prodname_dotcom %} Flavored Markdown 规格](https://github.github.com/gfm/) -- "[基本撰写和格式语法](/articles/basic-writing-and-formatting-syntax)" diff --git a/translations/zh-CN/content/github/writing-on-github/working-with-advanced-formatting/using-keywords-in-issues-and-pull-requests.md b/translations/zh-CN/content/github/writing-on-github/working-with-advanced-formatting/using-keywords-in-issues-and-pull-requests.md deleted file mode 100644 index 4327469eb3..0000000000 --- a/translations/zh-CN/content/github/writing-on-github/working-with-advanced-formatting/using-keywords-in-issues-and-pull-requests.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: 在议题和拉取请求中使用关键字 -intro: 使用关键字链接议题和拉取请求,或将议题或拉取请求标记为重复。 -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -topics: - - Issues - - Pull requests ---- - -## 将拉取请求链接到议题 - -要将拉取请求链接到议题以{% ifversion fpt or ghes or ghae or ghec %} 显示正在进行的修复,并且{% endif %} 当有人合并拉取请求时自动关闭议题,请键入以下关键字之一,然后引用议题。 例如 `Closes #10` 或 `Fixes octo-org/octo-repo#100`。 - -* close -* closes -* closed -* fix -* fixes -* fixed -* 解决 -* resolves -* resolved - -更多信息请参阅“[将拉取请求链接到议题](/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue)”。 - -## 将议题或拉取请求标记为重复 - -要将议题或拉取请求标记为重复,请在新评论正文中输入 "Duplicate of",后接它复制的议题或拉取请求编号。 更多信息请参阅“[将议题或拉取请求标记为重复](/issues/tracking-your-work-with-issues/marking-issues-or-pull-requests-as-a-duplicate)”。 diff --git a/translations/zh-CN/content/github/writing-on-github/working-with-saved-replies/about-saved-replies.md b/translations/zh-CN/content/github/writing-on-github/working-with-saved-replies/about-saved-replies.md deleted file mode 100644 index fde14f46a4..0000000000 --- a/translations/zh-CN/content/github/writing-on-github/working-with-saved-replies/about-saved-replies.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: 关于已保存回复 -intro: 您可以使用已保存回复来响应议题或拉取请求。 -redirect_from: - - /articles/about-saved-replies - - /github/writing-on-github/about-saved-replies -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' ---- - -![已保存回复](/assets/images/help/settings/saved-replies.png) - -已保存回复用于创建可重复使用的议题和拉取请求响应。 创建回复作为常用响应可节省时间。 - -已保存回复在添加后,可用于议题和拉取请求。 已保存回复与您的用户帐户关联。 在它们创建后,便可用于不同的仓库和组织。 - -最多可以创建 100 个已保存回复。 如果已达到最大限制,可以删除不再使用的已保存回复,或者编辑现有的已保存回复。 - -您也可以使用 {% data variables.product.product_name %} 提供“重复议题”已保存回复来将议题标记为重复,并用类似的议题跟踪它。 - -## 延伸阅读 - -- "[创建已保存回复](/articles/creating-a-saved-reply)" -- "[使用已保存回复](/articles/using-saved-replies)" -- "[编辑已保存回复](/articles/editing-a-saved-reply)" -- "[删除已保存回复](/articles/deleting-a-saved-reply)" diff --git a/translations/zh-CN/content/github/writing-on-github/working-with-saved-replies/creating-a-saved-reply.md b/translations/zh-CN/content/github/writing-on-github/working-with-saved-replies/creating-a-saved-reply.md deleted file mode 100644 index d5a36e97dc..0000000000 --- a/translations/zh-CN/content/github/writing-on-github/working-with-saved-replies/creating-a-saved-reply.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: 创建已保存回复 -intro: 如果您经常反复添加相同的评论,您可以创建已保存回复。 -redirect_from: - - /articles/creating-a-saved-reply - - /github/writing-on-github/creating-a-saved-reply -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' ---- - -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.saved_replies %} -3. 在“Add a saved reply(添加已保存回复)”下,添加已保存回复的标题。 ![已保存回复标题](/assets/images/help/settings/saved-replies-title.png) -4. 在“Write(撰写 )”字段中,添加要用于已保存回复的内容。 有关在 {% data variables.product.product_name %} 上撰写的更多信息,请参阅“[基本撰写和格式语法](/articles/basic-writing-and-formatting-syntax)”。 ![撰写已保存回复](/assets/images/help/settings/saved-replies-settings-adding.png) -5. 要查看回复,请单击 **Preview(预览)**。 ![添加已保存回复](/assets/images/help/settings/saved-replies-preview.png) -6. 单击 **Add saved reply(添加已保存回复)**。 !["添加已保存回复"按钮](/assets/images/help/settings/saved-replies-add-button.png) - -## 延伸阅读 - -- "[使用已保存回复](/articles/using-saved-replies)" -- "[编辑已保存回复](/articles/editing-a-saved-reply)" -- "[删除已保存回复](/articles/deleting-a-saved-reply)" diff --git a/translations/zh-CN/content/github/writing-on-github/working-with-saved-replies/deleting-a-saved-reply.md b/translations/zh-CN/content/github/writing-on-github/working-with-saved-replies/deleting-a-saved-reply.md deleted file mode 100644 index 5ff29c2160..0000000000 --- a/translations/zh-CN/content/github/writing-on-github/working-with-saved-replies/deleting-a-saved-reply.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: 删除已保存回复 -intro: 如果发现不再使用某个已保存回复,可将其删除。 -redirect_from: - - /articles/deleting-a-saved-reply - - /github/writing-on-github/deleting-a-saved-reply -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' ---- - -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.saved_replies %} -3. 在“已保存回复”下,靠近要删除的已保存回复的位置,单击 {% octicon "x" aria-label="The X" %}。 - ![删除已保存回复](/assets/images/help/settings/saved-replies-delete-existing.png) diff --git a/translations/zh-CN/content/github/writing-on-github/working-with-saved-replies/editing-a-saved-reply.md b/translations/zh-CN/content/github/writing-on-github/working-with-saved-replies/editing-a-saved-reply.md deleted file mode 100644 index 3de2d823e1..0000000000 --- a/translations/zh-CN/content/github/writing-on-github/working-with-saved-replies/editing-a-saved-reply.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: 编辑已保存回复 -intro: 您可以编辑已保存回复的标题和正文。 -redirect_from: - - /articles/changing-a-saved-reply - - /articles/editing-a-saved-reply - - /github/writing-on-github/editing-a-saved-reply -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' ---- - -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.saved_replies %} -3. 使用位于要编辑已保存回复旁边的“Saved replies”(已保存回复),单击 {% octicon "pencil" aria-label="The pencil" %}。 - ![编辑已保存回复](/assets/images/help/settings/saved-replies-edit-existing.png) -4. 在“ Edit saved reply”(已保存回复)下,您可以编辑已保存回复的标题和内容。 ![编辑标题和内容](/assets/images/help/settings/saved-replies-edit-existing-content.png) -5. 单击 **Update saved reply(更新已保存回复)**。 ![更新已保存回复](/assets/images/help/settings/saved-replies-save-edit.png) - -## 延伸阅读 - -- "[创建已保存回复](/articles/creating-a-saved-reply)" -- "[删除已保存回复](/articles/deleting-a-saved-reply)" -- "[使用已保存回复](/articles/using-saved-replies)" diff --git a/translations/zh-CN/content/github/writing-on-github/working-with-saved-replies/index.md b/translations/zh-CN/content/github/writing-on-github/working-with-saved-replies/index.md deleted file mode 100644 index a9d2f098f9..0000000000 --- a/translations/zh-CN/content/github/writing-on-github/working-with-saved-replies/index.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: 使用已保存回复 -intro: 为节省时间并确保提供一致的消息,您可将已保存回复添加到议题和拉取请求评论。 -redirect_from: - - /articles/working-with-saved-replies -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -children: - - /about-saved-replies - - /creating-a-saved-reply - - /editing-a-saved-reply - - /deleting-a-saved-reply - - /using-saved-replies -shortTitle: 处理已保存回复 ---- - diff --git a/translations/zh-CN/content/github/writing-on-github/working-with-saved-replies/using-saved-replies.md b/translations/zh-CN/content/github/writing-on-github/working-with-saved-replies/using-saved-replies.md deleted file mode 100644 index f447bd76f7..0000000000 --- a/translations/zh-CN/content/github/writing-on-github/working-with-saved-replies/using-saved-replies.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: 使用已保存回复 -intro: 对议题或拉取请求进行评论时,可添加您已设置的已保存回复。 已保存回复可以是整个评论;或者如果您想要自定义,可以添加或删除内容。 -redirect_from: - - /articles/using-saved-replies - - /github/writing-on-github/using-saved-replies -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' ---- - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-issue-pr %} -2. 单击所需的议题或拉取请求。 -3. 要添加已保存回复,在评论字段中,单击 {% octicon "reply" aria-label="The mail reply" %}。 ![已保存回复按钮](/assets/images/help/writing/saved-replies-button.png) -4. 从列表中,选择您想要添加到评论的已保存回复。 ![已保存回复](/assets/images/help/settings/saved-replies.png) - -{% tip %} - -**提示:** -- 您可以使用键盘快捷键通过已保存回复自动填充评论。 更多信息请参阅“[键盘快捷键](/articles/keyboard-shortcuts/#comments)”。 -- 您可通过输入已保存回复的标题来过滤该列表。 - -{% endtip %} - -## 延伸阅读 - -- "[创建已保存回复](/articles/creating-a-saved-reply)" -- "[编辑已保存回复](/articles/editing-a-saved-reply)" -- "[删除已保存回复](/articles/deleting-a-saved-reply)"