# Questions

# Do I need a premium account to use Hextml?

No. Just save the map by hand using the save button at the top. You will be able to reload this file at a later date with the import button.

# Why does Hextml displays "Save on server: never" in the status bar?

You have to connect with your google account and get a premium account with at least a $5 tier. Then, the "server" text will transform into a link that you can click to access your personnal map.

If you can't (or don't want to) you can still use everything normally but you'll have to regulary save your maps on your own computer.

I usually enable the premium account after the first $5 payment has gone through. If you didn't know patreon has a weird payment system where you only get payed around the 3rd of each month.

# Why can't I access or save my map on the server?

# How to see the debug information of the program?

Short answer: CTRL + MAJ + J

You may find information about any problem you encounter in the javascript console of your browser. It will probably be of little help to you but it may be easier to help you if you can provide thses information.

With both browser you'll see a "console" tab, it may already be active, or you may have to switch to it.

# Why is my premium accunt no enabled yet?

I usually enable the premium account after the first payment (of at least $5 at the time of this writing) has gone through. If you didn't know patreon has a weird payment system where you only get payed around the 3rd of each month. If you really need it now just send a message where you explain your reason and I'll probably make an exception :)

Be aware that you do not need a premium account to use hextml.

# Something doesn't work, what can I do?

Many things can fail for many reasons: something broke on the server, I made an update that introduced a bug, you did something that I didn't think of, ...

In any case your first steps should be to try if using a different browser solves the problem. Firefox and Chrome are the only browser officially supported even if I try my best to support the others.

You may have some browser extensions installed. Try disabling them one by one and see if it fixes something. Or you may block cookies, even if Hextml doesn't use cookies, some services we used do so try accepting all cookies to see if it changes something (and then put the setting back to its previous value because accepting all cookies is a bad idea).

# When I export to image there is some parts missing, what can I do?

For unknown reasons rivers, roads and borders are sometimes missing on the first export. I don't know why. I have investigated but without success (so far).

# Why is exporting to image so slow?

Browsers do not have the hability to program a screenshot (which is basically what exporting the map to an image is), I don't really know why, maybe for security reasons? Anyway, the only way to do it programmatically is very convoluted and quite slow.

If you want to export to image faster Firefox provides a good workaround with the integrated screenshot feature.

You will notice that you have the button to leave the fullscreen mode in your screenshot. It's possible to remove it but it's a little more complicated. Before doing it do a backup of your map on your hard drive.

Before running the :screenshot command you have to run document.querySelector(".hovermap").style.display = "none", do your screenshot (see above) and then run document.querySelector(".hovermap").style.display = "" to show the button again and go out of fullscreen mode.

The backup is in case you can't go out of fullscreen mode, you can always refresh the page and import your backup.

# Collaboration

Sharing the map with collaborative mode won't work unless you keep your browser tab open to replicate the changes on the server. You are the only one that can save at this specific URL. It doesn't work like Google docs where someone can access your docs if you're note here.

Even if every editor has a premium account it won't work: you will all save the map on the server but there will be many different copies at different URL.

Think of it this way: the collaboration link is only valid for as long as you have your browser tab open.

# Export

There is multiple ways of saving data with Hextml:

# URL Actions

URL Actions are something I implemented for the share by link feature and I extended to provied other features. If you clicked the previous link you just used a URL action ;) You may have noticed than the command palette was pre-filled with "generate share link", that's an action that was in the URL, notice the #?p=generate%20share%20link in the address bar (or in the link).
The URL actions once are applied when you load the page.

URL actions are appended to the end of the URL. You need to add a # if there isn't already one.
There are many other URL actions, they are unstable and may not work in the future but, here they are:

They can be combined. For example you could combine grid and hw to make a link to #grid=hexinsquare&hw=3,3 a page with a 3x3 map with square tiles