Primeros Pasos Interfaz Proyectos Codificación Funciones Pro

1. PRIMEROS PASOS

1.1. Introducción a BCode Pro

BCode Pro no es solo un editor de código; es un entorno de desarrollo integrado (IDE) que vive en tu navegador. Ha sido diseñado para ofrecer la potencia y flexibilidad de herramientas de escritorio como VS Code, pero con la accesibilidad y las ventajas de la nube.

Nuestra filosofía es simple: un flujo de trabajo rápido, integrado y sin fricciones. Olvídate de instalaciones complejas y configuraciones de entorno. Con BCode Pro, puedes empezar a codificar en segundos, sincronizar tu trabajo a través de Firebase, colaborar usando GitHub y potenciar tu creatividad con un asistente de IA.

Esta guía te convertirá en un experto de BCode Pro.

Nota: BCode Pro funciona completamente en tu navegador, no requiere instalación y se ejecuta en cualquier dispositivo con conexión a Internet.

1.2. Registro e Inicio de Sesión

Para desbloquear todo el potencial de BCode Pro, como la sincronización en la nube y las funciones Pro, necesitas una cuenta.

Paso a Paso para Crear una Cuenta:

  1. 1 Localiza el Icono de Acceso: En la esquina superior derecha de la interfaz, encontrarás un icono de "Iniciar Sesión". Haz clic en él.
  2. 2 Selecciona "Registrarse": Se abrirá una ventana modal con dos pestañas. Asegúrate de estar en la pestaña "Registrarse".
  3. 3 Ingresa tus Datos: Proporciona una dirección de correo válida y una contraseña segura de al menos 6 caracteres.
  4. 4 Finaliza el Registro: Haz clic en el botón "Registrarse". Tu cuenta se creará instantáneamente.

Paso a Paso para Iniciar Sesión:

  1. 1 Abre el Modal de Acceso: Haz clic en el icono de "Iniciar Sesión".
  2. 2 Ingresa tus Credenciales: Introduce el correo y la contraseña con los que te registraste.
  3. 3 Sincronización Automática: Al iniciar sesión, BCode Pro buscará tu estado de trabajo guardado en Firebase y cargará automáticamente tus proyectos, archivos y configuraciones personalizadas.

Nota de Seguridad Importante: Para mantener la integridad del servicio y prevenir abusos, nuestro sistema limita la creación de cuentas a una por red o dispositivo. Si encuentras problemas al registrarte, asegúrate de no estar conectado a través de una VPN.

2. ENTENDIENDO LA INTERFAZ DE USUARIO

2.1. El Explorador de Archivos

Ubicado en la barra lateral izquierda, es tu centro de control para todos tus proyectos.

Acciones Principales (en la cabecera del explorador):

Nueva Carpeta Principal

Crea una carpeta de proyecto en el nivel más alto (raíz). Es el punto de partida para cualquier proyecto nuevo.

Importar

Te permite seleccionar una carpeta de tu computadora y subirla completamente al editor.

Exportar

Te permite seleccionar una de tus carpetas de proyecto y descargarla a tu computadora como un archivo .zip comprimido.

Acciones de Carpeta y Archivo (contextuales):

Al pasar el cursor sobre una carpeta o archivo en el explorador, aparecerán pequeños iconos de acción a la derecha:

Nueva Subcarpeta

(Solo en carpetas) Añade una nueva carpeta DENTRO de la carpeta sobre la que tienes el cursor.

Nuevo Archivo

(Solo en carpetas) Crea un nuevo archivo DENTRO de la carpeta sobre la que tienes el cursor.

Renombrar

Cambia el nombre del archivo o carpeta seleccionado.

Eliminar

Borrar permanentemente el archivo o carpeta. ¡Esta acción es irreversible!

2.2. El Área de Edición y las Pestañas

El espacio central es donde escribirás tu código. Usamos el motor de Monaco Editor, el corazón de Visual Studio Code, lo que te da acceso a una experiencia de edición profesional.

Pestañas de Archivos

Cada archivo que abres se muestra en una pestaña en la parte superior. Esto te permite saltar entre archivos abiertos con un solo clic.

Indicador de Cambios

Si modificas un archivo y no lo has guardado, el nombre en la pestaña aparecerá en cursiva y con un color ámbar.

Cerrar Pestañas

Puedes cerrar una pestaña individualmente con el icono x o cerrar todas las pestañas a la vez con el botón correspondiente.

2.3. El Panel Inferior (Terminal y Consola)

Este panel, que puedes mostrar u ocultar con el botón correspondiente de la barra de acciones, es crucial para la depuración y ejecución.

Pestaña "Terminal"

Aquí verás la salida de tus scripts de Python. Si tu script imprime algo (print()) o pide datos (input()), todo ocurrirá aquí.

Pestaña "Consola"

Esta pestaña captura todos los mensajes de la consola de JavaScript (console.log, console.error, etc.) y los errores que ocurran durante la ejecución.

Pestaña "Problemas"

(Próximamente) Esta pestaña se integrará con herramientas de análisis de código (linters) para mostrarte errores de sintaxis y malas prácticas.

2.4. La Barra de Acciones Rápidas y Accesos

Esta columna de botones flotantes a la derecha te da acceso con un solo clic a las funciones más importantes.

Ejecutar/Previsualizar

Guarda todos tus cambios y abre la vista previa de tu proyecto web.

Ejecutar Python

Este botón reemplaza al de previsualización cuando tienes un archivo .py activo. Ejecuta tu script de Python.

Abrir/Cerrar Panel

Muestra u oculta el panel inferior.

Asistente de IA

Abre el panel de chat con BCode AI, tu asistente de codificación.

Accesos Rápidos

Abre un panel lateral con un selector de color y botones para insertar rápidamente caracteres comunes como `{}`, `[]`, `()`, etc.

3. GESTIÓN DE PROYECTOS: DE CERO A EXPERTO

3.1. Entendiendo la Estructura de Proyectos de BCode

Para usar BCode Pro eficazmente, es útil entender cómo gestiona internamente tus datos. Todo se almacena en dos objetos principales de JavaScript:

1. El Objeto projectStructure:

Este objeto es un árbol que representa la jerarquía de tus carpetas y archivos. Cada elemento (nodo) en el árbol tiene esta forma:

{
  name: "nombre_del_archivo_o_carpeta",
  type: "file" | "folder",
  path: "ruta/completa/al/elemento",
  children: [ /* Un array de más objetos como este si es una carpeta */ ]
}
  • name: El nombre del elemento (ej. index.html, css).
  • type: Indica si es un "file" o una "folder".
  • path: La ruta única desde la raíz del proyecto (ej. mi-proyecto/css/styles.css).
  • children: Un array que contiene otros nodos, solo presente si type es "folder".

2. El Objeto folderCode:

Este objeto actúa como una base de datos en memoria para el contenido de todos tus archivos. Es un diccionario donde las claves son las rutas de las carpetas, y los valores son otros diccionarios que mapean nombres de archivo a su contenido.

folderCode = {
  "mi-proyecto": {
    "index.html": "<!DOCTYPE html>...",
    "script.js": "console.log('Hola');"
  },
  "mi-proyecto/css": {
    "styles.css": "body { color: red; }"
  }
};

Esta estructura permite un acceso muy rápido al contenido de cualquier archivo sin tener que buscarlo recursivamente en projectStructure cada vez.

3.2. Creación de Carpetas y Archivos (con Plantillas)

Cuando creas un archivo, BCode Pro (a través de modelos.js) genera contenido de plantilla para acelerar tu desarrollo.

Crear una Carpeta Principal

Usa el botón correspondiente en la cabecera del explorador. Esto añade un nuevo objeto de tipo folder al nivel superior de projectStructure.

Crear una Subcarpeta

Usa el icono contextual en una carpeta existente. Esto añade un nuevo objeto de tipo folder al array children de la carpeta padre.

Crear un Archivo

Usa el icono contextual en una carpeta. Esto hace dos cosas: añade un nuevo objeto de tipo file al array children de la carpeta padre en projectStructure y añade una nueva entrada en folderCode con el contenido de la plantilla correspondiente.

Plantillas de Archivos:

Para index.html:
<!DOCTYPE html>
<html lang="es">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Título de la página</title>
</head>
<body>

</body>
</html>
Para styles.css:
/* styles.css */
Para script.js:
// script.js

3.3. Importar y Exportar Proyectos

Importar

Al seleccionar una carpeta de tu PC, BCode Pro lee su estructura y el contenido de cada archivo, y luego reconstruye los objetos projectStructure y folderCode en el editor.

Mantiene la estructura original de carpetas y archivos
Exportar

Al seleccionar una carpeta para exportar, BCode Pro lee la estructura y el contenido de projectStructure y folderCode, los empaqueta usando una librería (JSZip) y te ofrece el archivo .zip para descargar.

Genera un archivo ZIP listo para usar en cualquier entorno

4. FUNCIONALIDADES ESENCIALES DE CODIFICACIÓN

4.1. Edición de Código Avanzada

Autocompletado Inteligente

Mientras escribes, el editor te ofrecerá sugerencias. Para HTML, puedes escribir div y presionar Enter para autocompletar <div></div>. Para Python, puedes escribir def y te sugerirá la estructura completa de una función.

Resaltado de Sintaxis

El editor reconoce automáticamente el lenguaje de programación y aplica el resaltado de sintaxis apropiado, haciendo que tu código sea más legible y fácil de depurar.

Atajos de Teclado Esenciales:

[Ctrl+S] o [Cmd+S] Guardar

Guarda el estado actual de todo tu proyecto en la memoria local o en Firebase si has iniciado sesión.

[Shift+S] Ejecutar

Un atajo de productividad que guarda y ejecuta la previsualización en un solo paso.

[Ctrl+/] o [Cmd+/] Comentar

Comenta o descomenta la línea actual o las líneas seleccionadas con el formato de comentario correcto para el lenguaje del archivo.

[Shift+Alt+F] Formatear

Formatea automáticamente todo el documento para que siga un estilo de código limpio y consistente.

4.2. Previsualización en Vivo (HTML/CSS/JS)

¿Cómo Funciona?

Cuando presionas "Ejecutar", BCode Pro no sube tus archivos a un servidor. En su lugar, realiza un proceso inteligente en el navegador:

  1. 1 Encuentra tu archivo .html principal.
  2. 2 Lee su contenido desde el objeto folderCode.
  3. 3 Analiza el HTML en busca de etiquetas como <link>, <script> e <img>.
  4. 4 Para cada ruta local (ej. href="css/styles.css"), busca el archivo correspondiente dentro de folderCode.
  5. 5 Reemplaza las etiquetas de enlace por el contenido real del archivo CSS dentro de una etiqueta <style>.
  6. 6 Reemplaza las etiquetas de script por el contenido real del archivo JS dentro de una etiqueta <script>.
  7. 7 Convierte las imágenes a formato Base64 y las incrusta directamente en las etiquetas <img>.
  8. 8 Inyecta el HTML procesado en un <iframe> para mostrar el resultado.

Este método es extremadamente rápido y te permite ver tus cambios al instante.

Abrir en Nueva Pestaña: En el modal de Configuración > Editor, activa "Abrir El Resultado En Otra Pestaña". La próxima vez que ejecutes, la vista previa se abrirá en una nueva ventana del navegador, lo que es perfecto si usas dos monitores.

4.3. Ejecución de Código Python

Gracias a la tecnología Pyodide, BCode Pro puede ejecutar Python directamente en tu navegador.

¿Cómo Ejecutar?

  1. 1 Asegúrate de tener un archivo con extensión .py abierto y activo en el editor.
  2. 2 El botón de ejecución principal cambiará al icono de Python.
  3. 3 Haz clic en él. El panel inferior se abrirá, y en la pestaña "Terminal" verás la salida de tu script.

Manejo Interactivo de input():

Si tu script de Python utiliza la función input("Pregunta") para solicitar datos al usuario, BCode Pro lo detectará. Pausará la ejecución y mostrará un campo de texto en la terminal para que puedas escribir tu respuesta. Al presionar Enter, la ejecución continuará con el valor que ingresaste.

Nota sobre Rendimiento: La primera vez que ejecutas un script de Python, BCode Pro necesita descargar el entorno de Pyodide (unos 20 MB). Las ejecuciones posteriores serán casi instantáneas porque el entorno ya estará en la caché de tu navegador.

5. FUNCIONES PRO Y PERSONALIZACIÓN AVANZADA

5.1. Configuración del Editor

Accede al modal de configuración con el icono de engranaje para personalizar tu entorno.

Apariencia y Fondo

Sube una imagen de fondo para tu editor y ajusta la opacidad del color de fondo para que la imagen sea visible. También puedes cambiar la fuente, el tamaño y el interlineado.

Colores y Temas

Elige entre varios temas predefinidos. Si tienes una suscripción Pro, puedes desbloquear los selectores de color para crear tu propio tema, personalizando cada elemento de la sintaxis.

5.2. Mascotas del Editor

¡Dale vida a tu editor! En la pestaña "Mascotas" del modal de configuración, puedes seleccionar hasta 5 compañeros virtuales que te acompañarán mientras codificas.

Estas mascotas caminarán, correrán y descansarán en la parte inferior de tu editor y en la barra de estado, reaccionando a tus acciones y añadiendo un toque divertido a tu sesión de trabajo.

5.3. Integración Total con GitHub

BCode Pro se conecta directamente a GitHub para que puedas gestionar repositorios sin salir del editor.

Cargar un Repositorio
  1. Abre el modal de GitHub.
  2. Introduce la URL en formato usuario/repositorio (ej. AnteroTeobaldo/BCodeProyectos).
  3. Haz clic en "Cargar Repo". El explorador de archivos del modal mostrará el contenido del repositorio.
Subir Proyectos Locales a GitHub
  1. Carga tu repositorio de destino.
  2. En el explorador de archivos principal de BCode, selecciona la carpeta que quieres subir.
  3. En el modal de GitHub, haz clic en el botón "Subir".
  4. Escribe un mensaje de commit (ej. "Subida inicial del proyecto X"). BCode Pro subirá la carpeta completa a tu repositorio.
Guardar Cambios (Hacer un Commit)
  1. Abre un archivo desde el explorador del repositorio de GitHub.
  2. Modifícalo en el editor del modal.
  3. Haz clic en el botón "Guardar".
  4. Escribe un mensaje de commit descriptivo (ej. "Corregido el error en el botón de login").
  5. Tus cambios se guardarán directamente en GitHub.

Importante: Para guardar cambios, necesitas un token de acceso de GitHub con permisos de repo. Debes configurar este token en la configuración del editor.

5.4. Asistente de IA (BCode AI)

Accede al asistente con el botón del robot.

Generación de Código

Pídele que cree componentes. Por ejemplo: "Crea un formulario de contacto con HTML y CSS". La IA te dará el código en pestañas separadas.

Explicación y Depuración

Pega un trozo de código y pregunta: "¿Qué hace este código?" o "Encuentra el error en este bucle".

Inyección Automática (Función Pro): En Configuración > Avanzado, activa esta opción. El código generado por la IA se insertará automáticamente en los archivos correspondientes de tu proyecto, ahorrándote el copiar y pegar.

5.5. Compartir Proyectos con Seguimiento

Desde el modal de GitHub, puedes compartir tus proyectos web con un solo clic.

  1. 1 Carga tu repositorio y abre el archivo .html que deseas mostrar.
  2. 2 Haz clic en el botón "Compartir".
  3. 3 Elige una de las siguientes opciones:
Enlace Público Directo

Obtendrás una URL de htmlpreview.github.io que renderiza tu página al instante.

Acortar Enlace (Pro)

Genera una URL corta y personalizable (ej. bcode.pro/mi-portfolio).

Compartir con Seguimiento (Pro)

Genera un enlace especial que rastrea cuántas personas lo visitan y en qué elementos de tu página hacen clic. Podrás ver estas estadísticas en un dashboard.

6. ECOSISTEMA BCODE

BCode Pro es más que un editor. Ofrecemos herramientas adicionales para complementar tu flujo de trabajo.

6.1. Acortador de URLs (BC-RECORTER)

Integrado en la función de compartir y también disponible como una herramienta independiente, nuestro acortador te permite crear enlaces cortos, limpios y personalizables. Ideal para compartir en redes sociales o para campañas de marketing.

Los usuarios registrados pueden ver estadísticas de clics para cada enlace que crean.

6.2. Generador de Códigos QR

Desde la página del acortador, puedes acceder a nuestro generador de códigos QR. Convierte cualquier URL (larga o acortada) en un código QR escaneable, perfecto para material impreso, presentaciones o para compartir rápidamente a dispositivos móviles.

7. PREGUNTAS FRECUENTES (FAQ)

P: ¿Mi código está seguro?

R: Sí. Si no inicias sesión, tu código se guarda solo en tu navegador. Si inicias sesión, se sincroniza de forma segura con Firebase, una plataforma de Google. Nadie más puede acceder a tu código.

P: ¿Puedo usar BCode Pro sin conexión a internet?

R: Sí. Una vez que la página ha cargado, puedes seguir trabajando sin conexión. Tus cambios se guardarán en el navegador. Cuando te vuelvas a conectar, si has iniciado sesión, los cambios se sincronizarán con la nube.

P: ¿Por qué la ejecución de Python es más lenta la primera vez?

R: La primera vez que ejecutas un script de Python, BCode Pro necesita descargar el entorno de Pyodide (unos 20 MB). Las ejecuciones posteriores serán casi instantáneas porque el entorno ya estará en la caché de tu navegador.

P: ¿Qué pasa si cierro el navegador sin guardar?

R: BCode Pro tiene una función de autoguardado que se activa cada pocos segundos. Es muy probable que tu trabajo más reciente ya esté guardado, ya sea localmente o en la nube.