Expose the name, location, and format of city "bookmark" files

[talmage]

One of outside's nicest features is its ability to fetch weather for several cities. It is hard to find where the configuration information about these "bookmarked" cities is stored unless one is conversant with Rust. Although I was able to find it in ~/.cache/outside/*.cache, it took many minutes of reading the source code and poking around in my home directory. I expected to find the "bookmarked" cities in the directory ~/.config/outside/.

I would like to see these changes to outside that will make it more user friendly:

1. Document the location of the bookmark files.
2. Document the file format for the bookmark files.
3. Make the bookmark files human readable.
4. Move the bookmark files to a system-dependent well known place for configuration files, such as ~/.config/outside/ on Linux.
5. Give each bookmark file a unique, human-readable name that clearly corresponds to the bookmarked city.

[BaconIsAVeg]

So we should distinguish between the 'bookmark list', which is just a list of cities, and the actual 'cache' files which are the raw API results. There's no value in exposing the raw API data, if you want to use it you're better off running outside -o json | jq which will handle the unit conversion and clean the data up a bit.

While moving the 'bookmark list' to XDG_CONFIG_HOME might make sense, it's just using the same savefile crate as the cache files, though I don't mind if someone wants to take that on, perhaps store it as JSON or Yaml/Toml/etc in XDG_CONFIG_HOME.

The cached API responses definately do belong in XDG_CACHE_HOME however, and the dirs-next crate handles that for Unix/OSX/Windows already.

As for storing the files with the city name, why deal with file names like Çöte?

[talmage]

Yes, please, to JSON or YAML or any sane, human-readable, machine-parsable text format for the bookmarks file(s). The bookmarks are configuration files for outside, aren't they? Don't they tell outside what weather station data to fetch? You could put other things there, too, like how often to update the weather info.

Storing each bookmark in a separate file makes each bookmark easily sharable. outside users could create a library of bookmarks that users could just install in XDG_CONFIG_HOME/outside.

Why deal with city file names with diacritical marks? Ask a person whose written language uses them. If the filesystem supports it, then why not?