This repository has been archived on 2024-05-11. You can view files and clone it, but cannot push or open issues or pull requests.
Go to file
Xaver Maierhofer 9c4fdde4d8 [TASK] Use forked grunt-inline for updated dependencys 2017-02-19 14:00:27 +01:00
.github [DOC] Add github templates 2017-02-07 10:32:18 +01:00
assets [TASK] Add & update icons to table-header 2017-02-05 16:56:02 +01:00
html [TASK] Load mode style inline 2017-01-31 18:07:46 +01:00
lib [TASK] Remove shadow in forcegraph 2017-02-14 14:37:06 +01:00
locale [TASK] Add french language 2017-02-10 15:29:17 +01:00
scss [BUGFIX] Add sidebar postion for transition 2017-02-18 17:24:47 +01:00
tasks [BUGFIX] Scss grunt dev task 2017-02-03 01:54:45 +01:00
.bithoundrc [TASK] Use forked grunt-inline for updated dependencys 2017-02-19 14:00:27 +01:00
.editorconfig [TASK] Add .yml and .md to editorconfig 2017-02-12 19:21:39 +01:00
.eslintrc [TASK] Add node filter 2017-02-01 22:13:06 +01:00
.gitignore [TASK] Use npm/yarn for JS libarys instead of bower 2017-01-16 17:48:31 +01:00
.sass-lint.yml [TASK] Remove sass lint exceptions 2017-02-04 03:01:17 +01:00
.travis.yml [TASK] Change travis IRC message 2017-02-12 23:57:07 +01:00
CHANGELOG.md [DOC] Add information about development in CHANGELOG.md 2017-01-14 01:21:36 +01:00
Gruntfile.js [BUGFIX] Scss grunt dev task 2017-02-03 01:54:45 +01:00
LICENSE.md [TASK] LICENSE formatted with Markdown 2017-02-12 19:09:02 +01:00
README.md [DOC] Update README 2017-02-18 17:56:04 +01:00
app.js [TASK] Add language selection and language util 2017-02-14 12:35:00 +01:00
config.json [TASK] Rename parameters and require image 2017-02-11 12:12:25 +01:00
crowdin.yml [TASK] Add translations 2017-01-30 01:17:21 +01:00
package.json [TASK] Use forked grunt-inline for updated dependencys 2017-02-19 14:00:27 +01:00
yarn.lock [TASK] Update to rbush 2.0 2017-02-07 00:17:15 +01:00

README.md

Meshviewer

Build Status Scrutinizer Code Quality License: AGPL v3

Web-app to visualize nodes and links on a map for Freifunk open mesh network.

Main differences to https://github.com/ffnord/meshviewer

Some similar features might have been implemented/merged

  • Map layer modes (Allow to set a default layer based on time combined with a stylesheet)
  • Updates for selected node or list (incl. image stats cache-breaker)
  • Node filter is implemented
  • Zoom level for a node (nodeZoom) - Zoom level 22 available, but it is to close for a click
  • Formatted Code
  • Translation support - https://crowdin.com/project/meshviewer - Contact us for new languages
    • Currently available: en, de & fr
  • Grunt inline for some css and js - less requests
  • Icon font with needed icons only
  • Upgrade to Grunt v1.x (Tested with Node.js 4/6 LTS, 7 on Linux, 7 OSX & W**)
    • Moved css and some js inline
  • Remove bower in favour of npm/yarn
    • Load only moment.js without languages (Languages are included in translations)
    • Remove unneeded components (es6-shim, tablesort, numeraljs, leaflet-providers, jshashes)
  • RBush v2 - performance boost in last versions (Positions labels and clients on the map)
  • Remove ruby dependency
  • FixedCenter is required
  • Rewrite scss, sass-lint and variables for easy customization/adjustments
  • Improved cross browser/device support THX@BrowserStack
  • Leaflet with patch to avoid IE/Edge crashes
  • Yarn package manager in favor of npm (npm still works)
  • Configurable reverse geocoding server
  • A lot more in the commit history

Demo:

Embedded: https://regensburg.freifunk.net/netz/karte/
Standalone: https://regensburg.freifunk.net/meshviewer/

Known instances

Community Instance Repo GitHub
Freifunk Bremen https://map.bremen.freifunk.net/ FreifunkBremen/meshviewer-ffrgb

Dependencies

  • yarn (npm fallback)
  • grunt-cli

Installing dependencies

npm is still possible to use, but yarn is much faster https://yarnpkg.com/

Install yarn package-manager:

Chosse your OS and install yarn https://yarnpkg.com/en/docs/install

Execute these commands on your server as a normal user to prepare the dependencies:

git clone https://github.com/ffrgb/meshviewer.git
cd meshviewer
yarn
# Only needed when no global grunt is installed
yarn global add grunt-cli

Building

Just run the following command from the meshviewer directory:

grunt

This will generate build/ containing all required files.

Development

Use grunt serve for development.

Support/Help

Customize style

Start your development and edit files in scss/custom/. Additional information in file comments.

Configure

Change config.jsonto match your community.

dataPath (string/array)

dataPath can be either a string containing the address of a Nodes.json v2 compatible backend (e.g. ffmap backend) or an array containing multiple addresses. Don't forget the trailing slash! Also, proxying the data through a webserver will allow GZip and thus will greatly reduce bandwidth consumption. It may help with firewall problems too.

siteName (string)

Change this to match your communities' name. It will be used in various places.

maxAge (integer)

Nodes being online for less than maxAge days are considered "new". Likewise, nodes being offline for more than than maxAge days are considered "lost".

maxAgeAlert (integer)

Nodes being offline for more than than maxAge days are considered "lost". Lost will be splitted in alert and lost.

nodeZoom (integer)

Max level to be applied by clicking a node or open a node. With value 18 near by buildings and streets should be visible. Interesting if one of configured map provider has zoom-level under 18.

labelZoom (integer)

Min. level for node labels shown on the map. Labels aren't shown in first zoom levels and need performance.

clientZoom (integer)

Min. level to set starting layer for client dots on map.

nodeInfobox

contact (bool, optional)

Setting this to false will hide contact information for nodes.

hardwareUsage (bool, optional)

Setting this to false will hide bars of memory usage and load avg for nodes.

mapLayers (List)

A list of objects describing map layers. Each object has at least name, url and config properties. Example layers and configuration (map against config.json).

mode (string, optional)

Allows to load a additional style for a night mode or similar use case. Possible are inline style or link. Inline avoids re-rendering and maybe issues with label-layer update. Important are class "css-mode mode-name" and media "not".

Default is night.css inline in index.html

 <link rel="stylesheet" class="css-mode mode-name" media="not" href="mode-name.css">

or

<style class="css-mode mode-name" media="not">
   <inline src="mode-name.css" />
</style>

start (integer, optional)

Start a time range to put this mapLayer on first position.

end (integer, optional)

End a time range for first map. Stops sort this mapLayer.

fixedCenter (array[array, array])

Choose a rectangle that must be displayed on the map. Set 2 Locations and everything between will displayed.

Examples for fixedCenter:

// Set a visible frame
"fixedCenter": [
  [
    49.3522,
    11.7752
  ],
  [
    48.7480,
    12.8917
  ]
],

nodeInfos (array, optional)

This option allows to show node statistics depending on following case-sensitive parameters:

  • name header of statistics segment in infobox
  • href absolute or relative URL to statistics image
  • image (required) absolute or relative URL to image, can be the same like href
  • title for the image

To insert current variables in either href, image or title you can use the case-sensitive template string {NODE_ID}, {NODE_NAME}, {LOCALE} and {TIME} as cache-breaker.

Examples for nodeInfos:

"nodeInfos": [
  { 
    "name": "Clientstatistik",
    "href": "stats/dashboard/db/node-byid?var-nodeid={NODE_ID}",
    "image": "stats/render/dashboard-solo/db/node-byid?panelId=1&fullscreen&theme=light&width=600&height=300&var-nodeid={NODE_ID}&var-host={NODE_NAME}&_t={TIME}",
    "title": "Knoten {NODE_ID}"
  },
  {
    "name": "Uptime",
    "href": "stats/dashboard/db/node-byid?var-nodeid={NODE_ID}",
    "image": "stats/render/dashboard-solo/db/node-byid?panelId=2&fullscreen&theme=light&width=600&height=300&var-nodeid={NODE_ID}&_t={TIME}",
    "title": "Knoten {NODE_ID}"
  }
]

In order to have statistics images available, you have to set up an instance of each Prometheus and Grafana.

globalInfos (array, optional)

This option allows to show global statistics on statistics page depending on following case-sensitive parameters:

  • name header of statistics segment in infobox
  • href absolute or relative URL to statistics image
  • image (required) absolute or relative URL to image, can be the same like href
  • title for the image

In contrast to nodeInfos there is no template substitution in href, image or title.

Examples for globalInfos using Grafana server rendering:

"globalInfos": [
  { 
    "name": "Wochenstatistik",
    "href": "stats/render/render/dashboard-solo/db/global?panelId=1&fullscreen&theme=light&width=600&height=300",
    "image": "nodes/globalGraph.png",
    "title": "Bild mit Wochenstatistik"
  }
]

linkInfos (array, optional)

This option allows to show link statistics depending on the following case-sensitive parameters:

  • name header of statistics segment in infobox
  • href absolute or relative URL to statistics image
  • image (required) absolute or relative URL to image, can be the same like href
  • title for the image

To insert the source or target variable in either href, image or title you can use the case-sensitive template strings {SOURCE_ID}, {TARGET_ID}, {SOURCE_NAME}, {TARGET_NAME}, {LOCALE} and {TIME} as cache-breaker.

"linkInfos": [
  {
    "name": "Linkstatistik",
    "href": "stats/dashboard/db/links?var-source={SOURCE_ID}&var-target={TARGET_ID}",
    "image": "stats/render/dashboard-solo/db/links?panelId=1&fullscreen&theme=light&width=800&height=600&var-source={SOURCE_ID}&var-target={TARGET_ID}&_t={TIME}",
    "title": "Bild mit Linkstatistik"
  }
]

siteNames (array, optional)

In this array name definitions for site statistics and node info can be saved. This requires one object for each site code. This object must contain:

  • site the site code
  • name the defined written name for this site code

If neither siteNames nor showSites are set, site statistics and node info won't be displayed

Example for siteNames:

  "siteNames": [
    {
      "site": "ffrgb",
      "name": "Regensburg"
    },
    {
      "site": "ffrgb-dummy",
      "name": "Regensburg Test"
    }
  ],

supportedLocale (array)

Add supported locale (with matching language file in locales/*.json) and it will be matched against the browser language setting. Fallback is the first language in the array.

Example for supportedLocale:

"supportedLocale": [
  "en",
  "de",
  "fr"
]

cacheBreaker (string)

Will be replaced in every build to avoid missing or outdated language strings, because language.json isn't up to date.

Fixed value (y0z).

Sponsoring / Supporting

  • BrowserStack for providing an awesome testing service for hundreds of browsers
  • Travis CI for building meshviewer on every push and pull request
  • Scrutinizer CI for testing code quality on every push and pull request
  • Crowdin for providing an easy non-developer translation environment

These tools need a lot of infrastructure and provide a free account for open source software.