Consolidate docs into one multilingual site (EN + ES)

.gitignore

@@ -4,3 +4,7 @@ site
 Pipfile
 Pipfile.lock
 docs.code-workspace
+
+.venv-ml/
+site/
+.DS_Store

docs/es/device-configuration/configure-ap-mesh.md

@@ -0,0 +1,85 @@
+---
+Title: Configurar AP Mesh
+
+---
+# Configurar AP Mesh
+
+Esta guía lo guiará a través de la configuración de una malla de punto de acceso Ubiquiti para que pueda ser adoptada por la red PCW.
+
+## Hardware requerido
+
+* Unidad de malla AP: [Ubiquiti Mesh Dual-Band Access Point](https://store.ui.com/products/unifi-ac-mesh-ap) (antena Ubiquiti blanca con orejas de conejo)
+* Inyector PoE
+* Cable Ethernet
+* Ordenador
+* Adaptador Ethernet USB (si el ordenador no tiene puerto ethernet)
+* Cable de regleta/alargador
+* Paperclip
+
+![Materials](../assets/images/mesh/Materials.jpeg)
+
+## Pasos de instalación
+
+### Establecer IP estática en el equipo
+
+Instrucciones para Mac (otros sistemas operativos por determinar)
+
+1. Abra `System Preferences` > `Network`.
+2. Seleccione la conexión Ethernet que tiene con la unidad de malla AP. ![Mac Network Settings #1](../assets/images/static-ip/Network_1.png)
+3. Cambie el valor de `Configure IPv4` a `Manually`.
+   ![Mac Network Settings #2](../assets/images/static-ip/Network_2.png)
+4. Establezca la dirección IP en `192.168.1.29` (aunque la mayoría de los valores deberían funcionar aquí).
+5. Establezca la máscara de subred a `255.255.255.0`
+   ![Mac Network Settings #3](../assets/images/static-ip/Network_3.png)
+6. Haga clic en `Apply`
+
+### Conecte la unidad de malla AP.
+
+1. Conecte el inyector PoE a una toma de corriente o a una regleta.
+2. Conecte el puerto `POE` del inyector a la unidad de malla AP con un cable ethernet.
+3. Conecte el puerto `LAN` del inyector al ordenador, utilizando el adaptador Ethernet USB si no dispone de un puerto Ethernet.
+   ![Ports](../assets/images/mesh/Ports.jpeg)
+   ![Wiring](../assets/images/mesh/Wiring.jpeg)
+
+### Restablecimiento de fábrica de la unidad de malla AP.
+
+Las unidades de malla AP han tenido un comportamiento inesperado incluso fuera de la caja, por lo que se recomienda reiniciarlas de fábrica antes de continuar.
+
+1. Con el clip, pulse el botón de restablecimiento situado en la parte inferior de la unidad de malla AP hasta que haga clic.![Reset Button](../assets/images/mesh/Reset.jpeg)
+2. Mantenga pulsado durante 15 segundos.
+3. Una vez que la luz de estado de la unidad de malla AP ha destellado y se ha apagado, el dispositivo se ha restablecido.
+
+### Conecte a la unidad de malla AP.
+
+1. Abra un símbolo del sistema
+2. Si se ha conectado previamente a una unidad de malla de AP, tendrá que editar el archivo de `known_hosts` , o obtendrá un error de`Host key verification failed` error.
+   1. Abra `~/.ssh/known_hosts` con `vim`, `nano`, o el editor de texto que desee.
+   2. Elimine la línea que comienza por `192.168.1.20` (tendrá un aspecto similar a `192.168.1.20 ssh-rsa AAAAB3NzaC1yc2E...`), y guarde el archivo.
+3. Ejecute el comando `ssh ubnt@192.168.1.20`
+4. Puede ver la alerta:
+
+       The authenticity of host '192.168.1.20 (192.168.1.20)' can't be established.
+       RSA key fingerprint is SHA256:oUG6ABM3uor6lfBpJFcnHWyhhPnCrIx2Jf0U1+UAg4g.
+       Are you sure you want to continue connecting (yes/no/[fingerprint])?
+
+   Presione sí para continuar.
+5. Cuando se le solicite la contraseña, escriba `ubnt`.
+6. Ahora debe estar conectado a la unidad de malla AP.
+   ![SSH Connection](../assets/images/mesh/SSH.png)
+
+### Adopte AP Mesh Unit
+
+Necesitará acceso al portal Philly Community Wireless HostiFi para completar este paso.
+
+1. De su `ssh` , ejecute el comando `set-inform http://unifi.phillycommunitywireless.org:8080/inform`.
+   * Esto alertará al controlador HostiFi de que la unidad de malla AP desea ser adoptada.
+2. Abra el portal HostiFi en el explorador y desplácese a la lista de dispositivos.
+3. La unidad de malla AP debe aparecer en la lista de dispositivos en espera de adopción.
+4. Pulse `Adopt` para adoptar la unidad de malla AP.
+
+## Solución de problemas
+
+1. Computadora no reconoce la unidad de malla AP en la configuración de red o el comando`ssh` falla.
+   * La unidad de malla AP puede tardar unos minutos en iniciarse después de enchufarla, por lo que espere hasta que la luz de estado se ilumine en blanco y vuelva a intentarlo.
+2. ¿Qué significa este patrón de luces de estado?
+   * [LED Color Patterns for UniFi Devices](https://help.ui.com/hc/en-us/articles/204910134-UniFi-LED-Color-Patterns-for-UniFi-Devices)

docs/es/device-configuration/configure-edgerouter-x.md

@@ -0,0 +1,44 @@
+---
+Title: Configurar ERX Router
+
+---
+# Configurar ERX Router
+
+Esta guía le guiará a través de la configuración de un Ubiquiti EdgeRouter X.
+
+## Hardware requerido
+
+* Router e cable de alimentación
+* Tranque cable
+* Computador
+* Adaptador Ethernet USB (si la computadora no tiene puerto Ethernet)
+
+![Hardware](../assets/images/erx/hardware.jpg)
+
+## Pasos de instalación
+
+### Establecer IP estática en el equipo
+
+Ver [Configurar una IP estática](configure-computer.md)
+
+### Conecte el ERX
+
+1. Conecte el ERX a su cable de alimentación y conecte el cable de alimentación a una toma de corriente.
+2. Conecte el puerto `eth0` del ERX al ordenador con un cable Ethernet, utilizando el adaptador Ethernet USB si no dispone de un puerto Ethernet.
+
+![Ports](../assets/images/erx/wiring.jpeg)
+![Ports](../assets/images/erx/eth0.jpeg)
+
+### Configurar ERX
+
+1. Descargue el [ERX config file](../assets/configs/erx-config.tar.gz)
+2. Navegue al portal en [https://192.168.1.1](https://192.168.1.1) en su navegador.
+3. Regístrese sesión en el portal con nombre de usuario `ubnt`, contraseña `ubnt`.
+   ![Login](../assets/images/erx/login.jpeg)
+4. En el `Use wizard?` , presione no.
+   ![Login](../assets/images/erx/wizard.jpeg)
+5. Presione la pestaña `System` en la parte inferior de la página.
+6. En la sección `Restore Config` , presione `Upload a file` y seleccione el archivo de configuración de ERX que descargó.
+   ![Login](../assets/images/erx/system.jpeg)
+7. El ERX se reiniciará utilizando la nueva configuración.
+8. ¡Eso es todo! Si necesita realizar más configuración, puede volver a iniciar sesión en el portal utilizando el nombre de usuario `pcwadmin`, y una contraseña que puede obtener de los mantenedores del proyecto.

docs/es/index.md

@@ -0,0 +1,32 @@
+---
+
+---
+# **Documentación técnica**
+
+## El proyecto PCW
+**Philly Community Wireless** (PCW) es un proyecto para desarrollar redes de malla de propiedad comunitaria en North Philly. Somos un grupo de trabajo de organizadores, tecnólogos, académicos, maestros de escuelas públicas y personal del Ayuntamiento de Filadelfia. Durante una época de distanciamiento social y enseñanza en línea, aproximadamente la mitad de los estudiantes de las escuelas públicas de la ciudad carecen de conexión wifi en casa. En ciertos vecindarios, aún más residentes carecen de conexión a Internet. Buscamos abordar la brecha digital de **la ciudad con tecnologías de red de malla operadas y propiedad de la comunidad.**
+
+Las redes de malla permiten compartir una única conexión a Internet entre un grupo más amplio de usuarios con muy poco coste o infraestructura necesaria. Con la ayuda de **PhillyWisper**, un proveedor de servicios de Internet inalámbrico, pro-neutral, estamos trabajando para instalar dos sitios piloto en **Kensington y Fairhill**. A partir de ahí, planearemos talleres de diseño participativo y capacitación técnica para la comunidad que los capacitará para mantener y hacer crecer esta conexión de red gratuita.
+
+## Los documentos de PCW
+Esta página de documentos proporciona información técnica en desarrollo y guías para replicar la configuración y distribución del proyecto de routers y antenas para construir una red de malla.
+
+Si está buscando una **descripción no técnica del proyecto** o está interesado en suscribirse a la cobertura de PCW, visite nuestra [homepage](https://phillycommunitywireless.org).
+
+### [Recursos Académicos](resources.md)
+Esta página describe recursos secundarios sobre los problemas del acceso de banda ancha y la inequidad digital en ciudades urbanas como Philadelphia.
+
+### [Hardware requerido](installations/hardware.md)
+Visión general del hardware necesario para la infraestructura del proyecto PCW.
+
+### [Instalaciones de antenas](installations/installations.md)
+Esta guía describe el proceso de instalación de antenas en la azotea como base para la red de malla inalámbrica y el wifi público gratuito.
+
+### [Configurar enrutadores ERX](device-configuration/configure-edgerouter-x.md)
+La página Configurar enrutadores ERX explica la fase de configuración de los hosts de enrutador de las instalaciones en tejados.
+
+### IP estática
+Esta guía describe cómo configurar el ordenador con una IP estática, de modo que pueda configurar el router y el kit de malla.
+
+### [Configurar AP-Mesh](device-configuration/configure-ap-mesh.md)
+Esta guía describe la configuración de un kit de malla que se puede instalar en cualquier hogar muy cerca (medio bloque de vecindario) de un host de antena en la azotea.

docs/es/installations/hardware.md

@@ -0,0 +1,32 @@
+---
+Title: Hardware
+
+---
+# Hardware requerido
+
+## Kit de malla
+
+* [Ubiquiti Mesh Dual-Band Access Point](https://store.ui.com/products/unifi-ac-mesh-ap)
+
+## Instalación de antena en la azotea
+
+* [airMAX LiteBeam AC 5 GHz Bridge](https://store.ui.com/collections/wireless/products/litebeam-5ac-gen2)
+* [Ubiquiti EdgeRouter ERX](https://dl.ui.com/qsg/ER-X/ER-X_EN.html)
+* [Ubiquiti Mesh Dual-Band Access Point](https://store.ui.com/products/unifi-ac-mesh-ap)
+
+## Antenas adicionales
+
+* [Ubiquiti Directional Dual-Band Antenna](https://store.ui.com/collections/operator-airmax-and-ltu-antennas/products/directional-dual-band-antenna-for-uap-ac-m)
+
+### Routers alternativos
+
+* [MikroTik hEX PoE](https://www.doubleradius.com/mikrotik-hex-poe-rb960pgs)
+
+## Accesorios
+
+* [Ethernet Cables 3'](https://www.newegg.com/Product/ComboDealDetails?ItemList=Combo.4307102&quicklink=true)
+* [6-outlet power strip](https://www.newegg.com/apc-pe63-nema-5-15r/p/1B4-0052-000C2?Description=power%20strip&cm_re=power_strip-_-1B4-0052-000C2-_-Product&quicklink=true)
+* [Extension cords](https://www.newegg.com/black-monoprice-6-00-ft-others/p/0N6-01B8-002D6)
+* [PoE Injector/Splitter](https://www.newegg.com/p/2WG-00DK-00004)
+* [Ethernet to Ethernet adapter](https://www.newegg.com/p/0Y3-02J6-00001)
+* [USB Type C to Ethernet adapter](https://www.ebay.com/itm/132225990432?epid=910384900&hash=item1ec9487f20:g:FhgAAOSwqiVdyN)

docs/es/installations/installations.md

@@ -0,0 +1,78 @@
+---
+Title: Instalación de antenas
+
+---
+# Instalación de antenas
+
+Philly Community Wireless se ha asociado con PhillyWisper para instalar antenas para la red wifi gratuita en los tejados del barrio de Norris Square Park. PhillyWisper es un proveedor de servicios de Internet inalámbrico (WISP), lo que significa que nuestro proyecto ofrece Internet a nuestros clientes a través de la tecnología de radio.
+
+## Proceso de instalación en la azotea
+
+La mayoría de las instalaciones se realizaron en el siguiente orden:
+
+1. Examine el edificio y la azotea para evaluar la línea de visión (LOV) de la torre de origen de la ubicación alta para la señal de banda ancha.
+2. Instale la antena en la azotea y conecte el cable al edificio.
+3. Configure el router wifi y los kits de malla (para obtener más información, consulte nuestra guía [Configurar AP-Mesh](../device-configuration/configure-ap-mesh.md) y nuestra guía [Configurar enrutadores ERX](../device-configuration/configure-edgerouter-x.md)).
+4. Es posible que instale una antena montada en la pared para propagar la señal por la calle.
+
+## Duración de las instalaciones de antenas
+
+Normalmente, las instalaciones tardan entre dos y cuatro horas en completarse, pero en algunos casos pueden tardar más. El proceso de instalación completo, desde una antena en el techo hasta un kit de malla montado en la pared, puede implicar 2-3 visitas, cada una de las cuales implica una o dos horas de trabajo.
+
+# Hardware para la instalación
+
+Las instalaciones en la azotea constan de una antena en la azotea, un inyector de alimentación a través de Ethernet, un router y un punto de acceso de malla. Philly Community Wireless y PhillyWisper utilizan principalmente radios y equipos de red Ubiquiti. Como cada techo es diferente, la instalación se personaliza para cada ubicación para garantizar la colocación más segura de acuerdo con los estándares del sector.
+
+En general, instalamos una antena Ubiquiti LiteBeam en el techo de la casa, que recibe la señal de una torre PhillyWisper. La antena se conecta al hogar mediante un cable Ethernet. Actualmente, esta parte de la instalación debe ser completada por un técnico de PhillyWisper. Para fines de instalación, esto significa que los técnicos de PhillyWisper tendrán que montar una antena de radio pequeña (aproximadamente 14 x 11 x 11 pulgadas) a la altura del techo y apuntar con precisión a la torre más cercana.
+
+PhillyWisper se esfuerza al máximo por impactar los edificios durante la instalación. Utilizan técnicas no invasivas al montar la radio (consulte las imágenes adjuntas de las distintas técnicas de montaje que aparecen a continuación). Nunca penetran en el sistema de techado mismo y ellos intentan y utilizan estructuras preexistentes (chimeneas, tubos de ventilación, etc) cuando es posible.
+
+Si las estructuras preexistentes no son una opción, utilizarán un soporte de techo no penetrante, que se pesa correctamente y descansa sobre una alfombrilla de goma en la parte superior de su techo. A continuación, aseguran un cable de red estabilizado a los rayos UV para exteriores desde la radio del techo, hacia abajo a lo largo del exterior del edificio y el interior donde se ubicará el router WiFi.
+
+Tanto Philly Community Wireless y PhillyWisper como la de la comunidad Philly garantizan que el recorrido del cable sea lo más discreto posible y garantizan que el cable tenga mucha tensión para que no se solapa con el viento. Si hay alguna penetración preexistente que entra en el edificio de ISP anteriores, utilizarán eso si es posible y calafatearás cuando termine.
+
+## Ejemplos de instalación
+
+### Soportes de techo no penetrantes
+
+Utilizamos soportes de techo no penetrantes (NPRM). Una alfombra de goma gruesa se coloca debajo del NPRM para proteger el techo. Los bloques de cemento se utilizan como lastre para asegurar el NPRM:
+
+![Non-penetrating roof mount 1](../assets/images/install/image1.jpg)
+![Non-penetrating roof mount 2](../assets/images/install/image2.jpg)
+
+### Antenas montadas en la pared
+
+La siguiente imagen muestra dos mástiles montados en la pared con radios, junto con un interruptor exterior y una caja de conexiones.
+
+El mástil de la izquierda tiene una radio Ubiquiti AF-24 que funciona a 24 GHz y proporciona una conexión de retorno de 1,4 Gbps al centro de datos.
+
+![Wall mounted antenna 1](../assets/images/install/image6.jpg)
+![Wall mounted antenna 2](../assets/images/install/image7.jpg)
+![Wall mounted antenna 3](../assets/images/install/image8.jpg)
+![Wall mounted antenna 4](../assets/images/install/image9.jpg)
+
+El mástil de la derecha tiene radios PTMP con antenas de bocina simétricas. Las radios proporcionan servicio a clientes individuales.
+
+El dispositivo blanco cuadrado entre y debajo de los mástiles es un Ubiquiti EP-S16, un conmutador de red para exteriores. Se suministra alimentación de 54 V CC al EP-S16, que a su vez suministra alimentación a las radios mediante POE (alimentación de Ethernet).
+
+# Instalación de kit de malla para hosts de antena en la azotea
+
+Los anfitriones de las instalaciones en la azotea también albergará un router en la casa cerca de la ventana al frente de la casa. En algunos casos podemos instalar una antena montada en la pared en el exterior de la casa para propagar la señal de banda ancha a través del vecindario.
+
+Proporcionamos un kit con un inyector PoE y un AP de malla de orejas de conejo. Philly Community Wireless puede instalar el kit, o el residente puede instalar las orejas de conejo en cualquier lugar dentro de su casa, siempre y cuando otros puntos de acceso de malla estén dentro del alcance de radio (estamos planeando sugerir la entrada de la casa o el porche -- los puntos de acceso son impermeables).
+
+## Descripción general del kit de malla
+
+El cable Ethernet pasa a través de un inyector de alimentación a través de Ethernet (PoE), que añade alimentación a la señal que transporta el cable Ethernet y permite que los dispositivos de bajada se alimenten únicamente a través de Ethernet.
+
+![PoE Injector](../assets/images/install/image4.jpg)
+
+El cable Ethernet alimentado está conectado a un Ubiquiti EdgeRouter-X (o posiblemente a otro router en el futuro) configurado para admitir redes de malla. El router gestiona el tráfico de cada uno de los puntos de acceso (AP) con los que está conectado en malla.
+
+![EdgeRouter-X](../assets/images/install/image5.jpg)
+
+Por último, un Ubiquiti Mesh AP (“orejas de conejito” porque miren a ellos!) está conectado al router y permite que los dispositivos de su rango de señal de radio se conecten a la red. Las orejas de conejito deben instalarse en una ubicación que sea radiovisible para los puntos de acceso de malla en las instalaciones domésticas a su alcance.
+
+![Ubiquiti Mesh AP](../assets/images/install/image3.jpg)
+
+Para obtener más información sobre el kit de malla, consulte nuestra guía [Configurar AP-Mesh](../device-configuration/configure-ap-mesh.md)