Multilingual

Pipfile

@@ -0,0 +1,33 @@
+[[source]]
+url = "https://pypi.org/simple"
+verify_ssl = true
+name = "pypi"
+
+[packages]
+argh = "==0.26.2"
+click = "==8.0.1"
+ghp-import = "==2.0.1"
+importlib-metadata = "==4.6.1"
+jinja2 = "==3.0.1"
+markdown = "==3.3.4"
+markupsafe = "==2.0.1"
+mergedeep = "==1.3.4"
+mkdocs = "==1.2.3"
+mkdocs-material = "==7.1.10"
+mkdocs-material-extensions = "==1.0.1"
+packaging = "==21.0"
+pygments = "==2.12"
+pymdown-extensions = "==10.0"
+pyparsing = "==2.4.7"
+python-dateutil = "==2.8.2"
+pyyaml = "==6.0.1"
+pyyaml-env-tag = "==0.1"
+six = "==1.16.0"
+typing-extensions = "==3.10.0.0"
+watchdog = "==2.1.3"
+zipp = "==3.5.0"
+
+[dev-packages]
+
+[requires]
+python_version = "3.9"

docs/installations/installations.md → docs/English/installations/installations.md

@@ -3,11 +3,11 @@ title: Installation Overview
 ---
 
 # Installation Overview
-
 Philly Community Wireless has partnered with [**PhillyWisper**](https://phillywisper.net/) to install antennas for our free WiFi network on rooftops in the Norris Square, Fairhill, and Kensington neighborhoods. PhillyWisper is a wireless internet service provider (WISP) which means our project delivers the internet the "last mile" to our customers using radio technology.
 
-## Rooftop Installation Process
+Philly Community Wireless seeks to build community-owned and community-operated wireless mesh network technologies. This page describes our process for installation and the type of network we are trying to build over a large expanse of the city. In a typical home network, all 'access points' (APs) are hard-wired to your router via Ethernet cable. In a mesh network, access points can not only be hard-wired, but connect to each other wirelessly, allowing a single Internet connection to be shared with significantly less infrastructure and labor than hard-wiring every single AP. 
 
+## Rooftop Installation Process
 Most installations proceed in the following order:
 
 1. **Building Assessment** - A new address is submitted to us. We check if the address has line of sight (LoS) to a PhillyWisper high site using Google Earth and other mapping tools, and we conduct both remote and in-person building assessments as part of developing an install plan. For more information, please see [Building Assessments](../buildingassessment) page.
@@ -21,25 +21,18 @@ Most installations proceed in the following order:
 During residential installs, we either broadcast a private network for the resident to use from the same access points broadcasting the public PCW network, or provide an additional router for the resident to have their own private network that gets its uplink from the PCW network. 
 
 ## Length of Time for Antenna Installations
-
 Typically, installs take between two and four hours to complete, but in certain cases they can take longer. The full installation process, from a rooftop antenna to a wall-mounted mesh kit, can involve 2-3 visits, each involving an hour or two of work.
 
 ## Hardware for Installation
+Internet installations typically consist of a rooftop antenna, a power-over-Ethernet injector, a router, and a WiFi access point (all of which are typically Ubiquiti networking equipment). During installation we take every effort to minimally impact buildings. At any given install site, our installation work will be customized to ensure the least invasive and most secure placement of networking equipment, according to industry standards. 
 
-Rooftop installs consist of a rooftop antenna, a power-over-Ethernet injector, a router, and a mesh access point. Philly Community Wireless and PhillyWisper primarily deploy Ubiquiti radios and networking equipment. As each roof is different, the installation is customized for each location to ensure the most secure placement according to industry standards.
+For most locations, we first install a Ubiquiti LiteBeam antenna on the roof of the home, which receives signal from a nearby high site managed by PhillyWisper. To install the rooftop antenna, PhillyWisper technicians will access a high point and mount a small radio antenna (approx 14" x 11" x 11", see attached images of various mounting techniques below) that they precision aim  at the closest source tower. For mounting the radio, we never penetrate the roofing system itself, and wherever possible we utilize preexisting structures (chimneys, vent pipes, etc). If preexisting structures aren't an option, we use a non-penetrating roof mount, which is properly weighed down and rests on a rubber mat on top of your roof. 
 
-In general, we will install a Ubiquiti LiteBeam antenna on the roof of the home, which receives signal from a PhillyWisper tower. The antenna is wired into the home via an Ethernet cable. Currently, this part of the install must be completed by a PhillyWisper technician. For installation purposes, this means PhillyWisper technicians will need to mount a small radio antenna (approx 14" x 11" x 11") at roof height and precision aim it at the closest tower.
-
-PhillyWisper takes every effort to minimally impact buildings during installation. They use non-invasive techniques when mounting the radio (see attached images of various mounting techniques below). They never penetrate the roofing system itself and they try and utilize preexisting structures (chimneys, vent pipes, etc) when possible.
-
-If preexisting structures aren't an option, they will use a non-penetrating roof mount, which is properly weighed down and rests on a rubber mat on top of your roof. They then secure an outdoor-rated, UV stabilized network cable from the radio on the roof, down along the building exterior, and inside where your WiFi router will be located.
-
-Both PhillyWisper and Philly Community Wireless make sure the wire run is as inconspicuously as possible and ensure there is plenty of tension on the wire so that it doesn't flap in the wind. If there are any preexisting penetrations entering the building from previous ISPs, they will use that if possible and caulk when finished.
+The rooftop radio gets powered via outdoor-rated Ethernet cable that runs into the home (our equipment uses Power over Ethernet (PoE), so we can power outdoor devices with Ethernet from an indoor outlet). We make sure the wire run is as inconspicuous and secure as possible. We try to use preexisting penetrations into the building from previous ISPs, and we seal any holes to the exterior.
 
 ## Installation Examples
 
 ### Non-Penetrating Roof Mounts
-
 We utilize non-penetrating roof mounts (NPRM). A thick rubber mat is placed below the NPRM to protect the roof. Cinderblocks are used as ballast to secure the NPRM:
 
 <figure style="display: flex; justify-content: center; align-items: center; flex-direction: column;">
@@ -57,7 +50,6 @@ We utilize non-penetrating roof mounts (NPRM). A thick rubber mat is placed belo
 </figure>
 
 ### Mounting on existing roof structures
-
 We also often use j-arm mounts or previously existing mounts from previous telecommunications installations (old TV/Satellite antennas)to mount our equipment: 
 
 <figure style="display: flex; justify-content: center; align-items: center; flex-direction: column;">
@@ -86,11 +78,9 @@ The mast on the right has PTMP radios with symmetrical horn antennas. The radios
 The square-ish white device between and below the masts is a Ubiquiti EP-S16, an outdoor rated network switch. 54 VDC power is supplied to the EP-S16 which in turns provides power to the radios using POE (power of Ethernet). -->
 
 ## Outdoor Access Points Overview 
-
 Hosts of rooftop installations will also host a router in the house near the window to the front of the house. In some cases we may install a wall-mounted access point on the outside of the house to propagate the broadband signal throughout the neighborhood.
 
 ### Indoor Router and Access Points Overview
-
 The Ethernet cable is passed through a Power-over-Ethernet (PoE) injector, which adds power to the signal the Ethernet cable is carrying and allows downstream devices to be powered solely through Ethernet.
 
 <figure style="display: flex; justify-content: center; align-items: center; flex-direction: column;">
@@ -116,7 +106,15 @@ Finally, a Ubiquiti Mesh AP ("bunny ears" because look at them!) is connected to
     <figcaption>A Unifi UAP-AC-Mesh, or "bunny ears"</figcaption>
 </figure>
 
-
 For more information on configuring our access points, see our [Configure AP-Mesh Guide](../../Device-Configuration/configure-ap-mesh)
 
+## Considerations When Installing a Mesh Node
+Mesh nodes are installations where we do not use a Litebeam, but instead set up a wireless access point that meshes from a nearby access point wired to a router and Litebeam at a local hub. As documented by [Unifi](https://help.ui.com/hc/en-us/articles/115002262328-Considerations-for-Optimal-Wireless-Mesh-Networks), several factors must be considered when building a mesh network:
+
+* **Mesh networks should be supplemental** - Although mesh networks can operate comporably to a hard-wired network, connection quality and speed can be greatly affected by radiofrequency (RF) noise and obstructions between APs such as walls, trees, or other structures. 
+
+* **Mesh 'hops' should be minimized** - A meshed AP should only have one 'parent' - each mesh 'hop', or mesh connection between APs, results in a significant performance decrease. Ideally, there should be a maximum of two 'hops' - e.g, a mesh AP meshes with another mesh AP, which then meshes to a hard-wired AP. 
+
+* **Limit conncurrent connections to a 'parent'** - Similarly, meshing too many APs to the same 'parent' creates additional RF noise and performance demands on the parent, resulting in decreased performance and stability. 
 
+* **Ensure strong signal strength between meshed APs** - Ideally, a meshed AP will have clear Line-of-Sight (LoS) to its mesh parent. A signal strength of -60dbm is recommended for ideal performance. Ensure minimal obstructions between the meshed AP and the parent, such as walls, trees, furniture, etc. 

docs/Español/configurar/configurar-ap-mesh.md

@@ -0,0 +1,84 @@
+---
+
+---
+# 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/Español/configurar/configurar-erx.md

@@ -0,0 +1,43 @@
+---
+
+---
+# 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 [./static-ip](./static-ip.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/Español/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. In certain neighborhoods, even more residents lack any connection to the 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]()
+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]()
+Visión general del hardware necesario para la infraestructura del proyecto PCW.
+
+### [Instalaciones de antenas]()
+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]()
+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]()
+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.