Python markdown extension for Google Maps. Should be loaded as an extension to the markdown library.
Installation:pip install mdx-google-map
Usage:import markdown md = markdown.Markdown(extensions=["mdx_google_map"]) md.convert("[map:Central Paris]")
Or if you want to alter the config:
import markdown from mdx_google_map import GoogleMapExtension md = markdown.Markdown(extensions=[GoogleMapExtension(...config values...)]) md.convert("[map:Central Paris]")Markdown syntax:
It's pretty simple:
Hey look at my map! [map:City of London]
Which will output:
<p> Hey look at my map! <iframe allowfullscreen="true" frameborder="0" height="300" src="//www.google.com/maps/embed/v1/place?key=AIzaSyD5DlGo1lo0V2Np7TxfpuNuWbWcr5TV8Sw&q=City+of+London" width="500"></iframe> </p>Configuring:
You will need an API Key from Google to use the Maps APIs, once obtained it can be configured as an environment variable:
$ export GOOGLE_API_KEY=MyGoogleAPIKey1234
or simply passed through to the extension as with any other config:
GoogleMapExtension(google_api_key='MyGoogleAPIKey1234')
You can also load the API key by passing a callable that conforms to the same syntax as dict.get('KEY', 'default value'). This is more of an implementation detail, but it is supported if you find the need.
my_dict = {'GOOGLE_API_KEY': 'MyGoogleAPIKey1234'} GoogleMapExtension(config_getter=my_dict.get)
Explicitly passing the google_api_key config param takes precedence over other methods of setting the API Key.
All other config is optional and detailed below
Config is passed through when loading the extension as with the API Key example above:
GoogleMapExtension(width='500', height='400', ...)
Pull requests are welcome, though we'd be grateful if you would open an issue to discuss your feature/bugfix first.
To install the development dependencies locally it's: $ pip install -e .[dev]
To run the tests it is just: $ python -m unittest
You'll need to follow PEP8 in addition to the Google Python Style Guide. Sensible deviations from the above will be considered.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4