templates: Support parametric Markdown macros for webhooks docs.

templates/zerver/help/include/create-bot-construct-url.md

@@ -1,5 +1,5 @@
-Next, on your {{ settings_html|safe }}, create a bot for this
-integration. Construct the URL for this bot using the bot API key
-and stream name:
+Next, on your {{ settings_html|safe }}, create a bot for
+{{ integration_display_name }}. Construct the URL for the
+{{ integration_display_name }} bot using the bot API key and stream name:
 
-`{{ external_api_uri_subdomain }}/v1/external/
+{!webhook-url.md!}

templates/zerver/help/include/create-stream.md

@@ -1,3 +1,4 @@
-First, create the stream you'd like to use for notifications from
-this integration, and subscribe all interested parties to this stream.
-We recommend the name
+First, create the stream you'd like to use for
+{{ integration_display_name }} notifications, and subscribe all
+interested parties to this stream. We recommend the
+name `{{ integration_name }}`.

templates/zerver/help/include/webhook-url.md

@@ -0,0 +1 @@
+`{{ external_api_uri_subdomain }}{{ integration_url }}?api_key=abcdefgh&stream={{ integration_name }}`

zerver/templatetags/app_filters.py

@@ -82,6 +82,13 @@ def render_markdown_path(markdown_file_path, context=None):
     if context is None:
         context = {}
 
+    if markdown_file_path.endswith('doc.md'):
+        integration_dir = markdown_file_path.split('/')[0]
+        integration = context['integrations_dict'][integration_dir]
+        context['integration_name'] = integration.name
+        context['integration_display_name'] = integration.display_name
+        context['integration_url'] = integration.url[3:]
+
     jinja = engines['Jinja2']
     markdown_string = jinja.env.loader.get_source(jinja.env, markdown_file_path)[0]
     html = md_engine.convert(markdown_string)