chore: prune stale translation files
This commit is contained in:
Jules Parker
@@ -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í.
|
||||
|
||||
|
||||
|
||||
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)"
|
||||
@@ -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 %}. 
|
||||
{% 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. 
|
||||
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 <em> <REMOTE_URL> </em>
|
||||
# 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 %}. 
|
||||
{% 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. 
|
||||
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 <em> <REMOTE_URL> </em>
|
||||
# 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 %}. 
|
||||
{% 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. 
|
||||
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 <em> <REMOTE_URL> </em>
|
||||
# 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)"
|
||||
@@ -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/<em>extuser</em>/<em>repo.git</em>
|
||||
# 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 <em>repo.git</em>
|
||||
$ git push --mirror https://{% data variables.command_line.codeblock %}/<em>ghuser</em>/<em>repo.git</em>
|
||||
# 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 <em>repo.git</em>
|
||||
```
|
||||
@@ -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). 
|
||||
2. En "La URL del clon de tu repositorio antiguo", escribe la URL del proyecto que quieres importar. 
|
||||
3. Elige tu cuenta de usuario o una organización como propietaria del repositorio, luego escribe un nombre para el repositorio en GitHub. 
|
||||
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)". 
|
||||
5. Revisa la información que ingresaste, luego haz clic en **Begin import** (Comenzar importación). 
|
||||
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). 
|
||||
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). 
|
||||
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). 
|
||||
|
||||
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)"
|
||||
@@ -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
|
||||
---
|
||||
|
||||
@@ -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 %}
|
||||
@@ -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). 
|
||||
2. Al lado del autor cuya información quieres actualizar, haz clic en **Connect** (Conectar). 
|
||||
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 `<username>@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)"
|
||||
@@ -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
|
||||
---
|
||||
|
||||
@@ -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
|
||||
---
|
||||
|
||||
@@ -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.
|
||||
@@ -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/<em>user</em>/<em>repo</em>
|
||||
> Checked out revision 1.
|
||||
$ cd <em>repo</em>
|
||||
```
|
||||
|
||||
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:
|
||||
|
||||
|
||||
|
||||
También puedes confirmar la nueva rama por medio de la línea de comando:
|
||||
|
||||
```shell
|
||||
$ git fetch
|
||||
> From https://github.com/<em>user</em>/<em>repo</em>/
|
||||
> * [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/<em>user</em>/<em>repo</em>/trunk
|
||||
```
|
||||
|
||||
Luego, puedes alternar a otra rama:
|
||||
|
||||
```shell
|
||||
$ svn switch https://github.com/<em>user</em>/<em>repo</em>/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/<em>user</em>/<em>repo</em>
|
||||
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)"
|
||||
@@ -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)"
|
||||
@@ -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.
|
||||
@@ -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
|
||||
---
|
||||
|
||||
@@ -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 %} {% elsif ghec %}
|
||||
{% 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)"
|
||||
@@ -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**. 
|
||||
|
||||
## Leer más
|
||||
- [{% data variables.product.prodname_archive %} Preguntas Frecuentes](https://archiveprogram.github.com/faq/)
|
||||
@@ -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).  
|
||||
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). 
|
||||
@@ -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. 
|
||||
|
||||
4. Teclea el texto de tu gist en la caja de texto de este. 
|
||||
|
||||
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 %}**. 
|
||||
@@ -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.
|
||||
|
||||
|
||||
|
||||
## 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)".
|
||||
|
||||
|
||||
|
||||
## 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.
|
||||
|
||||
|
||||
|
||||
Verás el historial completo de confirmaciones del gist con sus diferencias.
|
||||
|
||||
|
||||
@@ -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
|
||||
---
|
||||
|
||||
@@ -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.
|
||||
|
||||
|
||||
|
||||
{% 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**. 
|
||||
|
||||
{% 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/)"
|
||||
@@ -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
|
||||
```
|
||||
|
||||
|
||||
|
||||
## 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
|
||||
```
|
||||
|
||||
|
||||
|
||||
{% 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.
|
||||
```
|
||||
|
||||
|
||||
|
||||
To format code or text into its own distinct block, use triple backticks.
|
||||
|
||||
<pre>
|
||||
Some basic Git commands are:
|
||||
```
|
||||
git status
|
||||
git add
|
||||
git commit
|
||||
```
|
||||
</pre>
|
||||
|
||||
|
||||
|
||||
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/).`
|
||||
|
||||
|
||||
|
||||
{% 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 `()`.
|
||||
|
||||
``
|
||||
|
||||
|
||||
|
||||
{% 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 | `` |
|
||||
| Light Theme | `` |
|
||||
{% 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
|
||||
```
|
||||
|
||||
|
||||
|
||||
To order your list, precede each line with a number.
|
||||
|
||||
```markdown
|
||||
1. James Madison
|
||||
2. James Monroe
|
||||
3. John Quincy Adams
|
||||
```
|
||||
|
||||
|
||||
|
||||
### 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
|
||||
```
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
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
|
||||
```
|
||||
|
||||
|
||||
|
||||
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
|
||||
```
|
||||
|
||||
|
||||
|
||||
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?`
|
||||
|
||||
|
||||
|
||||
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.
|
||||
|
||||
|
||||
|
||||
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:`
|
||||
|
||||
|
||||
|
||||
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:
|
||||
|
||||
|
||||
|
||||
{% 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.
|
||||
|
||||
<pre>
|
||||
<!-- This content will not appear in the rendered Markdown -->
|
||||
</pre>
|
||||
|
||||
## 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\*.`
|
||||
|
||||
|
||||
|
||||
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/)"
|
||||
@@ -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
|
||||
---
|
||||
|
||||
@@ -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
|
||||
---
|
||||
|
||||
@@ -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.
|
||||
|
||||
|
||||
|
||||
{% 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 %}
|
||||
|
||||
|
||||
@@ -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`
|
||||
|
||||
|
||||
|
||||
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)"
|
||||
@@ -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.
|
||||
|
||||
|
||||
|
||||
{% 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**. 
|
||||
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**. 
|
||||
|
||||
## 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/<organization>/<repository>/blob/<branch_name>/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/<organization>/<repository>/blob/<branch_name>/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/)"
|
||||
@@ -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 <code>\`\`\`</code> 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.
|
||||
|
||||
<pre>
|
||||
```
|
||||
function test() {
|
||||
console.log("notice the blank line before this function?");
|
||||
}
|
||||
```
|
||||
</pre>
|
||||
|
||||
|
||||
|
||||
{% 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.
|
||||
|
||||
|
||||
<pre>
|
||||
````
|
||||
```
|
||||
Look! Puedes ver mis comillas inversas.
|
||||
```
|
||||
````
|
||||
</pre>
|
||||
|
||||
|
||||
|
||||
{% data reusables.user_settings.enabling-fixed-width-fonts %}
|
||||
|
||||
## Resaltado de la sintaxis
|
||||
|
||||
<!-- If you make changes to this feature, update /getting-started-with-github/github-language-support to reflect any changes to supported languages. -->
|
||||
|
||||
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
|
||||
```
|
||||
|
||||
|
||||
|
||||
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)"
|
||||
@@ -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
|
||||
---
|
||||
|
||||
@@ -1,41 +0,0 @@
|
||||
---
|
||||
title: Organizing information with collapsed sections
|
||||
intro: You can streamline your Markdown by creating a collapsed section with the `<details>` 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 `<details>` block will be collapsed until the reader clicks {% octicon "triangle-right" aria-label="The right triange icon" %} to expand the details. Within the `<details>` block, use the `<summary>` tag to create a label to the right of {% octicon "triangle-right" aria-label="The right triange icon" %}.
|
||||
|
||||
```markdown
|
||||
<details><summary>CLICK ME</summary>
|
||||
<p>
|
||||
|
||||
#### We can hide anything, even code!
|
||||
|
||||
```ruby
|
||||
puts "Hello World"
|
||||
```
|
||||
|
||||
</details> ```</p>
|
||||
|
||||
The Markdown will be collapsed by default.
|
||||
|
||||
|
||||
|
||||
After a reader clicks {% octicon "triangle-right" aria-label="The right triange icon" %}, the details are expanded.
|
||||
|
||||
|
||||
|
||||
## 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)"
|
||||
@@ -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 |
|
||||
```
|
||||
|
||||
|
||||
|
||||
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 |
|
||||
```
|
||||
|
||||
|
||||
|
||||
{% 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 |
|
||||
```
|
||||
|
||||
|
||||
|
||||
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 |
|
||||
```
|
||||
|
||||
|
||||
|
||||
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 | \| |
|
||||
```
|
||||
|
||||
|
||||
|
||||
## 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)"
|
||||
@@ -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)".
|
||||
@@ -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: '*'
|
||||
---
|
||||
|
||||
|
||||
|
||||
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)"
|
||||
@@ -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. 
|
||||
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)". 
|
||||
5. Para revisar tu respuesta, haz clic en **Vista previa**. 
|
||||
6. Haz clic en **Agregar respuesta guardada**. 
|
||||
|
||||
## 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)"
|
||||
@@ -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" %}.
|
||||
|
||||
@@ -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" %}.
|
||||
|
||||
4. En "Editar una respuesta guardada", puedes editar el título y el contenido de la respuesta guardada. 
|
||||
5. Haz clic en **Actualizar una respuesta guardada**. 
|
||||
|
||||
## 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)"
|
||||
@@ -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
|
||||
---
|
||||
|
||||
@@ -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" %}. 
|
||||
4. Desde la lista, selecciona la respuesta guardada que quieres agregar en el comentario. 
|
||||
|
||||
{% 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)"
|
||||
@@ -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は、コミットやリビジョン履歴を含めてソースコードリポジトリを素早くインポートしてくれます。
|
||||
|
||||
|
||||
|
||||
インポートの間、インポート元のバージョン管理システムによって、リモートリポジトリでの認証、コミット作者の属性の更新、大きなファイルを持つリポジトリのインポート（あるいは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)
|
||||
@@ -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. 
|
||||
8. ターミナルで、ローカルリポジトリがプッシュされる[リモートリポジトリの URL を追加](/github/getting-started-with-github/managing-remote-repositories)してください。
|
||||
```shell
|
||||
$ git remote add origin <em> <REMOTE_URL> </em>
|
||||
# 新しいリモートを設定する
|
||||
$ 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. 
|
||||
8. コマンドプロンプトで、ローカルリポジトリのプッシュ先となる[リモートリポジトリの URL を追加](/github/getting-started-with-github/managing-remote-repositories)します。
|
||||
```shell
|
||||
$ git remote add origin <em> <REMOTE_URL> </em>
|
||||
# 新しいリモートを設定する
|
||||
$ 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. 
|
||||
8. ターミナルで、ローカルリポジトリがプッシュされる[リモートリポジトリの URL を追加](/github/getting-started-with-github/managing-remote-repositories)してください。
|
||||
```shell
|
||||
$ git remote add origin <em> <REMOTE_URL> </em>
|
||||
# 新しいリモートを設定する
|
||||
$ 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)
|
||||
@@ -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/<em>extuser</em>/<em>repo.git</em>
|
||||
# ローカル リポジトリに、外部リポジトリのベア クローンを作成
|
||||
```
|
||||
3. "mirror" オプションを使用して、ローカルにクローンされたリポジトリを {% data variables.product.product_name %} にプッシュします。インポートされたリポジトリには、ブランチやタグなどすべての参照がコピーされます。
|
||||
```shell
|
||||
$ cd <em>repo.git</em>
|
||||
$ git push --mirror https://{% data variables.command_line.codeblock %}/<em>ghuser</em>/<em>repo.git</em>
|
||||
# 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 <em>repo.git</em>
|
||||
```
|
||||
@@ -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 を入力します。 
|
||||
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)
|
||||
@@ -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
|
||||
---
|
||||
|
||||
@@ -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 %}
|
||||
@@ -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**] をクリックします。 
|
||||
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 アカウントを、コミットに関連付けられているメールアドレスにマッチングできない場合があります。
|
||||
|
||||
このことを、コミット作者はメールアドレスをプライベートに設定することで解決できます。 コミットは、 `<username>@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)
|
||||
@@ -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
|
||||
---
|
||||
|
||||
@@ -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
|
||||
---
|
||||
|
||||
@@ -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`、カスタムプロパティ、その他上記にないプロパティをサポートしていません。
|
||||
@@ -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/<em>user</em>/<em>repo</em>
|
||||
> Checked out revision 1.
|
||||
$ cd <em>repo</em>
|
||||
```
|
||||
|
||||
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.
|
||||
```
|
||||
|
||||
リポジトリのブランチドロップダウンに新しいブランチが存在することを確認できます:
|
||||
|
||||
|
||||
|
||||
コマンドラインで新しいブランチを確認することもできます:
|
||||
|
||||
```shell
|
||||
$ git fetch
|
||||
> From https://github.com/<em>user</em>/<em>repo</em>/
|
||||
> * [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/<em>user</em>/<em>repo</em>/trunk
|
||||
```
|
||||
|
||||
次に、他のブランチにスイッチします:
|
||||
|
||||
```shell
|
||||
$ svn switch https://github.com/<em>user</em>/<em>repo</em>/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/<em>user</em>/<em>repo</em>
|
||||
05fcc584ed53d7b0c92e116cb7e64d198b13c4e3
|
||||
```
|
||||
|
||||
このコミット SHA によって、たとえば、GitHub 上の関連 Git コミットを検索できます。
|
||||
|
||||
## 参考リンク
|
||||
|
||||
* [GitHub がサポートする Subversion プロパティ](/articles/subversion-properties-supported-by-github)
|
||||
@@ -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)
|
||||
@@ -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)に記載されている場合を除き、人の眼はプライベートリポジトリの内容を見ることはありません。
|
||||
|
||||
あなたの個人データあるいはリポジトリデータがサードパーティと共有されることはありません。 弊社は、分析から得られた集約データをパートナーと共有することがあります。
|
||||
@@ -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
|
||||
---
|
||||
|
||||
@@ -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 %}
|
||||
{% elsif ghec %}
|
||||
{% 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)"
|
||||
@@ -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_archive %} FAQ](https://archiveprogram.github.com/faq/)
|
||||
@@ -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)
|
||||
@@ -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.
|
||||
|
||||
|
||||
4. Type the text of your gist into the gist text box.
|
||||
|
||||
|
||||
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**.
|
||||
|
||||
@@ -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 をクローンする
|
||||
|
||||
Gist にローカルの変更を加え、ウェブにプッシュしたい場合は、Gist をクローンして Git リポジトリと同様にコミットを行えます。 詳しい情報については[リポジトリのクローン](/articles/cloning-a-repository)を参照してください。
|
||||
|
||||
|
||||
|
||||
## 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)
|
||||
@@ -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
|
||||
---
|
||||
|
||||
@@ -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.
|
||||
|
||||
|
||||
|
||||
{% 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**. 
|
||||
|
||||
{% 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/)
|
||||
@@ -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 (最も小さいヘッディング)
|
||||
```
|
||||
|
||||
|
||||
|
||||
## スタイル付きテキスト
|
||||
|
||||
コメントフィールドと `.md` ファイルでは、太字、斜体、または取り消し線のテキストで強調を示すことができます。
|
||||
|
||||
| スタイル | 構文 | キーボードショートカット | サンプル | 出力 |
|
||||
| ------------- | ------------------- | ------------------- | ------------------------- | ----------------------- |
|
||||
| 太字 | `** **`もしくは`__ __` | command/control + b | `**これは太字のテキストです**` | **これは太字のテキストです** |
|
||||
| 斜体 | `* *`あるいは`_ _` | command/control + i | `*このテキストは斜体です*` | *このテキストは斜体です* |
|
||||
| 取り消し線 | `~~ ~~` | | `~~これは間違ったテキストでした~~` | ~~これは間違ったテキストでした~~ |
|
||||
| 太字および太字中にある斜体 | `** **`及び`_ _` | | `**このテキストは_きわめて_ 重要です**` | **このテキストは_きわめて_重要です** |
|
||||
| 全体が太字かつ斜体 | `*** ***` | | `***すべてのテキストがきわめて重要です***` | ***すべてのテキストがきわめて重要です*** |
|
||||
|
||||
## テキストの引用
|
||||
|
||||
テキストは`>`で引用できます。
|
||||
|
||||
```markdown
|
||||
Text that is not a quote
|
||||
|
||||
> Text that is a quote
|
||||
```
|
||||
|
||||
|
||||
|
||||
{% 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` を使ってください。
|
||||
```
|
||||
|
||||
|
||||
|
||||
独立したブロック内にコードあるいはテキストをフォーマットするには、3 重のバッククォートを使用します。
|
||||
|
||||
<pre>
|
||||
いくつかの基本的な Git コマンド:
|
||||
```
|
||||
git status
|
||||
git add
|
||||
git commit
|
||||
```
|
||||
</pre>
|
||||
|
||||
|
||||
|
||||
詳しい情報については[コードブロックの作成とハイライト](/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/) を使って構築されています。`
|
||||
|
||||
|
||||
|
||||
{% 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 `()`.
|
||||
|
||||
``
|
||||
|
||||
|
||||
|
||||
{% 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 | `` |
|
||||
| Light Theme | `` |
|
||||
{% endif %}
|
||||
|
||||
## リスト
|
||||
|
||||
1 つ以上の行の前に `-` または `*` を置くことで、順序なしリストを作成できます。
|
||||
|
||||
```markdown
|
||||
- George Washington
|
||||
- John Adams
|
||||
- Thomas Jefferson
|
||||
```
|
||||
|
||||
|
||||
|
||||
リストを順序付けするには、各行の前に数字を置きます。
|
||||
|
||||
```markdown
|
||||
1. James Madison
|
||||
2. James Monroe
|
||||
3. John Quincy Adams
|
||||
```
|
||||
|
||||
|
||||
|
||||
### 入れ子になったリスト
|
||||
|
||||
1 つ以上のリストアイテムを他のアイテムの下にインデントすることで、入れ子になったリストを作成できます。
|
||||
|
||||
{% data variables.product.product_name %}上の Web のエディタあるいは [Atom](https://atom.io/) のようなモノスペースフォントを使うテキストエディタを使って入れ子になったリストを作成するには、リストが揃って見えるように編集します。 入れ子になったリストアイテムの前に空白を、リストマーカーの文字 (`-` または `*`) が直接上位のアイテム内のテキストの一文字目の下に来るように入力してください。
|
||||
|
||||
```markdown
|
||||
1. 最初のリストアイテム
|
||||
- 最初の入れ子になったリストアイテム
|
||||
- 2 番目の入れ子になったリストアイテム
|
||||
```
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
モノスペースフォントを使っていない {% data variables.product.product_name %}のコメントエディタで入れ子になったリストを作成するには、入れ子になったリストのすぐ上にあるリストアイテムを見て、そのアイテムの内容の前にある文字数を数えます。 そして、その数だけ空白を入れ子になったリストアイテムの前に入力します。
|
||||
|
||||
この例では、入れ子になったリストアイテムをリストアイテム `100. 最初のリストアイテム` の下に、最低 5 つの空白で入れ子になったリストアイテムをインデントさせることで追加できます。これは、`最初のリストアイテム`の前に 5 文字 (`100. `) があるからです。
|
||||
|
||||
```markdown
|
||||
100. 最初のリストアイテム
|
||||
- 最初の入れ子になったリストアイテム
|
||||
```
|
||||
|
||||
|
||||
|
||||
同じ方法で、複数レベルの入れ子になったリストを作成できます。 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 番目の入れ子になったリストアイテム
|
||||
```
|
||||
|
||||
|
||||
|
||||
[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 これらのアップデートについてどう思いますか？`
|
||||
|
||||
|
||||
|
||||
親チームにメンションすると、その子チームのメンバーも通知を受けることになり、複数のグループの人々とのコミュニケーションがシンプルになります。 詳しい情報については[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 の下に表示します。
|
||||
|
||||
|
||||
|
||||
コンテンツの添付を見るには、リポジトリにインストールされた 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:`
|
||||
|
||||
|
||||
|
||||
`:` を入力すると、絵文字のサジェストリストが表示されます。 このリストは、入力を進めるにつれて絞り込まれていくので、探している絵文字が見つかったら、**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:
|
||||
|
||||
|
||||
|
||||
{% 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.
|
||||
|
||||
<pre>
|
||||
<!-- This content will not appear in the rendered Markdown -->
|
||||
</pre>
|
||||
|
||||
## Markdown のフォーマットの無視
|
||||
|
||||
{% data variables.product.product_name %}に対し、Markdown のキャラクタの前に `\` を使うことで、Markdown のフォーマットを無視 (エスケープ) させることができます。
|
||||
|
||||
`\*新しいプロジェクト\* を \*古いプロジェクト\* にリネームしましょう`
|
||||
|
||||
|
||||
|
||||
詳しい情報については 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/)
|
||||
@@ -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
|
||||
---
|
||||
|
||||
@@ -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
|
||||
---
|
||||
|
||||
@@ -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 やプルリクエストの会話にファイルを添付するには、コメントボックスにファイルをドラッグアンドドロップします。 または、コメントボックスの下部にあるバーをクリックしてコンピュータからファイルを参照、選択、追加することもできます。
|
||||
|
||||
|
||||
|
||||
{% 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 %}
|
||||
|
||||
|
||||
@@ -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`
|
||||
|
||||
|
||||
|
||||
リンクの生成に関する詳しい情報については[基本的な書き方とフォーマットの構文](/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)
|
||||
@@ -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 として表示されます。
|
||||
|
||||
|
||||
|
||||
{% 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**] をクリックします。 
|
||||
5. コードスニペットにリンクさせたい会話に移動します。
|
||||
6. コメントにパーマリンクを貼り付け、[**Comment**] をクリックします。 
|
||||
|
||||
## 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/<organization>/<repository>/blob/<branch_name>/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/<organization>/<repository>/blob/<branch_name>/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/)」
|
||||
@@ -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
|
||||
---
|
||||
|
||||
## コードブロック
|
||||
|
||||
三連バッククォート <code>\`\`\`</code> をコードのブロック前後に入力すると、コードブロックを作成できます。 ソースコードを読みやすくするために、コードブロックの前後に空の行を入れることをお勧めします。
|
||||
|
||||
<pre>
|
||||
```
|
||||
function test() {
|
||||
console.log("この関数の前に空白行があるのがわかりますか?");
|
||||
}
|
||||
```
|
||||
</pre>
|
||||
|
||||
|
||||
|
||||
{% tip %}
|
||||
|
||||
**ヒント:** リスト内でフォーマットを保持するために、フェンスされていないコードのブロックをスペース 8 つでインデントしてください。
|
||||
|
||||
{% endtip %}
|
||||
|
||||
To display triple backticks in a fenced code block, wrap them inside quadruple backticks.
|
||||
|
||||
|
||||
<pre>
|
||||
````
|
||||
```
|
||||
Look! You can see my backticks.
|
||||
```
|
||||
````
|
||||
</pre>
|
||||
|
||||
|
||||
|
||||
{% data reusables.user_settings.enabling-fixed-width-fonts %}
|
||||
|
||||
## 構文の強調表示
|
||||
|
||||
<!-- If you make changes to this feature, update /getting-started-with-github/github-language-support to reflect any changes to supported languages. -->
|
||||
|
||||
言語識別子を追加して、コードブロックの構文を強調表示することができます。
|
||||
|
||||
たとえば、Ruby コードの構文を強調表示するには:
|
||||
|
||||
```ruby
|
||||
require 'redcarpet'
|
||||
markdown = Redcarpet.new("Hello World!")
|
||||
puts markdown.to_html
|
||||
```
|
||||
|
||||
|
||||
|
||||
構文強調表示のための言語検出の実行や[サードパーティの文法](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)
|
||||
@@ -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
|
||||
---
|
||||
|
||||
@@ -1,41 +0,0 @@
|
||||
---
|
||||
title: Organizing information with collapsed sections
|
||||
intro: You can streamline your Markdown by creating a collapsed section with the `<details>` 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 `<details>` block will be collapsed until the reader clicks {% octicon "triangle-right" aria-label="The right triange icon" %} to expand the details. Within the `<details>` block, use the `<summary>` tag to create a label to the right of {% octicon "triangle-right" aria-label="The right triange icon" %}.
|
||||
|
||||
```markdown
|
||||
<details><summary>CLICK ME</summary>
|
||||
<p>
|
||||
|
||||
#### We can hide anything, even code!
|
||||
|
||||
```ruby
|
||||
puts "Hello World"
|
||||
```
|
||||
|
||||
</details> ```</p>
|
||||
|
||||
The Markdown will be collapsed by default.
|
||||
|
||||
|
||||
|
||||
After a reader clicks {% octicon "triangle-right" aria-label="The right triange icon" %}, the details are expanded.
|
||||
|
||||
|
||||
|
||||
## 参考リンク
|
||||
|
||||
- [{% data variables.product.prodname_dotcom %} Flavored Markdown の仕様](https://github.github.com/gfm/)
|
||||
- [基本的な書き方とフォーマットの構文](/articles/basic-writing-and-formatting-syntax)
|
||||
@@ -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 |
|
||||
| ------------- | ------------- |
|
||||
| 内容セル | 内容セル |
|
||||
| 内容セル | 内容セル |
|
||||
```
|
||||
|
||||
|
||||
|
||||
表の両側のパイプ文字はオプションです。
|
||||
|
||||
セルの幅は変わるので、列がぴったり一致する必要はありません。 各列のヘッダ行には、ハイフンを 3 つ以上使用してください。
|
||||
|
||||
```markdown
|
||||
| Command | Description |
|
||||
| --- | --- |
|
||||
| git status | List all new or modified files |
|
||||
| git diff | Show file differences that haven't been staged |
|
||||
```
|
||||
|
||||
|
||||
|
||||
{% 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 |
|
||||
```
|
||||
|
||||
|
||||
|
||||
ヘッダー行でハイフンの左、右、両側にコロン (`:`) を使うと、列でテキストを左寄せ、右寄せ、センタリングすることができます。
|
||||
|
||||
```markdown
|
||||
| Left-aligned | Center-aligned | Right-aligned |
|
||||
| :--- | :---: | ---: |
|
||||
| git status | git status | git status |
|
||||
| git diff | git diff | git diff |
|
||||
```
|
||||
|
||||
|
||||
|
||||
セルでパイプ文字 (`|`) を使用するには、パイプ文字の前に `\` を追加します。
|
||||
|
||||
```markdown
|
||||
| Name | Character |
|
||||
| --- | --- |
|
||||
| Backtick | ` |
|
||||
| Pipe | \| |
|
||||
```
|
||||
|
||||
|
||||
|
||||
## 参考リンク
|
||||
|
||||
- [{% data variables.product.prodname_dotcom %} Flavored Markdown の仕様](https://github.github.com/gfm/)
|
||||
- [基本的な書き方とフォーマットの構文](/articles/basic-writing-and-formatting-syntax)
|
||||
@@ -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)."
|
||||
@@ -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: '*'
|
||||
---
|
||||
|
||||
|
||||
|
||||
返信テンプレートを使うと、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)
|
||||
@@ -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] の下に返信テンプレートのタイトルを追加します。 
|
||||
4. [Write] フィールドに、返信テンプレートに使用するコンテンツを追加します。 {% data variables.product.product_name %} での書き方に関する詳しい情報については「[基本的な書き方とフォーマットの構文](/articles/basic-writing-and-formatting-syntax)」を参照してください。 
|
||||
5. 返信をレビューするには、[**Preview**] をクリックします。 
|
||||
6. [**Add saved reply**] をクリックします。 
|
||||
|
||||
## 参考リンク
|
||||
|
||||
- 「[返信テンプレートを利用する](/articles/using-saved-replies)」
|
||||
- 「[返信テンプレートを編集する](/articles/editing-a-saved-reply)」
|
||||
- [返信テンプレートの削除](/articles/deleting-a-saved-reply)
|
||||
@@ -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" %} をクリックします。
|
||||
|
||||
@@ -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" %} をクリックします。
|
||||
|
||||
4. [Edit saved reply] で、返信テンプレートのタイトルと内容を編集できます。 
|
||||
5. [**Update saved reply**] をクリックします。 
|
||||
|
||||
## 参考リンク
|
||||
|
||||
- [返信テンプレートの作成](/articles/creating-a-saved-reply)
|
||||
- [返信テンプレートの削除](/articles/deleting-a-saved-reply)
|
||||
- 「[返信テンプレートを利用する](/articles/using-saved-replies)」
|
||||
@@ -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
|
||||
---
|
||||
|
||||
@@ -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. リストから、コメントに追加したい返信テンプレートを選択します。 
|
||||
|
||||
{% tip %}
|
||||
|
||||
**参考:**
|
||||
- キーボードショートカットを使用して、返信テンプレートをコメントに自動入力できます。 詳細は「[キーボードのショートカット](/articles/keyboard-shortcuts/#comments)」を参照してください。
|
||||
- 返信テンプレートのタイトルを入力して、フィルタリングすることができます。
|
||||
|
||||
{% endtip %}
|
||||
|
||||
## 参考リンク
|
||||
|
||||
- [返信テンプレートの作成](/articles/creating-a-saved-reply)
|
||||
- 「[返信テンプレートを編集する](/articles/editing-a-saved-reply)」
|
||||
- [返信テンプレートの削除](/articles/deleting-a-saved-reply)
|
||||
@@ -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.
|
||||
|
||||
|
||||
|
||||
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)"
|
||||
@@ -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 %}. 
|
||||
{% 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. 
|
||||
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 <em> <REMOTE_URL> </em>
|
||||
# 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</0> 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 %}. 
|
||||
{% 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. 
|
||||
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 <em> <REMOTE_URL> </em>
|
||||
# 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</0> 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 %}. 
|
||||
{% 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. 
|
||||
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 <em> <REMOTE_URL> </em>
|
||||
# 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</0> 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)"
|
||||
@@ -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/<em>extuser</em>/<em>repo.git</em>
|
||||
# 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 <em>repo.git</em>
|
||||
$ git push --mirror https://{% data variables.command_line.codeblock %}/<em>ghuser</em>/<em>repo.git</em>
|
||||
# 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 <em>repo.git</em>
|
||||
```
|
||||
@@ -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). 
|
||||
2. Embaixo de "Your old repository's clone URL" (URL clone de seu antigo repositório), digite a URL do projeto que quer importar. 
|
||||
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. 
|
||||
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)". 
|
||||
5. Revise a informação que digitou e clique em **Begin import** (Iniciar importação). 
|
||||
6. Caso seu projeto antigo esteja protegido por uma senha, digite sua informação de login para aquele projeto e clique em **Submit** (Enviar). 
|
||||
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). 
|
||||
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). 
|
||||
|
||||
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)"
|
||||
@@ -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
|
||||
---
|
||||
|
||||
@@ -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 %}
|
||||
@@ -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. 
|
||||
2. Clique em **Connect** (Conectar) ao lado do autor cujas informações você deseja atualizar. 
|
||||
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 `<username>@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)"
|
||||
@@ -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
|
||||
---
|
||||
|
||||
@@ -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
|
||||
---
|
||||
|
||||
@@ -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.
|
||||
@@ -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/<em>user</em>/<em>repo</em>
|
||||
> Checked out revision 1.
|
||||
$ cd <em>repo</em>
|
||||
```
|
||||
|
||||
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:
|
||||
|
||||
|
||||
|
||||
Você também pode confirmar o novo branch por meio da linha de comando:
|
||||
|
||||
```shell
|
||||
$ git fetch
|
||||
> Em https://github.com/<em>user</em>/<em>repo</em>/
|
||||
> * [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/<em>user</em>/<em>repo</em>/trunk
|
||||
```
|
||||
|
||||
E depois alternar para outro branch:
|
||||
|
||||
```shell
|
||||
$ svn switch https://github.com/<em>user</em>/<em>repo</em>/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/<em>user</em>/<em>repo</em>
|
||||
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)"
|
||||
@@ -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)"
|
||||
@@ -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.
|
||||
@@ -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
|
||||
---
|
||||
|
||||
@@ -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 %} {% elsif ghec %}
|
||||
{% 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)"
|
||||
@@ -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**. 
|
||||
|
||||
## Leia mais
|
||||
- [{% data variables.product.prodname_archive %} FAQ](https://archiveprogram.github.com/faq/)
|
||||
@@ -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).  
|
||||
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). 
|
||||
@@ -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. 
|
||||
|
||||
4. Digite o texto do seu gist na caixa de texto do gist. 
|
||||
|
||||
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 %}**. 
|
||||
@@ -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.
|
||||
|
||||
|
||||
|
||||
## 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)".
|
||||
|
||||
|
||||
|
||||
## 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.
|
||||
|
||||
|
||||
|
||||
Você verá o histórico completo do gist com os diffs.
|
||||
|
||||
|
||||
@@ -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
|
||||
---
|
||||
|
||||
@@ -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.
|
||||
|
||||
|
||||
|
||||
{% 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**. 
|
||||
|
||||
{% 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/)"
|
||||
@@ -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
|
||||
```
|
||||
|
||||
|
||||
|
||||
## 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
|
||||
```
|
||||
|
||||
|
||||
|
||||
{% 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.
|
||||
```
|
||||
|
||||
|
||||
|
||||
Para formatar código ou texto no próprio bloco distinto, use aspas triplas.
|
||||
|
||||
<pre>
|
||||
Alguns comandos Git básicos são:
|
||||
```
|
||||
git status
|
||||
git add
|
||||
git commit
|
||||
```
|
||||
</pre>
|
||||
|
||||
|
||||
|
||||
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/).`
|
||||
|
||||
|
||||
|
||||
{% 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 `()`.
|
||||
|
||||
``
|
||||
|
||||
|
||||
|
||||
{% 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 | `` |
|
||||
| Tema claro | `` |
|
||||
{% 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
|
||||
```
|
||||
|
||||
|
||||
|
||||
Para ordenar a lista, coloque um número na frente de cada linha.
|
||||
|
||||
```markdown
|
||||
1. James Madison
|
||||
2. James Monroe
|
||||
3. John Quincy Adams
|
||||
```
|
||||
|
||||
|
||||
|
||||
### 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
|
||||
```
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
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
|
||||
```
|
||||
|
||||
|
||||
|
||||
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
|
||||
```
|
||||
|
||||
|
||||
|
||||
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?`
|
||||
|
||||
|
||||
|
||||
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.
|
||||
|
||||
|
||||
|
||||
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:`
|
||||
|
||||
|
||||
|
||||
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:
|
||||
|
||||
|
||||
|
||||
{% 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.
|
||||
|
||||
<pre>
|
||||
<!-- This content will not appear in the rendered Markdown -->
|
||||
</pre>
|
||||
|
||||
## 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\*.`
|
||||
|
||||
|
||||
|
||||
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/)"
|
||||
@@ -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
|
||||
---
|
||||
|
||||
@@ -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
|
||||
---
|
||||
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user