github Tutorial
Empezando con github
Buscar..
Observaciones
Esta sección proporciona una descripción general de qué es github, y por qué un desarrollador puede querer usarlo.
También debe mencionar cualquier tema grande dentro de github, y vincular a los temas relacionados. Dado que la Documentación para github es nueva, es posible que deba crear versiones iniciales de los temas relacionados.
Instalación o configuración
GitHub es una gran colección de repositorios Git. En otras palabras, ¡puedes pensar en GitHub como una colección de muchos proyectos!
Creando una cuenta
- Visita la página principal de GitHub aquí.
- ¡Elija un nombre de usuario, ingrese su dirección de correo electrónico y elija una contraseña segura y listo!
Herramientas utiles
Para los principiantes de Git / GitHub, entender cómo funciona el control de versiones puede ser confuso al principio. Existe una versión GUI de GitHub que puedes descargar y usar. GitHub Desktop es solo esa herramienta.
Creando tu primer repositorio
Puedes pensar en un repositorio como un proyecto. Puede crear un repositorio en línea o fuera de línea. Siga los pasos a continuación:
En línea
- Primero inicia sesión y ve a tu perfil.
- Vaya a la pestaña "Repositorios" cerca de la parte superior de la página
- ¡Presiona el botón verde "Nuevo" y estás listo para retumbar!
Desconectado
- Descarga e instala git (elige el sistema operativo que estás ejecutando)
- Después de la descarga y la instalación, puede utilizar la herramienta de línea de comandos o puede descargar un cliente GUI.
- Después de la instalación, crea una cuenta en github
- Desde la parte superior derecha, haga clic en el signo + y elija crear un nuevo repositorio o importar un archivo existente en.
- Si elige uno nuevo, ingrese el nombre del repositorio y elija tenerlo público o privado.
- Haga clic en: Crear repositorio
NB Los repositorios privados no están disponibles para usuarios gratuitos.
Archivo readme
Si su proyecto no tiene README.md, GitHub puede analizar README.rdoc para mostrar los detalles. Si tiene ambos, usará README.md, ignorando silenciosamente rdoc.
Un archivo README puede incluir-
Título del Proyecto
Describe brevemente sobre tu proyecto. También puede proporcionar el enlace al sitio web del proyecto, las insignias, la comunidad y la información de contacto (es decir, correo electrónico, sitio social).
Descargar
Enlace de archivo ejecutable (ejecutable o minimizado o archivo de instalación). También puede haber enlaces a versiones anteriores.
Instalación
Cómo se puede utilizar tu trabajo. Puede incluir los requisitos previos, la configuración, las bibliotecas de terceros, el uso, las precauciones, etc.
Demostración
Puede incluir ejemplo de código, archivo gif, enlace de video o incluso capturas de pantalla.
Autores
Nombres de autores, información de contacto, etc.
Expresiones de gratitud
Lista de personas o comunidad ayudada e inspirada a lo largo del proyecto.
Contribuyendo
Instrucciones para contribuir (es decir, agregar características, informar errores, enviar parches) al proyecto. Puede incluir enlace de documentación también.
Licencia
Dar una breve introducción sobre su licencia. También puede dar un enlace al sitio de la licencia.
Archivo de licencia
GitHub lo ayuda a agregar rápidamente una licencia a su repositorio, como una alternativa para agregar su propio archivo de texto / markdown.
En su repositorio, haga clic en 'Crear nuevo archivo'
En la próxima página:
- Escriba
LICENSE.md
oLICENSE.txt
como el nombre de archivo del nuevo archivo. - ¿Quieres usar una nueva plantilla? Aparecerá el diálogo.
- Escriba
Elija su licencia preferida.
La licencia que podías ver en los detalles del repositorio:
De preguntas y respuestas: cómo agregar una licencia a un proyecto existente de Github
GitHub Con sabor Markdown
GitHub expande la sintaxis de Markdown para proporcionar nuevas funciones útiles.
Encabezamiento
# Header1
## Header2
### Header3
#### Header4
##### Header5
###### Header6
H1
===
H2
---
Énfasis
*Italic1* _Italic2_
**Bold1** __Bold2__
***Bold_Italic***
~~Strikethrough~~
Linea horizontal
---
***
___
Lista
unordered list:
* item-1
* sub-item-1
* sub-item-2
- item-2
- sub-item-3
- sub-item-4
+ item-3
+ sub-item-5
+ sub-item-6
ordered list:
1. item-1
1. sub-item-1
2. sub-item-2
2. item-2
1. sub-item-3
2. sub-item-4
3. item-3
Mesa
Table Header-1 | Table Header-2 | Table Header-3
:--- | :---: | ---:
Table Data-1 | Table Data-2 | Table Data-3
TD-4 | Td-5 | TD-6
Table Data-7 | Table Data-8 | Table Data-9
Código
inline code- `int i=0`
block code-
``` C
for(int i=0; i<10; i++){
printf("Hallow World! \n");
}
```
Citar
> Stay hungry; stay foolish.
>> Quality is better than quantity.
>>> Life is not fair; get used to it.
Enlazar
https://github.com
[GitHub](https://github.com)
[GitHub](https://github.com "github website")
[GitHub][1]
[1]: https://github.com
Imagen
![GitHub Logo](https://assets-cdn.github.com/images/icons/emoji/octocat.png "GitHub")
Listas de tareas
- [x] completed item
- [ ] incomplete item
Emoji
:octocat: :+1: :book: :ghost: :bulb: :imp:
Para todos los emojies de GitHub visita- Hoja de trucos Emoji .
Referencias SHA
Cualquier referencia a un hash SHA1 de una confirmación se convertirá en un enlace a la confirmación en GitHub:
e7909ea4fbb162db3f7f543d43c30684a3fb745f
Solicitud de extracción y referencias de problemas
Cualquier referencia a una solicitud de extracción o un problema se vinculará automáticamente a esa solicitud de extracción o problema.
Esto se puede hacer colocando un #
delante del número de solicitud de emisión / problema.