https://github.com/m-lab/mlab-speedtest

Repository of the Interface and Project for speed.measurementlab.net
https://github.com/m-lab/mlab-speedtest

Last synced: about 15 hours ago
JSON representation

Repository of the Interface and Project for speed.measurementlab.net

• Host: GitHub
• URL: https://github.com/m-lab/mlab-speedtest
• Owner: m-lab
• License: apache-2.0
• Created: 2016-06-29T19:22:50.000Z (over 8 years ago)
• Default Branch: main
• Last Pushed: 2024-10-16T13:59:32.000Z (2 months ago)
• Last Synced: 2024-10-29T14:54:32.686Z (about 2 months ago)
• Language: CSS
• Homepage: https://speed.measurementlab.net
• Size: 2.36 MB
• Stars: 37
• Watchers: 15
• Forks: 14
• Open Issues: 25
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# speed.measurementlab.net source code

`mlab-speedtest` is an Angular.js application providing the website https://speed.measurementlab.net. The app code currently uses `gulp` to integrate language localizations prior to deployment.

## Setting up Local Development Environment

### Install Build Dependencies

* Install website build dependencies for your operating system and environment

  * Node >= v10.15.1 - Using NVM: `nvm install v10.15.1`

  * Gulp - Installed with `yarn`

  * Install libraries - `gulp copy_libs`

  * Firebase tools - `npm install -g firebase-tools`

## Adding new languages

Translations for this site are managed in the [Open Technology Fund's Localization Lab Transifex site](https://www.transifex.com/otf/m-lab-ndt-portal/dashboard/). Contributing translators may choose to translate and/or review translations there. Completed translations are then imported for use within this application and published by M-Lab staff.

### How to add a new localization

* Download a completed language translation file

  * Visit the Transifex site and locate a completed language

  * Click **Interface Language Strings** and then **Download for use** to download the completed language `.po` file

  * Save it in the folder: `/translations/source/` using the file name pattern: **.po**

* Create new language template & update language string references

  * Create a copy of an existing translation folder and index.html file, and make some edits to support the new language

    * Copy the folder and index file: `cp -r app/nl app/es`

    * Edit the index file to change the language it references. In `app/es/index.html`: 

      * change: `const INTERFACE_LANGUAGE = 'nl';` to `const INTERFACE_LANGUAGE = 'es';`

      * change: ``

    * to: ``

  * Regenerate the supported language strings: 

    * `gulp inject`

## Previewing site locally

To preview the site locally, we recommend using the Python Simple HTTP Server. 

* Navigate to the `/app` directory and run: `python3 -m http.server 8000`

If you are a user on the M-Lab Firebase project, you can also preview the site locally using the firebase-cli: `firebase serve --only hosting:mlab-speedtest`