Test local icn3d instance

[CFGrote]

Going through @digitaltodd 's instructions how to setup and run a local icn3d instance and taking notes

[CFGrote]

Unpacking

I made the mistake to create a new subdirectory first, cd into that and unpack the zip file from here. Instead, it's important that the zip file is unpacked directly in the ImmunoZoo root directory.

unzip icn3d.zip

Instantiation with python

I ran

python -m http.server 8080 | python -m webbrowser 'http://localhost:8080/icn3d/?menuconfig=menu.json'

Expected to see the familiar icn3d site but only see my default browser start page.

Instead, I only start the server with

python -m http.server 8080 

and navigate to http://localhost/icn3d?menuconfig=menu.json which brings up the expected icn3d site.

[CFGrote]

Editing the menu file.

Starting the server as I did above, takes the menu.json from the icn3d/ directory, not the one in the repository root dir, so I have to edit icn3d/menu.json, clear cache, reload http://localhost/icn3d?menuconfig=menu.json, to see the effect.

I'm attaching my menu.json here. I deactivated every menu item and only kept those that I used or looked into during the hackathon.

menu.json.txt

[CFGrote]

Debugging

If the edited menu.json contains syntax errors (e.g. unmatched parentheses, invalid characters, ...), the site loads a default
menu. This may be confusing for the developer working on menu.json. Good advise is to have the browser's log console open and filter for "menu", see attached screenshot

There's an unmatched parenthesis on the highlighted line in the editor window which causes an exception when the site loads the menu file. The Color menu should only show "UniColor" (everything else set to '0' in menu.json) but shows all default menu items instead. The console shows the error message but it does not point to menu.json, so beware.