Estructura de Directorios y Archivos Clave

El proyecto del editor Python para BBC micro:bit organiza su código en una jerarquía de carpetas que facilita la gestión y el desarrollo. A continuación, se detalla la disposición típica:

PythonEditor/
├── bin/
├── blockly/
├── docs/
├── js/
├── lang/
├── microbit_blocks/
├── micropython/
├── static/
├── tests/
├── .gitignore
├── .gitmodules
├── AUTHORS
├── CHANGELOG
├── CONTRIBUTING.rst
├── LICENSE
├── README.rst
├── azure-pipelines.yml
├── crowdin.yml
├── editor.html
├── help.html
├── tests.html
└── show.sh

Las carpetas y archivos principales incluyen:

• bin/: Contiene scripts de utilidad para el desarrollo.
• blockly/: Integración con Blockly, un entorno de programcaión visual, gestionado como un submódulo Git.
• docs/: Documentación adicional sobre el editor.
• js/: Código JavaScript que impulsa la funcionalidad del editor.
• lang/: Archivos de traducción para la internacionalización.
• microbit_blocks/: Bloques personalizados de MicroPython, también un submódulo Git.
• micropython/: Archivos hexadecimales de MicroPython necesarios para la compilación.
• static/: Recursos estáticos como CSS, JavaScript de terceros e imágenes.
• tests/: Suite de pruebas específicas para el componente Python.

Los archivos de configuración y metadatos, como .gitignore y .gitmodules, facilitan el control de versiones, mientras que azure-pipelines.yml y crowdin.yml automatizan la integración continua y la gestión de traducciones, respectivamente.

Iniciando el Editor en Entorno Local

El archivo editor.html sirve como la interfaz principal del editor, permitiendo a los usuarios escribir y ejecutar código MicroPython. Para arrancar el editor localmente, se proporciona el script show.sh.

Ejecutar el siguiente comando en la terminal lanza un servidor de desarrollo:

./show.sh

Esto hace que el editor esté accesible en el navegador mediante la URL http://localhost:8000/editor.html, facilitando pruebas y desarrollo.

Ajustes de Configuración del Editor

El editor admite configuraciones específicas mediante parámetros en editor.html, como traducciones y flags de características. Un ejemplo de inicialización en JavaScript es el siguiente:

<script>
  var configuracion = {
    traducciones: {
      en: {
        "saludo": "Hello",
        "mundo": "World"
      },
      es: {
        "saludo": "Hola",
        "mundo": "Mundo"
      }
    },
    banderasCaracteristicas: {
      modoOscuro: true,
      guardadoAutomatico: false
    }
  };
</script>

Este bloque define un objeto de configuración con traducciones para múltiples idiomas y flags que controlan funcionalidades como el modo oscuro. Además, otros archivos como CONTRIBUTING.rst y LICENSE (bajo licencia MIT) proporcionan directrices para contribuyentes y detalles legales, asegurando un desarrollo colaborativo estructurado.