2015-02-28 00:23:18 +00:00
|
|
|
# SOME DESCRIPTIVE TITLE.
|
2018-09-27 15:51:01 +00:00
|
|
|
# Copyright (C) 2010-2018, Read the Docs, Inc & contributors
|
|
|
|
# This file is distributed under the same license as the Read the Docs package.
|
|
|
|
#
|
2015-02-28 00:23:18 +00:00
|
|
|
# Translators:
|
|
|
|
msgid ""
|
|
|
|
msgstr ""
|
|
|
|
"Project-Id-Version: readthedocs-docs\n"
|
|
|
|
"Report-Msgid-Bugs-To: \n"
|
2018-09-27 15:51:01 +00:00
|
|
|
"POT-Creation-Date: 2018-09-17 19:05-0500\n"
|
|
|
|
"PO-Revision-Date: 2018-09-18 00:29+0000\n"
|
|
|
|
"Last-Translator: Anthony <aj@ohess.org>\n"
|
|
|
|
"Language-Team: Persian (http://www.transifex.com/readthedocs/readthedocs-docs/language/fa/)\n"
|
2015-02-28 00:23:18 +00:00
|
|
|
"MIME-Version: 1.0\n"
|
|
|
|
"Content-Type: text/plain; charset=UTF-8\n"
|
|
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
|
|
"Language: fa\n"
|
2018-09-27 15:51:01 +00:00
|
|
|
"Plural-Forms: nplurals=2; plural=(n > 1);\n"
|
2015-02-28 00:23:18 +00:00
|
|
|
|
|
|
|
#: ../../webhooks.rst:2
|
|
|
|
msgid "Webhooks"
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../../webhooks.rst:4
|
|
|
|
msgid ""
|
2018-09-27 15:51:01 +00:00
|
|
|
"The primary method that Read the Docs uses to detect changes to your "
|
|
|
|
"documentation is through the use of *webhooks*. Webhooks are configured with"
|
|
|
|
" your repository provider, such as GitHub, Bitbucket or GitLab, and with "
|
|
|
|
"each commit, merge, or other change to your repository, Read the Docs is "
|
|
|
|
"notified. When we receive a webhook notification, we determine if the change"
|
|
|
|
" is related to an active version for your project, and if it is, a build is "
|
|
|
|
"triggered for that version."
|
2015-02-28 00:23:18 +00:00
|
|
|
msgstr ""
|
|
|
|
|
2018-09-27 15:51:01 +00:00
|
|
|
#: ../../webhooks.rst:13
|
|
|
|
msgid "Webhook Integrations"
|
2015-02-28 00:23:18 +00:00
|
|
|
msgstr ""
|
|
|
|
|
2018-09-27 15:51:01 +00:00
|
|
|
#: ../../webhooks.rst:15
|
2015-02-28 00:23:18 +00:00
|
|
|
msgid ""
|
2018-09-27 15:51:01 +00:00
|
|
|
"You'll find a list of configured webhook integrations on your project's "
|
|
|
|
"admin dashboard, under **Integrations**. You can select any of these "
|
|
|
|
"integrations to see the *integration detail page*. This page has additional "
|
|
|
|
"configuration details and a list of HTTP exchanges that have taken place for"
|
|
|
|
" the integration."
|
2015-02-28 00:23:18 +00:00
|
|
|
msgstr ""
|
|
|
|
|
2018-09-27 15:51:01 +00:00
|
|
|
#: ../../webhooks.rst:20
|
|
|
|
msgid ""
|
|
|
|
"You need this information for the URL, webhook, or Payload URL needed by the"
|
|
|
|
" repository provider such as GitHub, GitLab, or Bitbucket."
|
2015-02-28 00:23:18 +00:00
|
|
|
msgstr ""
|
|
|
|
|
2018-09-27 15:51:01 +00:00
|
|
|
#: ../../webhooks.rst:24
|
|
|
|
msgid "Webhook Creation"
|
2015-02-28 00:23:18 +00:00
|
|
|
msgstr ""
|
|
|
|
|
2018-09-27 15:51:01 +00:00
|
|
|
#: ../../webhooks.rst:26
|
|
|
|
msgid ""
|
|
|
|
"If you import a project using a :ref:`connected account "
|
|
|
|
"<getting_started:Sign Up and Connect an External Account>`, a webhook will "
|
|
|
|
"be set up automatically for your repository. However, if your project was "
|
|
|
|
"not imported through a connected account, you may need to manually configure"
|
|
|
|
" a webhook for your project."
|
2015-02-28 00:23:18 +00:00
|
|
|
msgstr ""
|
|
|
|
|
2018-09-27 15:51:01 +00:00
|
|
|
#: ../../webhooks.rst:31
|
|
|
|
msgid ""
|
|
|
|
"To manually set up a webhook, click **Add integration** on your project's "
|
|
|
|
"**Integrations** Admin dashboard page and select the integration type you'd "
|
|
|
|
"like to add. After you have added the integration, you'll see a link to "
|
|
|
|
"information about the integration."
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../../webhooks.rst:35
|
|
|
|
msgid ""
|
|
|
|
"As an example, the URL pattern looks like this: "
|
|
|
|
"*readthedocs.org/api/v2/webhook/<project-name>/<id>/*."
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../../webhooks.rst:37
|
|
|
|
msgid ""
|
|
|
|
"Use this URL when setting up a new webhook with your provider -- these steps"
|
|
|
|
" vary depending on the provider:"
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../../webhooks.rst:40
|
|
|
|
msgid "GitHub"
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../../webhooks.rst:42 ../../webhooks.rst:59 ../../webhooks.rst:69
|
|
|
|
msgid "Go to the **Settings** page for your project"
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../../webhooks.rst:43 ../../webhooks.rst:60
|
|
|
|
msgid "Click **Webhooks** and then **Add webhook**"
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../../webhooks.rst:44
|
|
|
|
msgid ""
|
|
|
|
"For **Payload URL**, use the URL of the integration on Read the Docs, found "
|
|
|
|
"on the the project's **Integrations** Admin dashboard page"
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../../webhooks.rst:46
|
|
|
|
msgid ""
|
|
|
|
"For **Content type**, both *application/json* and *application/x-www-form-"
|
|
|
|
"urlencoded* work"
|
2015-02-28 00:23:18 +00:00
|
|
|
msgstr ""
|
|
|
|
|
2018-09-27 15:51:01 +00:00
|
|
|
#: ../../webhooks.rst:48
|
|
|
|
msgid "Select **Just the push event**"
|
2015-02-28 00:23:18 +00:00
|
|
|
msgstr ""
|
|
|
|
|
2018-09-27 15:51:01 +00:00
|
|
|
#: ../../webhooks.rst:49
|
|
|
|
msgid "Finish by clicking **Add webhook**"
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../../webhooks.rst:51
|
|
|
|
msgid ""
|
|
|
|
"You can verify if the webhook is working at the bottom of the GitHub page "
|
|
|
|
"under **Recent Deliveries**. If you see a Response 200, then the webhook is "
|
|
|
|
"correctly configured. For a 403 error, it's likely that the Payload URL is "
|
|
|
|
"incorrect."
|
2015-02-28 00:23:18 +00:00
|
|
|
msgstr ""
|
|
|
|
|
2018-09-27 15:51:01 +00:00
|
|
|
#: ../../webhooks.rst:54
|
|
|
|
msgid ""
|
|
|
|
"The webhook token, intended for the GitHub **Secret** field, is not yet "
|
|
|
|
"implemented."
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../../webhooks.rst:57
|
2015-02-28 00:23:18 +00:00
|
|
|
msgid "Bitbucket"
|
|
|
|
msgstr ""
|
|
|
|
|
2018-09-27 15:51:01 +00:00
|
|
|
#: ../../webhooks.rst:61 ../../webhooks.rst:71
|
2015-02-28 00:23:18 +00:00
|
|
|
msgid ""
|
2018-09-27 15:51:01 +00:00
|
|
|
"For **URL**, use the URL of the integration on Read the Docs, found on the "
|
|
|
|
"**Dashboard** > **Admin** > **Integrations** page"
|
2015-02-28 00:23:18 +00:00
|
|
|
msgstr ""
|
|
|
|
|
2018-09-27 15:51:01 +00:00
|
|
|
#: ../../webhooks.rst:63
|
|
|
|
msgid "Under **Triggers**, **Repository push** should be selected"
|
2015-02-28 00:23:18 +00:00
|
|
|
msgstr ""
|
|
|
|
|
2018-09-27 15:51:01 +00:00
|
|
|
#: ../../webhooks.rst:64
|
|
|
|
msgid "Finish by clicking **Save**"
|
2015-02-28 00:23:18 +00:00
|
|
|
msgstr ""
|
|
|
|
|
2018-09-27 15:51:01 +00:00
|
|
|
#: ../../webhooks.rst:67
|
|
|
|
msgid "GitLab"
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../../webhooks.rst:70
|
|
|
|
msgid "Click **Integrations**"
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../../webhooks.rst:73
|
|
|
|
msgid ""
|
|
|
|
"Leave the default **Push events** selected and mark **Tag push events** also"
|
2015-02-28 00:23:18 +00:00
|
|
|
msgstr ""
|
|
|
|
|
2018-09-27 15:51:01 +00:00
|
|
|
#: ../../webhooks.rst:74
|
|
|
|
msgid "Finish by clicking **Add Webhook**"
|
2015-02-28 00:23:18 +00:00
|
|
|
msgstr ""
|
|
|
|
|
2018-09-27 15:51:01 +00:00
|
|
|
#: ../../webhooks.rst:77
|
|
|
|
msgid "Using the generic API integration"
|
2015-02-28 00:23:18 +00:00
|
|
|
msgstr ""
|
|
|
|
|
2018-09-27 15:51:01 +00:00
|
|
|
#: ../../webhooks.rst:79
|
2015-02-28 00:23:18 +00:00
|
|
|
msgid ""
|
2018-09-27 15:51:01 +00:00
|
|
|
"For repositories that are not hosted with a supported provider, we also "
|
|
|
|
"offer a generic API endpoint for triggering project builds. Similar to "
|
|
|
|
"webhook integrations, this integration has a specific URL, found on the "
|
|
|
|
"project's **Integrations** Admin dashboard page on readthedocs.org."
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../../webhooks.rst:84
|
|
|
|
msgid ""
|
|
|
|
"Token authentication is required to use the generic endpoint, you will find "
|
|
|
|
"this token on the integration details page. The token should be passed in as"
|
|
|
|
" a request parameter, either as form data or as part of JSON data input."
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../../webhooks.rst:89
|
|
|
|
msgid "Parameters"
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../../webhooks.rst:91
|
|
|
|
msgid "This endpoint accepts the following arguments during an HTTP POST:"
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../../webhooks.rst:97
|
|
|
|
msgid "branches"
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../../webhooks.rst:94
|
|
|
|
msgid ""
|
|
|
|
"The names of the branches to trigger builds for. This can either be an array"
|
|
|
|
" of branch name strings, or just a single branch name string."
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../../webhooks.rst:97
|
|
|
|
msgid "Default: **latest**"
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../../webhooks.rst:101
|
|
|
|
msgid "token"
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../../webhooks.rst:100
|
|
|
|
msgid ""
|
|
|
|
"The integration token. You'll find this value on the project's "
|
|
|
|
"**Integrations** Admin dashboard page."
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../../webhooks.rst:103
|
|
|
|
msgid ""
|
|
|
|
"For example, the cURL command to build the ``dev`` branch, using the token "
|
|
|
|
"``1234``, would be::"
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../../webhooks.rst:108
|
|
|
|
msgid ""
|
|
|
|
"A command like the one above could be called from a cron job or from a hook "
|
|
|
|
"inside Git_, Subversion_, Mercurial_, or Bazaar_."
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../../webhooks.rst:117
|
|
|
|
msgid "Authentication"
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../../webhooks.rst:119
|
|
|
|
msgid ""
|
|
|
|
"This endpoint requires authentication. If authenticating with an integration"
|
|
|
|
" token, a check will determine if the token is valid and matches the given "
|
|
|
|
"project. If instead an authenticated user is used to make this request, a "
|
|
|
|
"check will be performed to ensure the authenticated user is an owner of the "
|
|
|
|
"project."
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../../webhooks.rst:125
|
|
|
|
msgid "Debugging webhooks"
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../../webhooks.rst:127
|
|
|
|
msgid ""
|
|
|
|
"If you are experiencing problems with an existing webhook, you may be able "
|
|
|
|
"to use the integration detail page to help debug the issue. Each project "
|
|
|
|
"integration, such as a webhook or the generic API endpoint, stores the HTTP "
|
|
|
|
"exchange that takes place between Read the Docs and the external source. "
|
|
|
|
"You'll find a list of these exchanges in any of the integration detail "
|
|
|
|
"pages."
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../../webhooks.rst:134
|
|
|
|
msgid "Resyncing webhooks"
|
2015-02-28 00:23:18 +00:00
|
|
|
msgstr ""
|
|
|
|
|
2018-09-27 15:51:01 +00:00
|
|
|
#: ../../webhooks.rst:136
|
2015-02-28 00:23:18 +00:00
|
|
|
msgid ""
|
2018-09-27 15:51:01 +00:00
|
|
|
"It might be necessary to re-establish a webhook if you are noticing "
|
|
|
|
"problems. To resync a webhook from Read the Docs, visit the integration "
|
|
|
|
"detail page and follow the directions for re-syncing your repository "
|
|
|
|
"webhook."
|
2015-02-28 00:23:18 +00:00
|
|
|
msgstr ""
|