Reference-es

Reference-es is the repo for the Language Reference documentation of the Arduino syntax in Spanish. All the Reference terms files are in AsciiDoc format.

Gracias por tomarte el tiempo para contribuir a contenido sobre Arduino, eso es de mucha ayuda para toda la comunidad Arduino.

Editando y Creando Contenido

Si deseas contribuir con nuevo contenido, crea un archivo nuevo (con cualquier editor de texto o codigo) y guardalo con extension .adoc. No uses parentesis o cualquier otro caracter especial en el nombre del archivo. En reference-en/AsciiDoc_sample/AsciiDoc_Dictionary encontraras una descripcion de la sintaxis AsciiDoc. Esto incluye Titulos, Texto, Enlaces, Imagenes, Tablas, Codigo y varios embebidos (video, diapositivas, audio y codigo). Puedes verlo aqui.

Si quieres contribuir a la guia de referencia o editar contenido existente, puedes encontrar dos plantillas en reference-en/AsciiDoc_sample/Reference_Terms:

• Usa AsciiDoc_Template-Single_Entity.adoc (presentado aqui) para terminos como analogWrite.

• Usa AsciiDoc_Template-Parent_Of_Entities.adoc (presentado aqui) para grupos de funciones como Serial.

Por favor toma nota de que cada archivo de referencia deberia incluir al menos una Descripcion, algun Codigo de Ejemplo, y enlaces a otra informacion relevante (seccion Ver Tambien).

Si necesitas adicionar imagenes al Asciidoc por favor crea un folder llamado attachments en el mismo directorio que el archivo Asciidoc . Las imagenes se pueden grabar en los formatos SVG y PNG, tamaño maximo 200KB.

Contribuir Contenido en Github

Si no estas familiarizado con Git puedes contribuir con contenido directamente en GitHub mediante su interfaz online. Creamos un corto tutorial para enseñarte como, REVISALO!

Tambien puedes seguir esta guia (escrita por el equipo de GitHub) para aprender como editar un archivo .adoc y proponer un cambio en el mismo al equipo de Arduino. Cuando sugieras un cambio, por favor sigue los lineamientos descritos en los archivos plantilla de referencia.

Enviar un pull request

Estamos contentos de que desees contribuir a la guia de referencia de Arduino: esa es la mejor manera de ayudar a la comunidad.

Si tu contribucion es adicionar o modificar codigo existente o descripciones completas, por favor siempre refierase a un problema existente o abra uno nuevo antes de contribuir.

Tome nota que sus contribuciones a la guia de Referencia de Arduino estan bajo la licencia Creative Commons Attribution-Share Alike 3.0. vea https://creativecommons.org/licenses/by-sa/3.0/

Estructura de los Directorios

reference-en
├─ AsciiDoc_sample
│   ├── AsciiDoc_Dictionary
│   │   ├── AsciiDoc_Template-Dictionary.adoc
│   │   └── attachments
│   └── Reference_Terms
│       ├── AsciiDoc_Template-Parent_Of_Entities.adoc
│       ├── AsciiDoc_Template-Single_Entity.adoc
│       └── attachments
├── Language
│   ├── Functions
│   ├── Structure
│   └── Variables
├── LICENCE.md
└── README.adoc

Dentro del directorio de Languaje, La estructura sigue la misma estructura que en la Pagina de Referencia de Arduino