integrations/redmine: Migrate docs to Markdown.

This commit is contained in:
Eeshan Garg 2017-06-22 09:21:39 -02:30 committed by showell
parent 53c1a53120
commit ed388ed320
3 changed files with 53 additions and 94 deletions

View File

@ -1,93 +0,0 @@
<p>
Get information on new or updated Redmine issues right in
Zulip with our Zulip Redmine plugin! Note: this setup must be
done by a Redmine Administrator.
</p>
<p>
First, create the stream you'd like to use for Redmine notifications,
and subscribe all interested parties to this stream. We recommend the
name <code>redmine</code>.
</p>
<p>Then:</p>
<ol>
<li>
<p>
Clone the
<a href="https://github.com/zulip/zulip-redmine-plugin">
Zulip Redmine plugin repository
</a>
by running:
</p>
<pre>git clone https://github.com/zulip/zulip-redmine-plugin</pre>
</li>
<li>
<p>
Follow the
<a href="http://www.redmine.org/projects/redmine/wiki/Plugins">
Redmine plugin installation guide
</a>
to install the <code>zulip_redmine</code> plugin directory, which is a
subdirectory of the <code>zulip-redmine-plugin</code> repository
directory. In a nutshell, the steps are:
</p>
<ol type="A">
<li>
<p>
Copy the <code>zulip_redmine</code> directory to
the <code>plugins</code> directory of your Redmine
instance.
</p>
</li>
<li>
<p>
Update the Redmine database by running (for Rake 2.X, see the
guide for instructions for older versions):
</p>
<pre>rake redmine:plugins:migrate RAILS_ENV=production</pre>
</li>
<li>
<p>Restart your Redmine instance.</p>
</li>
</ol>
<p>The Zulip plugin is now registered with Redmine!</p>
</li>
<li>
<p>On your {{ settings_html|safe }}, create a new Redmine bot.</p>
</li>
<li>
<p>
To configure Zulip notification settings that apply to many
projects in one go, in Redmine click the "Administration" link in
the top left. Click the "Plugins" link on the Administration page,
and click the "Configure" link to the right of the Zulip plugin
description. In the "Projects" section, select all projects to which
you want these settings to apply.
</p>
<p>
To configure Zulip notifications for a particular Redmine project,
visit the project's Settings page.
</p>
<p>
In either case, fill out zulip server by <code>{{ external_api_path_subdomain }}</code>,
the bot email address, and API key, and the
Zulip stream that should receive notifications. Apply your changes.
</p>
</li>
<li>
<p>
To test the plugin, create an issue or update an existing issue in
a Redmine project that has Zulip notifications configured (any
project, if you've configured global settings).
</p>
</li>
</ol>
<p>
<b>Congratulations! You're done!</b><br/> When you update issues in
Redmine, the team can see these updates in real time in Zulip:
</p>
<img class="screenshot" src="/static/images/integrations/redmine/001.png"/>

View File

@ -0,0 +1,52 @@
Get information on new or updated Redmine issues right in
Zulip with our Zulip Redmine plugin! Note: this setup must be
done by a Redmine Administrator.
{!create-stream.md!}
Clone the [Zulip Redmine plugin repository][1] by running:
`git clone https://github.com/zulip/zulip-redmine-plugin`
[1]: https://github.com/zulip/zulip-redmine-plugin
Follow the [Redmine plugin installation guide][2] to install
the `zulip_redmine` plugin directory, which is a subdirectory
of the `zulip-redmine-plugin` repository directory. In a nutshell,
the steps are:
1. Copy the `zulip_redmine` directory to the `plugins`
directory of your Redmine instance.
2. Update the Redmine database by running (for Rake 2.X, see
the guide for instructions for older versions):
`rake redmine:plugins:migrate RAILS_ENV=production`
3. Restart your Redmine instance.
The Zulip plugin is now registered with Redmine!
[2]: http://www.redmine.org/projects/redmine/wiki/Plugins
On your {{ settings_html|safe }}, create a new Redmine bot.
To configure Zulip notification settings that apply to many
projects in one go, in Redmine click the **Administration** link in
the top left. Click the **Plugins** link on the Administration page,
and click the **Configure** link to the right of the Zulip plugin
description. In the **Projects** section, select all projects to which
you want these settings to apply.
To configure Zulip notifications for a particular Redmine project,
visit the project's **Settings** page.
In either case, fill out zulip server by `{{ external_api_path_subdomain }}`
the bot email address, and API key, and the Zulip stream that should
receive notifications. Apply your changes.
To test the plugin, create an issue or update an existing issue
in a Redmine project that has Zulip notifications configured (any
project, if you've configured global settings).
{!congrats.md!}
![](/static/images/integrations/redmine/001.png)

View File

@ -298,7 +298,7 @@ INTEGRATIONS = {
'perforce': Integration('perforce', 'perforce', doc='zerver/integrations/perforce.html'),
'phabricator': Integration('phabricator', 'phabricator', doc='zerver/integrations/phabricator.md'),
'puppet': Integration('puppet', 'puppet', doc='zerver/integrations/puppet.md'),
'redmine': Integration('redmine', 'redmine', doc='zerver/integrations/redmine.html'),
'redmine': Integration('redmine', 'redmine', doc='zerver/integrations/redmine.md'),
'rss': Integration('rss', 'rss', display_name='RSS', doc='zerver/integrations/rss.md'),
'svn': Integration(
'svn', 'svn',