Skip to content
This repository has been archived by the owner on Jul 11, 2023. It is now read-only.

Latest commit

 

History

History
130 lines (86 loc) · 7.7 KB

README_es.md

File metadata and controls

130 lines (86 loc) · 7.7 KB

Ejemplos de los paquetes de datos

goodtables.io

English | Español

Este repositorio contiene ejemplos de los paquetes de datos para ayudarte a aprender sobre el Frictionless Data. Un ejemplo de los contenido de los paquetes:

  • ilustraciones sobre los paquetes actuales con Frictionless Data Especificaciones
  • ayuda sobre Frictionless Data Guías
  • demostraciones de Frictionless Data Formas - formas para resolver problemas comunes que (aún) no están en las especificaciones

Las guías son una excelente forma de empezar a aprender. Otra forma sería abriendo el directorio de los paquetes de datos, vea los README.md, luego vea el datapackage.json para entender el contenido.

Paquete de Datos

El datapackage.json describirá el contenido del paquete como un todo, y describe uno o más recurso del contenido (cada uno puede que tenga su esquema o su visualizacion).

Si todo el contenido es tabular (es decir archivos CSV), entonces será describido como un paquete de datos tabular con uno o más recursos de contenido tabular todos con su tabla de esquemas y, de ser necesario, un CSV dialect.

Existen otras especialidades en los perfiles que describen los diferentes tipos de contenido, tales como contenido fiscal.

Todos los paquetes de datos son almacenados en su propio directorio:

|- data-package-name-1
   |- README.md
   |- datapackage.json
   |- data
      |- data.csv
      |- ...

Este contiene:

  • README.md que explique de donde proviene el contenido
  • datapackage.json un archivo legible que explique la estructura y el significado del contenido
  • uno o más archivos, que normalmente son agrupados en un directorio de data

El paquete de datos puede que tambien contenga otros archivos o subdirectorios. Estos archivos pueden ser scripts utilizados para preparar el paquete de datos o otros recursos relacionados.

Aprobación

Aprobación del Repositorio

Con cada ajuste al repositorio, el paquete de datos será aprobado utilizando goodtables.io. El resultado de la aprobación del paquete de datos se especifica en goodtables.yml son indicados con una insignia: goodtables.io

Idealmente se otorgará una insignia por cada paquete de datos y será visible en su archivo README.md pero esto aún no es posible. (Vealo en goodtables.io issue #285)

La aprobación es controlada por el archivo goodtables.yaml. Este debe ser configurado para que valide cada contenido de los paquetes en el repositorio. Esto podrá ser cambiado si trabaja localmente para validar el contenido de un paquete en especifico.

Validación Local

Queremos implementar la validación local para que los paquetes puedan ser validados antes de ser contribuidos en este repositorio.

Comprimir el paquete de datos

Con cada ajuste al repositorio, el directorio con el paquete de datos será convertido en un archivo .zip para que pueda ser usado con un software que ejecute el Frictionless Data tal como el Curador de Contenido o la libreria de DataPackage.js. Los paquetes de datos comprimidos son almacenados en el directorio zip.

Mientras que no se haya finalizado la compresión del paquete de datos un numero de Software de Frictionless Data implementaciones compatibles al archivo zip comprimido.

Para esto: es necesario script

Formateo de JSON

Con cada ajuste, el archivo datapackage.json será formateado para ser más fácil de leer. Aunque este formateo no sea necesario en programas de computador, Te hace más fácil para ver el contenido del archivo.

Para esto: es necesario script (o linting)

Recursos

Los recursos del directorio contienen la planilla README.md y fragmentos de datapackage.json.

Planilla README.md

En este repositorio, cada contenido de paquete debe tener un README.md. El README.md debe tener buena legibilidad.

Fragmentos de datapackage.json

Los fragmentos de JSON proveen un archivo datapackage.json para ayudarte a aprender sobre una propiedad especifica o a copiar y pegar en tu propio contenido del paquete P.ej. licenses.json puede incluir un JSON para cada recomendación de Open Definition conforme a su licencia.

Estructura del Repositorio

|
|- data-package-name-1
|  |- README.md
|   |- datapackage.json
|   |- data
|     |- data.csv
|     |- data.geojson
|     |- ...
|     
|- data-package-name-2
|  |- etc.
|
|- resources
|  |- README-template.md
|  |- licenses.json
|  |- contributors.json
|  |- dialect.json
|  |- ...
|
|- zip
|  |- data-package-name-1.zip
|  |- data-package-name-2.zip
|
|
|- goodtables.yaml
|- README.md

Contribución

Apreciamos todo tipo de colaboración:

Agradecemos nuestros generosos colaboradores de este proyecto.

Para unirse, Porfavor leer el CONTRIBUTING.md para los detalles sobre nuestro código de conducta y como solicitar un pull request. Cada contenido del paquete contribuido deberá tener una licencia abierta.

Licencias

El contenido de paquetes en este proyecto será licenciado como se especifique en cada archivo datapackage.json. Si no se especifica una licencia, se proveerá bajo un CC0 1.0 Universal dominio público.

El código de este proyecto, a menos que se indique lo contrario, tendrá la licencia que se describe en LICENSE.md.