Skip to main content

Trabajo con archivos que no son de código

GitHub AE es compatible con interpretar y diferenciar varios formatos de archivo que no son de código.

Representar y comparar imágenes

GitHub AE puede mostrar varios formatos de imagen comunes, incluidos PNG, JPG, GIF, PSD y SVG. Asimismo, para simplificar mostrarlas, existen diversas formas de comparar las diferencias entre las versiones de esos formatos de imagen.

Nota:

  • GitHub no admite la comparación de las diferencias entre archivos PSD.
  • Si usa el explorador Firefox, es posible que los SVG en GitHub no se representen.

Visualización de imágenes

Puedes buscar y ver imágenes directamente en tu repositorio de GitHub AE:

imagen alineada

Los SVG actualmente no admiten scripting alineado o animación.

Ver diferencias

Hay tres modos diferentes de comparar visualmente las imágenes: dual, deslizar rápidamente y papel cebolla.

2-up

Dual es el modo predeterminado; ofrece una visión rápida de las dos imágenes. Asimismo, si la imagen cambió de tamaño entre las versiones, se muestra el cambio de dimensión real. Esto debería ser muy evidente cuando las cosas cambian de tamaño, como cuando los activos se suben de categoría a resoluciones más altas.

2-up

Deslizar rápidamente

Deslizar rápidamente le permite ver partes de la imagen en paralelo. ¿No estás seguro de si cambiaron los colores en las diferentes versiones? Arrastra el control deslizante de deslizamiento sobre el área en cuestión y compara los píxeles tú mismo.

Deslizar rápidamente

Papel cebolla

Papel cebolla es muy útil cuando los elementos apenas se desplazan y cuesta percibir el cambio. ¿Un icono se corrió dos píxeles a la izquierda? Arrastra el control deslizante de opacidad hacia atrás un poco y comprueba si las cosas se desplazaron.

Papel cebolla

Visualizador de archivos 3D

GitHub AE puede hospedar y representar archivos 3D con la extensión .stl.

Al buscar directamente en un archivo STL en GitHub AE puedes:

  • Hacer clic y arrastrar para girar el modelo.
  • Hacer clic con el botón derecho y arrastrar para traducir la vista.
  • Desplazarse para acercar y alejar.
  • Hacer clic en los diferentes modos para cambiar la vista.

Diferencias

Cuando miras una confirmación de cambios o un conjunto de cambios que incluyen un archivo STL, podrás ver una diferencia de antes y después del archivo.

Por defecto, obtendrás una vista donde todo lo que no ha cambiado está en el esquema de página. Las adiciones aparecen en verde y las partes eliminadas aparecen en rojo.

esquema de página

También puede seleccionar la opción Control deslizante de revisión, que permite usar un control deslizante en la parte superior del archivo para cambiar entre la revisión actual y la anterior.

Solucionar un rendimiento reducido

Si ves este ícono en la esquina del visualizador, entonces la tecnología WebGL no está disponible en tu navegador:

error emergente de WebGL

WebGL es necesario para aprovechar el hardware de tu equipo al máximo. Se recomienda probar exploradores como Chrome o Firefox, que incluyen WebGL habilitado.

Error: "No se puede mostrar"

Si tu modelo no es válido, es posible que GitHub no pueda mostrar el archivo. Además, los archivos de más de 10 MB son demasiado grandes para que GitHub los muestre.

Insertar tu modelo en otro lugar

Para mostrar tu archivo 3D en algún otro lugar de Internet, modifica esta plantilla y colócala en cualquier página HTML que sea compatible con JavaScript:

<script src="https://embed.github.com/view/3d/<username>/<repo>/<ref>/<path_to_file>"></script>

Por ejemplo, si la dirección URL del modelo es github.com/skalnik/secret-bear-clip/blob/master/stl/clip.stl, el código de inserción sería el siguiente:

<script src="https://embed.github.com/view/3d/skalnik/secret-bear-clip/master/stl/clip.stl"></script>

De manera predeterminada, el representador insertado es de 420 píxeles de ancho por 620 de alto, pero puede personalizar la salida si pasa las variables de altura y ancho como parámetros al final de la URL, como ?height=300&width=500.

Nota: ref puede ser una rama o el hash de una confirmación individual (como 2391ae).

Representar datos CSV y TSV

GitHub admite la representación de datos tabulares en forma de archivos .csv (separados por comas) y .tsv (separados por tabulaciones).

Muestra de CSV representado

Cuando se visualiza, cualquier archivo .csv o .tsv confirmado en un repositorio de GitHub AE se representa automáticamente como una tabla interactiva completa con encabezados y números de fila. Por defecto, siempre asumimos que la primera fila es tu fila de encabezados.

Puedes generar un enlace a una fila particular haciendo clic en el número de fila o seleccionar varias filas manteniendo presionada la tecla shift. Tan solo copia la URL y envíasela a un amigo.

Búsqueda de datos

Si quieres encontrar un valor determinado en tu conjunto de datos, puedes comenzar escribiendo en la barra de búsqueda directamente arriba del archivo. Las filas se filtrarán automáticamente:

Buscar valores

Control de errores

De manera ocasional, puede que descubras que tu archivo CSV o TSV no se representa. En esas instancias, aparece un cuadro de error al pie del texto original que sugiere cuál puede ser el error.

Mensaje de error de representación de CSV

Estos son algunos de los errores comunes:

  • Conteos de columnas que no coinciden. Debes tener la misma cantidad de separadores en cada fila, incluso si la celda está en blanco
  • Superar el tamaño de archivo. Nuestra representación solo funciona para archivos de hasta 512KB. Cualquier cosa más grande hace que el navegador se vuelva más lento.

Representar documentos PDF

GitHub admite la representación de documentos PDF.

Documento PDF representado

Actualmente, se ignoran los enlaces dentro de los PDF.

Representar diferencias en documentos en prosa

Las confirmaciones y solicitudes de incorporación de cambios que incluyen documentos en prosa tienen la capacidad de representar esos documentos con las vistas de origen y representada.

En la vista de origen se muestra el texto sin formato que se ha escrito, mientras que en la vista representada se muestra el aspecto que tendrá cuando se represente en GitHub AE. Por ejemplo, esto podría ser la diferencia entre mostrar **bold** en Markdown y negrita en la vista representada.

La representación de prosa se admite para documentos representados compatibles con github/markup:

  • Markdown
  • AsciiDoc
  • Textile
  • ReStructuredText
  • Rdoc
  • Organización
  • Creole
  • MediaWiki
  • Pod

Icono Paper (Papel) para ver el documento en prosa representado

Puede hacer clic en para ver los cambios realizados en el documento como parte de una confirmación.

Cambios en prosa representados

Inhabilitar la representación del lenguaje de marcado

Cuando ves un archivo de lenguaje de marcado, puedes hacer clic en el en la parte superior de este para inhabilitar la representación de lenguaje de marcado y ver en su lugar el código fuente del archivo.

Mostrar el lenguaje de marcado como código fuente

El inhabilitar la interpretación de lenguaje de marcado te permite utilizar las características de vista de código fuente, tales como el enlazado de líneas, el cual no es posible cuando se está viendo un archivo interpretado en lenguaje de marcado.

Ver los cambios del atributo

Proporcionamos una información sobre herramientas que describe los cambios en los atributos que, a diferencia de las palabras, no serían visibles en el documento representado. Por ejemplo, si la URL de un vínculo cambia de un sitio web a otro, se mostraría una información para herramientas como la siguiente:

Cambios en atributos de la prosa representados

Comentar cambios

Los comentarios de confirmación solo se pueden agregar a los archivos en la vista de origen, por cada línea.

Vincular a encabezados

Como sucede con otros documentos de prosa representados, al mantener el puntero sobre un encabezado del documento se crea un icono de vínculo. Puede vincular a los lectores de la diferencia de prosa representada a secciones específicas.

Ver diferencias complejas

Algunas solicitudes de extracción incluyen una gran cantidad de cambios con documentos grandes y complejos. Cuando los cambios toman demasiado tiempo en su análisis, GitHub AE no siempre puede producir una vista renderizada de los cambios. Si esto pasa, verás un mensaje de error cuando das clic en el botón renderizado.

Mensaje cuando la vista no se puede renderizar

Aún puedes utilizar la vista de origen para analizar y comentar cambios.

Ver elementos HTML

No admitimos directamente vistas representadas de confirmaciones en documentos HTML. Algunos formatos, como Markdown, te permiten insertar HTML arbitrarios en un documento. Cuando estos documentos se muestran en GitHub AE, algunos de esos HTML insertados pueden aparecer en una vista previa, mientras que con otros no es posible hacerlo (como un video de YouTube insertado).

En general, las vistas representadas de los cambios en un documento que contiene HTML insertados mostrarán los cambios en los elementos que se admiten en la vista del documento de GitHub AE. Los cambios en los documentos que contienen HTML insertados siempre se deben verificar en las vistas de origen y representada para corroborar que estén todos.

Mapeo de archivos de GeoJSON o TopoJSON en GitHub

GitHub AE admite representar archivos de mapa GeoJSON y TopoJSON en repositorios de GitHub AE. Simplemente confirme el archivo como lo haría normalmente con una extensión .geojson o .topojson. También se admiten los archivos con una extensión .json, pero solo si type se establece en FeatureCollection, GeometryCollection o topology. Después, navega hasta la ruta del archivo GeoJSON o TopoJSON en GitHub.com.

Cuando haces clic en el ícono de papel a la derecha, también verás los cambios realizados a ese archivo como parte de una confirmación de cambios.

Captura de pantalla de conmutación de representación de fuente

Tipos de geometría

Los mapas de GitHub AE usan Leaflet.js y admiten todos los tipos de geometría descritos en la especificación geoJSON (Point, LineString, Polygon, MultiPoint, MultiLineString, MultiPolygon y GeometryCollection). Los archivos TopoJSON deben ser de tipo "Topología" y cumplir con la especificación TopoJSON.

Características de estilo

Puedes personalizar la manera en que se muestran las características, como especificar un color particular o agregar un icono descriptivo, al pasar metadatos adicionales dentro de las propiedades del objeto GeoJSON. Las opciones son:

  • marker-size - small, medium o large
  • marker-color: color hexadecimal RGB válido
  • marker-symbol: identificador de icono del proyecto Maki o un único carácter alfanumérico (a-z o 0-9).
  • stroke: color de un borde o línea poligonal (RGB)
  • stroke-opacity: opacidad de un borde o línea de polígono (0,0 - 1,0)
  • stroke-width: ancho de un borde o línea poligonal
  • fill: color del interior de un polígono (GRB)
  • fill-opacity: opacidad del interior de un polígono (0,0-1,0)

Vea la versión 1.1.0 de la especificación open simplestyle para más información.

Incrustrar tu mapa en otro lugar

¿Quieres hacer disponible tu mapa GeoJSON en un lugar distinto a GitHub AE? Simplemente modifica esta plantilla y colócala en cualquier página HTML que admita JavaScript (por ejemplo, GitHub Pages):

<script src="https://embed.github.com/view/geojson/<username>/<repo>/<ref>/<path_to_file>"></script>

Por ejemplo, si la dirección URL del mapa es github.com/benbalter/dc-wifi-social/blob/master/bars.geojson, el código para insertar sería el siguiente:

<script src="https://embed.github.com/view/geojson/benbalter/dc-wifi-social/master/bars.geojson"></script>

De manera predeterminada, el mapa insertado tiene 420 x 620 píxeles, pero puede personalizar la salida si pasa variables de alto y ancho como parámetros al final, por ejemplo, ?height=300&width=500.

Nota: ref puede ser una rama o el hash de una confirmación individual (como 2391ae).

Agrupación en clústeres

Si tu mapa contiende una gran cantidad de marcadores (aproximadamente más de 750), GitHub automáticamente agrupará marcadores cercanos en niveles superiores de zoom. Simplemente haz clic la agrupación o el zoom de acercamiento para ver los marcadores individuales.

Algo sucede con el mapa subyacente

Los datos de mapa subyacentes (nombres de calle, carreteras, etc.) se basan en OpenStreetMap, un proyecto de colaboración para crear un mapa del mundo editable y gratuito. Si observa que algo no es correcto, al tratarse de código abierto, simplemente regístrese y envíe una corrección.

Solución de problemas

Si tienes problemas para representar archivos GeoJSON, asegúrate de que tienes un archivo GeoJSON válido ejecutándolo con un linter de GeoJSON. Si los puntos no aparecen donde se espera (por ejemplo, en la mitad del océano), es probable que los datos estén en una proyección que actualmente no se admite. Actualmente, GitHub AE solo admite la proyección urn:ogc:def:crs:OGC:1.3:CRS84.

Por otra parte, si el archivo .geojson es especialmente grande (más de 10 MB), no es posible representarlo en el explorador. Si ese es el caso, por lo general verás un mensaje similar a este:

Archivo de gran tamaño

Todavía puede representar los datos si convierte el archivo .geojsona TopoJSON, un formato de compresión que, en algunos casos, puede reducir el tamaño de los archivos hasta un 80 %. Por supuesto, siempre puedes partir el archivo en fragmentos más pequeños (como por estado o por año), y almacenar los datos como archivos múltiples dentro del repositorio.

Información adicional

Trabajar con arhivos de Jupyter Notebook en GitHub

Al agregar archivos de cuaderno de Jupyter Notebook o IPython con una extensión .ipynb en your enterprise, se representarán como archivos HTML estáticos en el repositorio.

Las funciones interactivas de cuaderno, como los trazados personalizados de JavaScript, no funcionarán en tu repositorio en your enterprise. Para obtener un ejemplo, vea Vinculación e interacciones.ipynb.

Para ver el cuaderno de Jupyter Notebook con contenido de JavaScript representado o para compartir los archivos de cuaderno con otros usuarios, puede usar nbviewer. Para obtener un ejemplo, vea Vinculación e interacciones.ipynb representados en nbviewer.

Para ver una versión completamente interactiva de tu notebook Jupyter, puedes configurar un servidor notebook de manera local. Para más información, vea la documentación oficial de Jupyter.

Solución de problemas

Si tiene problemas para representar archivos de Jupyter Notebook en HTML estático, puede convertir el archivo localmente en la línea de comandos mediante el comando nbconvert:

$ jupyter nbconvert --to html NOTEBOOK-NAME.ipynb

Información adicional