2.2: Enviar asignaciones de codificación y usar GitHub
- Page ID
- 152682
\( \newcommand{\vecs}[1]{\overset { \scriptstyle \rightharpoonup} {\mathbf{#1}} } \)
\( \newcommand{\vecd}[1]{\overset{-\!-\!\rightharpoonup}{\vphantom{a}\smash {#1}}} \)
\( \newcommand{\id}{\mathrm{id}}\) \( \newcommand{\Span}{\mathrm{span}}\)
( \newcommand{\kernel}{\mathrm{null}\,}\) \( \newcommand{\range}{\mathrm{range}\,}\)
\( \newcommand{\RealPart}{\mathrm{Re}}\) \( \newcommand{\ImaginaryPart}{\mathrm{Im}}\)
\( \newcommand{\Argument}{\mathrm{Arg}}\) \( \newcommand{\norm}[1]{\| #1 \|}\)
\( \newcommand{\inner}[2]{\langle #1, #2 \rangle}\)
\( \newcommand{\Span}{\mathrm{span}}\)
\( \newcommand{\id}{\mathrm{id}}\)
\( \newcommand{\Span}{\mathrm{span}}\)
\( \newcommand{\kernel}{\mathrm{null}\,}\)
\( \newcommand{\range}{\mathrm{range}\,}\)
\( \newcommand{\RealPart}{\mathrm{Re}}\)
\( \newcommand{\ImaginaryPart}{\mathrm{Im}}\)
\( \newcommand{\Argument}{\mathrm{Arg}}\)
\( \newcommand{\norm}[1]{\| #1 \|}\)
\( \newcommand{\inner}[2]{\langle #1, #2 \rangle}\)
\( \newcommand{\Span}{\mathrm{span}}\) \( \newcommand{\AA}{\unicode[.8,0]{x212B}}\)
\( \newcommand{\vectorA}[1]{\vec{#1}} % arrow\)
\( \newcommand{\vectorAt}[1]{\vec{\text{#1}}} % arrow\)
\( \newcommand{\vectorB}[1]{\overset { \scriptstyle \rightharpoonup} {\mathbf{#1}} } \)
\( \newcommand{\vectorC}[1]{\textbf{#1}} \)
\( \newcommand{\vectorD}[1]{\overrightarrow{#1}} \)
\( \newcommand{\vectorDt}[1]{\overrightarrow{\text{#1}}} \)
\( \newcommand{\vectE}[1]{\overset{-\!-\!\rightharpoonup}{\vphantom{a}\smash{\mathbf {#1}}}} \)
\( \newcommand{\vecs}[1]{\overset { \scriptstyle \rightharpoonup} {\mathbf{#1}} } \)
\( \newcommand{\vecd}[1]{\overset{-\!-\!\rightharpoonup}{\vphantom{a}\smash {#1}}} \)
\(\newcommand{\avec}{\mathbf a}\) \(\newcommand{\bvec}{\mathbf b}\) \(\newcommand{\cvec}{\mathbf c}\) \(\newcommand{\dvec}{\mathbf d}\) \(\newcommand{\dtil}{\widetilde{\mathbf d}}\) \(\newcommand{\evec}{\mathbf e}\) \(\newcommand{\fvec}{\mathbf f}\) \(\newcommand{\nvec}{\mathbf n}\) \(\newcommand{\pvec}{\mathbf p}\) \(\newcommand{\qvec}{\mathbf q}\) \(\newcommand{\svec}{\mathbf s}\) \(\newcommand{\tvec}{\mathbf t}\) \(\newcommand{\uvec}{\mathbf u}\) \(\newcommand{\vvec}{\mathbf v}\) \(\newcommand{\wvec}{\mathbf w}\) \(\newcommand{\xvec}{\mathbf x}\) \(\newcommand{\yvec}{\mathbf y}\) \(\newcommand{\zvec}{\mathbf z}\) \(\newcommand{\rvec}{\mathbf r}\) \(\newcommand{\mvec}{\mathbf m}\) \(\newcommand{\zerovec}{\mathbf 0}\) \(\newcommand{\onevec}{\mathbf 1}\) \(\newcommand{\real}{\mathbb R}\) \(\newcommand{\twovec}[2]{\left[\begin{array}{r}#1 \\ #2 \end{array}\right]}\) \(\newcommand{\ctwovec}[2]{\left[\begin{array}{c}#1 \\ #2 \end{array}\right]}\) \(\newcommand{\threevec}[3]{\left[\begin{array}{r}#1 \\ #2 \\ #3 \end{array}\right]}\) \(\newcommand{\cthreevec}[3]{\left[\begin{array}{c}#1 \\ #2 \\ #3 \end{array}\right]}\) \(\newcommand{\fourvec}[4]{\left[\begin{array}{r}#1 \\ #2 \\ #3 \\ #4 \end{array}\right]}\) \(\newcommand{\cfourvec}[4]{\left[\begin{array}{c}#1 \\ #2 \\ #3 \\ #4 \end{array}\right]}\) \(\newcommand{\fivevec}[5]{\left[\begin{array}{r}#1 \\ #2 \\ #3 \\ #4 \\ #5 \\ \end{array}\right]}\) \(\newcommand{\cfivevec}[5]{\left[\begin{array}{c}#1 \\ #2 \\ #3 \\ #4 \\ #5 \\ \end{array}\right]}\) \(\newcommand{\mattwo}[4]{\left[\begin{array}{rr}#1 \amp #2 \\ #3 \amp #4 \\ \end{array}\right]}\) \(\newcommand{\laspan}[1]{\text{Span}\{#1\}}\) \(\newcommand{\bcal}{\cal B}\) \(\newcommand{\ccal}{\cal C}\) \(\newcommand{\scal}{\cal S}\) \(\newcommand{\wcal}{\cal W}\) \(\newcommand{\ecal}{\cal E}\) \(\newcommand{\coords}[2]{\left\{#1\right\}_{#2}}\) \(\newcommand{\gray}[1]{\color{gray}{#1}}\) \(\newcommand{\lgray}[1]{\color{lightgray}{#1}}\) \(\newcommand{\rank}{\operatorname{rank}}\) \(\newcommand{\row}{\text{Row}}\) \(\newcommand{\col}{\text{Col}}\) \(\renewcommand{\row}{\text{Row}}\) \(\newcommand{\nul}{\text{Nul}}\) \(\newcommand{\var}{\text{Var}}\) \(\newcommand{\corr}{\text{corr}}\) \(\newcommand{\len}[1]{\left|#1\right|}\) \(\newcommand{\bbar}{\overline{\bvec}}\) \(\newcommand{\bhat}{\widehat{\bvec}}\) \(\newcommand{\bperp}{\bvec^\perp}\) \(\newcommand{\xhat}{\widehat{\xvec}}\) \(\newcommand{\vhat}{\widehat{\vvec}}\) \(\newcommand{\uhat}{\widehat{\uvec}}\) \(\newcommand{\what}{\widehat{\wvec}}\) \(\newcommand{\Sighat}{\widehat{\Sigma}}\) \(\newcommand{\lt}{<}\) \(\newcommand{\gt}{>}\) \(\newcommand{\amp}{&}\) \(\definecolor{fillinmathshade}{gray}{0.9}\)Nota: Si estás aquí como parte de un curso, por favor sigue leyendo. De lo contrario, no se requiere enviar asignaciones de codificación.
La mayoría de las tareas que siguen son varios widgets de páginas web inaccesibles que te pediremos que hagas accesibles reescribiendo su código (HTML, CSS o JavaScript). Si estás participando aquí como parte de un curso, necesitarás el enlace a una página web en vivo con tu solución. Antes de revisar el código, se verificará la accesibilidad de la página (usando ChromeVox y otras herramientas).
Es tu decisión donde quieres alojar las páginas que enviarás para su revisión. Si tienes tu propio dominio y espacio de servidor, puedes subir las asignaciones completadas allí y enviar la URL. Otra opción es enviar la URL de un archivo en GitHub a GitHack (https://raw.githack.com), luego enviar la URL a la salida que genera como envío de tu tarea.
Siéntase libre de descargar los archivos de actividad de nuestro repositorio ahora, o si va a usar GitHub, siga leyendo para obtener instrucciones sobre cómo bifurcarlo en su propia cuenta.
Si no tienes un sitio web, te recomendamos usar GitHub como tu plataforma para enviar asignaciones. A continuación describimos GitHub y GitHub Pages. Si estás familiarizado con el uso de GitHub o tienes tu propio servidor web, puedes saltarte el resto de esta página o simplemente escanearla.
Configurar una cuenta de GitHub
Si aún no tienes una, deberías crear una cuenta de GitHub. Para cualquier desarrollador, es una herramienta invaluable para compartir y colaborar en el desarrollo de código. Una cuenta de GitHub es gratuita. Aunque puedes descargar los archivos de actividad de GitHub, luego descomprimirlos y trabajar desde un directorio local en tu disco duro, te recomendamos crear una bifurcación de los archivos de actividad en tu propia cuenta y clonar tu bifurcación en un directorio local. Siga el siguiente enlace para configurar una cuenta, luego siga leyendo.
Configurar un entorno local de Git
Dependiendo del sistema operativo que estés usando, existen versiones específicas de Git para cada plataforma. Puedes elegir usar un cliente Git, o puedes elegir usar Git desde la línea de comandos. Aquí presentaremos opciones de línea de comandos. Si elige usar un cliente, consulte la documentación asociada con el cliente para obtener detalles sobre clonación, confirmación, tracción y empuje.
Para usuarios de Windows y Mac, si vas a usar un cliente en lugar de trabajar desde una línea de comandos, te sugerimos instalar SourceTree. GitHub Desktop es una buena alternativa si prefieres usar un cliente de código abierto. Siéntase libre de elegir otro cliente de Git si lo desea.
Para los usuarios de Linux puedes usar el administrador de paquetes de tu sistema para instalar Git para el uso de la línea de comandos. En Ubuntu, por ejemplo, en el símbolo del sistema puedes ejecutar apt-get
como usuario root para instalar Git:
#> sudo apt-get install git
Si estás usando otra distribución de Linux, usa Google para encontrar detalles sobre cómo instalar Git en tu versión de Linux.
Envíos de tareas vía GitHub
La mayoría de las tareas que siguen requieren enviar una URL a una versión públicamente accesible de los widgets que son el foco de las actividades.
Si necesitas un lugar para publicar tus asignaciones de actividad, GitHub Pages puede ser una buena opción. O bien, tal vez prefieras usar Páginas de GitHub para organizar tus archivos para que no estén abarrotando tu servidor web. Crearás una bifurcación de los archivos de actividad (learnaria.github.io), renombrarás el repositorio para crear tu propia versión, y o bien subirlo a un sitio de tu elección o usar Páginas de GitHub. La opción Páginas de GitHub se describe aquí.
Si eliges usar Páginas de GitHub, sigue estos pasos para crear una copia de los archivos bajo tu propia cuenta de GitHub.
-
- Inicia sesión en GitHub, encuentra tu camino a los archivos de actividad y bifurca ese repositorio. El botón de bifurcación está en la parte superior derecha de la pantalla de GitHub mientras se ve un repositorio. Esto crea una copia del repositorio bajo tu propia cuenta de GitHub desde donde trabajarás.
- Después de haber bifurcado los archivos de actividad, entra en la configuración de ese repositorio y cambia el nombre de learnaria.github.io a [nombre de usuario] .github.io, donde username es el nombre de usuario de tu cuenta de GitHub. Esto creará automáticamente tu sitio web GitHub Pages en https://[username].github.io.
- Ahora querrás crear un clon de tu repositorio de archivos de actividad bifurcados en tu computadora, a través del cual harás tu trabajo. Desde la línea de comandos emite el siguiente comando para crear un clon de la versión bifurcada de los archivos de actividad que creaste, donde [username] es el nombre de usuario de tu cuenta de GitHub. También puedes copiar el enlace https desde un campo que se abre al hacer clic en el botón “Clonar o descargar” en tu repositorio.
#> git clone - Si está utilizando SourceTree, haga clic en “+ Nuevo repositorio” y elija “Clonar desde URL” e ingrese la URL anterior en el campo “URL de origen”. Establezca la “Ruta de destino” en su directorio de trabajo preferido.
Ahora deberías tener una copia de los archivos de actividad disponibles localmente que puedes editar y comprometer como tus actualizaciones de asignación, que pasan a formar parte de tu sitio web de Páginas GitHub.
Ten en cuenta que los cambios comprometidos en tu repositorio de Páginas GitHub pueden tardar unos segundos o un minuto en aparecer realmente en el sitio web.
Si ya tienes un sitio de GitHub Pages
Para agregar los archivos a un sitio existente de GitHub Pages, abre la configuración del repositorio bifurcado que creaste. En la sección Páginas de GitHub que se muestra en la captura de pantalla a continuación, elija la Fuente (normalmente, la rama maestra) y haga clic en Guardar. Esto creará un subdirectorio bajo tu sitio existente de GitHub Pages con el nombre del repositorio bifurcado (es decir, learnaria.github.io).
Es posible que desee cambiar el nombre del repositorio a algo más corto (por ejemplo, learnaria) antes de habilitarlo en Páginas de GitHub. Esto produciría una URL a los archivos de actividad, algo así como:
https://[username].github.io/learnaria/
Comandos básicos de Git
No necesitas ser un usuario experto de Git, pero debes conocer algunos comandos básicos si estás trabajando desde un símbolo del sistema. Los comandos que probablemente usarás son los siguientes:
git status (muestra una lista de archivos modificados y no rastreados)
git add [nombre de archivo] (prepara un archivo para cometer)
git commit -m “[message]” (describa la naturaleza de la confirmación)
git push [origin master] (envía el cambio comprometido a tu rama maestra del repositorio GitHub)
git diff [nombre de archivo] (muestra los cambios en un archivo)
Por supuesto que hay muchos otros comandos potenciales, pero estos son los más comunes. Si está utilizando un cliente Git, como SourceTree, estos comandos se pueden hacer clic en los botones y menús de la interfaz de usuario. Para más información sobre el uso de Git desde la línea de comandos, consulta el libro de Git.
Cómo se ven los archivos de actividad
Esto es lo que puede esperar una vez que haya configurado correctamente los archivos de actividad. Notarás que los widgets son inaccesibles. Tu trabajo a lo largo de las actividades será arreglar la accesibilidad de cada widget.