Skip to main content

Create a repo

To put your project up on GitHub, you will need to create a repository for it to live in.

Create a repository

You can store a variety of projects in GitHub AE repositories, including innersource projects. With innersource, you can share code to make better, more reliable software. For more information on innersource, see GitHub's white paper "An introduction to innersource."

  1. En la esquina superior derecha de cualquier página, utiliza el menú desplegable y selecciona New repository (Nuevo repositorio). Menú desplegable con opción para crear un repositorio
  2. Type a short, memorable name for your repository. For example, "hello-world". Field for entering a repository name
  3. Optionally, add a description of your repository. For example, "My first repository on GitHub AE." Field for entering a repository description
  4. Elige la visibilidad del repositorio. Para más información, vea "Acerca de los repositorios". Botones de radio para seleccionar la visibilidad del repositorio
  5. Seleccione Initialize this repository with a README (Inicializar este repositorio con un archivo Léame). Inicializar este repositorio con una casilla archivo Léame
  6. Haga clic en Create repository (Crear repositorio). Botón para crear un repositorio

Congratulations! You've successfully created your first repository, and initialized it with a README file.

Para obtener más información sobre GitHub CLI, vea "Acerca de GitHub CLI".

  1. In the command line, navigate to the directory where you would like to create a local clone of your new project.
  2. To create a repository for your project, use the gh repo create subcommand. When prompted, select Create a new repository on GitHub from scratch and enter the name of your new project. If you want your project to belong to an organization instead of to your personal account, specify the organization name and project name with organization-name/project-name.
  3. Follow the interactive prompts. To clone the repository locally, confirm yes when asked if you would like to clone the remote project directory.
  4. Alternatively, to skip the prompts supply the repository name and a visibility flag (--public, --private, or --internal). For example, gh repo create project-name --public. To clone the repository locally, pass the --clone flag. For more information about possible arguments, see the GitHub CLI manual.

Commit your first change

A commit is like a snapshot of all the files in your project at a particular point in time.

When you created your new repository, you initialized it with a README file. README files are a great place to describe your project in more detail, or add some documentation such as how to install or use your project. The contents of your README file are automatically shown on the front page of your repository.

Let's commit a change to the README file.

  1. In your repository's list of files, click README.md. README file in file list
  2. Above the file's content, click .
  3. On the Edit file tab, type some information about yourself. New content in file
  4. Encima del nuevo contenido, haga clic en Vista previa de los cambios. Botón de vista previa del archivo
  5. Review the changes you made to the file. You will see the new content in green. File preview view
  6. En la parte inferior de la página, teclea un mensaje de confirmación corto y significativo que describa el cambio que realizaste al archivo. Puedes atribuir el cambio a mas de un autor en el mensaje del mismo. Para más información, vea "Creación de una confirmación con varios coautores". Mensaje de confirmación para el cambio
  7. Debajo de los campos para el mensaje de confirmación, decide si deseas agregar tu confirmación a la rama actual o a una rama nueva. Debajo de los campos del mensaje de confirmación, decide si deseas agregar tu confirmación a la rama actual o a una nueva rama. Si tu rama actual es la rama predeterminada, debes elegir crear una nueva rama para tu confirmación y después crear una solicitud de extracción. Para más información, vea "Creación de una solicitud de incorporación de cambios". Opciones de confirmación de rama
  8. Haga clic en Propose file change (Proponer cambio de archivo). Botón para proponer cambio de archivo

Now that you have created a project, you can start committing changes.

README files are a great place to describe your project in more detail, or add some documentation such as how to install or use your project. The contents of your README file are automatically shown on the front page of your repository. Follow these steps to add a README file.

  1. In the command line, navigate to the root directory of your new project. (This directory was created when you ran the gh repo create command.)

  2. Create a README file with some information about the project.

    echo "info about this project" >> README.md
  3. Enter git status. You will see that you have an untracked README.md file.

    $ git status
    
    Untracked files:
      (use "git add ..." to include in what will be committed)
      README.md
    
    nothing added to commit but untracked files present (use "git add" to track)
  4. Stage and commit the file.

    git add README.md && git commit -m "Add README"
  5. Push the changes to your branch.

    git push --set-upstream origin HEAD

Next steps

You have now created a repository, including a README file, and created your first commit on your enterprise.

  • You can now clone a GitHub repository to create a local copy on your computer. From your local repository you can commit, and create a pull request to update the changes in the upstream repository. For more information, see "Cloning a repository" and "Set up Git."
  • You can find interesting projects and repositories on GitHub and make changes to them by creating a fork of the repository. La bifurcación de un repositorio te permitirá realizar cambios en otro repositorio sin afectar al original. Para obtener más información, vea "Bifurcación de un repositorio".

  • Cada repositorio de GitHub le pertenece a una persona u organización. Puedes interactuar con las personas, repositorios y organizaciones conectándote y siguiéndolos en GitHub AE. Para obtener más información, consulta "Ser social".

  • GitHub tiene una excelente comunidad de soporte técnico en la que puede pedir ayuda y hablar con usuarios de todo el mundo. Únete a la conversación en GitHub Community.