Google-Embed
Google-Embed is a Pelican plugin providing restucturedText directives to allow easy embedding of Google+ (for example a public post or album) and Google Maps.
Live examples can also be viewed from a Pelican-built website.
Features
Embed Google+ posts within a page or blog post easily, simply by specifying the URL of the post.
Google Maps can also be embedded by specifying:
- A place
- A search term
- Directions with optional waypoints
Furthermore, a static image from Google Maps or Google Streetview can also be embedded.
Installation
Google-Embed can be installed using pip
$ pip install google-embed
or manually from the source code
$ python setup.py install
Once installed, simply add it to your pelicanconf.py
configuration file:
PLUGINS = [
# ...
'google_embed'
]
Note
Whilst not required, it is recommended that you sign up for an
API key. This can be
entered in your pelicanconf.py
file after loading the
google_embed plugin like so:
GMAPS_KEY = 'AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA'
Usage
Google+
To embed a public Google+ post, you just need the permalink to the post:
.. gplus:: PERMALINK
Embed Google Maps
To embed a Google Map object:
.. gmaps:: location
:mode: place
where location
in this case is a name of a specific place. Note that
:mode:
is a required option, and can take the value place
or search
.
If in search
mode, the value of location
can be a more generic phrase,
such as Mexican Restraunts near Fake St
- the result will be displayed on
the map with markers.
Other options include:
-
:align:
-left
,right
, orcenter
-
:maptype:
-roadmap
orsatelite
:width:
:height:
Embed Google Map Directions
To embed Google Map directions:
.. directions::
:mode: walking
:origin: Tower of London
:destination: Westminster Abbey
Required options:
-
:mode:
-driving
,walking
,bicycling
,transit
,flying
:origin:
:destination:
Other options include:
-
:align:
-left
,right
, orcenter
-
:maptype:
-roadmap
orsatelite
-
:waypoints:
- points to stop along the way. Should be entered likeBerlin+Germany|Paris+France
:width:
:height:
Embed Google Map as an Image
.. static-map:: The queens larder
Other options include:
-
:align:
-left
,right
, orcenter
-
:maptype:
-roadmap
,satelite
,hybrid
,terrain
-
:markers:
- places markers on the map -
:zoom:
- default is12
:width:
:height:
When using markers, styles come before locations. For numerous markers of the same style,
.. static-map:: The queens larder
:markers: color:blue The+British+Museum Lamb+Bar
For markers of different styles, these should be separated with a &
:
.. static-map:: The queens larder
:markers: color:blue label:A The+British+Museum & color:red label:B Lamb+Bar
Note that marker locations use +
to seprate words, not spaces.
Embed Streetview as an Image
.. streetview:: Paragon, Orchard Rd
Other options include:
-
:align:
-left
,right
, orcenter
:width:
:height: