Instructivo de Programadores de Adas

1. PROYECTO CANAIMA EDUCATIVO
INSTRUCTIVO DE PROGRAMADORES
PARA LA ELABORACION DE ACTIVIDAD DIGITALIZADAS PARA LOS
APRENDIZAJES
DGC/PCE/MV/coordinacióntécnica

2. Introducción
La finalidad de este instructivo es proporcionar en los programadores que laboran para
el Proyecto Canaima Educativo la estructura y consideraciones que deben tener las
carpetas y archivos a la hora de elaborar un contenido educativo o para su adecuación.
Sin embargo también muestra a través de ejemplos la estructura que se debe tener al
trabajar en páginas de Lenguaje de Marcas de Hipertexto (HTML), hojas de estilos en
cascadas (CSS) y javascript (js).
Se plantean para la elaboración de contenidos trabajar bajo las políticas de software
libre GNU/Linux, fomentar la investigación y el desarrollo del mismo, para ello se toma
como referencia a:
LEY DE INFOGOBIERNO publicada en la Gaceta Oficial de la República Bolivariana de
Venezuela N° 40.274 el 17 de octubre de 2013.
• Artículo 1: “…promover el desarrollo de las tecnologías de información libres en
el Estado; garantizar la independencia tecnológica; la apropiación social del
conocimiento; así como la seguridad y defensa de la Nación”.
• Artículo 3: en su numerales 3 y 5:
◦ Universalizar el acceso de las personas a las tecnologías de información
libres y garantizar su apropiación para beneficio de la sociedad.
◦ Promover el empoderamiento del Poder Popular a través de la generación de
medios de participación y organización de las personas, haciendo uso de las
tecnologías de información.
• Y demás artículos de la Ley que entró en vigencia derogando el decreto presi-
dencia 3390 del 2004.
Objetivo: Especificar la estructura de carpetas y archivos para la creación o adecua-
ción de las Actividades Digitalizadas para los Aprendizajes.
DGC/PCE/MV/coordinacióntécnica

3. Definición de Actividad Digitalizada para los Aprendizajes (ADA): Recurso para
el aprendizaje con formato digital que permite pedagógicamente y de manera
dinámica, mostrar aspectos de las áreas de aprendizaje que refuerzan los
conocimientos, saberes y destrezas de las y los estudiantes de Educación Primaria, los
contenidos se presentan con distintos niveles de complejidad a través de conceptos,
actividades lúdicas, lecturas, preguntas generadoras, validaciones, entre otras,
incorporándose en ellas audios y videos referentes al contenido de la misma.
Consideraciones para adecuar un contenido educativo:
1) El presente instructivo suprime deliberadamente las tilde en las palabras
referidas a los nombres de carpetas y documentos debido que las mismas
deben estar escritas sin acentos, mayúsculas, espacios en blanco, números, ni
ningún tipo de carácter especial ( ñ,/,_ ).
2) Solo deben existir las carpetas que se necesitan para la realización de la
Actividades Digitalizados para los Aprendizajes.
3) Los nombres de las carpetas no deben poseer acentos, mayúsculas, espacios en
blanco, números, ni ningún tipo de carácter especial ( ñ,/,_ ).
4) Los nombres de las páginas creadas en html, js y css no deben poseer acentos,
mayúsculas, espacios en blanco, números, ni ningún tipo de carácter especial
( ñ,/,_ ).
5) Los nombres de las imágenes no deben poseer acentos, mayúsculas, espacios
en blanco, números, ni ningún tipo de carácter especial ( ñ,/,_ ).
6) No cablear las rutas para llamar imágenes o archivos.
Ejemplo: ,,/actividades-en-los-espacios-libres/imagenes/png/pantallazo.png
Utilizar rutas relativas:
Ejemplo: ../imagenes/png/pantallazo.png
DGC/PCE/MV/coordinacióntécnica

4. Consideraciones generales para los archivos en HTML, JS y CSS.
1) Solo deben existir páginas en html, js y css que se estén utilizando en el
contenido educativo.
2) Todas las páginas de html deben tener la etiqueta <title>Nombre del
contenido educativo</title>, bien sean actividades, orientaciones,
sugerencias, cuento, libro, entre otros.
3) Debe ser un código limpio sin basura, es decir, sin funciones o llamados a ima-
genes que no se estén realizando en el contenido educativo.
4) Se debe comentar el código, para saber que hace en cada paso y así de realizar-
se algunas adecuaciones en dicho código, se tenga una idea en donde se deben
realizar.
5) Se debe identar las líneas del código, para una visualización óptima y entendi-
ble.
6) Solo deben poseer llamados a JS o CSS que hagan interacción con el contenido
educativo en las paginas de HTML.
DGC/PCE/MV/coordinacióntécnica

5. Diagrama de carpetas para las ADAs:
DGC/PCE/MV/coordinacióntécnica

6. a) Nombre del contenido educativo: dicho nombre deberá estar en minúscula
y con guión normal, esta carpeta contendrá las sub-carpetas que se necesitan
en el contenido educativo.
Carpeta principal del contenido educativo
b) Carpetas internas: solo debe llevar las carpetas que se estén empleando en
el contenido educativo.
Sub-carpetas del contenido educativo
c) Carpeta actividades: aquí se ubicarán las páginas que contienen las activida-
des que se visualizarán en el recurso, las cuales pueden elaborarse en un editor
de texto y guardarse con la extensión (.html).
Carpeta actividades
Archivos de la carpeta actividades
DGC/PCE/MV/coordinacióntécnica

7. d) Carpeta audio: esta carpeta solo estará presente si existe un audio que se uti-
lizará en el contenido educativo, el formato para los audios solo debe ser ogg
que es una extensión libre.
Carpeta audio
Archivos de la carpeta audio
e) Carpeta guiones: esta carpeta contendrá la caracterización, guión de audio de
ser necesario y el guión pedagógico, dichos documentos solo pueden estar en
formato odt.
Carpeta guiones
Sub-carpetas de guiones
• caracterizacion: consta de dos partes, la primera muestra la primera pantalla
del contenido educativo con su título y la segunda parte suministra la informa-
ción en relación a la creación de las ADAs. (ver carpeta anexos)
DGC/PCE/MV/coordinacióntécnica

8. • guion-audio: el técnico en programación lo construye si en el ADA aparecen
diálogos, allí se debe especificar los botones y los diálogos que se muestran en
el ADA. (ver carpeta anexos)
• guion-pedagogico: dicho archivo detalla el contenido de cada pantalla, boto-
nes e interacciones, actividades y posee sugerencias en cuanto a la elaboración
de diseño gráfico. (ver carpeta anexos)
f) Carpeta imagenes: esta carpeta posee las imágenes que se van a incluir en el
contenido educativo y los editables, bien sean en gráficos vectoriales redimen-
sionables (svg) o archivos de imagen rasterizada asociados con GIMP (xcf).
Carpetas imagenes
Sub-carpetas de imagenes
• png: formato gráfico basado en un algoritmo de compresión sin pérdida para
imagen en mapa de bits no sujeto a patentes, estas son las imágenes que serán
utilizadas en el desarrollo del contenido educativo, las cuales al ser exportadas
no deben poseer caracteres especiales, guión bajo, acentos o numeración al
principio del nombre, solo deben ser exportadas en formato png.
Carpeta png
DGC/PCE/MV/coordinacióntécnica

9. Archivos de la carpeta png
• svg: editables de los diseños que se han elaborado para un determinado conte-
nido educativo, estos deben estar en la carpeta svg, dado que se pueden nece-
sitar para la adecuación de alguna imagen o texto que posea el contenido edu-
cativo.
Carpeta svg
Archivos de la carpeta svg
• xcf: es el formato nativo de Gimp, esta carpeta contendrá los editables de las
imágenes reales que se han desarrollado para el contenido educativo.
Carpeta xcf
DGC/PCE/MV/coordinacióntécnica

10. Archivos de la carpeta xcf
g) Carpeta paginas: son archivos con extensión Lenguaje de Marcas de Hipertex-
to (html), aquí se ubican las páginas en donde se presentará el contenido, las
cuales serán elaboradas en un editor de texto y guardado con la extensión
(.html).
Carpeta paginas
Archivos de la carpeta pagina
h) Carpeta presentacion: en esta carpeta se ubica la primera página de html
que se realiza para la presentación del tema a tratar, el único nombre para
guardar el archivo es index y es elaborada en un editor de texto, se guarda con
la extensión (.html).
Carpeta presentacion
DGC/PCE/MV/coordinacióntécnica

11. Archivo de la carpeta presentacion
Estructura del código para todas las paginas de HTML
DGC/PCE/MV/coordinacióntécnica

12. i) Carpeta script: esta carpeta contiene los JavaScript (js) y Hoja de estilo en
cascada (css), que permitirán la interactividad del recurso y el estilo que se le
pueden dar a las páginas de html.
Carpeta script
Sub-carpeta de script
• js: carpeta que contendrá todos los archivos que permiten la interactividad del
contenido educativo, los cuales no deben llevar acentos, guiones bajos, carate-
res especiales, o numeración al principio del nombre, estas pueden ser elabora-
das en un editor de texto y guardados con la extensión (.js).
Archivo de la carpeta js
DGC/PCE/MV/coordinacióntécnica

13. Estructura del código para todos los JS
• css: es un lenguaje usado para definir la presentación de un documento estruc-
turado escrito en HTML, los cuales no deben llevar acentos, guiones bajos, ca-
racteres especiales, o numeración al principio del nombre, pueden ser elabora-
dos en un editor de texto y guardadas con la extensión (.css).
Archivo de la carpeta css
DGC/PCE/MV/coordinacióntécnica

14. Estructura del código para los CSS
DGC/PCE/MV/coordinacióntécnica

15. j) Carpeta video: aquí se ubicarán los videos que se incorporaran en el conteni-
do educativo, solo estará presente dicha carpeta si existe algún video.
Carpeta video
Archivo de la carpeta video
Joycé Rosal
Coordinadora Técnica
Proyecto Canaima Educativo
DGC/PCE/MV/coordinacióntécnica