paulmataruso/zulip
1
0
Fork 0
mirror of https://github.com/zulip/zulip.git synced 2025-11-03 13:33:24 +00:00
Code Issues Packages Projects Releases Wiki Activity

webhooks/bitbucket: Migrate docs to Markdown.

Browse Source
This commit is contained in:
Eeshan Garg
2017-06-04 22:43:57 -02:30
committed by Tim Abbott
parent def4650d84
commit ffb3994b4e
2 changed files with 27 additions and 45 deletions
Download Patch File Download Diff File Expand all files Collapse all files

45
zerver/webhooks/bitbucket/doc.html
View File

@@ -1,45 +0,0 @@
<p>
Zulip supports both Git and Mercurial notifications from
Bitbucket. This integration is for the old-style Bitbucket
webhooks used by Bitbucket Enterprise.
</p>
<p>
First, create the stream you'd like to use for Bitbucket notifications,
and subscribe all interested parties to this stream. The integration will
use the default stream <code>commits</code> if no stream is supplied in the
hook; you still need to create the stream even if you are using this
default.
</p>
<p>
Next, from your repository's web page, go to the Administration page and choose Hooks on the left-hand side.
Choose the <code>POST</code> hook from the list presented and click "Add hook." Make sure to replace the
<code>@</code> in the bot's email address with <code>%40</code>,
as Bitbucket will not execute the hook if the username contains a <code>@</code>.
</p>
<p>
In the URL field, enter
<code>{{ external_uri_scheme }}bot_email:bot_api_key@{{ external_api_path_subdomain }}/v1/external/bitbucket</code>
</p>
<p>
Or, you can also limit the notifications you receive to specific
branches by specifying them in a comma-separated list at the end
of the URL, like so:
</p>
<p><code>{{ external_uri_scheme }}bot_email:bot_api_key@{{ external_api_path_subdomain }}/v1/external/bitbucket?branches=master,development</code></p>
<img class="screenshot" src="/static/images/integrations/bitbucket/001.png"/>
<p>
By default, notifications are sent to the <code>commits</code> stream.
To send notifications to a different stream,
append <code style="white-space: nowrap;">?stream=stream_name</code> to
the URL.
</p>
<p>
<b>Congratulations! You're done!</b><br/> Whenever you push code to your repository,
you'll get an automated notification that looks like this:
</p>
<img class="screenshot" src="/static/images/integrations/bitbucket/002.png"/>

27
zerver/webhooks/bitbucket/doc.md Normal file
View File

@@ -0,0 +1,27 @@
Zulip supports both Git and Mercurial notifications from
Bitbucket. This integration is for the old-style Bitbucket
webhooks used by Bitbucket Enterprise.
{!create-stream.md!}
The integration will use the default stream `commits` if no
stream is supplied in the hook; you still need to create the
stream even if you are using this default.
Next, from your repository's web page, go to the **Administration**
page and choose **Hooks** on the left-hand side. Choose the **POST**
hook from the list presented and click **Add hook**.
{!webhook-url-with-bot-email.md!}
{!git-append-branches.md!}
By default, notifications are sent to the `commits` stream. To
send notifications to a different stream, append
`?stream=stream_name` to the URL.
![](/static/images/integrations/bitbucket/001.png)
{!congrats.md!}
![](/static/images/integrations/bitbucket/002.png)