Skip to content

Debug Environment Setup

zstadler edited this page Feb 10, 2017 · 13 revisions

The setup instructions are enabling the build of the project and some debugging. Full debugging of the site requires additional settings.

Contents

Map Tiles

The tiles are external to this repository. Therefore, without additional setup, only Google Earth imagery can be seen. If needed, the Hiking and Biking tiles can be setup using external or local sources.

###External Tiles External map sources added as new layers, just as done by users of the site. For example:

Map Source Tiles Address
Hebrew Hiking https://IsraelHiking.osm.org.il/Hebrew/Tiles/{z}/{x}/{y}.png
Hebrew MTB https://IsraelHiking.osm.org.il/Hebrew/mtbTiles/{z}/{x}/{y}.png
English Hiking https://IsraelHiking.osm.org.il/English/Tiles/{z}/{x}/{y}.png
English MTB https://IsraelHiking.osm.org.il/English/mtbTiles/{z}/{x}/{y}.png
Marked Trails https://IsraelHiking.osm.org.il/English/OverlayTiles/{z}/{x}/{y}.png

Note: Some features of the site, such as changing the map language, are not available when using external tile sources.

###Local Tiles Local tiles take about 35Gb of disk space! They are expected at IsrealHiking.Web\Hebrew, IsrealHiking.Web\English, and IsrealHiking.Web\OverlayTiles.

If the tiles exist in some other location, such as the Map project, it is advised to create a symbolic link to the existing location, rather than a physical copy. For example if Site and Map repositories are located under the same parent folder:

cd IsrealHiking.Web
mklink /D Hebrew ..\..\Map\Hebrew
mklink /D English ..\..\Map\English
mklink /D OverlayTiles ..\..\Map\Hebrew\OverlayTiles

An alternative way to create the symbolic links is the excellent Link Shell Extension for Windows' File Explorer. It allows you to pick a directory and drop it as a symbolic link, just like copy-paste.

The extension also supports Hardlinks, Junctions, Volume Mountpoints, and several ways of using them for copying directory trees.