228 lines
7.2 KiB
Plaintext
228 lines
7.2 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
|
# Copyright (C) 2010-2018, Read the Docs, Inc & contributors
|
|
# This file is distributed under the same license as the Read the Docs package.
|
|
#
|
|
# Translators:
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: readthedocs-docs\n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"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: Portuguese (Brazil) (http://www.transifex.com/readthedocs/readthedocs-docs/language/pt_BR/)\n"
|
|
"MIME-Version: 1.0\n"
|
|
"Content-Type: text/plain; charset=UTF-8\n"
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
"Language: pt_BR\n"
|
|
"Plural-Forms: nplurals=2; plural=(n > 1);\n"
|
|
|
|
#: ../../getting_started.rst:2
|
|
msgid "Getting Started"
|
|
msgstr ""
|
|
|
|
#: ../../getting_started.rst:4
|
|
msgid ""
|
|
"This document will show you how to get up and running with Read the Docs. "
|
|
"You will have your docs imported on Read the Docs in 5 minutes, displayed "
|
|
"beautifully for the world."
|
|
msgstr ""
|
|
|
|
#: ../../getting_started.rst:8
|
|
msgid ""
|
|
"If you are already using Sphinx or Markdown for your docs, skip ahead to "
|
|
":ref:`getting_started:Import Your Docs`."
|
|
msgstr ""
|
|
|
|
#: ../../getting_started.rst:12
|
|
msgid "Write Your Docs"
|
|
msgstr ""
|
|
|
|
#: ../../getting_started.rst:14
|
|
msgid "You have two options for formatting your documentation:"
|
|
msgstr ""
|
|
|
|
#: ../../getting_started.rst:16
|
|
msgid "`In reStructuredText`_"
|
|
msgstr ""
|
|
|
|
#: ../../getting_started.rst:17
|
|
msgid "`In Markdown`_"
|
|
msgstr ""
|
|
|
|
#: ../../getting_started.rst:20
|
|
msgid "In reStructuredText"
|
|
msgstr ""
|
|
|
|
#: ../../getting_started.rst:22
|
|
msgid "There is `a screencast`_ that will help you get started if you prefer."
|
|
msgstr ""
|
|
|
|
#: ../../getting_started.rst:24
|
|
msgid ""
|
|
"Sphinx_ is a tool that makes it easy to create beautiful documentation. "
|
|
"Assuming you have Python_ already, `install Sphinx`_::"
|
|
msgstr ""
|
|
|
|
#: ../../getting_started.rst:29
|
|
msgid "Create a directory inside your project to hold your docs::"
|
|
msgstr ""
|
|
|
|
#: ../../getting_started.rst:34
|
|
msgid "Run ``sphinx-quickstart`` in there::"
|
|
msgstr ""
|
|
|
|
#: ../../getting_started.rst:39
|
|
msgid ""
|
|
"This quick start will walk you through creating the basic configuration; in "
|
|
"most cases, you can just accept the defaults. When it's done, you'll have an"
|
|
" ``index.rst``, a ``conf.py`` and some other files. Add these to revision "
|
|
"control."
|
|
msgstr ""
|
|
|
|
#: ../../getting_started.rst:43
|
|
msgid ""
|
|
"Now, edit your ``index.rst`` and add some information about your project. "
|
|
"Include as much detail as you like (refer to the reStructuredText_ syntax or"
|
|
" `this template`_ if you need help). Build them to see how they look::"
|
|
msgstr ""
|
|
|
|
#: ../../getting_started.rst:49
|
|
msgid ""
|
|
"You can use ``sphinx-autobuild`` to auto-reload your docs. Run ``sphinx-"
|
|
"autobuild . _build/html`` instead."
|
|
msgstr ""
|
|
|
|
#: ../../getting_started.rst:51
|
|
msgid ""
|
|
"Edit your files and rebuild until you like what you see, then commit your "
|
|
"changes and push to your public repository. Once you have Sphinx "
|
|
"documentation in a public repository, you can start using Read the Docs."
|
|
msgstr ""
|
|
|
|
#: ../../getting_started.rst:55
|
|
msgid "In Markdown"
|
|
msgstr ""
|
|
|
|
#: ../../getting_started.rst:57
|
|
msgid ""
|
|
"You can use Markdown and reStructuredText in the same Sphinx project. We "
|
|
"support this natively on Read the Docs, and you can do it locally::"
|
|
msgstr ""
|
|
|
|
#: ../../getting_started.rst:62
|
|
msgid "Then in your ``conf.py``:"
|
|
msgstr ""
|
|
|
|
#: ../../getting_started.rst:74
|
|
msgid ""
|
|
"Markdown doesn't support a lot of the features of Sphinx, like inline markup"
|
|
" and directives. However, it works for basic prose content. reStructuredText"
|
|
" is the preferred format for technical documentation, please read `this blog"
|
|
" post`_ for motivation."
|
|
msgstr ""
|
|
|
|
#: ../../getting_started.rst:83
|
|
msgid "Sign Up and Connect an External Account"
|
|
msgstr ""
|
|
|
|
#: ../../getting_started.rst:85
|
|
msgid ""
|
|
"If you are going to import a repository from GitHub, Bitbucket or GitLab, "
|
|
"you should connect your account to your provider first. Connecting your "
|
|
"account allows for easier importing and enables Read the Docs to configure "
|
|
"your repository webhooks automatically."
|
|
msgstr ""
|
|
|
|
#: ../../getting_started.rst:90
|
|
msgid ""
|
|
"To connect your account, go to your *Settings* dashboard and select "
|
|
"*Connected Services*. From here, you'll be able to connect to your GitHub, "
|
|
"Bitbucket or GitLab account. This process will ask you to authorize a "
|
|
"connection to Read the Docs, that allows us to read information about and "
|
|
"clone your repositories."
|
|
msgstr ""
|
|
|
|
#: ../../getting_started.rst:96
|
|
msgid "Import Your Docs"
|
|
msgstr ""
|
|
|
|
#: ../../getting_started.rst:98
|
|
msgid "To import a repository, visit your dashboard_ and click Import_."
|
|
msgstr ""
|
|
|
|
#: ../../getting_started.rst:100
|
|
msgid ""
|
|
"If you have a connected account, you will see a list of your repositories "
|
|
"that we are able to import. To import one of these projects, just click the "
|
|
"import icon next to the repository you'd like to import. This will bring up "
|
|
"a form that is already filled with your project's information. Feel free to "
|
|
"edit any of these properties, and the click **Next** to build your "
|
|
"documentation."
|
|
msgstr ""
|
|
|
|
#: ../../getting_started.rst:107
|
|
msgid "Manually Import Your Docs"
|
|
msgstr ""
|
|
|
|
#: ../../getting_started.rst:109
|
|
msgid ""
|
|
"If you do not have a connected account, you will need select **Import "
|
|
"Manually** and enter the information for your repository yourself. You will "
|
|
"also need to manually configure the webhook for your repository as well. "
|
|
"When importing your project, you will be asked for the repository URL, along"
|
|
" with some other information for you new project. The URL is normally the "
|
|
"URL or path name you'd use to checkout, clone, or branch your repository. "
|
|
"Some examples:"
|
|
msgstr ""
|
|
|
|
#: ../../getting_started.rst:116
|
|
msgid "Git: ``http://github.com/ericholscher/django-kong.git``"
|
|
msgstr ""
|
|
|
|
#: ../../getting_started.rst:117
|
|
msgid "Mercurial: ``https://bitbucket.org/ianb/pip``"
|
|
msgstr ""
|
|
|
|
#: ../../getting_started.rst:118
|
|
msgid "Subversion: ``http://varnish-cache.org/svn/trunk``"
|
|
msgstr ""
|
|
|
|
#: ../../getting_started.rst:119
|
|
msgid "Bazaar: ``lp:pasta``"
|
|
msgstr ""
|
|
|
|
#: ../../getting_started.rst:121
|
|
msgid "Add an optional homepage URL and some tags, and then click **Next**."
|
|
msgstr ""
|
|
|
|
#: ../../getting_started.rst:123
|
|
msgid ""
|
|
"Once your project is created, you'll need to manually configure the "
|
|
"repository webhook if you would like to have new changesets to trigger "
|
|
"builds for your project on Read the Docs. Go to your project's "
|
|
"**Integrations** page to configure a new webhook, or see :ref:`our steps for"
|
|
" webhook creation <webhooks:Webhook Creation>` for more information on this "
|
|
"process."
|
|
msgstr ""
|
|
|
|
#: ../../getting_started.rst:129
|
|
msgid ""
|
|
"Within a few seconds your code will automatically be fetched from your "
|
|
"public repository, and the documentation will be built. Check out our "
|
|
":doc:`builds` page to learn more about how we build your docs, and to "
|
|
"troubleshoot any issues that arise."
|
|
msgstr ""
|
|
|
|
#: ../../getting_started.rst:134
|
|
msgid ""
|
|
"Read the Docs will host multiple versions of your code. You can read more "
|
|
"about how to use this well on our :doc:`versions` page."
|
|
msgstr ""
|
|
|
|
#: ../../getting_started.rst:137
|
|
msgid ""
|
|
"If you have any more trouble, don't hesitate to reach out to us. The "
|
|
":doc:`support` page has more information on getting in touch."
|
|
msgstr ""
|