Pelican 的 Google Map 插件

青蛙最近整理照片和blog的时候，一直想想在blog post里添加一个地图。但是pelican似乎没有靠谱的google map plugin。虽然有一个 google_embed ，但是似乎现在不能用了，按照它的README写好map之后，post里面完全不会转义。

于是青蛙一怒之下自己照猫画虎写了个liquid_tag版本的google map，竟然也能用了。

目前这个plugin支持map和direction模式，青蛙还在考虑要不要添加街景模式。

添加map的方法：

    {% gmap "location" mode [maptype] [align] [width] [height] %}

location：必选项，指定地点，必须包含双引号，支持中文。

mode：必选项，地图模式，有place和search选项，指定地图显示单个地点或者搜索location中的关键字

maptype：地图的显示模式，包含roadmap、satellite、hybrid和terrain。

align：地图在页面中的对齐方式，left、center或者right

width：地图宽度

height：地图高度

例如： { % gmap "东方明珠,上海" place roadmap left 600 480 % } 显示如下地图：

添加direction（导航）的方法：

    {% gdirection "origin" "destination" ["waypoints"] mode [maptype] [align] [width] [height] %}

origin：必选项，指定出发点，必须包含双引号，支持中文。

destination：必选项，指定目的地，必须包含双引号，支持中文。

waypoints：指定途经点，必须包含双引号，支持中文。

mode：必选项，导航模式，有driving、walking、bicycling、 transit和flying选项。

maptype：地图的显示模式，包含roadmap、satellite、hybrid和terrain。

align：地图在页面中的对齐方式，left、center或者right。

width：地图宽度。

height：地图高度。

例如： { % gdirection "东方明珠,上海" "人民广场,上海" driving roadmap left 600 480 % } 显示如下地图：

如果你也想在pelican里面使用这个插件，可以在 Google cloud plateform console 申请一个MAP API key，然后在pelicanconfig.py文件里加入API key配置：

GMAPS_API_KEY = "YOUR_API_KEY_HERE"

然后给liquid_tag打个补丁：

--- a/liquid_tags/mdx_liquid_tags.py +++ b/liquid_tags/mdx_liquid_tags.py @@ -22,12 +22,14 @@ EXTRACT_TAG = re.compile(r'(?:\s*)(\S+)(?:\s*)') LT_CONFIG = { 'CODE_DIR': 'code', 'NOTEBOOK_DIR': 'notebooks', 'FLICKR_API_KEY': 'flickr', - 'GIPHY_API_KEY': 'giphy' + 'GIPHY_API_KEY': 'giphy', + 'GMAPS_API_KEY': 'gmap' } LT_HELP = { 'CODE_DIR' : 'Code directory for include_code subplugin', 'NOTEBOOK_DIR' : 'Notebook directory for notebook subplugin', 'FLICKR_API_KEY': 'Flickr key for accessing the API', - 'GIPHY_API_KEY': 'Giphy key for accessing the API' + 'GIPHY_API_KEY': 'Giphy key for accessing the API', + 'GMAPS_API_KEY': 'Google Maps key for accessing the API' } class _LiquidTagsPreprocessor(markdown.preprocessors.Preprocessor):

接着把这个文件放进liquid_tags目录里面，然后就可以在post里添加地图了。

Enjoy posting!

""" Google maps Tag --------- This implements a Liquid-style google map tag for Pelican, based on the google_embed plugin. Syntax ------ {% gmap "location" mode [maptype] [align] [width] [height] %} {% gdirection "origin" "destination" "waypoints" mode [maptype] [align] [width] [height] %} """ import re from .mdx_liquid_tags import LiquidTags MAP_SYNTAX = '{% gmap "location" mode [maptype] [align] [width] [height] %}' # Regular expression for full syntax map_re_str = """(?:"(?P[\w\s\,\.]+?)")""" map_re_str += """(?:\s+(?P\w+))?""" map_re_str += """(?:\s+(?P\w+))?""" map_re_str += """(?:\s+(?P\w+))?""" map_re_str += """(?:\s+(?P\d*))?""" map_re_str += """(?:\s+(?P\d*))?""" ReGmap = re.compile(map_re_str) def get_align(align): if align == 'right': align_css = "float:right;" elif align == 'left': align_css = "" else: align_css = "display: block;margin: 0 auto;" return align_css @LiquidTags.register('gmap') def gmap(preprocessor, tag, markup): GMAPS_API_KEY = preprocessor.configs.getConfig('GMAPS_API_KEY') attrs = None # Default setting location = "" mode = "place" maptype = "roadmap" width = 600 height = 400 align = 'center' # Parse the markup string match = ReGmap.search(markup) if match: attrs = dict([(key, val.strip()) for (key, val) in match.groupdict().items() if val]) else: raise ValueError('Error processing input. ' 'Expected syntax: {0}'.format(MAP_SYNTAX)) # Construct URI location = attrs['location'] del attrs['location'] if ' ' in location: location = '+'.join(location.split()) if 'mode' in attrs: mode = attrs['mode'] del attrs['mode'] else: raise ValueError('Error processing input. ' 'Expected syntax: {0}'.format(MAP_SYNTAX)) if 'maptype' in attrs: maptype = attrs['maptype'] del attrs['maptype'] if 'width' in attrs: width = attrs['width'] del attrs['width'] if 'height' in attrs: height = attrs['height'] del attrs['height'] if 'align' in attrs: align = attrs['align'] del attrs['align'] align_css = get_align(align) linkHTML=""" """.format(mode,GMAPS_API_KEY,location,width,height,maptype,align_css) return linkHTML DIRECTION_SYNTAX = '{% gdirection "origin" "destination" "waypoints" mode [maptype] [align] [width] [height] %}' # Regular expression for full syntax direction_re_str = """(?:(?P"[\w\s\S]+"))""" direction_re_str += """(?:\s+(?P\w+))?""" direction_re_str += """(?:\s+(?P\w+))?""" direction_re_str += """(?:\s+(?P\w+))?""" direction_re_str += """(?:\s+(?P\d*))?""" direction_re_str += """(?:\s+(?P\d*))?""" ReGdirection = re.compile(direction_re_str) waypoints_re_str = """(?:"(?P[\w\s\S]+?)")""" waypoints_re_str += """(?:\s+"(?P[\w\s\S]+?)")""" waypoints_re_str += """(?:\s+"(?P[\w\s\S]+?)")?""" ReGwaypoints = re.compile(waypoints_re_str) @LiquidTags.register('gdirection') def gdirection(preprocessor, tag, markup): GMAPS_API_KEY = preprocessor.configs.getConfig('GMAPS_API_KEY') attrs = None # Default setting origin = "" destination = "" waypoints = "" mode = "place" maptype = "roadmap" width = 600 height = 400 align = 'center' # Parse the markup string match = ReGdirection.search(markup) if match: attrs = dict([(key, val.strip()) for (key, val) in match.groupdict().items() if val]) else: raise ValueError('Error processing input. ' 'Expected syntax: {0}'.format(DIRECTION_SYNTAX)) # Construct URI directions = attrs['directions'] del attrs['directions'] m = ReGwaypoints.search(directions) if m: attrs.update([(key, val.strip()) for (key, val) in m.groupdict().items() if val]) else: raise ValueError('Error processing input. ' 'Expected syntax: {0}'.format(DIRECTION_SYNTAX)) origin = attrs['origin'] del attrs['origin'] if ' ' in origin: origin = '+'.join(origin.split()) destination = attrs['destination'] del attrs['destination'] if ' ' in destination: destination = '+'.join(destination.split()) if 'waypoints' in attrs: waypoints = attrs['waypoints'] del attrs['waypoints'] if ' ' in waypoints: waypoints = '+'.join(waypoints.split()) if 'mode' in attrs: mode = attrs['mode'] del attrs['mode'] if 'maptype' in attrs: maptype = attrs['maptype'] del attrs['maptype'] if 'width' in attrs: width = attrs['width'] del attrs['width'] if 'height' in attrs: height = attrs['height'] del attrs['height'] if 'align' in attrs: align = attrs['align'] del attrs['align'] align_css = get_align(align) query_str = 'origin={0}&destination={1}'.format(origin,destination) if waypoints: query_str += '&waypoints={0}'.format(waypoints) linkHTML=""" """.format(mode,GMAPS_API_KEY,query_str,width,height,maptype,align_css) return linkHTML @LiquidTags.register('gmap_places') def gmap_places(preprocessor, tag, markup): GMAPS_API_KEY = preprocessor.configs.getConfig('GMAPS_API_KEY') attrs = None linkHTML=""" """.format(GMAPS_API_KEY) #---------------------------------------------------------------------- # This import allows image tag to be a Pelican plugin from liquid_tags import register