Merge tag '2.7.2' into relcorp

hotfix/featureflag-mkdocs-theme
Anthony Johnson 2018-10-24 10:49:00 -06:00
commit b78d1f390c
No known key found for this signature in database
GPG Key ID: 709FE91423F05AA0
1462 changed files with 149583 additions and 66856 deletions

2
.codecov.yml Normal file
View File

@ -0,0 +1,2 @@
comment:
layout: "diff, files"

View File

@ -1,3 +1,19 @@
[run]
branch = true
source = .
omit =
*/**/migrations/*
*/**/management/commands/*
*/**/settings/*
*/**/settings.py
analytics/vendor/*
rtd_tests/*
*/**/tests/**
wsgi.py
[report]
exclude_lines =
if self.debug:
pragma: no cover
raise NotImplementedError
if __name__ == .__main__.:

View File

@ -7,14 +7,14 @@ env:
- ES_VERSION=1.3.9 ES_DOWNLOAD_URL=https://download.elastic.co/elasticsearch/elasticsearch/elasticsearch-${ES_VERSION}.tar.gz
matrix:
include:
- python: 2.7
- python: 3.6
env: TOXENV=docs
- python: 3.6
env: TOXENV=docs-lint
- python: 2.7
- python: 3.6
env: TOXENV=lint
script: tox
- python: 2.7
- python: 3.6
env: TOXENV=eslint
cache:
directories:

View File

@ -1,3 +1,117 @@
Version 2.7.2
-------------
:Date: October 23, 2018
* `@humitos <http://github.com/humitos>`__: Validate the slug generated is valid before importing a project (`#4780 <https://github.com/rtfd/readthedocs.org/pull/4780>`__)
* `@humitos <http://github.com/humitos>`__: Do not log as error a webhook with an invalid branch name (`#4779 <https://github.com/rtfd/readthedocs.org/pull/4779>`__)
* `@ericholscher <http://github.com/ericholscher>`__: Add an index page to our design docs. (`#4775 <https://github.com/rtfd/readthedocs.org/pull/4775>`__)
* `@dojutsu-user <http://github.com/dojutsu-user>`__: Remove /embed API endpoint (`#4771 <https://github.com/rtfd/readthedocs.org/pull/4771>`__)
* `@stsewd <http://github.com/stsewd>`__: Upgrade logs from debug on middleware (`#4769 <https://github.com/rtfd/readthedocs.org/pull/4769>`__)
* `@humitos <http://github.com/humitos>`__: Link to SSL for Custom Domains fixed (`#4766 <https://github.com/rtfd/readthedocs.org/pull/4766>`__)
* `@ericholscher <http://github.com/ericholscher>`__: Remove Eric & Anthony from ADMINS & MANAGERS settings (`#4762 <https://github.com/rtfd/readthedocs.org/pull/4762>`__)
* `@humitos <http://github.com/humitos>`__: Do not re-raise the exception if the one that we are checking (`#4761 <https://github.com/rtfd/readthedocs.org/pull/4761>`__)
* `@humitos <http://github.com/humitos>`__: Do not fail when unlinking an non-existing path (`#4760 <https://github.com/rtfd/readthedocs.org/pull/4760>`__)
* `@humitos <http://github.com/humitos>`__: Allow to extend the DomainForm from outside (`#4752 <https://github.com/rtfd/readthedocs.org/pull/4752>`__)
* `@davidfischer <http://github.com/davidfischer>`__: Fixes an OSX issue with the test suite (`#4748 <https://github.com/rtfd/readthedocs.org/pull/4748>`__)
* `@humitos <http://github.com/humitos>`__: Use Docker time limit for max lock age (`#4747 <https://github.com/rtfd/readthedocs.org/pull/4747>`__)
* `@xyNNN <http://github.com/xyNNN>`__: Fixed link of PagerDuty (`#4744 <https://github.com/rtfd/readthedocs.org/pull/4744>`__)
* `@davidfischer <http://github.com/davidfischer>`__: Make storage syncers extend from a base class (`#4742 <https://github.com/rtfd/readthedocs.org/pull/4742>`__)
* `@ericholscher <http://github.com/ericholscher>`__: Revert "Upgrade theme media to 0.4.2" (`#4735 <https://github.com/rtfd/readthedocs.org/pull/4735>`__)
* `@ericholscher <http://github.com/ericholscher>`__: Upgrade theme media to 0.4.2 (`#4734 <https://github.com/rtfd/readthedocs.org/pull/4734>`__)
* `@stsewd <http://github.com/stsewd>`__: Extend install option from config file (v2, schema only) (`#4732 <https://github.com/rtfd/readthedocs.org/pull/4732>`__)
* `@stsewd <http://github.com/stsewd>`__: Remove /cname endpoint (`#4731 <https://github.com/rtfd/readthedocs.org/pull/4731>`__)
* `@ericholscher <http://github.com/ericholscher>`__: Fix get_vcs_repo by moving it to the Mixin (`#4727 <https://github.com/rtfd/readthedocs.org/pull/4727>`__)
* `@humitos <http://github.com/humitos>`__: Guide explaining how to keep compatibility with mkdocs (`#4726 <https://github.com/rtfd/readthedocs.org/pull/4726>`__)
* `@ericholscher <http://github.com/ericholscher>`__: Release 2.7.1 (`#4725 <https://github.com/rtfd/readthedocs.org/pull/4725>`__)
* `@dojutsu-user <http://github.com/dojutsu-user>`__: Fix the form for adopting a project (`#4721 <https://github.com/rtfd/readthedocs.org/pull/4721>`__)
* `@ericholscher <http://github.com/ericholscher>`__: Remove logging verbosity on syncer failure (`#4717 <https://github.com/rtfd/readthedocs.org/pull/4717>`__)
* `@humitos <http://github.com/humitos>`__: Lint requirement file for py2 (`#4712 <https://github.com/rtfd/readthedocs.org/pull/4712>`__)
* `@davidfischer <http://github.com/davidfischer>`__: Improve the getting started docs (`#4676 <https://github.com/rtfd/readthedocs.org/pull/4676>`__)
* `@stsewd <http://github.com/stsewd>`__: Strict validation in configuration file (v2 only) (`#4607 <https://github.com/rtfd/readthedocs.org/pull/4607>`__)
* `@stsewd <http://github.com/stsewd>`__: Run coverage on travis (`#4605 <https://github.com/rtfd/readthedocs.org/pull/4605>`__)
Version 2.7.1
-------------
:Date: October 04, 2018
* `@ericholscher <http://github.com/ericholscher>`__: Revert "Merge pull request #4636 from rtfd/search_upgrade" (`#4716 <https://github.com/rtfd/readthedocs.org/pull/4716>`__)
* `@ericholscher <http://github.com/ericholscher>`__: Reduce the logging we do on CNAME 404 (`#4715 <https://github.com/rtfd/readthedocs.org/pull/4715>`__)
* `@davidfischer <http://github.com/davidfischer>`__: Minor redirect admin improvements (`#4709 <https://github.com/rtfd/readthedocs.org/pull/4709>`__)
* `@humitos <http://github.com/humitos>`__: Define the doc_search reverse URL from inside the __init__ on test (`#4703 <https://github.com/rtfd/readthedocs.org/pull/4703>`__)
* `@ericholscher <http://github.com/ericholscher>`__: Revert "auto refresh false" (`#4701 <https://github.com/rtfd/readthedocs.org/pull/4701>`__)
* `@browniebroke <http://github.com/browniebroke>`__: Remove unused package nilsimsa (`#4697 <https://github.com/rtfd/readthedocs.org/pull/4697>`__)
* `@stsewd <http://github.com/stsewd>`__: Fix broken url on sphinx projects (`#4696 <https://github.com/rtfd/readthedocs.org/pull/4696>`__)
* `@safwanrahman <http://github.com/safwanrahman>`__: Tuning elasticsearch shard and replica (`#4689 <https://github.com/rtfd/readthedocs.org/pull/4689>`__)
* `@ericholscher <http://github.com/ericholscher>`__: Fix bug where we were not indexing Sphinx HTMLDir projects (`#4685 <https://github.com/rtfd/readthedocs.org/pull/4685>`__)
* `@ericholscher <http://github.com/ericholscher>`__: Fix the queryset used in chunking (`#4683 <https://github.com/rtfd/readthedocs.org/pull/4683>`__)
* `@ericholscher <http://github.com/ericholscher>`__: Fix python 2 syntax for getting first key in search index update (`#4682 <https://github.com/rtfd/readthedocs.org/pull/4682>`__)
* `@ericholscher <http://github.com/ericholscher>`__: Release 2.7.0 (`#4681 <https://github.com/rtfd/readthedocs.org/pull/4681>`__)
* `@davidfischer <http://github.com/davidfischer>`__: Increase footer ad text size (`#4678 <https://github.com/rtfd/readthedocs.org/pull/4678>`__)
* `@davidfischer <http://github.com/davidfischer>`__: Fix broken docs links (`#4677 <https://github.com/rtfd/readthedocs.org/pull/4677>`__)
* `@ericholscher <http://github.com/ericholscher>`__: Remove search autosync from tests so local tests work (`#4675 <https://github.com/rtfd/readthedocs.org/pull/4675>`__)
* `@stsewd <http://github.com/stsewd>`__: Refactor tasks into decorators (`#4666 <https://github.com/rtfd/readthedocs.org/pull/4666>`__)
* `@stsewd <http://github.com/stsewd>`__: Clean up logging (`#4665 <https://github.com/rtfd/readthedocs.org/pull/4665>`__)
* `@davidfischer <http://github.com/davidfischer>`__: Ad customization docs (`#4659 <https://github.com/rtfd/readthedocs.org/pull/4659>`__)
* `@davidfischer <http://github.com/davidfischer>`__: Fix a typo in the privacy policy (`#4658 <https://github.com/rtfd/readthedocs.org/pull/4658>`__)
* `@stsewd <http://github.com/stsewd>`__: Refactor PublicTask into a decorator task (`#4656 <https://github.com/rtfd/readthedocs.org/pull/4656>`__)
* `@stsewd <http://github.com/stsewd>`__: Remove -r option from update_repos command (`#4653 <https://github.com/rtfd/readthedocs.org/pull/4653>`__)
* `@davidfischer <http://github.com/davidfischer>`__: Create an explicit ad placement (`#4647 <https://github.com/rtfd/readthedocs.org/pull/4647>`__)
* `@agjohnson <http://github.com/agjohnson>`__: Use collectstatic on `media/`, without collecting user files (`#4502 <https://github.com/rtfd/readthedocs.org/pull/4502>`__)
* `@stsewd <http://github.com/stsewd>`__: Implement submodules key from v2 config (`#4493 <https://github.com/rtfd/readthedocs.org/pull/4493>`__)
* `@stsewd <http://github.com/stsewd>`__: Implement mkdocs key from v2 config (`#4486 <https://github.com/rtfd/readthedocs.org/pull/4486>`__)
* `@agjohnson <http://github.com/agjohnson>`__: Add docs on our roadmap process (`#4469 <https://github.com/rtfd/readthedocs.org/pull/4469>`__)
* `@humitos <http://github.com/humitos>`__: Send notifications when generic/unhandled failures (`#3864 <https://github.com/rtfd/readthedocs.org/pull/3864>`__)
* `@stsewd <http://github.com/stsewd>`__: Use relative path for docroot on mkdocs (`#3525 <https://github.com/rtfd/readthedocs.org/pull/3525>`__)
Version 2.7.0
-------------
:Date: September 29, 2018
**Reverted, do not use**
Version 2.6.6
-------------
:Date: September 25, 2018
* `@davidfischer <http://github.com/davidfischer>`__: Fix a markdown test error (`#4663 <https://github.com/rtfd/readthedocs.org/pull/4663>`__)
* `@davidfischer <http://github.com/davidfischer>`__: Ad customization docs (`#4659 <https://github.com/rtfd/readthedocs.org/pull/4659>`__)
* `@davidfischer <http://github.com/davidfischer>`__: Fix a typo in the privacy policy (`#4658 <https://github.com/rtfd/readthedocs.org/pull/4658>`__)
* `@agjohnson <http://github.com/agjohnson>`__: Put search step back into project build task (`#4655 <https://github.com/rtfd/readthedocs.org/pull/4655>`__)
* `@davidfischer <http://github.com/davidfischer>`__: Create an explicit ad placement (`#4647 <https://github.com/rtfd/readthedocs.org/pull/4647>`__)
* `@stsewd <http://github.com/stsewd>`__: Fix some typos in docs and code (`#4646 <https://github.com/rtfd/readthedocs.org/pull/4646>`__)
* `@stsewd <http://github.com/stsewd>`__: Downgrade celery (`#4644 <https://github.com/rtfd/readthedocs.org/pull/4644>`__)
* `@stsewd <http://github.com/stsewd>`__: Downgrade django-taggit (`#4639 <https://github.com/rtfd/readthedocs.org/pull/4639>`__)
* `@safwanrahman <http://github.com/safwanrahman>`__: [Fix #4247] deleting old search code (`#4635 <https://github.com/rtfd/readthedocs.org/pull/4635>`__)
* `@stsewd <http://github.com/stsewd>`__: Add change versions slug to faq (`#4633 <https://github.com/rtfd/readthedocs.org/pull/4633>`__)
* `@stsewd <http://github.com/stsewd>`__: Pin sphinx to a compatible version (`#4631 <https://github.com/rtfd/readthedocs.org/pull/4631>`__)
* `@davidfischer <http://github.com/davidfischer>`__: Make ads more obvious that they are ads (`#4628 <https://github.com/rtfd/readthedocs.org/pull/4628>`__)
* `@agjohnson <http://github.com/agjohnson>`__: Change mentions of "CNAME" -> custom domain (`#4627 <https://github.com/rtfd/readthedocs.org/pull/4627>`__)
* `@invinciblycool <http://github.com/invinciblycool>`__: Use validate_dict for more accurate error messages (`#4617 <https://github.com/rtfd/readthedocs.org/pull/4617>`__)
* `@safwanrahman <http://github.com/safwanrahman>`__: fixing the indexing (`#4615 <https://github.com/rtfd/readthedocs.org/pull/4615>`__)
* `@humitos <http://github.com/humitos>`__: Update our sponsors to mention Azure (`#4614 <https://github.com/rtfd/readthedocs.org/pull/4614>`__)
* `@agjohnson <http://github.com/agjohnson>`__: Add cwd to subprocess calls (`#4611 <https://github.com/rtfd/readthedocs.org/pull/4611>`__)
* `@agjohnson <http://github.com/agjohnson>`__: Make restapi URL additions conditional (`#4609 <https://github.com/rtfd/readthedocs.org/pull/4609>`__)
* `@agjohnson <http://github.com/agjohnson>`__: Ability to use supervisor from python 2.7 and still run Python 3 (`#4606 <https://github.com/rtfd/readthedocs.org/pull/4606>`__)
* `@humitos <http://github.com/humitos>`__: Return 404 for inactive versions and allow redirects on them (`#4599 <https://github.com/rtfd/readthedocs.org/pull/4599>`__)
* `@davidfischer <http://github.com/davidfischer>`__: Fixes an issue with duplicate gold subscriptions (`#4597 <https://github.com/rtfd/readthedocs.org/pull/4597>`__)
* `@davidfischer <http://github.com/davidfischer>`__: Fix ad block nag project issue (`#4596 <https://github.com/rtfd/readthedocs.org/pull/4596>`__)
* `@humitos <http://github.com/humitos>`__: Run all our tests with Python 3.6 on Travis (`#4592 <https://github.com/rtfd/readthedocs.org/pull/4592>`__)
* `@humitos <http://github.com/humitos>`__: Sanitize command output when running under DockerBuildEnvironment (`#4591 <https://github.com/rtfd/readthedocs.org/pull/4591>`__)
* `@humitos <http://github.com/humitos>`__: Force resolver to use PUBLIC_DOMAIN over HTTPS if not Domain.https (`#4579 <https://github.com/rtfd/readthedocs.org/pull/4579>`__)
* `@davidfischer <http://github.com/davidfischer>`__: Updates and simplification for mkdocs (`#4556 <https://github.com/rtfd/readthedocs.org/pull/4556>`__)
* `@humitos <http://github.com/humitos>`__: Docs for hidding "On ..." section from versions menu (`#4547 <https://github.com/rtfd/readthedocs.org/pull/4547>`__)
* `@stsewd <http://github.com/stsewd>`__: Implement sphinx key from v2 config (`#4482 <https://github.com/rtfd/readthedocs.org/pull/4482>`__)
* `@safwanrahman <http://github.com/safwanrahman>`__: [Fix #4268] Adding Documentation for upgraded Search (`#4467 <https://github.com/rtfd/readthedocs.org/pull/4467>`__)
* `@humitos <http://github.com/humitos>`__: Upgrade all packages using pur (`#4318 <https://github.com/rtfd/readthedocs.org/pull/4318>`__)
* `@humitos <http://github.com/humitos>`__: Clean CC sensible data on Gold subscriptions (`#4291 <https://github.com/rtfd/readthedocs.org/pull/4291>`__)
* `@stsewd <http://github.com/stsewd>`__: Update docs to match the new triague guidelines (`#4260 <https://github.com/rtfd/readthedocs.org/pull/4260>`__)
* `@xrmx <http://github.com/xrmx>`__: Make the STABLE and LATEST constants overridable (`#4099 <https://github.com/rtfd/readthedocs.org/pull/4099>`__)
* `@stsewd <http://github.com/stsewd>`__: Use str to get the exception message (`#3912 <https://github.com/rtfd/readthedocs.org/pull/3912>`__)
Version 2.6.5
-------------

View File

@ -26,7 +26,7 @@ stderr_logfile = /dev/stderr
stderr_logfile_maxbytes = 0
[program:main]
command = python manage.py runserver 8000
command = python3 manage.py runserver 8000
directory = ../
priority = 100
stopasgroup = True
@ -34,7 +34,7 @@ stderr_logfile = /dev/stderr
stderr_logfile_maxbytes = 0
[program:celery]
command = celery worker -A readthedocs -Q default,celery,web,builder -l DEBUG -c 2
command = python3 -m celery worker -A readthedocs -Q default,celery,web,builder -l DEBUG -c 2
directory = ../
priority = 100
stopasgroup = True

View File

@ -1,424 +1,429 @@
[main]
host = https://www.transifex.com
type = PO
[readthedocs-docs.tests]
file_filter = locale/<lang>/LC_MESSAGES/tests.po
source_file = locale/pot/tests.pot
source_lang = en
type = PO
[readthedocs-docs.user-defined-redirects]
file_filter = locale/<lang>/LC_MESSAGES/user-defined-redirects.po
source_file = locale/pot/user-defined-redirects.pot
source_lang = en
type = PO
[readthedocs-docs.badges]
file_filter = locale/<lang>/LC_MESSAGES/badges.po
source_file = locale/pot/badges.pot
source_lang = en
type = PO
[readthedocs-docs.privacy-policy]
file_filter = locale/<lang>/LC_MESSAGES/privacy-policy.po
source_file = locale/pot/privacy-policy.pot
source_lang = en
type = PO
[readthedocs-docs.conda]
file_filter = locale/<lang>/LC_MESSAGES/conda.po
source_file = locale/pot/conda.pot
source_lang = en
type = PO
[readthedocs-docs.changelog]
file_filter = locale/<lang>/LC_MESSAGES/changelog.po
source_file = locale/pot/changelog.pot
source_lang = en
type = PO
[readthedocs-docs.docs]
file_filter = locale/<lang>/LC_MESSAGES/docs.po
source_file = locale/pot/docs.pot
source_lang = en
type = PO
[readthedocs-docs.sponsors]
file_filter = locale/<lang>/LC_MESSAGES/sponsors.po
source_file = locale/pot/sponsors.pot
source_lang = en
type = PO
[readthedocs-docs.localization]
file_filter = locale/<lang>/LC_MESSAGES/localization.po
source_file = locale/pot/localization.pot
[readthedocs-docs.embed]
file_filter = locale/<lang>/LC_MESSAGES/embed.po
source_file = _build/locale/embed.pot
source_lang = en
type = PO
[readthedocs-docs.privacy]
file_filter = locale/<lang>/LC_MESSAGES/privacy.po
source_file = locale/pot/privacy.pot
source_file = _build/locale/privacy.pot
source_lang = en
type = PO
[readthedocs-docs.canonical]
file_filter = locale/<lang>/LC_MESSAGES/canonical.po
source_file = locale/pot/canonical.pot
[readthedocs-docs.user-defined-redirects]
file_filter = locale/<lang>/LC_MESSAGES/user-defined-redirects.po
source_file = _build/locale/user-defined-redirects.pot
source_lang = en
type = PO
[readthedocs-docs.vcs]
file_filter = locale/<lang>/LC_MESSAGES/vcs.po
source_file = locale/pot/vcs.pot
source_lang = en
type = PO
[readthedocs-docs.contribute]
file_filter = locale/<lang>/LC_MESSAGES/contribute.po
source_file = locale/pot/contribute.pot
source_lang = en
type = PO
[readthedocs-docs.abandoned-projects]
file_filter = locale/<lang>/LC_MESSAGES/abandoned-projects.po
source_file = locale/pot/abandoned-projects.pot
source_lang = en
type = PO
[readthedocs-docs.open-source-philosophy]
file_filter = locale/<lang>/LC_MESSAGES/open-source-philosophy.po
source_file = locale/pot/open-source-philosophy.pot
source_lang = en
type = PO
[readthedocs-docs.faq]
file_filter = locale/<lang>/LC_MESSAGES/faq.po
source_file = locale/pot/faq.pot
source_lang = en
type = PO
[readthedocs-docs.install]
file_filter = locale/<lang>/LC_MESSAGES/install.po
source_file = locale/pot/install.pot
source_lang = en
type = PO
[readthedocs-docs.architecture]
file_filter = locale/<lang>/LC_MESSAGES/architecture.po
source_file = locale/pot/architecture.pot
source_lang = en
type = PO
[readthedocs-docs.i18n]
file_filter = locale/<lang>/LC_MESSAGES/i18n.po
source_file = locale/pot/i18n.pot
source_lang = en
type = PO
[readthedocs-docs.alternate_domains]
file_filter = locale/<lang>/LC_MESSAGES/alternate_domains.po
source_file = locale/pot/alternate_domains.pot
source_lang = en
type = PO
[readthedocs-docs.settings]
file_filter = locale/<lang>/LC_MESSAGES/settings.po
source_file = locale/pot/settings.pot
source_lang = en
type = PO
[readthedocs-docs.getting_started]
file_filter = locale/<lang>/LC_MESSAGES/getting_started.po
source_file = locale/pot/getting_started.pot
source_lang = en
type = PO
[readthedocs-docs.versions]
file_filter = locale/<lang>/LC_MESSAGES/versions.po
source_file = locale/pot/versions.pot
source_lang = en
type = PO
[readthedocs-docs.subprojects]
file_filter = locale/<lang>/LC_MESSAGES/subprojects.po
source_file = locale/pot/subprojects.pot
source_lang = en
type = PO
[readthedocs-docs.single_version]
file_filter = locale/<lang>/LC_MESSAGES/single_version.po
source_file = locale/pot/single_version.pot
source_lang = en
type = PO
[readthedocs-docs.features]
file_filter = locale/<lang>/LC_MESSAGES/features.po
source_file = locale/pot/features.pot
source_lang = en
type = PO
[readthedocs-docs.gsoc]
file_filter = locale/<lang>/LC_MESSAGES/gsoc.po
source_file = locale/pot/gsoc.pot
source_lang = en
type = PO
[readthedocs-docs.story]
file_filter = locale/<lang>/LC_MESSAGES/story.po
source_file = locale/pot/story.pot
source_lang = en
type = PO
[readthedocs-docs.embed]
file_filter = locale/<lang>/LC_MESSAGES/embed.po
source_file = locale/pot/embed.pot
source_lang = en
type = PO
[readthedocs-docs.automatic-redirects]
file_filter = locale/<lang>/LC_MESSAGES/automatic-redirects.po
source_file = locale/pot/automatic-redirects.pot
source_lang = en
type = PO
[readthedocs-docs.webhooks]
file_filter = locale/<lang>/LC_MESSAGES/webhooks.po
source_file = locale/pot/webhooks.pot
source_lang = en
type = PO
[readthedocs-docs.security]
file_filter = locale/<lang>/LC_MESSAGES/security.po
source_file = locale/pot/security.pot
source_lang = en
type = PO
[readthedocs-docs.code-of-conduct]
file_filter = locale/<lang>/LC_MESSAGES/code-of-conduct.po
source_file = locale/pot/code-of-conduct.pot
source_lang = en
type = PO
[readthedocs-docs.support]
file_filter = locale/<lang>/LC_MESSAGES/support.po
source_file = locale/pot/support.pot
source_lang = en
type = PO
[readthedocs-docs.symlinks]
file_filter = locale/<lang>/LC_MESSAGES/symlinks.po
source_file = locale/pot/symlinks.pot
[readthedocs-docs.sponsors]
file_filter = locale/<lang>/LC_MESSAGES/sponsors.po
source_file = _build/locale/sponsors.pot
source_lang = en
type = PO
[readthedocs-docs.team]
file_filter = locale/<lang>/LC_MESSAGES/team.po
source_file = locale/pot/team.pot
source_file = _build/locale/team.pot
source_lang = en
type = PO
[readthedocs-docs.issue-labels]
file_filter = locale/<lang>/LC_MESSAGES/issue-labels.po
source_file = locale/pot/issue-labels.pot
source_lang = en
type = PO
[readthedocs-docs.yaml-config]
file_filter = locale/<lang>/LC_MESSAGES/yaml-config.po
source_file = locale/pot/yaml-config.pot
source_lang = en
type = PO
[readthedocs-docs.index]
file_filter = locale/<lang>/LC_MESSAGES/index.po
source_file = locale/pot/index.pot
[readthedocs-docs.install]
file_filter = locale/<lang>/LC_MESSAGES/install.po
source_file = _build/locale/install.pot
source_lang = en
type = PO
[readthedocs-docs.design]
file_filter = locale/<lang>/LC_MESSAGES/design.po
source_file = locale/pot/design.pot
source_file = _build/locale/design.pot
source_lang = en
type = PO
[readthedocs-docs.builds]
file_filter = locale/<lang>/LC_MESSAGES/builds.po
source_file = locale/pot/builds.pot
source_file = _build/locale/builds.pot
source_lang = en
type = PO
[readthedocs-docs.dmca_index]
file_filter = locale/<lang>/LC_MESSAGES/dmca/index.po
source_file = locale/pot/dmca/index.pot
[readthedocs-docs.single_version]
file_filter = locale/<lang>/LC_MESSAGES/single_version.po
source_file = _build/locale/single_version.pot
source_lang = en
type = PO
[readthedocs-docs.business_organizations]
file_filter = locale/<lang>/LC_MESSAGES/business/organizations.po
source_file = locale/pot/business/organizations.pot
[readthedocs-docs.open-source-philosophy]
file_filter = locale/<lang>/LC_MESSAGES/open-source-philosophy.po
source_file = _build/locale/open-source-philosophy.pot
source_lang = en
type = PO
[readthedocs-docs.business_sharing]
file_filter = locale/<lang>/LC_MESSAGES/business/sharing.po
source_file = locale/pot/business/sharing.pot
[readthedocs-docs.webhooks]
file_filter = locale/<lang>/LC_MESSAGES/webhooks.po
source_file = _build/locale/webhooks.pot
source_lang = en
type = PO
[readthedocs-docs.business_analytics]
file_filter = locale/<lang>/LC_MESSAGES/business/analytics.po
source_file = locale/pot/business/analytics.pot
[readthedocs-docs.issue-labels]
file_filter = locale/<lang>/LC_MESSAGES/issue-labels.po
source_file = _build/locale/issue-labels.pot
source_lang = en
type = PO
[readthedocs-docs.business_index]
file_filter = locale/<lang>/LC_MESSAGES/business/index.po
source_file = locale/pot/business/index.pot
[readthedocs-docs.security]
file_filter = locale/<lang>/LC_MESSAGES/security.po
source_file = _build/locale/security.pot
source_lang = en
type = PO
[readthedocs-docs.features_embed]
file_filter = locale/<lang>/LC_MESSAGES/features/embed.po
source_file = locale/pot/features/embed.pot
[readthedocs-docs.tests]
file_filter = locale/<lang>/LC_MESSAGES/tests.po
source_file = _build/locale/tests.pot
source_lang = en
type = PO
[readthedocs-docs.development_buildenvironments]
file_filter = locale/<lang>/LC_MESSAGES/development/buildenvironments.po
source_file = locale/pot/development/buildenvironments.pot
[readthedocs-docs.docs]
file_filter = locale/<lang>/LC_MESSAGES/docs.po
source_file = _build/locale/docs.pot
source_lang = en
type = PO
[readthedocs-docs.development_standards]
file_filter = locale/<lang>/LC_MESSAGES/development/standards.po
source_file = locale/pot/development/standards.pot
[readthedocs-docs.alternate_domains]
file_filter = locale/<lang>/LC_MESSAGES/alternate_domains.po
source_file = _build/locale/alternate_domains.pot
source_lang = en
type = PO
[readthedocs-docs.api_v2]
file_filter = locale/<lang>/LC_MESSAGES/api/v2.po
source_file = locale/pot/api/v2.pot
[readthedocs-docs.index]
file_filter = locale/<lang>/LC_MESSAGES/index.po
source_file = _build/locale/index.pot
source_lang = en
type = PO
[readthedocs-docs.api_v1]
file_filter = locale/<lang>/LC_MESSAGES/api/v1.po
source_file = locale/pot/api/v1.pot
[readthedocs-docs.abandoned-projects]
file_filter = locale/<lang>/LC_MESSAGES/abandoned-projects.po
source_file = _build/locale/abandoned-projects.pot
source_lang = en
type = PO
[readthedocs-docs.api_index]
file_filter = locale/<lang>/LC_MESSAGES/api/index.po
source_file = locale/pot/api/index.pot
[readthedocs-docs.canonical]
file_filter = locale/<lang>/LC_MESSAGES/canonical.po
source_file = _build/locale/canonical.pot
source_lang = en
type = PO
[readthedocs-docs.custom_installs_local_rtd_vm]
file_filter = locale/<lang>/LC_MESSAGES/custom_installs/local_rtd_vm.po
source_file = locale/pot/custom_installs/local_rtd_vm.pot
[readthedocs-docs.versions]
file_filter = locale/<lang>/LC_MESSAGES/versions.po
source_file = _build/locale/versions.pot
source_lang = en
type = PO
[readthedocs-docs.custom_installs_customization]
file_filter = locale/<lang>/LC_MESSAGES/custom_installs/customization.po
source_file = locale/pot/custom_installs/customization.pot
[readthedocs-docs.i18n]
file_filter = locale/<lang>/LC_MESSAGES/i18n.po
source_file = _build/locale/i18n.pot
source_lang = en
type = PO
[readthedocs-docs.custom_installs_elasticsearch]
file_filter = locale/<lang>/LC_MESSAGES/custom_installs/elasticsearch.po
source_file = locale/pot/custom_installs/elasticsearch.pot
[readthedocs-docs.yaml-config]
file_filter = locale/<lang>/LC_MESSAGES/yaml-config.po
source_file = _build/locale/yaml-config.pot
source_lang = en
type = PO
[readthedocs-docs.custom_installs_index]
file_filter = locale/<lang>/LC_MESSAGES/custom_installs/index.po
source_file = locale/pot/custom_installs/index.pot
[readthedocs-docs.changelog]
file_filter = locale/<lang>/LC_MESSAGES/changelog.po
source_file = _build/locale/changelog.pot
source_lang = en
type = PO
[readthedocs-docs.design_theme-context]
file_filter = locale/<lang>/LC_MESSAGES/design/theme-context.po
source_file = locale/pot/design/theme-context.pot
[readthedocs-docs.automatic-redirects]
file_filter = locale/<lang>/LC_MESSAGES/automatic-redirects.po
source_file = _build/locale/automatic-redirects.pot
source_lang = en
type = PO
[readthedocs-docs.design_yaml-file]
file_filter = locale/<lang>/LC_MESSAGES/design/yaml-file.po
source_file = locale/pot/design/yaml-file.pot
[readthedocs-docs.support]
file_filter = locale/<lang>/LC_MESSAGES/support.po
source_file = _build/locale/support.pot
source_lang = en
type = PO
[readthedocs-docs.advertising_advertising-details]
file_filter = locale/<lang>/LC_MESSAGES/advertising/advertising-details.po
source_file = locale/pot/advertising/advertising-details.pot
[readthedocs-docs.badges]
file_filter = locale/<lang>/LC_MESSAGES/badges.po
source_file = _build/locale/badges.pot
source_lang = en
type = PO
[readthedocs-docs.advertising_ad-blocking]
file_filter = locale/<lang>/LC_MESSAGES/advertising/ad-blocking.po
source_file = locale/pot/advertising/ad-blocking.pot
[readthedocs-docs.vcs]
file_filter = locale/<lang>/LC_MESSAGES/vcs.po
source_file = _build/locale/vcs.pot
source_lang = en
type = PO
[readthedocs-docs.advertising_ethical-advertising]
file_filter = locale/<lang>/LC_MESSAGES/advertising/ethical-advertising.po
source_file = locale/pot/advertising/ethical-advertising.pot
[readthedocs-docs.features]
file_filter = locale/<lang>/LC_MESSAGES/features.po
source_file = _build/locale/features.pot
source_lang = en
type = PO
[readthedocs-docs.advertising_index]
[readthedocs-docs.gsoc]
file_filter = locale/<lang>/LC_MESSAGES/gsoc.po
source_file = _build/locale/gsoc.pot
source_lang = en
type = PO
[readthedocs-docs.contribute]
file_filter = locale/<lang>/LC_MESSAGES/contribute.po
source_file = _build/locale/contribute.pot
source_lang = en
type = PO
[readthedocs-docs.code-of-conduct]
file_filter = locale/<lang>/LC_MESSAGES/code-of-conduct.po
source_file = _build/locale/code-of-conduct.pot
source_lang = en
type = PO
[readthedocs-docs.architecture]
file_filter = locale/<lang>/LC_MESSAGES/architecture.po
source_file = _build/locale/architecture.pot
source_lang = en
type = PO
[readthedocs-docs.conda]
file_filter = locale/<lang>/LC_MESSAGES/conda.po
source_file = _build/locale/conda.pot
source_lang = en
type = PO
[readthedocs-docs.symlinks]
file_filter = locale/<lang>/LC_MESSAGES/symlinks.po
source_file = _build/locale/symlinks.pot
source_lang = en
type = PO
[readthedocs-docs.subprojects]
file_filter = locale/<lang>/LC_MESSAGES/subprojects.po
source_file = _build/locale/subprojects.pot
source_lang = en
type = PO
[readthedocs-docs.privacy-policy]
file_filter = locale/<lang>/LC_MESSAGES/privacy-policy.po
source_file = _build/locale/privacy-policy.pot
source_lang = en
type = PO
[readthedocs-docs.faq]
file_filter = locale/<lang>/LC_MESSAGES/faq.po
source_file = _build/locale/faq.pot
source_lang = en
type = PO
[readthedocs-docs.getting_started]
file_filter = locale/<lang>/LC_MESSAGES/getting_started.po
source_file = _build/locale/getting_started.pot
source_lang = en
type = PO
[readthedocs-docs.localization]
file_filter = locale/<lang>/LC_MESSAGES/localization.po
source_file = _build/locale/localization.pot
source_lang = en
type = PO
[readthedocs-docs.story]
file_filter = locale/<lang>/LC_MESSAGES/story.po
source_file = _build/locale/story.pot
source_lang = en
type = PO
[readthedocs-docs.advertising--index]
file_filter = locale/<lang>/LC_MESSAGES/advertising/index.po
source_file = locale/pot/advertising/index.pot
source_file = _build/locale/advertising/index.pot
source_lang = en
type = PO
[readthedocs-docs.guides_google-analytics]
[readthedocs-docs.advertising--ethical-advertising]
file_filter = locale/<lang>/LC_MESSAGES/advertising/ethical-advertising.po
source_file = _build/locale/advertising/ethical-advertising.pot
source_lang = en
type = PO
[readthedocs-docs.advertising--ad-blocking]
file_filter = locale/<lang>/LC_MESSAGES/advertising/ad-blocking.po
source_file = _build/locale/advertising/ad-blocking.pot
source_lang = en
type = PO
[readthedocs-docs.advertising--advertising-details]
file_filter = locale/<lang>/LC_MESSAGES/advertising/advertising-details.po
source_file = _build/locale/advertising/advertising-details.pot
source_lang = en
type = PO
[readthedocs-docs.business--sharing]
file_filter = locale/<lang>/LC_MESSAGES/business/sharing.po
source_file = _build/locale/business/sharing.pot
source_lang = en
type = PO
[readthedocs-docs.business--analytics]
file_filter = locale/<lang>/LC_MESSAGES/business/analytics.po
source_file = _build/locale/business/analytics.pot
source_lang = en
type = PO
[readthedocs-docs.business--index]
file_filter = locale/<lang>/LC_MESSAGES/business/index.po
source_file = _build/locale/business/index.pot
source_lang = en
type = PO
[readthedocs-docs.business--organizations]
file_filter = locale/<lang>/LC_MESSAGES/business/organizations.po
source_file = _build/locale/business/organizations.pot
source_lang = en
type = PO
[readthedocs-docs.design--yaml-file]
file_filter = locale/<lang>/LC_MESSAGES/design/yaml-file.po
source_file = _build/locale/design/yaml-file.pot
source_lang = en
type = PO
[readthedocs-docs.design--theme-context]
file_filter = locale/<lang>/LC_MESSAGES/design/theme-context.po
source_file = _build/locale/design/theme-context.pot
source_lang = en
type = PO
[readthedocs-docs.guides--google-analytics]
file_filter = locale/<lang>/LC_MESSAGES/guides/google-analytics.po
source_file = locale/pot/guides/google-analytics.pot
source_file = _build/locale/guides/google-analytics.pot
source_lang = en
type = PO
[readthedocs-docs.guides_adding-custom-css]
file_filter = locale/<lang>/LC_MESSAGES/guides/adding-custom-css.po
source_file = locale/pot/guides/adding-custom-css.pot
source_lang = en
type = PO
[readthedocs-docs.guides_wipe-environment]
file_filter = locale/<lang>/LC_MESSAGES/guides/wipe-environment.po
source_file = locale/pot/guides/wipe-environment.pot
source_lang = en
type = PO
[readthedocs-docs.guides_build-notifications]
file_filter = locale/<lang>/LC_MESSAGES/guides/build-notifications.po
source_file = locale/pot/guides/build-notifications.pot
source_lang = en
type = PO
[readthedocs-docs.guides_build-using-too-many-resources]
[readthedocs-docs.guides--build-using-too-many-resources]
file_filter = locale/<lang>/LC_MESSAGES/guides/build-using-too-many-resources.po
source_file = locale/pot/guides/build-using-too-many-resources.pot
source_file = _build/locale/guides/build-using-too-many-resources.pot
source_lang = en
type = PO
[readthedocs-docs.guides_remove-edit-buttons]
file_filter = locale/<lang>/LC_MESSAGES/guides/remove-edit-buttons.po
source_file = locale/pot/guides/remove-edit-buttons.pot
source_lang = en
type = PO
[readthedocs-docs.guides_specifying-dependencies]
[readthedocs-docs.guides--specifying-dependencies]
file_filter = locale/<lang>/LC_MESSAGES/guides/specifying-dependencies.po
source_file = locale/pot/guides/specifying-dependencies.pot
source_file = _build/locale/guides/specifying-dependencies.pot
source_lang = en
type = PO
[readthedocs-docs.guides_index]
[readthedocs-docs.guides--index]
file_filter = locale/<lang>/LC_MESSAGES/guides/index.po
source_file = locale/pot/guides/index.pot
source_file = _build/locale/guides/index.pot
source_lang = en
type = PO
[readthedocs-docs.guides--build-notifications]
file_filter = locale/<lang>/LC_MESSAGES/guides/build-notifications.po
source_file = _build/locale/guides/build-notifications.pot
source_lang = en
type = PO
[readthedocs-docs.guides--adding-custom-css]
file_filter = locale/<lang>/LC_MESSAGES/guides/adding-custom-css.po
source_file = _build/locale/guides/adding-custom-css.pot
source_lang = en
type = PO
[readthedocs-docs.guides--manage-translations]
file_filter = locale/<lang>/LC_MESSAGES/guides/manage-translations.po
source_file = _build/locale/guides/manage-translations.pot
source_lang = en
type = PO
[readthedocs-docs.guides--wipe-environment]
file_filter = locale/<lang>/LC_MESSAGES/guides/wipe-environment.po
source_file = _build/locale/guides/wipe-environment.pot
source_lang = en
type = PO
[readthedocs-docs.guides--remove-edit-buttons]
file_filter = locale/<lang>/LC_MESSAGES/guides/remove-edit-buttons.po
source_file = _build/locale/guides/remove-edit-buttons.pot
source_lang = en
type = PO
[readthedocs-docs.features--embed]
file_filter = locale/<lang>/LC_MESSAGES/features/embed.po
source_file = _build/locale/features/embed.pot
source_lang = en
type = PO
[readthedocs-docs.custom_installs--local_rtd_vm]
file_filter = locale/<lang>/LC_MESSAGES/custom_installs/local_rtd_vm.po
source_file = _build/locale/custom_installs/local_rtd_vm.pot
source_lang = en
type = PO
[readthedocs-docs.custom_installs--index]
file_filter = locale/<lang>/LC_MESSAGES/custom_installs/index.po
source_file = _build/locale/custom_installs/index.pot
source_lang = en
type = PO
[readthedocs-docs.custom_installs--customization]
file_filter = locale/<lang>/LC_MESSAGES/custom_installs/customization.po
source_file = _build/locale/custom_installs/customization.pot
source_lang = en
type = PO
[readthedocs-docs.custom_installs--elasticsearch]
file_filter = locale/<lang>/LC_MESSAGES/custom_installs/elasticsearch.po
source_file = _build/locale/custom_installs/elasticsearch.pot
source_lang = en
type = PO
[readthedocs-docs.api--v2]
file_filter = locale/<lang>/LC_MESSAGES/api/v2.po
source_file = _build/locale/api/v2.pot
source_lang = en
type = PO
[readthedocs-docs.api--index]
file_filter = locale/<lang>/LC_MESSAGES/api/index.po
source_file = _build/locale/api/index.pot
source_lang = en
type = PO
[readthedocs-docs.api--v1]
file_filter = locale/<lang>/LC_MESSAGES/api/v1.po
source_file = _build/locale/api/v1.pot
source_lang = en
type = PO
[readthedocs-docs.development--buildenvironments]
file_filter = locale/<lang>/LC_MESSAGES/development/buildenvironments.po
source_file = _build/locale/development/buildenvironments.pot
source_lang = en
type = PO
[readthedocs-docs.development--standards]
file_filter = locale/<lang>/LC_MESSAGES/development/standards.po
source_file = _build/locale/development/standards.pot
source_lang = en
type = PO
[readthedocs-docs.dmca--index]
file_filter = locale/<lang>/LC_MESSAGES/dmca/index.po
source_file = _build/locale/dmca/index.pot
source_lang = en
type = PO
[readthedocs-docs.settings_]
file_filter = locale/<lang>/LC_MESSAGES/settings.po
source_file = _build/locale/settings.pot
source_lang = en
type = PO

Binary file not shown.

After

Width:  |  Height:  |  Size: 212 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 56 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 63 KiB

View File

@ -0,0 +1,56 @@
Customizing Advertising
=======================
.. warning::
This document details features that are a **work in progress**.
To discuss this document, please get in touch in the `issue tracker`_.
.. _issue tracker: https://github.com/rtfd/readthedocs.org/issues
In addition to allowing users and documentation authors to
:ref:`opt out <advertising/ethical-advertising:Opting out>` of advertising,
we allow some additional controls for documentation authors to control
the positioning and styling of advertising.
This can improve the performance of advertising or make sure the ad
is in a place where it fits well with the documentation.
Controlling the placement of an ad
----------------------------------
It is possible for a documentation author to instruct Read the Docs
to position advertising in a specific location.
This is done by adding a specific element to the generated body.
The ad will be inserted into this container wherever this element is in the document body.
.. code-block:: html
<div id="ethical-ad-placement"></div>
In Sphinx
~~~~~~~~~
In Sphinx, this is typically done by
adding a new template (under `templates_path`_)
for inclusion in the `HTML sidebar`_ in your ``conf.py``.
.. _HTML sidebar: http://www.sphinx-doc.org/en/master/usage/configuration.html#confval-html_sidebars
.. _templates_path: http://www.sphinx-doc.org/en/master/usage/configuration.html#confval-templates_path
.. code-block:: python
## In conf.py
html_sidebars = { '**': [
'localtoc.html',
'ethicalads.html', # Put the ad below the navigation but above previous/next
'relations.html',
'sourcelink.html',
'searchbox.html',
] }
.. code-block:: html
<!-- In _templates/ethicalads.html -->
<div id="ethical-ad-placement"></div>

View File

@ -11,17 +11,19 @@ Every project has a subdomain that is available to serve its documentation. If y
.. note:: If you have an old project that has an underscore (_) in the name, it will use a subdomain with a hyphen (-).
`RFC 1035 <http://tools.ietf.org/html/rfc1035>`_ has more information on valid subdomains.
CNAME Support
-------------
Custom Domain Support
---------------------
If you have your own domain, you can still host with us.
This requires two steps:
You can also host your documentation from your own domain by adding a domain to
your project:
* Add a CNAME record in your DNS that point to our servers `readthedocs.io`
* Add a Domain object in the **Project Admin > Domains** page for your project.
* Add a CNAME record in your DNS that points the domain to: ``readthedocs.io``
* Add a project domain in the :guilabel:`Domains` project admin page for your project.
.. note:: The ``Domain`` that should be used is the actual subdomain that you want your docs served on.
Generally it will be `docs.projectname.org`.
.. note::
We don't currently support pointing subdomains or naked domains to a project
using ``A`` records. It's best to point a subdomain, ``docs.example.com``
for example, using a CNAME record.
Using pip as an example, https://pip.pypa.io resolves, but is hosted on our infrastructure.
@ -32,23 +34,16 @@ As another example, fabric's dig record looks like this::
;; ANSWER SECTION:
docs.fabfile.org. 7200 IN CNAME readthedocs.io.
.. note::
We used to map your projects documentation from the subdomain that you pointed your CNAME to.
This wasn't workable at scale,
and now we require you to set the domain you want to resolve on your project.
CNAME SSL
---------
Custom Domain SSL
-----------------
By default, when you setup a custom domain to host documentation at Read the Docs,
we will attempt to provision a domain validated SSL certificate for the domain.
This service is generously provided by Cloudflare.
After configuring your custom domain on Read the Docs,
you can see the status of the certificate on the domain edit screen
(**Project Admin > Domains > Edit Domain**).
you can see the status of the certificate on the domain page in your project
admin dashboard (:guilabel:`Domains` > :guilabel:`Edit Domain`).
If your domain has configured CAA records, please do not forget to include
Cloudflare CAA entries, see their `Certification Authority Authorization (CAA)
@ -60,9 +55,11 @@ FAQ <https://support.cloudflare.com/hc/en-us/articles/115000310832-Certification
or another variation. While these continue to resolve,
they do not yet allow us to acquire SSL certificates for those domains.
Point the CNAME to ``readthedocs.io`` and re-request a certificate
by saving the domain (**Project Admin > Domains > Edit Domain**).
by saving the domain in the project admin (:guilabel:`Domains` >
:guilabel:`Edit Domain`).
If you change the CNAME, the SSL certificate issuance can take about one hour.
If you change the CNAME record, the SSL certificate issuance can take about
one hour.
.. important::

View File

@ -70,7 +70,7 @@ Doc Search
It returns data in the format of Elastic Search,
which requires a bit of traversing to use.
In the future we might change the format of this endpoint to make it more abstact.
In the future we might change the format of this endpoint to make it more abstract.
An example URL: https://readthedocs.org/api/v2/docsearch/?project=docs&version=latest&q=subdomains

View File

@ -8,7 +8,7 @@ Diagram
::
+-----------+
| Rackspace |
| Azure |
+-----| Load Bal |------+
| +-----------+ |
| |

View File

@ -47,7 +47,7 @@ we will first look for a ``mkdocs.yml`` file in the root of your repository.
If we don't find one,
we will generate one for you.
Then MkDocs will build any files with a ``.md`` extension within the directory specifed as ``docs_dir`` in the ``mkdocs.yml``.
Then MkDocs will build any files with a ``.md`` extension within the directory specified as ``docs_dir`` in the ``mkdocs.yml``.
If no ``mkdocs.yml`` was found in the root of your repository and we generated one for you,
Read the Docs will attempt to set ``docs_dir`` by sequentially searching for a ``docs``, ``doc``, ``Doc``, or ``book`` directory.
@ -56,6 +56,12 @@ and MkDocs will build the ``.md`` files in that directory.
As MkDocs doesn't support automatic PDF generation,
Read the Docs cannot create a PDF version of your documentation with the *Mkdocs* option.
.. warning::
We strongly recommend to :ref:`pin the MkDocs version <guides/specifying-dependencies:Specifying Dependencies>`
used for your project to build the docs to avoid potential future incompatibilities.
Understanding what's going on
-----------------------------
@ -186,7 +192,9 @@ Writing your own builder
The documentation build system in RTD is made pluggable, so that you can build out your own backend. If you have a documentation format that isn't currently supported, you can add support by contributing a backend.
The builders in :doc:`/developer-interface/doc_builder` detail the higher level parts of the API that you need to implement. A basic run goes something like this::
`The builder backends`_ detail the higher level parts of the API that you need to implement. A basic run goes something like this:
.. sourcecode:: python
backend = get_backend(project.documentation_type)
if force:
@ -196,6 +204,8 @@ The builders in :doc:`/developer-interface/doc_builder` detail the higher level
if success:
backend.move(version)
.. _The builder backends: https://github.com/rtfd/readthedocs.org/tree/master/readthedocs/doc_builder/backends
Deleting a stale or broken build environment
--------------------------------------------

View File

@ -40,8 +40,8 @@ project = u'Read the Docs'
copyright = '2010-{}, Read the Docs, Inc & contributors'.format(
timezone.now().year
)
version = '1.0'
release = '1.0'
version = '2.7'
release = version
exclude_patterns = ['_build']
default_role = 'obj'
intersphinx_mapping = {
@ -71,7 +71,7 @@ locale_dirs = [
gettext_compact = False
html_theme = 'sphinx_rtd_theme'
# html_static_path = ['_static']
html_static_path = ['_static']
html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
html_logo = 'img/logo.svg'
html_theme_options = {

View File

@ -0,0 +1,20 @@
Connecting Your Account
-----------------------
If you are going to import repositories from GitHub, Bitbucket, or GitLab,
you should connect your Read the Docs account to your repository host first.
Connecting your account allows for:
* Easier importing of your repositories
* Automatically configure your repository :doc:`webhooks`
which allow Read the Docs to build your docs on every change to your repository
* Log into Read the Docs with your GitHub, Bitbucket, or GitLab credentials
If you signed up or logged in to Read the Docs with your GitHub, Bitbucket, or GitLab
credentials, you're all done. Your account is connected.
To connect your unconnected account, go to your *Settings* dashboard
and select `Connected Services <https://readthedocs.org/accounts/social/connections/>`_.
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.

View File

@ -30,13 +30,15 @@ suggest you have a look at tickets in our issue tracker that are labelled `Good
First Issue`_. These are meant to be a great way to get a smooth start and
won't put you in front of the most complex parts of the system.
If you are up to more challenging tasks with a bigger scope, then there are a
set of tickets with a `Feature Overview`_ tag. These tickets have a general
overview and description of the work required to finish. If you want to start
somewhere, this would be a good place to start. That said, these aren't
necessarily the easiest tickets. They are simply things that are explained. If
you still didn't find something to work on, search for the `Sprintable`_
label. Those tickets are meant to be standalone and can be worked on ad-hoc.
If you are up to more challenging tasks with a bigger scope,
then there are a set of tickets with a `Feature`_ or `Improvement`_ tag.
These tickets have a general overview and description of the work required to finish.
If you want to start somewhere, this would be a good place to start
(make sure that the issue also have the `Accepted`_ label).
That said, these aren't necessarily the easiest tickets.
They are simply things that are explained.
If you still didn't find something to work on, search for the `Sprintable`_ label.
Those tickets are meant to be standalone and can be worked on ad-hoc.
When contributing code, then please follow the standard Contribution
Guidelines set forth at `contribution-guide.org`_.
@ -73,7 +75,9 @@ command will be run immediately and will inform you of the changes and errors.
linting changes would be a great help to making this possible.
.. _Feature Overview: https://github.com/rtfd/readthedocs.org/issues?direction=desc&labels=Feature+Overview&page=1&sort=updated&state=open
.. _Feature: https://github.com/rtfd/readthedocs.org/issues?direction=desc&labels=Feature&page=1&sort=updated&state=open
.. _Improvement: https://github.com/rtfd/readthedocs.org/issues?q=is%3Aopen+is%3Aissue+label%3AImprovement
.. _Accepted: https://github.com/rtfd/readthedocs.org/issues?q=is%3Aopen+is%3Aissue+label%3AAccepted
.. _Good First Issue: https://github.com/rtfd/readthedocs.org/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22
.. _Sprintable: https://github.com/rtfd/readthedocs.org/issues?q=is%3Aopen+is%3Aissue+label%3ASprintable
.. _contribution-guide.org: http://www.contribution-guide.org/#submitting-bugs
@ -111,8 +115,7 @@ label. The reported issue …
in the past or it was decided that the proposed feature will not be
implemented because it does not conform with the overall goal of Read the
Docs. Also if you happen to know that the problem was already reported,
label the ticket with **Status: duplicate**, reference the other ticket
that is already addressing the problem and close the duplicate.
reference the other ticket that is already addressing the problem and close the duplicate.
Examples:
@ -140,21 +143,30 @@ label. The reported issue …
- *My builds stopped working. Please help!*
Ask for a link to the build log and for which project is affected.
… is a valid enhancement proposal
If the ticket contains an enhancement proposal that aligns with the goals
of Read the Docs, then add the label **Enhancement**. If the proposal
… is a valid feature proposal
If the ticket contains a feature that aligns with the goals
of Read the Docs, then add the label **Feature**. If the proposal
seems valid but requires further discussion between core contributors
because there might be different possibilities on how to implement the
enhancement, then also add the label **Needed: design decision**.
feature, then also add the label **Needed: design decision**.
Examples:
- *Improve documentation about MKdocs integration*
- *Provide better integration with service XYZ*
- *Refactor module X for better readability*
- *Achieve world domination* (also needs the label **Needed: design
decision**)
… is a small change to the source code
If the ticket is about code cleanup or small changes to existing features
would likely have the **Improvement** label.
The distinction for this label is that these issues have a lower priority than a Bug,
and aren't implementing new features.
Examples:
- *Refactor namedtuples to dataclasess*
- *Change font size for the project's title*
… is a valid problem within the code base:
If it's a valid bug, then add the label **Bug**. Try to reference related
issues if you come across any.
@ -208,14 +220,6 @@ few more at hand to further categorize issues.
If the issue is urgent, assign this label. In the best case also go forward to
resolve the ticket yourself as soon as possible.
*Community Effort*
There are many valuable ideas in the issue tracker for future enhancements
of Read the Docs. Unfortunately too many for the core developers to handle
all of them. Therefore we assign the *Community Effort* label on all the
issues that we see as valid for the project but that we currently do not
have the resources to work on. We encourage community members to work
on these tickets and to submit a pull request.
*Good First Issue*
This label marks tickets that are easy to get started with. The ticket
should be ideal for beginners to dive into the code base. Better is if the
@ -225,14 +229,6 @@ few more at hand to further categorize issues.
Sprintable are all tickets that have the right amount of scope to be
handled during a sprint. They are very focused and encapsulated.
*Feature Overview*
If a feature is too big to be tackled in one ticket and should be split
up, then we have a feature overview ticket explaining the overarching
idea. Those tickets related to one feature should also be grouped by a
`milestone`_.
.. _milestone: https://github.com/rtfd/readthedocs.org/milestones
For a full list of available labels and their meanings, see
:doc:`issue-labels`.

12
docs/design/index.rst Normal file
View File

@ -0,0 +1,12 @@
Design Documents
================
This is where we outline the design of major parts of our project.
Generally this is only available for features that have been build in the recent past,
but we hope to write more of them over time.
.. toctree::
:maxdepth: 1
:glob:
*

View File

@ -112,7 +112,7 @@ Note that this dictionary is injected under the main key `readthedocs`:
so it's your responsibility to use this context in a proper way.
In case you want *fresh data* at the moment of reading your documentation,
you should consider using the :doc:`Read the Docs Public API <api>` via Javascript.
you should consider using the :doc:`Read the Docs Public API </api/index>` via Javascript.
Using Read the Docs context in your theme

View File

@ -1,8 +1,8 @@
YAML Configuration File
=======================
Backgroud
---------
Background
----------
The current YAML configuration file is in beta state.
There are many options and features that it doesn't support yet.

View File

@ -9,8 +9,8 @@ First, you should check out the Builds tab of your project. That records all of
If you are still seeing errors because of C library dependencies,
please see :ref:`faq:I get import errors on libraries that depend on C modules`.
How do I change my slug (the URL your docs are served at)?
----------------------------------------------------------
How do I change my project slug (the URL your docs are served at)?
------------------------------------------------------------------
We don't support allowing folks to change the slug for their project.
You can update the name which is shown on the site,
@ -21,6 +21,13 @@ You can delete and re-create the project with the proper name to get a new slug,
but you really shouldn't do this if you have existing inbound links,
as it `breaks the internet <http://www.w3.org/Provider/Style/URI.html>`_.
How do I change the version slug of my project?
-----------------------------------------------
We don't support allowing folks to change the slug for their versions.
But you can rename the branch/tag to achieve this.
If that isn't enough, you can ask to team to do this by `creating an issue <https://github.com/rtfd/readthedocs.org/issues/new>`__.
Help, my build passed but my documentation page is 404 Not Found!
-----------------------------------------------------------------
@ -112,12 +119,12 @@ Deleting a stale or broken build environment
See :doc:`guides/wipe-environment`.
How do I host multiple projects on one CNAME?
---------------------------------------------
How do I host multiple projects on one custom domain?
-----------------------------------------------------
We support the concept of Subprojects.
If you add a subproject to a project,
that documentation will also be served under the parent project's subdomain.
We support the concept of subprojects, which allows multiple projects to share a
single domain. If you add a subproject to a project, that documentation will
be served under the parent project's subdomain or custom domain.
For example,
Kombu is a subproject of Celery,
@ -125,11 +132,11 @@ so you can access it on the `celery.readthedocs.io` domain:
http://celery.readthedocs.io/projects/kombu/en/latest/
This also works the same for CNAMEs:
This also works the same for custom domains:
http://docs.celeryproject.org/projects/kombu/en/latest/
You can add subprojects in the Admin section for your project.
You can add subprojects in the project admin dashboard.
Where do I need to put my docs for RTD to find it?
--------------------------------------------------

View File

@ -65,4 +65,5 @@ We provide full-text search across all of the pages of documentation hosted on o
Alternate Domains
-----------------
We provide support for CNAMEs, subdomains, and a shorturl for your project as well. This is outlined in the :doc:`alternate_domains` section.
We provide support for custom domains, subdomains, and a shorturl for your
project as well. This is outlined in the :doc:`alternate_domains` section.

View File

@ -1,151 +0,0 @@
Getting Started
===============
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.
If you are already using Sphinx or Markdown for your docs, skip ahead to
:ref:`getting_started:Import Your Docs`.
Write Your Docs
---------------
You have two options for formatting your documentation:
* `In reStructuredText`_
* `In Markdown`_
In reStructuredText
~~~~~~~~~~~~~~~~~~~
There is `a screencast`_ that will help you get started if you prefer.
Sphinx_ is a tool that makes it easy to create beautiful documentation.
Assuming you have Python_ already, `install Sphinx`_::
$ pip install sphinx sphinx-autobuild
Create a directory inside your project to hold your docs::
$ cd /path/to/project
$ mkdir docs
Run ``sphinx-quickstart`` in there::
$ cd docs
$ sphinx-quickstart
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.
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::
$ make html
.. note:: You can use ``sphinx-autobuild`` to auto-reload your docs. Run ``sphinx-autobuild . _build/html`` instead.
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.
In Markdown
~~~~~~~~~~~
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::
$ pip install recommonmark
Then in your ``conf.py``:
.. code-block:: python
from recommonmark.parser import CommonMarkParser
source_parsers = {
'.md': CommonMarkParser,
}
source_suffix = ['.rst', '.md']
.. note:: 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.
.. _this blog post: http://ericholscher.com/blog/2016/mar/15/dont-use-markdown-for-technical-docs/
Sign Up and Connect an External Account
---------------------------------------
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.
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.
Import Your Docs
----------------
To import a repository, visit your dashboard_ and click Import_.
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.
Manually Import Your Docs
~~~~~~~~~~~~~~~~~~~~~~~~~
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:
* Git: ``http://github.com/ericholscher/django-kong.git``
* Mercurial: ``https://bitbucket.org/ianb/pip``
* Subversion: ``http://varnish-cache.org/svn/trunk``
* Bazaar: ``lp:pasta``
Add an optional homepage URL and some tags, and then click **Next**.
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.
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.
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.
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.
.. _a screencast: https://youtu.be/oJsUvBQyHBs
.. _Python: https://www.python.org/
.. _Sphinx: http://sphinx-doc.org/
.. _Markdown: http://daringfireball.net/projects/markdown/syntax
.. _Mkdocs: http://www.mkdocs.org/
.. _install Sphinx: http://sphinx-doc.org/latest/install.html
.. _install Mkdocs: http://www.mkdocs.org/#installation
.. _reStructuredText: http://sphinx-doc.org/rest.html
.. _this template: https://www.writethedocs.org/guide/writing/beginners-guide-to-docs/#id1
.. _Sign up: https://readthedocs.org/accounts/signup
.. _log in: https://readthedocs.org/accounts/login
.. _dashboard: https://readthedocs.org/dashboard
.. _Import: https://readthedocs.org/dashboard/import

View File

@ -108,7 +108,7 @@ Currently we have our documentation & website translated on Transifex,
but we don't have a management process for it.
This means that translations will often sit for months before making it back into the site and being available to users.
This project would include puting together a workflow for translations:
This project would include putting together a workflow for translations:
* Communicate with existing translators and see what needs they have
* Help formalize the process that we have around Transifex to make it easier to contribute to
@ -119,7 +119,7 @@ Support for additional build steps for linting & testing
Currently we only build documentation on Read the Docs,
but we'd also like to add additional build steps that lets users perform more actions.
This would likely take the form of wraping some of the existing `Sphinx builders <http://www.sphinx-doc.org/en/stable/builders.html>`_,
This would likely take the form of wrapping some of the existing `Sphinx builders <http://www.sphinx-doc.org/en/stable/builders.html>`_,
and giving folks a nice way to use them inside Read the Docs.
It would be great to have wrappers for the following as a start:

View File

@ -167,7 +167,7 @@ This command will leave the ``.po`` files needed for building the documentation
.. warning::
It's important to use always the same method to translate the documentation and do not mix them.
Otherwise, it's very easy to end up with inconsistent translations or loosing already translated text.
Otherwise, it's very easy to end up with inconsistent translations or losing already translated text.
Build the documentation in target language

View File

@ -0,0 +1,78 @@
Keep Building Docs With Old Version Of MkDocs
=============================================
Recent changes to ``mkdocs`` forced us to `upgrade the default version installed`_ by Read the Docs and this may be a breaking change for your documentation.
.. _upgrade the default version installed: https://github.com/rtfd/readthedocs.org/pull/4041
You should check that your docs continue building in any of these cases:
* your project doesn't have a ``requirements.txt`` file pinning ``mkdocs`` to a specific version
* your project is using a custom theme
* your project is using Markdown extensions
In case your builds are failing because of a ``mkdocs`` issue,
you may want to follow one of the following solutions depending on the case.
Pin mkdocs to the previous version
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Before Read the Docs upgraded its default version installed, ``mkdocs==0.15.0`` was used.
To make your project continue using this version you will need to create a ``requirements.txt`` file with this content::
# requirements.txt
mkdocs==0.15.0
mkdocs-bootstrap==0.1.1
mkdocs-bootswatch==0.1.0
.. note::
Most of the breaking changes where introduced in ``mkdocs==0.17``,
so you may want to test only pinning ``mkdocs`` to ``mkdocs<0.17``
and check if your docs keep building successfully.
More detailed information about how to specify dependencies can be found :ref:`here <guides/specifying-dependencies:Specifying Dependencies>`.
Upgrade your custom theme to be compatible with newer mkdocs versions
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
It is possible that event your build passes your documentation doesn't look correct.
This may be because the new ``mkdocs==0.17.3`` version installed by Read the Docs introduced some breaking changes on the structure of the theme.
You should check the `mkdocs' Custom Theme documentation`_ to upgrade your custom theme and make it compatible with the new version.
.. _mkdocs' Custom Theme documentation: https://www.mkdocs.org/user-guide/custom-themes/
Upgrade how extension arguments are defined
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
``mkdocs`` has changed the way that ``markdown_extensions`` are defined and you may need to upgrade it.
If you where passing arguments to the extension by defining them between brackets (``toc(permalink=true)``) in your ``mkdocs.yaml`` you may need to upgrade it to the new way.
For example, this definition:
.. code-block:: yaml
markdown_extensions:
- admonition
- codehilite(guess_lang=false)
- toc(permalink=true)
- footnotes
- meta
needs to be replaced by:
.. code-block:: yaml
markdown_extensions:
- admonition
- codehilite
guess_lang: false
- toc
permalink: true
- footnotes
- meta

View File

@ -2,11 +2,15 @@ Removing "Edit on ..." Buttons from Documentation
=================================================
When building your documentation, Read the Docs automatically adds buttons at
the top of your documentation that point readers to your repository to make
the top of your documentation and in the versions menu that point readers to your repository to make
changes. For instance, if your repository is on GitHub, a button that says "Edit
on GitHub" is added to your documentation to make it easy for readers to author
on GitHub" is added in the top-right corner to your documentation to make it easy for readers to author
new changes.
Remove links from top-right corner
----------------------------------
The only way to remove these links currently is to override the Read the Docs
theme templates:
@ -22,5 +26,25 @@ The new ``breadcrumbs.html`` should look like this::
{% block breadcrumbs_aside %}
{% endblock %}
Remove "On ..." section from versions menu
------------------------------------------
This section can be removed with a custom CSS rule to hide them.
Follow the instructions under :doc:`adding-custom-css` and put the following content into the ``.css`` file:
.. code-block:: css
/* Hide "On GitHub" section from versions menu */
div.rst-versions > div.rst-other-versions > div.injected > dl:nth-child(4) {
display: none;
}
.. warning::
You may need to change the ``4`` number in ``dl:nth-child(4)`` for a different one in case your project has more sections in the versions menu.
For example, if your project has translations into different languages, you will need to use the number ``5`` there.
Now when you build your documentation, your documentation won't include an edit
button or links to the page source.

View File

@ -27,7 +27,7 @@ The file's path should be relative to documentation root.
requirements_file: requirements.txt
See :doc:`yaml-config` for setting up the .yml file
See :doc:`/yaml-config` for setting up the .yml file
Using the project admin dashboard
---------------------------------
@ -43,7 +43,7 @@ Using a conda environment file
If using conda, the dependencies can be specified in the conda environment file, ``environment.yml`` .
More on Read the Doc's conda support: :doc:`conda`
More on Read the Doc's conda support: :doc:`/conda`
Working with `conda and environment.yml`_

View File

@ -1,34 +1,53 @@
Welcome to Read The Docs
========================
Read the Docs: Documentation Simplified
=======================================
`Read the Docs`_ hosts documentation for the open source community.
We support Sphinx_ docs written with reStructuredText_ and `CommonMark`_.
We pull your code from your Subversion_, Bazaar_, Git_, and Mercurial_ repositories.
Then we build documentation and host it for you.
`Read the Docs`_ simplifies software documentation
by automating building, versioning, and hosting of your docs for you.
Think of it as *Continuous Documentation*.
The code is open source, and `available on GitHub`_.
Never out of sync
Whenever you push code to your favorite version control system,
whether that is Git, Mercurial, Bazaar, or Subversion,
Read the Docs will automatically build your docs
so your code and documentation are always up-to-date.
Multiple versions
Read the Docs can host and build multiple versions of your docs
so having a 1.0 version of your docs and a 2.0 version
of your docs is as easy as having a separate branch or tag in your version control system.
Free and open source
Read the Docs is free and open source and hosts documentation
for nearly 100,000 large and small open source projects
in almost every human and computer language.
.. _Read the docs: http://readthedocs.org/
.. _Sphinx: http://sphinx.pocoo.org/
.. _reStructuredText: http://sphinx.pocoo.org/rest.html
.. _CommonMark: http://commonmark.org/
.. _Subversion: http://subversion.tigris.org/
.. _Bazaar: http://bazaar.canonical.com/
.. _Git: http://git-scm.com/
.. _Mercurial: https://www.mercurial-scm.org/
.. _available on GitHub: http://github.com/rtfd/readthedocs.org
The main documentation for the site is organized into a couple sections:
* :ref:`user-docs`
* :ref:`feature-docs`
* :ref:`about-docs`
First steps
-----------
Information about development is also available:
Are you new to software documentation
or are you looking to use your existing docs with Read the Docs?
Learn about documentation authoring tools such as Sphinx and MkDocs
to help you create fantastic documentation for your project.
* **Getting started**:
:doc:`With Sphinx <intro/getting-started-with-sphinx>` |
:doc:`With MkDocs <intro/getting-started-with-mkdocs>`
* **Importing your existing documentation**:
:doc:`Import guide <intro/import-guide>`
.. toctree::
:maxdepth: 2
:hidden:
:caption: First Steps
intro/getting-started-with-sphinx
intro/getting-started-with-mkdocs
intro/import-guide
* :ref:`dev-docs`
* :ref:`design-docs`
.. _user-docs:
@ -36,10 +55,10 @@ Information about development is also available:
:maxdepth: 2
:caption: User Documentation
getting_started
versions
builds
features
connected-accounts
support
faq
yaml-config
@ -47,24 +66,6 @@ Information about development is also available:
api/index
embed
.. _about-docs:
.. toctree::
:maxdepth: 2
:caption: About Read the Docs
contribute
team
gsoc
code-of-conduct
privacy-policy
advertising/index
sponsors
open-source-philosophy
story
abandoned-projects
dmca/index
.. _feature-docs:
.. toctree::
@ -86,11 +87,29 @@ Information about development is also available:
automatic-redirects
features/*
.. _about-docs:
.. toctree::
:maxdepth: 1
:caption: About Read the Docs
contribute
roadmap
team
gsoc
code-of-conduct
privacy-policy
advertising/index
sponsors
open-source-philosophy
story
abandoned-projects
dmca/index
.. _dev-docs:
.. toctree::
:maxdepth: 2
:maxdepth: 1
:caption: Developer Documentation
changelog
@ -105,6 +124,8 @@ Information about development is also available:
i18n
issue-labels
security
design
RTD Theme <https://sphinx-rtd-theme.readthedocs.io/en/latest/>
.. _business-docs:
@ -121,13 +142,3 @@ Information about development is also available:
:caption: Custom Install Documentation
custom_installs/index
.. _design-docs:
.. toctree::
:maxdepth: 2
:caption: Designer Documentation
design
Theme <https://sphinx-rtd-theme.readthedocs.io/en/latest/>

View File

@ -151,4 +151,4 @@ Importing your docs
One of the goals of readthedocs.org is to make it easy for any open source developer to get high quality hosted docs with great visibility!
Simply provide us with the clone URL to your repo, we'll pull your code, extract your docs, and build them!
We make available a post-commit webhook that can be configured to update the docs whenever you commit to your repo.
See our :doc:`getting_started` page to learn more.
See :doc:`/intro/import-guide` to learn more.

View File

@ -0,0 +1,73 @@
Getting Started with MkDocs
===========================
MkDocs is a documentation generator that focuses on speed and simplicity.
It has many great features including:
* Preview your documentation as you write it
* Easy customization with themes and extensions
* Writing documentation with Markdown
.. note::
MkDocs is a great choice for building technical documentation.
However, Read the Docs also supports :doc:`Sphinx </intro/getting-started-with-sphinx>`,
another tool for writing and building documentation.
Quick start
-----------
Assuming you have Python already, `install MkDocs`_:
.. sourcecode:: bash
$ pip install mkdocs
Setup your MkDocs project:
.. sourcecode:: bash
$ mkdocs new .
This command creates ``mkdocs.yml`` which holds your MkDocs configuration,
and ``docs/index.md`` which is the Markdown file
that is the entry point for your documentation.
You can edit this ``index.md`` file to add more details about your project
and then you can build your documentation:
.. sourcecode:: bash
$ mkdocs serve
This command builds your Markdown files into HTML
and starts a development server to browse your documentation.
Open up http://127.0.0.1:8000/ in your web browser to see your documentation.
You can make changes to your Markdown files and your docs will automatically rebuild.
.. figure:: ../_static/images/first-steps/mkdocs-hello-world.png
:align: right
:figwidth: 300px
:target: ../_static/images/first-steps/mkdocs-hello-world.png
Your MkDocs project is built
Once you have your documentation in a public repository such as GitHub, Bitbucket, or GitLab,
you can start using Read the Docs by :doc:`importing your docs </intro/import-guide>`.
.. _install MkDocs: https://www.mkdocs.org/#installation
External resources
------------------
Here are some external resources to help you learn more about MkDocs.
* `MkDocs documentation`_
* `Markdown syntax guide`_
* `Writing your docs with MkDocs`_
.. _MkDocs documentation: https://www.mkdocs.org/
.. _Markdown syntax guide: http://daringfireball.net/projects/markdown/syntax
.. _Writing your docs with MkDocs: https://www.mkdocs.org/user-guide/writing-your-docs/

View File

@ -0,0 +1,127 @@
Getting Started with Sphinx
===========================
Sphinx is a powerful documentation generator that
has many great features for writing technical documentation including:
* Generate web pages, printable PDFs, documents for e-readers (ePub),
and more all from the same sources
* You can use reStructuredText or :ref:`Markdown <intro/getting-started-with-sphinx:Using Markdown with Sphinx>`
to write documentation
* An extensive system of cross-referencing code and documentation
* Syntax highlighted code samples
* A vibrant ecosystem of first and third-party extensions_
.. _extensions: http://www.sphinx-doc.org/en/master/ext/builtins.html#builtin-sphinx-extensions
Quick start video
-----------------
This screencast will help you get started or you can
:ref:`read our guide below <intro/getting-started-with-sphinx:Quick start>`.
.. raw:: html
<div style="text-align: center; margin-bottom: 2em;">
<iframe width="100%" height="350" src="https://www.youtube.com/embed/oJsUvBQyHBs?rel=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
</div>
Quick start
-----------
Assuming you have Python already, `install Sphinx`_:
.. sourcecode:: bash
$ pip install sphinx
Create a directory inside your project to hold your docs:
.. sourcecode:: bash
$ cd /path/to/project
$ mkdir docs
Run ``sphinx-quickstart`` in there:
.. sourcecode:: bash
$ cd docs
$ sphinx-quickstart
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.
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:
.. sourcecode:: bash
$ make html
Your ``index.rst`` has been built into ``index.html``
in your documentation output directory (typically ``_build/html/index.html``).
Open this file in your web browser to see your docs.
.. figure:: ../_static/images/first-steps/sphinx-hello-world.png
:align: right
:figwidth: 300px
:target: ../_static/images/first-steps/sphinx-hello-world.png
Your Sphinx project is built
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
by :doc:`importing your docs </intro/import-guide>`.
.. _install Sphinx: http://sphinx-doc.org/latest/install.html
.. _reStructuredText: http://sphinx-doc.org/rest.html
.. _this template: https://www.writethedocs.org/guide/writing/beginners-guide-to-docs/#id1
Using Markdown with Sphinx
--------------------------
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:
.. sourcecode:: bash
$ pip install recommonmark
Then in your ``conf.py``:
.. code-block:: python
from recommonmark.parser import CommonMarkParser
source_parsers = {
'.md': CommonMarkParser,
}
source_suffix = ['.rst', '.md']
.. warning:: 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.
.. _this blog post: http://ericholscher.com/blog/2016/mar/15/dont-use-markdown-for-technical-docs/
External resources
------------------
Here are some external resources to help you learn more about Sphinx.
* `Sphinx documentation`_
* `RestructuredText primer`_
* `An introduction to Sphinx and Read the Docs for technical writers`_
.. _Sphinx documentation: http://www.sphinx-doc.org/
.. _RestructuredText primer: http://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html
.. _An introduction to Sphinx and Read the Docs for technical writers: http://ericholscher.com/blog/2016/jul/1/sphinx-and-rtd-for-writers/

View File

@ -0,0 +1,68 @@
Importing Your Documentation
============================
To import a documentation repository, visit your `Read the Docs dashboard`_ and click Import_.
If you have :doc:`connected your Read the Docs account <../connected-accounts>` to GitHub, Bitbucket, or GitLab,
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
:ref:`build your documentation <intro/import-guide:Building your documentation>`.
.. _Read the Docs dashboard: https://readthedocs.org/dashboard
.. _Import: https://readthedocs.org/dashboard/import
.. figure:: ../_static/images/first-steps/import-a-repository.png
:align: right
:figwidth: 300px
:target: ../_static/images/first-steps/import-a-repository.png
Importing a repository
Manually import your docs
-------------------------
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:
* Git: ``https://github.com/ericholscher/django-kong.git``
* Mercurial: ``https://bitbucket.org/ianb/pip``
* Subversion: ``http://varnish-cache.org/svn/trunk``
* Bazaar: ``lp:pasta``
Add an optional homepage URL and some tags, and then click **Next**.
Once your project is created, you'll need to manually configure the repository
webhook if you would like to have new changes 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.
Building your documentation
---------------------------
Within a few seconds of completing the import process,
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 Read the Docs builds your docs,
and to troubleshoot any issues that arise.
Some documentation projects require additional configuration to build
such as specifying a certain version of Python or installing additional dependencies.
You can configure these settings in a ``readthedocs.yml`` file.
See our :doc:`/yaml-config` docs for more details.
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.
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.

Binary file not shown.

View File

@ -0,0 +1,206 @@
# 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.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Read the Docs 1.0\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2018-09-17 19:05-0500\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Language-Team: Danish (https://www.transifex.com/readthedocs/teams/2534/da/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: da\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
#: ../../abandoned-projects.rst:2
msgid "Policy for Abandoned Projects"
msgstr ""
#: ../../abandoned-projects.rst:4
msgid ""
"This policy describes the process by which a Read the Docs project name may "
"be changed."
msgstr ""
#: ../../abandoned-projects.rst:7
msgid "Rationale"
msgstr ""
#: ../../abandoned-projects.rst:9
msgid ""
"Conflict between the current use of the name and a different suggested use "
"of the same name occasionally arise. This document aims to provide general "
"guidelines for solving the most typical cases of such conflicts."
msgstr ""
#: ../../abandoned-projects.rst:14
msgid "Specification"
msgstr ""
#: ../../abandoned-projects.rst:16
msgid ""
"The main idea behind this policy is that Read the Docs serves the community."
" Every user is invited to upload content under the Terms of Use, "
"understanding that it is at the sole risk of the user."
msgstr ""
#: ../../abandoned-projects.rst:20
msgid ""
"While Read the Docs is not a backup service, the core team of Read the Docs "
"does their best to keep that content accessible indefinitely in its "
"published form. However, in certain edge cases the greater community's needs"
" might outweigh the individual's expectation of ownership of a project name."
msgstr ""
#: ../../abandoned-projects.rst:25
msgid "The use cases covered by this policy are:"
msgstr ""
#: ../../abandoned-projects.rst:29 ../../abandoned-projects.rst:53
msgid "Abandoned projects"
msgstr ""
#: ../../abandoned-projects.rst:28
msgid ""
"Renaming a project so that the original project name can be used by a "
"different project"
msgstr ""
#: ../../abandoned-projects.rst:32
msgid "Active projects"
msgstr ""
#: ../../abandoned-projects.rst:32
msgid "Resolving disputes over a name"
msgstr ""
#: ../../abandoned-projects.rst:35
msgid "Implementation"
msgstr ""
#: ../../abandoned-projects.rst:38
msgid "Reachability"
msgstr ""
#: ../../abandoned-projects.rst:40
msgid ""
"The user of Read the Docs is solely responsible for being reachable by the "
"core team for matters concerning projects that the user owns. In every case "
"where contacting the user is necessary, the core team will try to do so at "
"least three times, using the following means of contact:"
msgstr ""
#: ../../abandoned-projects.rst:45
msgid "E-mail address on file in the user's profile"
msgstr ""
#: ../../abandoned-projects.rst:46
msgid "E-mail addresses found in the given project's documentation"
msgstr ""
#: ../../abandoned-projects.rst:47
msgid "E-mail address on the project's home page"
msgstr ""
#: ../../abandoned-projects.rst:49
msgid ""
"The core team will stop trying to reach the user after six weeks and the "
"user will be considered *unreachable*."
msgstr ""
#: ../../abandoned-projects.rst:55
msgid "A project is considered *abandoned* when ALL of the following are met:"
msgstr ""
#: ../../abandoned-projects.rst:57
msgid "Owner is unreachable (see `Reachability`_)"
msgstr ""
#: ../../abandoned-projects.rst:58
msgid ""
"The project has no proper documentation being served (no successful builds) "
"or does not have any releases within the past twelve months"
msgstr ""
#: ../../abandoned-projects.rst:60
msgid ""
"No activity from the owner on the project's home page (or no home page "
"found)."
msgstr ""
#: ../../abandoned-projects.rst:63
msgid "All other projects are considered *active*."
msgstr ""
#: ../../abandoned-projects.rst:66
msgid "Renaming of an abandoned project"
msgstr ""
#: ../../abandoned-projects.rst:68
msgid "Projects are never renamed solely on the basis of abandonment."
msgstr ""
#: ../../abandoned-projects.rst:70
msgid ""
"An *abandoned* project can be renamed (by appending ``-abandoned`` and a "
"uniquifying integer if needed) for purposes of reusing the name when ALL of "
"the following are met:"
msgstr ""
#: ../../abandoned-projects.rst:74
msgid ""
"The project has been determined *abandoned* by the rules described above"
msgstr ""
#: ../../abandoned-projects.rst:75
msgid ""
"The candidate is able to demonstrate their own failed attempts to contact "
"the existing owner"
msgstr ""
#: ../../abandoned-projects.rst:77
msgid ""
"The candidate is able to demonstrate that the project suggested to reuse the"
" name already exists and meets notability requirements"
msgstr ""
#: ../../abandoned-projects.rst:79
msgid ""
"The candidate is able to demonstrate why a fork under a different name is "
"not an acceptable workaround"
msgstr ""
#: ../../abandoned-projects.rst:81
msgid "The project has fewer than 100 monthly pageviews"
msgstr ""
#: ../../abandoned-projects.rst:82
msgid "The core team does not have any additional reservations."
msgstr ""
#: ../../abandoned-projects.rst:85
msgid "Name conflict resolution for active projects"
msgstr ""
#: ../../abandoned-projects.rst:87
msgid ""
"The core team of Read the Docs are not arbiters in disputes around *active* "
"projects. The core team recommends users to get in touch with each other and"
" solve the issue by respectful communication."
msgstr ""
#: ../../abandoned-projects.rst:92
msgid "Prior art"
msgstr ""
#: ../../abandoned-projects.rst:94
msgid ""
"The Python Package Index (PyPI) policy for claiming abandoned packages "
"(`PEP-0541 <https://www.python.org/dev/peps/pep-0541>`_) heavily influenced "
"this policy."
msgstr ""

View File

@ -1,123 +1,189 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2010, Eric Holscher, Charlie Leifer, Bobby Grace
# This file is distributed under the same license as the Read The Docs package.
# 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: 2014-03-01 22:07+0800\n"
"PO-Revision-Date: 2014-03-02 12:03+0000\n"
"Last-Translator: Eric Holscher <eric@ericholscher.com>\n"
"Language-Team: Danish (http://www.transifex.com/projects/p/readthedocs-docs/language/da/)\n"
"POT-Creation-Date: 2018-09-17 19:05-0500\n"
"PO-Revision-Date: 2018-09-18 00:15+0000\n"
"Last-Translator: Anthony <aj@ohess.org>\n"
"Language-Team: Danish (http://www.transifex.com/readthedocs/readthedocs-docs/language/da/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: da\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
# 611d066357c741f6b281b3c4370da82e
#: ../../alternate_domains.rst:2
msgid "Alternate Domains"
msgstr ""
# e60ba9fed7eb4434a59bb6eaa49c9695
#: ../../alternate_domains.rst:4
msgid ""
"Read the Docs supports a number of custom domains for your convenience. "
"Shorter urls make everyone happy, and we like making people happy!"
"Shorter URLs make everyone happy, and we like making people happy!"
msgstr ""
# f70862aa50954b9e92fc4d513d86a112
#: ../../alternate_domains.rst:7
msgid "Subdomain Support"
msgstr ""
# 8e43c6182074461299d8325580e867f6
#: ../../alternate_domains.rst:9
msgid ""
"Every project has a subdomain that is available to serve it's documentation."
" If you go to <slug>.readthedocs.org, it should show you the latest version "
"of documentation. A good example is http://pip.readthedocs.org"
"Every project has a subdomain that is available to serve its documentation. "
"If you go to <slug>.readthedocs.io, it should show you the latest version of"
" documentation. A good example is https://pip.readthedocs.io"
msgstr ""
# 8593b4cea401470090e2ecd2e84d69b7
#: ../../alternate_domains.rst:11
msgid ""
"If you have an old project that has an underscore (_) in the name, it will "
"use a subdomain with a hypen (-). `RTFD 1035 "
"use a subdomain with a hyphen (-). `RFC 1035 "
"<http://tools.ietf.org/html/rfc1035>`_ has more information on valid "
"subdomains."
msgstr ""
# 8d8306bebc324a9a89163b7794d4dade
#: ../../alternate_domains.rst:15
msgid "CNAME Support"
msgid "Custom Domain Support"
msgstr ""
# ed95727e73ca49588ecc56519b04e0b5
#: ../../alternate_domains.rst:17
msgid ""
"If you have your own domain, you can still host with us. If you point a "
"CNAME record in your DNS to the subdomain for your project, it should "
"magically serve your latest documentation on the custom domain. Using pip as"
" another example, http://www.pip-installer.org resolves, but is hosted on "
"our infrastructure."
"You can also host your documentation from your own domain by adding a domain"
" to your project:"
msgstr ""
# 8b294299a97748beba723ae93fa507fa
#: ../../alternate_domains.rst:19
msgid "As an example, fabric's dig record looks like this::"
msgstr ""
# 3faf2458a66c4f818b083e8700512b30
#: ../../alternate_domains.rst:27
msgid "CNAME SSL"
msgstr ""
# b0dc64d41d1e4761b19ecf18948727d2
#: ../../alternate_domains.rst:29
#: ../../alternate_domains.rst:20
msgid ""
"We don't support SSL for CNAMEs on our side, but you can enable support if "
"you have your own server. SSL requires having a secret key, and if we hosted"
" the key for you, it would no longer be secret."
"Add a CNAME record in your DNS that points the domain to: ``readthedocs.io``"
msgstr ""
# 0812a6744f06408b9371f7eba14bd446
#: ../../alternate_domains.rst:35
msgid "To enable SSL:"
#: ../../alternate_domains.rst:21
msgid ""
"Add a project domain in the :guilabel:`Domains` project admin page for your "
"project."
msgstr ""
# bd242a88c79d4575b48a6b128155531c
#: ../../alternate_domains.rst:37
#: ../../alternate_domains.rst:24
msgid ""
"We don't currently support pointing subdomains or naked domains to a project"
" using ``A`` records. It's best to point a subdomain, ``docs.example.com`` "
"for example, using a CNAME record."
msgstr ""
#: ../../alternate_domains.rst:28
msgid ""
"Using pip as an example, https://pip.pypa.io resolves, but is hosted on our "
"infrastructure."
msgstr ""
#: ../../alternate_domains.rst:30
msgid "As another example, fabric's dig record looks like this::"
msgstr ""
#: ../../alternate_domains.rst:38
msgid "Custom Domain SSL"
msgstr ""
#: ../../alternate_domains.rst:40
msgid ""
"By default, when you setup a custom domain to host documentation at Read the"
" Docs, we will attempt to provision a domain validated SSL certificate for "
"the domain. This service is generously provided by Cloudflare."
msgstr ""
#: ../../alternate_domains.rst:44
msgid ""
"After configuring your custom domain on Read the Docs, you can see the "
"status of the certificate on the domain page in your project admin dashboard"
" (:guilabel:`Domains` > :guilabel:`Edit Domain`)."
msgstr ""
#: ../../alternate_domains.rst:48
msgid ""
"If your domain has configured CAA records, please do not forget to include "
"Cloudflare CAA entries, see their `Certification Authority Authorization "
"(CAA) FAQ <https://support.cloudflare.com/hc/en-us/articles/115000310832"
"-Certification-Authority-Authorization-CAA-FAQ>`_."
msgstr ""
#: ../../alternate_domains.rst:54
msgid ""
"Some older setups configured a CNAME record pointing to ``readthedocs.org`` "
"or another variation. While these continue to resolve, they do not yet allow"
" us to acquire SSL certificates for those domains. Point the CNAME to "
"``readthedocs.io`` and re-request a certificate by saving the domain in the "
"project admin (:guilabel:`Domains` > :guilabel:`Edit Domain`)."
msgstr ""
#: ../../alternate_domains.rst:61
msgid ""
"If you change the CNAME record, the SSL certificate issuance can take about "
"one hour."
msgstr ""
#: ../../alternate_domains.rst:66
msgid ""
"Due to a limitation, a domain cannot be proxied on Cloudflare to another "
"Cloudflare account that also proxies. This results in a \"CNAME Cross-User "
"Banned\" error. In order to do SSL termination, we must proxy this "
"connection. If you don't want us to do SSL termination for your domain -- "
"**which means you are responsible for the SSL certificate** -- then set your"
" CNAME to ``cloudflare-to-cloudflare.readthedocs.io`` instead of "
"``readthedocs.io``."
msgstr ""
#: ../../alternate_domains.rst:75
msgid "For more details, see this `previous issue`_."
msgstr ""
#: ../../alternate_domains.rst:81
msgid "Proxy SSL"
msgstr ""
#: ../../alternate_domains.rst:83
msgid ""
"If you would prefer to do your own SSL termination on a server you own and "
"control, you can do that although the setup is a bit more complex."
msgstr ""
#: ../../alternate_domains.rst:87
msgid "Broadly, the steps are:"
msgstr ""
#: ../../alternate_domains.rst:89
msgid "Have a server listening on 443 that you control"
msgstr ""
# 9ac2902f1bf74b949104e47c0efb7d03
#: ../../alternate_domains.rst:38
#: ../../alternate_domains.rst:90
msgid ""
"Procure an SSL certificate for your domain and provision it and the private "
"key on your server."
msgstr ""
#: ../../alternate_domains.rst:92
msgid "Add a domain that you wish to point at Read the Docs"
msgstr ""
# d56d2d6bb83047669c6b4abe05ce7a56
#: ../../alternate_domains.rst:39
#: ../../alternate_domains.rst:93
msgid "Enable proxying to us, with a custom ``X-RTD-SLUG`` header"
msgstr ""
# 5f23a87007344515867ac1601e1fa6df
#: ../../alternate_domains.rst:41
#: ../../alternate_domains.rst:95
msgid "An example nginx configuration for pip would look like:"
msgstr ""
# 66b5da23108045a5979e1d5f425f9cab
#: ../../alternate_domains.rst:61
#: ../../alternate_domains.rst:115
msgid "rtfd.org"
msgstr ""
# eff90d7177ee4c1e93389898da25e1d9
#: ../../alternate_domains.rst:63
#: ../../alternate_domains.rst:117
msgid ""
"You can also use `rtfd.org` as a short URL for Read the Docs. For example, "
"http://pip.rtfd.org redirects to its documentation page. Any use of "
"`rtfd.org` will simply be redirected to `readthedocs.org`."
"You can also use `rtfd.io` and `rtfd.org` for short URLs for Read the Docs. "
"For example, https://pip.rtfd.io redirects to its documentation page. Any "
"use of `rtfd.io` or `rtfd.org` will simply be redirected to "
"`readthedocs.io`."
msgstr ""

Binary file not shown.

View File

@ -1,644 +0,0 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2010, Eric Holscher, Charlie Leifer, Bobby Grace
# 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: 2014-03-01 22:07+0800\n"
"PO-Revision-Date: 2014-03-02 12:03+0000\n"
"Last-Translator: Eric Holscher <eric@ericholscher.com>\n"
"Language-Team: Danish (http://www.transifex.com/projects/p/readthedocs-docs/language/da/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: da\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
# ac4435557ec54a0698a7652375e52cea
#: ../../api.rst:2
msgid "Read the Docs Public API"
msgstr ""
# b7be09eadfc0471185be47a502cc09ab
#: ../../api.rst:4
msgid ""
"We have a limited public API that is available for you to get data out of "
"the site. This page will only show a few of the basic parts, please file a "
"ticket or ping us on IRC (#readthedocs on `Freenode (chat.freenode.net) "
"<http://webchat.freenode.net>`_) if you have feature requests."
msgstr ""
# 6dba36b9c81c4c5ca088d7858dc9c64b
#: ../../api.rst:6
msgid ""
"This document covers the read-only API provided. We have plans to create a "
"read/write API, so that you can easily automate interactions with your "
"project."
msgstr ""
# ac65e5c56cae49689840a19ea5bd23c6
#: ../../api.rst:8
msgid ""
"The API is written in Tastypie, which provides a nice ability to browse the "
"API from your browser. If you go to "
"http://readthedocs.org/api/v1/?format=json and just poke around, you should "
"be able to figure out what is going on."
msgstr ""
# dace8530c59e462aae92712881d3e647
#: ../../api.rst:11
msgid "A basic API client using slumber"
msgstr ""
# 09b7adbd84384a528caeb2a9e49c334d
#: ../../api.rst:13
msgid ""
"You can use `Slumber <http://slumber.in/>`_ to build basic API wrappers in "
"python. Here is a simple example of using slumber to interact with the RTD "
"API::"
msgstr ""
# 785e8fcbb6304e9e82169f9e498255c1
#: ../../api.rst:42
msgid "Example of adding a user to a project"
msgstr ""
# dbb32c2891e74511aa76006d50809c53
#: ../../api.rst:74
msgid "API Endpoints"
msgstr ""
# 256d6d2f42634b408c316f1838dbd418
#: ../../api.rst:76
msgid ""
"Feel free to use cURL and python to look at formatted json examples. You can"
" also look at them in your browser, if it handles returned json."
msgstr ""
# 925e67726ec844eda23cf223ca8ed70c
#: ../../api.rst:83
msgid "Root"
msgstr ""
# 49219ebf9fc4433e887ec0ffded5267e
#: ../../api.rst:113
msgid "API endpoint for resource."
msgstr ""
# 187caa6e4807401baddeec344bbc6d01
#: ../../api.rst:114
msgid "API endpoint for schema of resource."
msgstr ""
# f4891dae130e47e59b06bea32d59cd2f
#: ../../api.rst:117
msgid "Builds"
msgstr ""
# 8546f8d134d74994ad138614d4268c3f
#: ../../api.rst:135
msgid "Number of Builds returned."
msgstr ""
# f563a7b3b9814ca1ae18ba582d909561
#: ../../api.rst:136
msgid "URI for next set of Builds."
msgstr ""
# 91fc6bb3f3b549fa997578a0a58d89e0
# 9b57a4c51db9446d82f1cd4d47e3f2fd
# c6f2d6b77d1444b3836e56c7e442118f
# 92332ddb736a43a7a0a83eeea67c7336
# e9db61910bc04c508376b4a37c584477
#: ../../api.rst:137 ../../api.rst:204 ../../api.rst:258 ../../api.rst:353
#: ../../api.rst:408
msgid "Current offset used for pagination."
msgstr ""
# 4932e8fd2b164793b9cbc5a7f3ee5dd7
#: ../../api.rst:138
msgid "URI for previous set of Builds."
msgstr ""
# 39da05c4172e4cecb610ae264b5f1f2d
#: ../../api.rst:139
msgid "Total number of Builds."
msgstr ""
# 617550e94e6a48a68d2816beb7fe96fc
#: ../../api.rst:140
msgid "Array of `Build`_ objects."
msgstr ""
# 42aa7c3b40d948a5a6c66ca3097dded6
#: ../../api.rst:144
msgid "Build"
msgstr ""
# 119aa8a5ac124969a4831f83385c04ea
#: ../../api.rst:147
msgid "A Build id."
msgstr ""
# 8a37c144b880428a94feebe7b3f996ae
#: ../../api.rst:169
msgid "Date of Build."
msgstr ""
# c0116659a7e64af9aa9d36750407371e
#: ../../api.rst:170
msgid "Error from Sphinx build process."
msgstr ""
# c895fa777f974afeb9e4d0388a48e004
#: ../../api.rst:171
msgid "Build id."
msgstr ""
# 4788ecdc77e94da9810d44e921221877
#: ../../api.rst:172
msgid "Output from Sphinx build process."
msgstr ""
# ddbe5eee7c7f4ff89adc75094810b7c2
#: ../../api.rst:173
msgid "URI for Project of Build."
msgstr ""
# b1c75d9d97b34a0dbd7074ded790f157
#: ../../api.rst:174
msgid "URI for Build."
msgstr ""
# 8c0b8e9a700a42f792591bd213e6da20
#: ../../api.rst:175
msgid "Setup output from Sphinx build process."
msgstr ""
# 9f18ac3cd5fd4665964ef3fb30b8003b
#: ../../api.rst:176
msgid "Setup error from Sphinx build process."
msgstr ""
# bb88975ccacc42088b4d2d1a4f6c8972
#: ../../api.rst:177
msgid "\"triggered\", \"building\", or \"finished\""
msgstr ""
# 9e0891b9e92a49b996d4cc118d691099
#: ../../api.rst:178
msgid "Was build successful?"
msgstr ""
# 8fbec26522cb4cc2a7d0c79513432cf6
#: ../../api.rst:179
msgid "Build type (\"html\", \"pdf\", \"man\", or \"epub\")"
msgstr ""
# 91a0d27882164afab1f6e2343bda3a87
#: ../../api.rst:180
msgid "URI for Version of Build."
msgstr ""
# efd5e1ed6b0d4379a01bc2e12b1a26c1
#: ../../api.rst:183
msgid "Files"
msgstr ""
# b1bff81d5e1c45d08f023b5f685b40b2
#: ../../api.rst:202
msgid "Number of Files returned."
msgstr ""
# d0f4916a663a428e99573e8025911909
#: ../../api.rst:203
msgid "URI for next set of Files."
msgstr ""
# 6929977ef35d46f78a83504b4fb7c928
#: ../../api.rst:205
msgid "URI for previous set of Files."
msgstr ""
# 33125cae21a84b0cbf6ac7daf12074e1
#: ../../api.rst:206
msgid "Total number of Files."
msgstr ""
# 8ec3f429672a4ef694e620bc1cbc63c5
#: ../../api.rst:207
msgid "Array of `File`_ objects."
msgstr ""
# f53da8f907cb49d79c2a5af96682b8f7
#: ../../api.rst:210
msgid "File"
msgstr ""
# f0e347883fab4f0ca76d99e6481bdefd
#: ../../api.rst:213
msgid "A File id."
msgstr ""
# 52c2f5761f8844feb791e9ae0e4440fd
#: ../../api.rst:229
msgid "URI for actual file (not the File object from the API.)"
msgstr ""
# 2d63e5b7b6f74159b72e1b2caca055b5
#: ../../api.rst:230
msgid "File id."
msgstr ""
# 44d7f8220c8d48eaad71e3e78e978c85
#: ../../api.rst:231
msgid "Name of File."
msgstr ""
# b651b232f5c24af6a4460691f3a4e349
#: ../../api.rst:232
msgid "Name of Path."
msgstr ""
# cb2bf233fa4e4689a34eaa7d847e4eff
#: ../../api.rst:233
msgid "A `Project`_ object for the file's project."
msgstr ""
# d6ee5d3412364e2faa0d078e3a1c1776
#: ../../api.rst:234
msgid "URI for File object."
msgstr ""
# 9208eb574e134642af14f4e0066ebb89
#: ../../api.rst:237
msgid "Projects"
msgstr ""
# 2c5b4298bc4e4887964beaf4edfd176a
#: ../../api.rst:256
msgid "Number of Projects returned."
msgstr ""
# 88a79000716247f2950c9c4f62192165
#: ../../api.rst:257
msgid "URI for next set of Projects."
msgstr ""
# f55ba5bacb74435d8e8b1c3283aa4e66
#: ../../api.rst:259
msgid "URI for previous set of Projects."
msgstr ""
# 9ee7a1ac44a84dc19ac0739f4a554e91
#: ../../api.rst:260
msgid "Total number of Projects."
msgstr ""
# de8fecbded8a4b05b2c7d1fa7df2db75
#: ../../api.rst:261
msgid "Array of `Project`_ objects."
msgstr ""
# ccd083da60884e06b971cdde183801f7
#: ../../api.rst:265
msgid "Project"
msgstr ""
# 3ae27c8a52a143cc88e8efef8f8d3d51
#: ../../api.rst:268
msgid "A Project id."
msgstr ""
# ffaff4d3bb644df9a3032cb67589183b
#: ../../api.rst:305
msgid "URI for project (not the Project object from the API.)"
msgstr ""
# 73377caefe0e4e4da310316631687869
#: ../../api.rst:306
msgid "Analytics tracking code."
msgstr ""
# 80abb8cd54d945979da68ac02b2baa5b
#: ../../api.rst:307
msgid "Copyright"
msgstr ""
# 4336364a50664071b0f65b0d807742ca
#: ../../api.rst:308
msgid "Crate.io URI."
msgstr ""
# 6c888ac3d10c4b65bd3abdcc4b750f01
#: ../../api.rst:309
msgid "Default branch."
msgstr ""
# 37db6aacac4a40cbb41c133090417d32
#: ../../api.rst:310
msgid "Default version."
msgstr ""
# 566c82d078404bc1ae8037fdb12281da
#: ../../api.rst:311
msgid "Description of project."
msgstr ""
# d64d7d4d686f4909913497e6bb412084
#: ../../api.rst:312
msgid "Djangopackages.com URI."
msgstr ""
# a11849760f124cbd9115b047ca6f49f5
#: ../../api.rst:313
msgid "Either \"sphinx\" or \"sphinx_html\"."
msgstr ""
# 9e5a345ee9154266bdb05808252661cf
#: ../../api.rst:314
msgid "Project id."
msgstr ""
# 32b326fb47f844069f8c2f779fd691f9
#: ../../api.rst:315
msgid "Last modified date."
msgstr ""
# e4d51e4ab53444159f3b4d84a7d7cd1d
#: ../../api.rst:316
msgid "Project name."
msgstr ""
# e4c6369819a14f72903f73213dfe10c7
#: ../../api.rst:317
msgid "Project homepage."
msgstr ""
# ac9e7ebd216044558453736c0ea63805
#: ../../api.rst:318
msgid "Last published date."
msgstr ""
# bac61fdd45ca45d4935993ef0ba04881
#: ../../api.rst:319
msgid "URI for VCS repository."
msgstr ""
# f956712f326443d087889f647e280ea4
#: ../../api.rst:320
msgid "Type of VCS repository."
msgstr ""
# 92a098cbc04d45d38731d6b2d43daa77
#: ../../api.rst:321
msgid "Pip requirements file for packages needed for building docs."
msgstr ""
# 3ba270adaef8417cad96ce98ceb44f8c
#: ../../api.rst:322
msgid "URI for Project."
msgstr ""
# f8180992629b4d209bbc7cb228a32fc3
#: ../../api.rst:323
msgid "Slug."
msgstr ""
# 87c0da5e4e60410f9cedae05dcbd57f8
#: ../../api.rst:324
msgid "Subdomain."
msgstr ""
# 02ea53d43c284a6296a25c9872b7b5d6
#: ../../api.rst:325
msgid "File suffix of docfiles. (Usually \".rst\".)"
msgstr ""
# 987aec8c320945d48cdba60caa340b9a
#: ../../api.rst:326
msgid "Sphinx theme."
msgstr ""
# 3ee22ab5384346c8b7dede723fa53a42
#: ../../api.rst:327
msgid "Build project in a virtualenv? (True or False)"
msgstr ""
# 24a499932a63456fae2a94fb6c1dca68
#: ../../api.rst:328
msgid "Array of readthedocs.org user URIs for administrators of Project."
msgstr ""
# ede247beac7d4c51b068fd692641610e
#: ../../api.rst:329
msgid "DEPRECATED."
msgstr ""
# e9c76ece62754d2888ef0ac4fc2e0571
#: ../../api.rst:333
msgid "Users"
msgstr ""
# f7629aa3942a47b6b44de8096567791b
#: ../../api.rst:351
msgid "Number of Users returned."
msgstr ""
# 6823a3ab7eea4436bf3817369d41a817
#: ../../api.rst:352
msgid "URI for next set of Users."
msgstr ""
# a5851a61a01a4faf9e58cfc1ece1f457
#: ../../api.rst:354
msgid "URI for previous set of Users."
msgstr ""
# bc1c957223854df0a48413840a319284
#: ../../api.rst:355
msgid "Total number of Users."
msgstr ""
# 54064875a3784ce3aa1b3a8704aae370
#: ../../api.rst:356
msgid "Array of `User`_ objects."
msgstr ""
# ad57e1125b1c4467905022bea6f212e8
#: ../../api.rst:360
msgid "User"
msgstr ""
# 20359af6e60342389e3653804d8524b0
#: ../../api.rst:363
msgid "A User id."
msgstr ""
# 3b007c0464654c0a9e462e721c109b15
#: ../../api.rst:378
msgid "First name."
msgstr ""
# d5d0941e8d414697a3af1b45fc2da470
#: ../../api.rst:379
msgid "User id."
msgstr ""
# 5cfd860d068b48c8bc351939feae57db
#: ../../api.rst:380
msgid "Timestamp of last login."
msgstr ""
# 6538d1f9b7ce422e87890d2e1fb92b2f
#: ../../api.rst:381
msgid "Last name."
msgstr ""
# e2f008f1f39a4fa292c4021824bd0a81
#: ../../api.rst:382
msgid "URI for this user."
msgstr ""
# 205bd87506ce4f438ed17e27bbc94f70
#: ../../api.rst:383
msgid "User name."
msgstr ""
# e626db1a66094a7d965e794c6b0db78f
#: ../../api.rst:387
msgid "Versions"
msgstr ""
# 6858d2545b434b35aa5004a6a5abe96e
#: ../../api.rst:406
msgid "Number of Versions returned."
msgstr ""
# 82bf3f5e6089456487ee173d8263439c
#: ../../api.rst:407
msgid "URI for next set of Versions."
msgstr ""
# 78fd452156e144c0989663d10420cdcc
#: ../../api.rst:409
msgid "URI for previous set of Versions."
msgstr ""
# 93fddf71370445a09c51805681918e1f
#: ../../api.rst:410
msgid "Total number of Versions."
msgstr ""
# 8b63b45dd8e44928bfd4c42a5b6e900e
#: ../../api.rst:411
msgid "Array of `Version`_ objects."
msgstr ""
# ce42ef1aae90433cba6b9c7ccf01b1f1
#: ../../api.rst:415
msgid "Version"
msgstr ""
# 9662153d97c74802b932193bb0789e70
# 1c78f8ac57b64f7b9f251126c92282f5
# 3789c84af92f47b28ccdd830dafa6766
#: ../../api.rst:418 ../../api.rst:459 ../../api.rst:487
msgid "A Version id."
msgstr ""
# 77b74636bba643a8bbb971b9d3808fa8
#: ../../api.rst:437
msgid "Are we continuing to build docs for this version?"
msgstr ""
# 45872947b4bd4ac18c0cbf962b35a31f
#: ../../api.rst:438
msgid "Have docs been built for this version?"
msgstr ""
# a63ce5db2d524186b6255fe43a1fe8b1
#: ../../api.rst:439
msgid "Version id."
msgstr ""
# 8c6ab958ba784fda8f3b3f8a3ca53829
#: ../../api.rst:440
msgid "Identifier of Version."
msgstr ""
# 307e3bc71e2b4e1d88b123f81fa3d800
#: ../../api.rst:441
msgid "A `Project`_ object for the version's project."
msgstr ""
# 6372c5cacaab415fa7ba0aba5bcf22b1
#: ../../api.rst:442
msgid "URI for Version object."
msgstr ""
# 95116e9005ad4b57843e36474e6b36fb
#: ../../api.rst:443
msgid "String that uniquely identifies a project"
msgstr ""
# f3a7cc2cab324f38afc8ba39c690de95
#: ../../api.rst:444
msgid "Were docs uploaded? (As opposed to being build by Read the Docs.)"
msgstr ""
# 738c5cfdf3d44f2ea7505c3152440798
#: ../../api.rst:445
msgid "Usually the same as Slug."
msgstr ""
# fe2ec80d0cfd4016b41033eb91146a42
#: ../../api.rst:449
msgid "Filtering Examples"
msgstr ""
# 726458cece1f4449aae87ddfaea246fb
#: ../../api.rst:452
msgid "Find Highest Version"
msgstr ""
# 91866a75a7b44bc7bff811261ddd7f2a
#: ../../api.rst:477
msgid "Compare Highest Version"
msgstr ""
# 948755edb21842b497acf94a0f32bb6a
#: ../../api.rst:479
msgid ""
"This will allow you to compare whether a certain version is the highest "
"version of a specific project. The below query should return a "
"`'is_highest': false` in the returned dictionary."
msgstr ""
# 667cf9549eed41a18cc80ce6101eac87
#: ../../api.rst:488
msgid "A Version number or string."
msgstr ""
# 2c43df5a275c49e8a9d1363782e10f99
#: ../../api.rst:506
msgid "File Search"
msgstr ""
# eded5174ea8545f69825ef22419e318f
#: ../../api.rst:513
msgid "Perform search with this term."
msgstr ""
# 8958abbf7f1c4312ba083f885f7f981c
#: ../../api.rst:563
msgid "Anchor Search"
msgstr ""
# cc940d2a0b5441a8b4c56b1d8d8c15a0
#: ../../api.rst:570
msgid "Perform search of files containing anchor text with this term."
msgstr ""

View File

@ -1,85 +0,0 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2010, Eric Holscher, Charlie Leifer, Bobby Grace
# 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: 2014-03-01 22:07+0800\n"
"PO-Revision-Date: 2014-03-02 12:03+0000\n"
"Last-Translator: Eric Holscher <eric@ericholscher.com>\n"
"Language-Team: Danish (http://www.transifex.com/projects/p/readthedocs-docs/language/da/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: da\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
# 2d2a1584eb7d4f84b2332fd1d2d2b952
#: ../../api/builds.rst:2
msgid ":mod:`builds`"
msgstr ""
# fae84b788fcd4c0182d7ffda46504916
#: ../../api/builds.rst:5
msgid ":mod:`builds.admin`"
msgstr ""
# 8f0d3e46bb6f4861b74f38194e3bead9
#: ../../../readthedocs/builds/admin.pydocstring of builds.admin:1
msgid "Django admin interface for `~builds.models.Build` and related models."
msgstr ""
# a2e23b3dcf4f4b178e1237288f15f57e
#: ../../api/builds.rst:10
msgid ":mod:`builds.models`"
msgstr ""
# 11b64438d56443ef8bf16fefeb6ff71d
#: ../../../readthedocs/builds/models.pydocstring of builds.models.Build:1
msgid ""
"Build(id, project_id, version_id, type, state, date, success, setup, "
"setup_error, output, error, exit_code)"
msgstr ""
# 4c2b3d4fb9be4004810cdaf1b274c287
#: ../../../readthedocs/builds/models.pydocstring of builds.models.Version:1
msgid ""
"Version(id, project_id, type, identifier, verbose_name, slug, supported, "
"active, built, uploaded, privacy_level)"
msgstr ""
# d6dd813be4974be49ce0fd8e62d0fb9e
#: ../../../readthedocs/builds/models.pydocstring of
#: builds.models.Version.save:1
msgid "Add permissions to the Version for all owners on save."
msgstr ""
# 26316e66a2c4411fbd5afbcd11f40ab9
#: ../../../readthedocs/builds/models.pydocstring of
#: builds.models.VersionAlias:1
msgid "VersionAlias(id, project_id, from_slug, to_slug, largest)"
msgstr ""
# 17545b7efa034381a269d6acc95f675a
#: ../../api/builds.rst:15
msgid ":mod:`builds.urls`"
msgstr ""
# 1139103ca82b404e8440330b2a384a50
#: ../../api/builds.rst:20
msgid ":mod:`builds.views`"
msgstr ""
# 1c574581cfb943129eea2205ad5234ce
#: ../../../readthedocs/builds/views.pydocstring of
#: builds.views.build_detail:1
msgid "Show the details of a particular build."
msgstr ""
# d3c2fb8134a240cd903ecc6c71a8ce93
#: ../../../readthedocs/builds/views.pydocstring of builds.views.build_list:1
msgid "Show a list of builds."
msgstr ""

View File

@ -1,216 +0,0 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2010, Eric Holscher, Charlie Leifer, Bobby Grace
# 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: 2014-03-01 22:07+0800\n"
"PO-Revision-Date: 2014-03-02 12:03+0000\n"
"Last-Translator: Eric Holscher <eric@ericholscher.com>\n"
"Language-Team: Danish (http://www.transifex.com/projects/p/readthedocs-docs/language/da/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: da\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
# 0493fabfae5f40e9ac3bbcefc84061db
#: ../../api/core.rst:2
msgid ":mod:`core`"
msgstr ""
# 8af4fb9765be48afb271e95d3f27dd76
#: ../../api/core.rst:5
msgid ":mod:`core.admin`"
msgstr ""
# 51b94810b54d4ec89eb49f3eb79943b6
#: ../../../readthedocs/core/admin.pydocstring of core.admin:1
msgid "Django admin interface for core models."
msgstr ""
# 1076c67bf8684eb695ca4e6a7524f06b
#: ../../api/core.rst:10
msgid ":mod:`core.forms`"
msgstr ""
# 15ce8f64bdac4be1b4179ba24eafd30d
#: ../../../readthedocs/core/forms.pydocstring of core.forms.FacetField:1
msgid ""
"For filtering searches on a facet, with validation for the format of facet "
"values."
msgstr ""
# df17be1ef9384072900bc26f800a4ade
#: ../../../readthedocs/core/forms.pydocstring of
#: core.forms.FacetField.valid_value:1
msgid ""
"Although this is a choice field, no choices need to be supplied. Instead, we"
" just validate that the value is in the correct format for facet filtering "
"(facet_name:value)"
msgstr ""
# af17e60114804b33a02cb88f3e201165
#: ../../../readthedocs/core/forms.pydocstring of
#: core.forms.FacetedSearchForm:1
msgid "Supports fetching faceted results with a corresponding query."
msgstr ""
# 2319e72154624a579388f9f80e04335f
#: ../../../readthedocs/core/forms.pydocstring of
#: core.forms.FacetedSearchForm:3
msgid "`facets`"
msgstr ""
# 948ef6c59d1f4905a59c2ba897f7f916
#: ../../../readthedocs/core/forms.pydocstring of
#: core.forms.FacetedSearchForm:4
msgid "A list of facet names for which to get facet counts"
msgstr ""
# 78bd17539cfa4b1b9610151bff858569
#: ../../../readthedocs/core/forms.pydocstring of
#: core.forms.FacetedSearchForm:5
msgid "`models`"
msgstr ""
# 1b6394d971074abfb44108c7ecbba331
#: ../../../readthedocs/core/forms.pydocstring of
#: core.forms.FacetedSearchForm:6
msgid "Limit the search to one or more models"
msgstr ""
# c927e9dd6e9949bb9a4bc652bd0d474b
#: ../../api/core.rst:15
msgid ":mod:`core.middleware`"
msgstr ""
# 8e9e68020a4a4acb9fda5e9db22d5794
#: ../../../readthedocs/core/middleware.pydocstring of
#: core.middleware.SingleVersionMiddleware:1
msgid "Reset urlconf for requests for 'single_version' docs."
msgstr ""
# a78f1fad976b498a9f126d7832913233
#: ../../../readthedocs/core/middleware.pydocstring of
#: core.middleware.SingleVersionMiddleware:3
msgid ""
"In settings.MIDDLEWARE_CLASSES, SingleVersionMiddleware must follow after "
"SubdomainMiddleware."
msgstr ""
# 7e24fa692ea4482a9f843d3bf202e7ae
#: ../../api/core.rst:20
msgid ":mod:`core.models`"
msgstr ""
# 5a1117e89a9d4ea4aaec11b677ae929d
#: ../../../readthedocs/core/models.pydocstring of core.models.UserProfile:1
msgid "Additional information about a User."
msgstr ""
# 166df641b5104d0e9db6fbb6c5446d3b
#: ../../../readthedocs/core/models.pydocstring of
#: core.models.UserProfile.get_contribution_details:1
msgid "Gets the line to put into commits to attribute the author."
msgstr ""
# 49f617d6e2a14ff3a66037d558cd56c7
#: ../../../readthedocs/core/models.pydocstring of
#: core.models.UserProfile.get_contribution_details:3
msgid "Returns a tuple (name, email)"
msgstr ""
# 1bbc78f196314d27985f78990196ef4b
#: ../../api/core.rst:25
msgid ":mod:`core.search_sites`"
msgstr ""
# 37e32571a1164cacbaf04080b92b4cee
#: ../../api/core.rst:30
msgid ":mod:`core.views`"
msgstr ""
# 9304957e15414971bc00a6c3c4ae6417
#: ../../../readthedocs/core/views.pydocstring of core.views:1
msgid ""
"Core views, including the main homepage, post-commit build hook, "
"documentation and header rendering, and server errors."
msgstr ""
# c6e633d426d24b95bd1dc1b7bb38c252
#: ../../../readthedocs/core/views.pydocstring of
#: core.views.default_docs_kwargs:1
msgid "Return kwargs used to reverse lookup a project's default docs URL."
msgstr ""
# f342e3af8e3248d7bc990ee55941f36c
#: ../../../readthedocs/core/views.pydocstring of
#: core.views.default_docs_kwargs:3
msgid ""
"Determining which URL to redirect to is done based on the kwargs passed to "
"reverse(serve_docs, kwargs). This function populates kwargs for the default"
" docs for a project, and sets appropriate keys depending on whether request "
"is for a subdomain URL, or a non-subdomain URL."
msgstr ""
# a27187a0a1df401bb2b351e11a55dea6
#: ../../../readthedocs/core/views.pydocstring of core.views.github_build:1
msgid "A post-commit hook for github."
msgstr ""
# 083fe46d2a0c4b03953ec53571cb8f54
#: ../../../readthedocs/core/views.pydocstring of
#: core.views.redirect_lang_slug:1
msgid "Redirect /en/ to /en/latest/."
msgstr ""
# 917927470fc34fd18033aea19b8fdff6
#: ../../../readthedocs/core/views.pydocstring of
#: core.views.redirect_page_with_filename:1
msgid "Redirect /page/file.html to /en/latest/file.html."
msgstr ""
# fa21ccc33cc54fe890796e09b51e7e60
#: ../../../readthedocs/core/views.pydocstring of
#: core.views.redirect_project_slug:1
msgid "Redirect / to /en/latest/."
msgstr ""
# 2ab25e52858d41da820b68f123db70b0
#: ../../../readthedocs/core/views.pydocstring of
#: core.views.redirect_version_slug:1
msgid "Redirect /latest/ to /en/latest/."
msgstr ""
# 48c216d478844dd59042115b1dca37d2
#: ../../../readthedocs/core/views.pydocstring of core.views.server_error:1
msgid "A simple 500 handler so we get media"
msgstr ""
# 9e58471dda5f45ac855f1db0ed29dcd8
#: ../../../readthedocs/core/views.pydocstring of
#: core.views.server_error_404:1
msgid "A simple 404 handler so we get media"
msgstr ""
# cd9c47e6246549ce8cb99ecd33c6278f
#: ../../api/core.rst:36
msgid ":mod:`core.management.commands`"
msgstr ""
# 77e89db3d1274264bf1ead2d60915ced
#: ../../api/core.rst:37
msgid "This is where custom ``manage.py`` commands are defined."
msgstr ""
# 89c565f223914d3194a3704370da371a
#: ../../../readthedocs/core/management/commands/update_repos.pydocstring of
#: core.management.commands.update_repos.Command:1
msgid ""
"Custom management command to rebuild documentation for all projects on the "
"site. Invoked via ``./manage.py update_repos``."
msgstr ""

View File

@ -1,127 +0,0 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2010, Eric Holscher, Charlie Leifer, Bobby Grace
# 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: 2014-03-01 22:07+0800\n"
"PO-Revision-Date: 2014-03-02 12:03+0000\n"
"Last-Translator: Eric Holscher <eric@ericholscher.com>\n"
"Language-Team: Danish (http://www.transifex.com/projects/p/readthedocs-docs/language/da/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: da\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
# b991e970952444c788004e9f007f3767
#: ../../api/doc_builder.rst:2
msgid ":mod:`doc_builder`"
msgstr ""
# 8eada7aadc5a4082ba0a0868956a1b68
#: ../../api/doc_builder.rst:5
msgid ":mod:`doc_builder.base`"
msgstr ""
# 65b85fe1d57b41cd891cded8dd933625
#: ../../../readthedocs/doc_builder/base.pydocstring of
#: doc_builder.base.BaseBuilder:1
msgid ""
"The Base for all Builders. Defines the API for subclasses. All workflow "
"steps need to return true, otherwise it is assumed something went wrong and "
"the Builder will stop"
msgstr ""
# a2a6b10fcfe9464fabd8cea86632c717
#: ../../../readthedocs/doc_builder/base.pydocstring of
#: doc_builder.base.BaseBuilder.build:1
msgid "Do the actual building of the documentation."
msgstr ""
# 709b793a28ea456f89f0db0307c6d896
#: ../../../readthedocs/doc_builder/base.pydocstring of
#: doc_builder.base.BaseBuilder.changed:1
msgid ""
"Says whether the documentation has changed, and requires further action."
msgstr ""
# a7239a9f885e4554b762141621f6e9d9
#: ../../../readthedocs/doc_builder/base.pydocstring of
#: doc_builder.base.BaseBuilder.changed:4
msgid ""
"This is mainly used to short-circuit more expensive builds of other output "
"formats if the project docs didn't change on an update. Subclasses are "
"recommended to override for more efficient builds."
msgstr ""
# dfab0ed8e52b442e92ff12d07630ba31
#: ../../../readthedocs/doc_builder/base.pydocstring of
#: doc_builder.base.BaseBuilder.changed:8
msgid "Defaults to `True`"
msgstr ""
# 418e4ebe80a84c14985cd855d6cc9c18
#: ../../../readthedocs/doc_builder/base.pydocstring of
#: doc_builder.base.BaseBuilder.clean:1
msgid "Clean up the version so it's ready for usage."
msgstr ""
# 8ac6b17f0cd34d28a08a92c3327a9540
#: ../../../readthedocs/doc_builder/base.pydocstring of
#: doc_builder.base.BaseBuilder.clean:3
msgid ""
"This is used to add RTD specific stuff to Sphinx, and to implement "
"whitelists on projects as well."
msgstr ""
# cfb6674b490244479da1ab35f12b64be
#: ../../../readthedocs/doc_builder/base.pydocstring of
#: doc_builder.base.BaseBuilder.clean:6
msgid "It is guaranteed to be called before your project is built."
msgstr ""
# 64395ce4405244c082d1bd5d168f6150
#: ../../../readthedocs/doc_builder/base.pydocstring of
#: doc_builder.base.BaseBuilder.force:1
msgid "An optional step to force a build even when nothing has changed."
msgstr ""
# 716785ec2c404dfa96698cbdb1e0ef33
#: ../../../readthedocs/doc_builder/base.pydocstring of
#: doc_builder.base.BaseBuilder.move:1
msgid "Move the documentation from it's generated place to its final home."
msgstr ""
# d7e47bec033c4c96928964c59275c585
#: ../../../readthedocs/doc_builder/base.pydocstring of
#: doc_builder.base.BaseBuilder.move:3
msgid ""
"This needs to understand both a single server dev environment, as well as a "
"multi-server environment."
msgstr ""
# c04471155b324c21ba65fa6922d8be08
#: ../../api/doc_builder.rst:10
msgid ":mod:`doc_builder.backends`"
msgstr ""
# 08338ee988434666b985d5435f6ce3bc
#: ../../api/doc_builder.rst:14
msgid ":mod:`doc_builder.backends.sphinx`"
msgstr ""
# b9b938829ca2494a86ec1228cae1610c
#: ../../../readthedocs/doc_builder/backends/sphinx.pydocstring of
#: doc_builder.backends.sphinx.Builder:1
msgid "The parent for most sphinx builders."
msgstr ""
# 6bfe51ff42e14246a572bfe871306752
#: ../../../readthedocs/doc_builder/backends/sphinx.pydocstring of
#: doc_builder.backends.sphinx.Builder:3
msgid "Also handles the default sphinx output of html."
msgstr ""

View File

@ -7,10 +7,10 @@ msgid ""
msgstr ""
"Project-Id-Version: readthedocs-docs\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2014-03-01 22:07+0800\n"
"POT-Creation-Date: 2014-03-26 11:17+0100\n"
"PO-Revision-Date: 2014-03-02 12:03+0000\n"
"Last-Translator: Eric Holscher <eric@ericholscher.com>\n"
"Language-Team: Danish (http://www.transifex.com/projects/p/readthedocs-docs/language/da/)\n"
"Language-Team: Danish (http://www.transifex.com/readthedocs/readthedocs-docs/language/da/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

View File

@ -1,480 +0,0 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2010, Eric Holscher, Charlie Leifer, Bobby Grace
# 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: 2014-03-01 22:07+0800\n"
"PO-Revision-Date: 2014-03-02 12:03+0000\n"
"Last-Translator: Eric Holscher <eric@ericholscher.com>\n"
"Language-Team: Danish (http://www.transifex.com/projects/p/readthedocs-docs/language/da/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: da\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
# 8a9a614ab388441aad6ebf92bfcf54f6
#: ../../api/projects.rst:2
msgid ":mod:`projects`"
msgstr ""
# 3a85bbd57c9842aa84aaee39ecefbe09
#: ../../api/projects.rst:5
msgid ":mod:`projects.admin`"
msgstr ""
# 7b2f3ab7abba41919880b86597a1834d
#: ../../../readthedocs/projects/admin.pydocstring of projects.admin:1
msgid ""
"Django administration interface for `~projects.models.Project` and related "
"models."
msgstr ""
# 85ccda3d132344ab82e44050b9c23f30
#: ../../api/projects.rst:10
msgid ":mod:`projects.constants`"
msgstr ""
# 6739af59661b47db99d93cbb1c465148
#: ../../../readthedocs/projects/constants.pydocstring of projects.constants:1
msgid ""
"Default values and other various configuration for projects, including "
"available theme names and repository types."
msgstr ""
# ddf1d5fee70f42a9ac05653b3cab049b
#: ../../api/projects.rst:15
msgid ":mod:`projects.forms`"
msgstr ""
# 50beadc405e04c65a117dcd08b292bd3
#: ../../api/projects.rst:20
msgid ":mod:`projects.models`"
msgstr ""
# 18c0d05d3ad8463bb0a35e9e1e4dfee3
#: ../../../readthedocs/projects/models.pydocstring of
#: projects.models.EmailHook:1
msgid "EmailHook(id, project_id, email)"
msgstr ""
# 9232676fa67742dfa184373d6d06b3ea
#: ../../../readthedocs/projects/models.pydocstring of
#: projects.models.ImportedFile:1
msgid "ImportedFile(id, project_id, version_id, name, slug, path, md5)"
msgstr ""
# 5edb560f63ff4799babba27f4897ffd7
#: ../../../readthedocs/projects/models.pydocstring of
#: projects.models.Project:1
msgid ""
"Project(id, pub_date, modified_date, name, slug, description, repo, "
"repo_type, project_url, canonical_url, version, copyright, theme, suffix, "
"single_version, default_version, default_branch, requirements_file, "
"documentation_type, analytics_code, path, conf_py_file, featured, skip, "
"mirror, use_virtualenv, python_interpreter, use_system_packages, "
"django_packages_url, privacy_level, version_privacy_level, language, "
"main_language_project_id, num_major, num_minor, num_point)"
msgstr ""
# 5675441d8110478498b27d731d633eeb
#: ../../../readthedocs/projects/models.pydocstring of
#: projects.models.Project.all_active_versions:1
msgid ""
"A temporary workaround for active_versions filtering out things that were "
"active, but failed to build"
msgstr ""
# e0ae6c572a6543f1be74ffe5171cd2ce
#: ../../../readthedocs/projects/models.pydocstring of
#: projects.models.Project.cnames_symlink_path:1
msgid "Path in the doc_path that we symlink cnames"
msgstr ""
# bf7ae6ee13994ad1a69c4b5c13b365f3
#: ../../../readthedocs/projects/models.pydocstring of
#: projects.models.Project.cnames_symlink_path:3
msgid ""
"This has to be at the top-level because Nginx doesn't know the projects "
"slug."
msgstr ""
# 08b509e8cce24d9790afc88ab643ac6f
# 5d51723c24db4007b66de7fdceb8ff27
#: ../../../readthedocs/projects/models.pydocstring of
#: projects.models.Project.find:1
#: ../../../readthedocs/projects/models.pydocstring of
#: projects.models.Project.full_find:1
msgid "A balla API to find files inside of a projects dir."
msgstr ""
# e519f438728b4884b51926773bb6937d
#: ../../../readthedocs/projects/models.pydocstring of
#: projects.models.Project.full_build_path:1
msgid "The path to the build html docs in the project."
msgstr ""
# 7c011d20fb904b32963abc98520334fd
#: ../../../readthedocs/projects/models.pydocstring of
#: projects.models.Project.full_dash_path:1
msgid "The path to the build dash docs in the project."
msgstr ""
# 78c38a8e11e8429cbbab83bc572f7826
#: ../../../readthedocs/projects/models.pydocstring of
#: projects.models.Project.full_doc_path:1
msgid "The path to the documentation root in the project."
msgstr ""
# ee1eb04bb2ec469bb928c1f112f1cee0
#: ../../../readthedocs/projects/models.pydocstring of
#: projects.models.Project.full_epub_path:1
msgid "The path to the build epub docs in the project."
msgstr ""
# ee1eb04bb2ec469bb928c1f112f1cee0
#: ../../../readthedocs/projects/models.pydocstring of
#: projects.models.Project.full_json_path:1
msgid "The path to the build json docs in the project."
msgstr ""
# 94129d075c35418e906f8333b963343f
#: ../../../readthedocs/projects/models.pydocstring of
#: projects.models.Project.full_latex_path:1
msgid "The path to the build LaTeX docs in the project."
msgstr ""
# ee1eb04bb2ec469bb928c1f112f1cee0
#: ../../../readthedocs/projects/models.pydocstring of
#: projects.models.Project.full_man_path:1
msgid "The path to the build man docs in the project."
msgstr ""
# 54d38fb2a7ba4b2f9b7bd4dab9f7bde6
#: ../../../readthedocs/projects/models.pydocstring of
#: projects.models.Project.full_singlehtml_path:1
msgid "The path to the build singlehtml docs in the project."
msgstr ""
# 9f115122a3714851a01928d190425612
#: ../../../readthedocs/projects/models.pydocstring of
#: projects.models.Project.get_default_branch:1
msgid "Get the version representing \"latest\""
msgstr ""
# ed6afc175888454ea69f977192b6666f
#: ../../../readthedocs/projects/models.pydocstring of
#: projects.models.Project.get_default_version:1
msgid "Get the default version (slug)."
msgstr ""
# d86d617176ee45539c17b77772e84d25
#: ../../../readthedocs/projects/models.pydocstring of
#: projects.models.Project.get_default_version:3
msgid ""
"Returns self.default_version if the version with that slug actually exists "
"(is built and published). Otherwise returns 'latest'."
msgstr ""
# fc4f82d0647943f19c9f2952bdc687f1
#: ../../../readthedocs/projects/models.pydocstring of
#: projects.models.Project.get_docs_url:1
msgid ""
"Return a url for the docs. Always use http for now, to avoid content "
"warnings."
msgstr ""
# b9dc426b24ef430ca9d74b11beab855a
#: ../../../readthedocs/projects/models.pydocstring of
#: projects.models.Project.rtd_build_path:1
msgid "The destination path where the built docs are copied."
msgstr ""
# 7b471222702f414db858b43073c7d9c2
#: ../../../readthedocs/projects/models.pydocstring of
#: projects.models.Project.single_version_symlink_path:1
msgid "Path in the doc_path for the single_version symlink."
msgstr ""
# 9c42a7e3969a459fa6a4991b989a67d0
#: ../../../readthedocs/projects/models.pydocstring of
#: projects.models.Project.subprojects_symlink_path:1
msgid "Path in the doc_path that we symlink subprojects"
msgstr ""
# 6a2b786705274c008323db14a41b81c7
#: ../../../readthedocs/projects/models.pydocstring of
#: projects.models.Project.supported_versions:1
msgid "Get the list of supported versions. Returns a list of version strings."
msgstr ""
# 33fc917403674f3ea273de1e64cfa768
#: ../../../readthedocs/projects/models.pydocstring of
#: projects.models.Project.translations_symlink_path:1
msgid "Path in the doc_path that we symlink translations"
msgstr ""
# f420a18d21fe42c5aaedf0c49a0a9df1
#: ../../../readthedocs/projects/models.pydocstring of
#: projects.models.ProjectRelationship:1
msgid "ProjectRelationship(id, parent_id, child_id)"
msgstr ""
# 1262e10548be4ed7b8bebbcd47b8fe5e
#: ../../../readthedocs/projects/models.pydocstring of
#: projects.models.WebHook:1
msgid "WebHook(id, project_id, url)"
msgstr ""
# 4863508f0c86430f8c29c8d08a610fe9
#: ../../api/projects.rst:25
msgid ":mod:`projects.search_indexes`"
msgstr ""
# ef7732bc51af4a9bb041207065435119
#: ../../api/projects.rst:30
msgid ":mod:`projects.tasks`"
msgstr ""
# 7616523a00784b9b9605a8d84758a192
#: ../../../readthedocs/projects/tasks.pydocstring of projects.tasks:1
msgid ""
"Tasks related to projects, including fetching repository code, cleaning "
"``conf.py`` files, and rebuilding documentation."
msgstr ""
# c5133618f92e40089f97ac5503025468
#: ../../../readthedocs/projects/tasks.pydocstring of
#: projects.tasks.import_open_comparison:1
msgid "Try importing a Project model from Open Comparison sites."
msgstr ""
# 05fe24fc916e4e9c876e2a680c90f844
#: ../../../readthedocs/projects/tasks.pydocstring of
#: projects.tasks.remove_symlink_single_version:1
msgid "Remove single_version symlink"
msgstr ""
# a1c705bcd4b1441c984db2f611c5da98
#: ../../../readthedocs/projects/tasks.pydocstring of
#: projects.tasks.symlink_cnames:1
msgid "OLD Link from HOME/user_builds/cnames/<cname> ->"
msgstr ""
# 0b8296a15eb240e39b748f191f21f9fd
# 0b8296a15eb240e39b748f191f21f9fd
# 0b8296a15eb240e39b748f191f21f9fd
#: ../../../readthedocs/projects/tasks.pydocstring of
#: projects.tasks.symlink_cnames:3
#: ../../../readthedocs/projects/tasks.pydocstring of
#: projects.tasks.symlink_subprojects:2
#: ../../../readthedocs/projects/tasks.pydocstring of
#: projects.tasks.symlink_translations:2
msgid "HOME/user_builds/<project>/rtd-builds/"
msgstr ""
# 50ee1a531931414794724e088a5d7da8
#: ../../../readthedocs/projects/tasks.pydocstring of
#: projects.tasks.symlink_cnames:4
msgid "NEW Link from HOME/user_builds/cnametoproject/<cname> ->"
msgstr ""
# 5d27e28473984668bade228754d67928
#: ../../../readthedocs/projects/tasks.pydocstring of
#: projects.tasks.symlink_cnames:6
msgid "HOME/user_builds/<project>/"
msgstr ""
# 53fce50cbbb447d7b8399aa4c559c9ea
#: ../../../readthedocs/projects/tasks.pydocstring of
#: projects.tasks.symlink_single_version:1
msgid "Link from HOME/user_builds/<project>/single_version ->"
msgstr ""
# a5a46bda73d24287a3f6b198e3de05fc
#: ../../../readthedocs/projects/tasks.pydocstring of
#: projects.tasks.symlink_single_version:2
msgid "HOME/user_builds/<project>/rtd-builds/<default_version>/"
msgstr ""
# 126f7c2c7c1142eb91ad3765094bd852
#: ../../../readthedocs/projects/tasks.pydocstring of
#: projects.tasks.symlink_subprojects:1
msgid "Link from HOME/user_builds/project/subprojects/<project> ->"
msgstr ""
# a3dc199da18e4cb983a9e9bdf55af75f
#: ../../../readthedocs/projects/tasks.pydocstring of
#: projects.tasks.symlink_translations:1
msgid "Link from HOME/user_builds/project/translations/<lang> ->"
msgstr ""
# fd98d43655d94503852a51ce36b583a0
#: ../../../readthedocs/projects/tasks.pydocstring of
#: projects.tasks.update_mirror_docs:1
msgid "A periodic task used to update all projects that we mirror."
msgstr ""
# 9f49cd1cdf87490498bc6620f5d65c20
#: ../../api/projects.rst:35
msgid ":mod:`projects.utils`"
msgstr ""
# d9e018a58a424853a489543bf83f516b
#: ../../../readthedocs/projects/utils.pydocstring of projects.utils:1
msgid "Utility functions used by projects."
msgstr ""
# ff9698e1d8dd4255ac1e1fcbcfae985e
#: ../../../readthedocs/projects/utils.pydocstring of
#: projects.utils.find_file:1
msgid ""
"Find matching filenames in the current directory and its subdirectories, and"
" return a list of matching filenames."
msgstr ""
# 2f3dd702e2f84e008dbdc9a61d083430
#: ../../../readthedocs/projects/utils.pydocstring of projects.utils.run:1
msgid ""
"Run one or more commands, and return ``(status, out, err)``. If more than "
"one command is given, then this is equivalent to chaining them together with"
" ``&&``; if all commands succeed, then ``(status, out, err)`` will represent"
" the last successful command. If one command failed, then ``(status, out, "
"err)`` will represent the failed command."
msgstr ""
# 0d9594b1fba94a7caf46a9052f4ed8cd
#: ../../../readthedocs/projects/utils.pydocstring of
#: projects.utils.safe_write:1
msgid ""
"Write ``contents`` to the given ``filename``. If the filename's directory "
"does not exist, it is created. Contents are written as UTF-8, ignoring any "
"characters that cannot be encoded as UTF-8."
msgstr ""
# 5b7b40193f1641b69717a0ee61ee61dc
#: ../../api/projects.rst:40
msgid ":mod:`projects.views`"
msgstr ""
# 01026916182b41bfbf291c9e16c44ab1
#: ../../api/projects.rst:43
msgid ":mod:`projects.views.public`"
msgstr ""
# 0d6acbba8f8a43ceb6ca6199d0c25bef
#: ../../../readthedocs/projects/views/public.pydocstring of
#: projects.views.public.project_badge:1
msgid "Return a sweet badge for the project"
msgstr ""
# d3d78d8ed03640ad943eba4b5fb17f5c
# 3b1fa7bfbcef435b9a0d72326c176129
#: ../../../readthedocs/projects/views/public.pydocstring of
#: projects.views.public.project_detail:1
#: ../../../readthedocs/projects/views/public.pydocstring of
#: projects.views.public.project_downloads:1
msgid "A detail view for a project with various dataz"
msgstr ""
# e53a22ee68564e48929b382f7e629656
#: ../../../readthedocs/projects/views/public.pydocstring of
#: projects.views.public.project_index:1
msgid ""
"The list of projects, which will optionally filter by user or tag, in which "
"case a 'person' or 'tag' will be added to the context"
msgstr ""
# 4f85615a264744b5a256b7fb3163c4b9
#: ../../../readthedocs/projects/views/public.pydocstring of
#: projects.views.public.search:1
msgid "our ghetto site search. see roadmap."
msgstr ""
# f513ed5a9df248ef8840de44ec95fd10
#: ../../../readthedocs/projects/views/public.pydocstring of
#: projects.views.public.search_autocomplete:1
msgid "return a json list of project names"
msgstr ""
# 412e4bf583a44f34a5634523d95f03e3
#: ../../../readthedocs/projects/views/public.pydocstring of
#: projects.views.public.tag_index:1
msgid "List of all tags by most common"
msgstr ""
# 3ea93d8785c3494bbcbde87e8ddadfa8
#: ../../../readthedocs/projects/views/public.pydocstring of
#: projects.views.public.version_autocomplete:1
msgid "return a json list of version names"
msgstr ""
# 03258a8916b740349157700c1e165246
#: ../../api/projects.rst:48
msgid ":mod:`projects.views.private`"
msgstr ""
# 6062e161b4f443d79aefd2c1cc28bc99
#: ../../../readthedocs/projects/views/private.pydocstring of
#: projects.views.private.export:1
msgid "Export a projects' docs as a .zip file, including the .rst source"
msgstr ""
# 5222a9d261fa490f9246d5d57964fc4e
# 5222a9d261fa490f9246d5d57964fc4e
#: ../../../readthedocs/projects/views/private.pydocstring of
#: projects.views.private.project_advanced:1
#: ../../../readthedocs/projects/views/private.pydocstring of
#: projects.views.private.project_edit:1
msgid ""
"Edit an existing project - depending on what type of project is being edited"
" (created or imported) a different form will be displayed"
msgstr ""
# 318da3dc4a634de8aabd97e36eb3f2fb
#: ../../../readthedocs/projects/views/private.pydocstring of
#: projects.views.private.project_dashboard:1
msgid ""
"A dashboard! If you aint know what that means you aint need to. Essentially"
" we show you an overview of your content."
msgstr ""
# 3e1396b6b0e8443e9ebd0bd2a31f6cae
#: ../../../readthedocs/projects/views/private.pydocstring of
#: projects.views.private.project_delete:1
msgid ""
"Make a project as deleted on POST, otherwise show a form asking for "
"confirmation of delete."
msgstr ""
# a7523151177242e6a0ff4f7f218a8ab9
#: ../../../readthedocs/projects/views/private.pydocstring of
#: projects.views.private.project_import:1
msgid "Import docs from an repo"
msgstr ""
# 2055bfe65f5740bfa729ee9dccb9e3de
#: ../../../readthedocs/projects/views/private.pydocstring of
#: projects.views.private.project_manage:1
msgid ""
"The management view for a project, where you will have links to edit the "
"projects' configuration, edit the files associated with that project, etc."
msgstr ""
# 82d0b6a00476474fb2a896c6b5821904
#: ../../../readthedocs/projects/views/private.pydocstring of
#: projects.views.private.project_manage:5
msgid "Now redirects to the normal /projects/<slug> view."
msgstr ""
# cc4c1922c68f4de1982d72d7baefcd4a
#: ../../../readthedocs/projects/views/private.pydocstring of
#: projects.views.private.project_versions:1
msgid ""
"Shows the available versions and lets the user choose which ones he would "
"like to have built."
msgstr ""

View File

@ -1,156 +0,0 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2010, Eric Holscher, Charlie Leifer, Bobby Grace
# 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: 2014-03-01 22:07+0800\n"
"PO-Revision-Date: 2014-03-02 12:03+0000\n"
"Last-Translator: Eric Holscher <eric@ericholscher.com>\n"
"Language-Team: Danish (http://www.transifex.com/projects/p/readthedocs-docs/language/da/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: da\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
# c114b9fc573b4e6ea9bd677487ccc350
#: ../../api/vcs_support.rst:2
msgid ":mod:`vcs_support`"
msgstr ""
# 2168fb47a3b045f69db6118a75b7649f
#: ../../api/vcs_support.rst:5
msgid ":mod:`vcs_support.base`"
msgstr ""
# 039fe7d0b3b44bca9d59ab4dabcba217
#: ../../../readthedocs/vcs_support/base.pydocstring of
#: vcs_support.base.BaseCLI:1
msgid "Helper class for CLI-heavy classes."
msgstr ""
# e84b37640a714fe89cb6336c58569fe7
#: ../../../readthedocs/vcs_support/base.pydocstring of
#: vcs_support.base.BaseCLI.run:1
msgid "list of command and args. See `subprocess` docs"
msgstr ""
# 9029d3bceac34fc2974a98619075a5d1
#: ../../../readthedocs/vcs_support/base.pydocstring of
#: vcs_support.base.BaseContributionBackend:1
msgid "Base class for contribution backends."
msgstr ""
# 08cec6ad85fd4b01aef16e3364f18052
#: ../../../readthedocs/vcs_support/base.pydocstring of
#: vcs_support.base.BaseContributionBackend:3
msgid "The main purpose of this base class is to define the API."
msgstr ""
# 91323650500e43109e3ad9928ad3e8d9
#: ../../../readthedocs/vcs_support/base.pydocstring of
#: vcs_support.base.BaseContributionBackend.accepts:1
msgid ""
"Classmethod that checks if a given repository URL is supported by this "
"backend."
msgstr ""
# 4d161b0f18b74a0e8388a00a14f98ab6
#: ../../../readthedocs/vcs_support/base.pydocstring of
#: vcs_support.base.BaseContributionBackend.get_branch_file:1
msgid "Returns the contents of a file as it is in the specified branch."
msgstr ""
# 23c018029e684891b18b7c47198cb6ef
#: ../../../readthedocs/vcs_support/base.pydocstring of
#: vcs_support.base.BaseContributionBackend.push_branch:1
msgid "Pushes a branch upstream."
msgstr ""
# 9df8fdc150164c43b89919ce049b491e
#: ../../../readthedocs/vcs_support/base.pydocstring of
#: vcs_support.base.BaseContributionBackend.set_branch_file:1
msgid "Saves the file in the specified branch."
msgstr ""
# c65beb5e1b4f46c58dbd5f6924bb1107
#: ../../../readthedocs/vcs_support/base.pydocstring of
#: vcs_support.base.BaseVCS:1
msgid "Base for VCS Classes. Built on top of the BaseCLI."
msgstr ""
# e4b8b4f783b745a2944707d791a06565
# f29a1e6b2d984fbe9b634de766591c83
#: ../../../readthedocs/vcs_support/base.pydocstring of
#: vcs_support.base.BaseVCS.branches:1
#: ../../../readthedocs/vcs_support/base.pydocstring of
#: vcs_support.base.BaseVCS.tags:1
msgid ""
"Returns a list of VCSVersion objects. See VCSVersion for more information."
msgstr ""
# d2ef3260822a4b5d84d923ef7a8aa146
#: ../../../readthedocs/vcs_support/base.pydocstring of
#: vcs_support.base.BaseVCS.checkout:1
msgid "Set the state to the given identifier."
msgstr ""
# 655c7b2f2d70435b80cd8402d424dcc5
#: ../../../readthedocs/vcs_support/base.pydocstring of
#: vcs_support.base.BaseVCS.checkout:3
msgid "If identifier is None, checkout to the latest revision."
msgstr ""
# 1c69e90a4da345a1aba7fc9b107bf65a
#: ../../../readthedocs/vcs_support/base.pydocstring of
#: vcs_support.base.BaseVCS.checkout:5
msgid ""
"The type and format of identifier may change from VCS to VCS, so each "
"backend is responsible to understand it's identifiers."
msgstr ""
# 60ee23dcf33747de8dfeafd041501b84
#: ../../../readthedocs/vcs_support/base.pydocstring of
#: vcs_support.base.BaseVCS.get_contribution_backend:1
msgid ""
"Returns a contribution backend or None for this repository. The backend is "
"detected via the repository URL."
msgstr ""
# f49a5857106c404486ec6de084165101
#: ../../../readthedocs/vcs_support/base.pydocstring of
#: vcs_support.base.BaseVCS.update:1
msgid ""
"If self.working_dir is already a valid local copy of the repository, update "
"the repository, else create a new local copy of the repository."
msgstr ""
# fd4f7a239d6542819687680626b2f291
#: ../../../readthedocs/vcs_support/base.pydocstring of
#: vcs_support.base.VCSProject:1
msgid "Transient object to encapsulate a projects stuff"
msgstr ""
# e7718753e3b5488d8665e56c62b59ed6
#: ../../../readthedocs/vcs_support/base.pydocstring of
#: vcs_support.base.VCSVersion:1
msgid "Represents a Version (tag or branch) in a VCS."
msgstr ""
# 9c37d628fd414f4eb3aa9c258789244e
#: ../../../readthedocs/vcs_support/base.pydocstring of
#: vcs_support.base.VCSVersion:3
msgid "This class should only be instantiated in BaseVCS subclasses."
msgstr ""
# 2f17689d78524225b98df526bc2ec9c9
#: ../../../readthedocs/vcs_support/base.pydocstring of
#: vcs_support.base.VCSVersion:5
msgid ""
"It can act as a context manager to temporarily switch to this tag (eg to "
"build docs for this tag)."
msgstr ""

View File

@ -1,28 +1,26 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2010, Eric Holscher, Charlie Leifer, Bobby Grace
# This file is distributed under the same license as the Read The Docs package.
# 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: 2014-03-01 22:07+0800\n"
"POT-Creation-Date: 2018-09-17 19:05-0500\n"
"PO-Revision-Date: 2014-03-02 12:03+0000\n"
"Last-Translator: Eric Holscher <eric@ericholscher.com>\n"
"Language-Team: Danish (http://www.transifex.com/projects/p/readthedocs-docs/language/da/)\n"
"Language-Team: Danish (http://www.transifex.com/readthedocs/readthedocs-docs/language/da/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: da\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
# 9ea817ff76ed4771b64cedf6245c6248
#: ../../architecture.rst:2
msgid "Architecture"
msgstr ""
# abe94834b6fc4b70b94e5747a3babbc9
#: ../../architecture.rst:4
msgid ""
"Read the Docs is architected to be highly available. A lot of projects host "
@ -32,7 +30,6 @@ msgid ""
"down, we have issues."
msgstr ""
# f96821ae1b7647f0a4d408e7b4eb23c4
#: ../../architecture.rst:7
msgid "Diagram"
msgstr ""

Binary file not shown.

View File

@ -0,0 +1,126 @@
# 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.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Read the Docs 1.0\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2018-09-17 19:05-0500\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Language-Team: Danish (https://www.transifex.com/readthedocs/teams/2534/da/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: da\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
#: ../../automatic-redirects.rst:2
msgid "Automatic Redirects"
msgstr ""
#: ../../automatic-redirects.rst:4
msgid ""
"Read the Docs supports redirecting certain URLs automatically. This is an "
"overview of the set of redirects that are fully supported and will work into"
" the future."
msgstr ""
#: ../../automatic-redirects.rst:8
msgid "Root URL"
msgstr ""
#: ../../automatic-redirects.rst:10
msgid ""
"A link to the root of your documentation will redirect to the *default "
"version*, as set in your project settings. For example::"
msgstr ""
#: ../../automatic-redirects.rst:17
msgid ""
"This only works for the root URL, not for internal pages. It's designed to "
"redirect people from http://pip.readthedocs.io/ to the default version of "
"your documentation, since serving up a 404 here would be a pretty terrible "
"user experience. (If your \"develop\" branch was designated as your default "
"version, then it would redirect to http://pip.readthedocs.io/en/develop.) "
"But, it's not a universal redirecting solution. So, for example, a link to "
"an internal page like http://pip.readthedocs.io/usage.html doesn't redirect "
"to http://pip.readthedocs.io/en/latest/usage.html."
msgstr ""
#: ../../automatic-redirects.rst:19
msgid ""
"The reasoning behind this is that RTD organizes the URLs for docs so that "
"multiple translations and multiple versions of your docs can be organized "
"logically and consistently for all projects that RTD hosts. For the way that"
" RTD views docs, http://pip.readthedocs.io/en/latest/ is the root directory "
"for your default documentation in English, not http://pip.readthedocs.io/. "
"Just like http://pip.readthedocs.io/en/develop/ is the root for your "
"development documentation in English."
msgstr ""
#: ../../automatic-redirects.rst:21
msgid ""
"Among all the multiple versions of docs, you can choose which is the "
"\"default\" version for RTD to display, which usually corresponds to the git"
" branch of the most recent official release from your project."
msgstr ""
#: ../../automatic-redirects.rst:24
msgid "rtfd.org"
msgstr ""
#: ../../automatic-redirects.rst:26
msgid ""
"Links to rtfd.org are treated the same way as above. They redirect the root "
"URL to the default version of the project. They are intended to be easy and "
"short for people to type."
msgstr ""
#: ../../automatic-redirects.rst:31
msgid "Supported Top-Level Redirects"
msgstr ""
#: ../../automatic-redirects.rst:33
msgid ""
"These \"implicit\" redirects are supported for legacy reasons. We will not "
"be adding support for any more magic redirects. If you want additional "
"redirects, they should live at a prefix like `Redirecting to a Page`_"
msgstr ""
#: ../../automatic-redirects.rst:38
msgid ""
"The main challenge of URL routing in Read the Docs is handling redirects "
"correctly. Both in the interest of redirecting older URLs that are now "
"obsolete, and in the interest of handling \"logical-looking\" URLs (leaving "
"out the lang_slug or version_slug shouldn't result in a 404), the following "
"redirects are supported::"
msgstr ""
#: ../../automatic-redirects.rst:44
msgid ""
"The language redirect will work for any of the defined ``LANGUAGE_CODES`` we"
" support. The version redirect will work for supported versions."
msgstr ""
#: ../../automatic-redirects.rst:48
msgid "Redirecting to a Page"
msgstr ""
#: ../../automatic-redirects.rst:50
msgid ""
"You can link to a specific page and have it redirect to your default "
"version. This is done with the ``/page/`` URL. For example::"
msgstr ""
#: ../../automatic-redirects.rst:57
msgid "This allows you to create links that are always up to date."
msgstr ""
#: ../../automatic-redirects.rst:59
msgid ""
"Another way to handle this is the *latest* version. You can set your "
"``latest`` version to a specific version and just always link to latest."
msgstr ""

Binary file not shown.

View File

@ -0,0 +1,136 @@
# 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.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Read the Docs 1.0\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2018-09-17 19:05-0500\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Language-Team: Danish (https://www.transifex.com/readthedocs/teams/2534/da/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: da\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
#: ../../badges.rst:2
msgid "Badges"
msgstr ""
#: ../../badges.rst:4
msgid ""
"Badges let you show the state of your documentation to your users. They are "
"great for embedding in your README, or putting inside your actual doc pages."
msgstr ""
#: ../../badges.rst:9
msgid "Status Badges"
msgstr ""
#: ../../badges.rst:11
msgid ""
"They will display in green for passing, red for failing, and yellow for "
"unknown states."
msgstr ""
#: ../../badges.rst:15
msgid "Here are a few examples:"
msgstr ""
#: ../../badges.rst:17
msgid "|green| |nbsp| |red| |nbsp| |yellow|"
msgstr ""
#: ../../badges.rst:19
msgid ""
"You can see it in action in the `Read the Docs README`_. They will link back"
" to your project's documentation page on Read the Docs."
msgstr ""
#: ../../badges.rst:23
msgid "Style"
msgstr ""
#: ../../badges.rst:25
msgid ""
"Now you can pass the ``style`` GET argument, to get custom styled badges "
"same as you would for shields.io. If no argument is passed, ``flat`` is used"
" as default."
msgstr ""
#: ../../badges.rst:30
msgid "STYLE"
msgstr ""
#: ../../badges.rst:30
msgid "BADGE"
msgstr ""
#: ../../badges.rst:32
msgid "flat"
msgstr ""
#: ../../badges.rst:32
msgid "|Flat Badge|"
msgstr ""
#: ../../badges.rst:34
msgid "flat-square"
msgstr ""
#: ../../badges.rst:34
msgid "|Flat-Square Badge|"
msgstr ""
#: ../../badges.rst:36
msgid "for-the-badge"
msgstr ""
#: ../../badges.rst:36
msgid "|Badge|"
msgstr ""
#: ../../badges.rst:38
msgid "plastic"
msgstr ""
#: ../../badges.rst:38
msgid "|Plastic Badge|"
msgstr ""
#: ../../badges.rst:40
msgid "social"
msgstr ""
#: ../../badges.rst:40
msgid "|Social Badge|"
msgstr ""
#: ../../badges.rst:51
msgid "Project Pages"
msgstr ""
#: ../../badges.rst:53
msgid ""
"You will now see badges embedded in your `project page`_. The default badge "
"will be pointed at the *default version* you have specified for your "
"project. The badge URLs look like this::"
msgstr ""
#: ../../badges.rst:59
msgid ""
"You can replace the version argument with any version that you want to show "
"a badge for. If you click on the badge icon, you will be given snippets for "
"RST, Markdown, and HTML; to make embedding it easier."
msgstr ""
#: ../../badges.rst:64
msgid ""
"If you leave the version argument off, it will default to your latest "
"version. This is probably best to include in your README, since it will stay"
" up to date with your Read the Docs project::"
msgstr ""

Binary file not shown.

View File

@ -1,42 +1,133 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2010, Eric Holscher, Charlie Leifer, Bobby Grace
# This file is distributed under the same license as the Read The Docs package.
# 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: 2014-03-01 22:07+0800\n"
"PO-Revision-Date: 2014-03-02 12:03+0000\n"
"Last-Translator: Eric Holscher <eric@ericholscher.com>\n"
"Language-Team: Danish (http://www.transifex.com/projects/p/readthedocs-docs/language/da/)\n"
"POT-Creation-Date: 2018-09-17 19:05-0500\n"
"PO-Revision-Date: 2018-09-18 00:30+0000\n"
"Last-Translator: Anthony <aj@ohess.org>\n"
"Language-Team: Danish (http://www.transifex.com/readthedocs/readthedocs-docs/language/da/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: da\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
# 3a8fbbce5d45416d99da9711b09bb6a9
#: ../../builds.rst:2
msgid "Build Process"
msgstr ""
# ef7b9d6a4ea34f449918d1f8cde89295
#: ../../builds.rst:5
#: ../../builds.rst:4
msgid "Files: `tasks.py`_ - `doc_builder/`_"
msgstr ""
#: ../../builds.rst:9
msgid ""
"Every documentation build has limited resources. Our current build limits "
"are:"
msgstr ""
#: ../../builds.rst:12
msgid "15 minutes"
msgstr ""
#: ../../builds.rst:13
msgid "1GB of memory"
msgstr ""
#: ../../builds.rst:15
msgid ""
"We can increase build limits on a per-project basis, if you provide a good "
"reason your documentation needs more resources."
msgstr ""
#: ../../builds.rst:18
msgid ""
"You can see the current Docker build images that we use in our `docker "
"repository <https://github.com/rtfd/readthedocs-docker-images>`_. `Docker "
"Hub <https://hub.docker.com/r/readthedocs/build/>`_ also shows the latest "
"set of images that have been built."
msgstr ""
#: ../../builds.rst:21
msgid ""
"Currently in production we're using the ``readthedocs/build:2.0`` docker "
"image as our default image."
msgstr ""
#: ../../builds.rst:24
msgid "How we build documentation"
msgstr ""
#: ../../builds.rst:26
msgid ""
"When we import your documentation, we look at two things first: your "
"*Repository URL* and the *Documentation Type*. We will clone your "
"repository, and then build your documentation using the *Documentation Type*"
" specified."
msgstr ""
#: ../../builds.rst:31
msgid "Sphinx"
msgstr ""
#: ../../builds.rst:33
msgid ""
"When you choose *Sphinx* as your *Documentation Type*, we will first look "
"for a ``conf.py`` file in your repository. If we don't find one, we will "
"generate one for you. We will look inside a ``doc`` or ``docs`` directory "
"first, and then look within your entire project."
msgstr ""
#: ../../builds.rst:40
msgid "Then Sphinx will build any files with an ``.rst`` extension."
msgstr ""
#: ../../builds.rst:43
msgid "MkDocs"
msgstr ""
#: ../../builds.rst:45
msgid ""
"When you choose *Mkdocs* as your *Documentation Type*, we will first look "
"for a ``mkdocs.yml`` file in the root of your repository. If we don't find "
"one, we will generate one for you."
msgstr ""
#: ../../builds.rst:50
msgid ""
"Then MkDocs will build any files with a ``.md`` extension within the "
"directory specifed as ``docs_dir`` in the ``mkdocs.yml``."
msgstr ""
#: ../../builds.rst:52
msgid ""
"If no ``mkdocs.yml`` was found in the root of your repository and we "
"generated one for you, Read the Docs will attempt to set ``docs_dir`` by "
"sequentially searching for a ``docs``, ``doc``, ``Doc``, or ``book`` "
"directory. The first of these directories that exists and contains files "
"with a ``.md`` extension will be set to ``docs_dir`` within ``mkdocs.yml``, "
"and MkDocs will build the ``.md`` files in that directory. As MkDocs doesn't"
" support automatic PDF generation, Read the Docs cannot create a PDF version"
" of your documentation with the *Mkdocs* option."
msgstr ""
#: ../../builds.rst:60
msgid "Understanding what's going on"
msgstr ""
# 9596846224074a88b4a15b8fe94c5ab8
#: ../../builds.rst:7
#: ../../builds.rst:62
msgid ""
"Understanding how Read the Docs builds your project will help you with "
"debugging the problems you have with the site. It should also allow you to "
"take advantage of certain things that happen during the build process."
msgstr ""
# a30b1141a52b4c10b2802fef386117f6
#: ../../builds.rst:9
#: ../../builds.rst:65
msgid ""
"The first step of the process is that we check out your code from the "
"repository you have given us. If the code is already checked out, we update "
@ -44,93 +135,232 @@ msgid ""
"configuration."
msgstr ""
# a54e8b4580e1459a8d5e0d127075b8a6
#: ../../builds.rst:11
#: ../../builds.rst:68
msgid ""
"Then we build the proper backend code for the type of documentation you've "
"selected."
msgstr ""
# ba475848a7994d5396abf0fc6ceb6143
#: ../../builds.rst:13
#: ../../builds.rst:70
msgid ""
"If you have the *Use Virtualenv* option enabled, we will run ``setup.py "
"If you have the *Install Project* option enabled, we will run ``setup.py "
"install`` on your package, installing it into a virtual environment. You can"
" also define additional packages to install with the *Requirements File* "
"option."
msgstr ""
# 06cc6cc16a0549819a7dad291636baf5
#: ../../builds.rst:15
#: ../../builds.rst:73
msgid ""
"When we build your documentation, we run `sphinx-build -b html . "
"_build/html`, where `html` would be replaced with the correct backend. We "
"also create man pages and pdf's automatically based on your project."
"When we build your Sphinx documentation, we run ``sphinx-build -b html . "
"_build/html``, where ``html`` would be replaced with the correct backend. We"
" also create pdf's and ePub's automatically based on your project. For "
"MkDocs, we run ``mkdocs build``."
msgstr ""
# 1f5069b137144fea87206c3b3a7a6b1c
#: ../../builds.rst:17
#: ../../builds.rst:78
msgid ""
"Then these files are copied across to our application servers from the build"
" server. Once on the application servers, they are served from nginx."
msgstr ""
# 932aa28f576e49cbae81fbebbe084571
#: ../../builds.rst:19
#: ../../builds.rst:81
msgid "An example in code:"
msgstr ""
# 458b6790f8b24bc08fd4ec19661494d4
#: ../../builds.rst:32
msgid "Packages installed in the build environment"
msgstr ""
# 18068130d2ba4cbd8ba7aa8a2add59b8
#: ../../builds.rst:34
#: ../../builds.rst:95
msgid ""
"The build server does have a select number of C libraries installed, because"
" they are used across a wide array of python projects. We can't install "
"every C library out there, but we try and support the major ones. We "
"currently have the following libraries installed:"
"Regardless of whether you build your docs with Sphinx or MkDocs, we "
"recommend you pin the version of Sphinx or Mkdocs you want us to use. You "
"can do this the same way other :doc:`dependencies are specified <guides"
"/specifying-dependencies>`. Some examples of pinning versions might be "
"``sphinx<2.0`` or ``mkdocs>=1.0``."
msgstr ""
# 68d042505a7e4e65a9acc42a896a1c77
#: ../../builds.rst:36
msgid "LaTeX (texlive-full)"
#: ../../builds.rst:102
msgid "Builder responsibility"
msgstr ""
# c76432f795c24fc298e68ad9032ac29b
#: ../../builds.rst:37
msgid "libevent (libevent-dev)"
#: ../../builds.rst:104
msgid ""
"Builders have a very specific job. They take the updated source code and "
"generate the correct artifacts. The code lives in "
"``self.version.project.checkout_path(self.version.slug)``. The artifacts "
"should end up in "
"``self.version.project.artifact_path(version=self.version.slug, "
"type=self.type)`` Where ``type`` is the name of your builder. All files that"
" end up in the artifact directory should be in their final form."
msgstr ""
# 3662e62a19a549428ea5b075c464dbd8
#: ../../builds.rst:38
msgid "dvipng"
#: ../../builds.rst:112
msgid "The build environment"
msgstr ""
# fb278765ae2a4fc8942165bb93fe40ca
#: ../../builds.rst:39
msgid "graphviz"
#: ../../builds.rst:114
msgid ""
"The build process is executed inside Docker containers, by default the image"
" used is ``readthedocs/build:2.0``, but you can change that using a "
":doc:`configuration file <yaml-config>`."
msgstr ""
# dcc1733c94db40809c2a383da69aa5d4
#: ../../builds.rst:40
msgid "libxslt1.1"
#: ../../builds.rst:120
msgid ""
"The Docker images have a select number of C libraries installed, because "
"they are used across a wide array of python projects. We can't install every"
" C library out there, but we try and support the major ones."
msgstr ""
# 0e0696a8b6054e41af0f0eb6ed866239
#: ../../builds.rst:41
msgid "libxml2-dev"
#: ../../builds.rst:127
msgid ""
"If you want to know the specific version of a package that is installed in "
"the image you can check the `Ubuntu package search page "
"<https://packages.ubuntu.com/>`__."
msgstr ""
# 9ed92a9aa08740b78b89ffb2f228c413
#: ../../builds.rst:44
#: ../../builds.rst:131
msgid "2.0 (stable)"
msgstr ""
#: ../../builds.rst:0 ../../builds.rst:0
msgid "O.S"
msgstr ""
#: ../../builds.rst:133 ../../builds.rst:157
msgid "Ubuntu 16.04"
msgstr ""
#: ../../builds.rst:0 ../../builds.rst:0
msgid "Conda"
msgstr ""
#: ../../builds.rst:134
msgid "Miniconda 4.3.31"
msgstr ""
#: ../../builds.rst:0 ../../builds.rst:0
msgid "Python"
msgstr ""
#: ../../builds.rst:136
msgid "``m2crypto``"
msgstr ""
#: ../../builds.rst:137 ../../builds.rst:160
msgid "``matplolib``"
msgstr ""
#: ../../builds.rst:138
msgid "``numpy``"
msgstr ""
#: ../../builds.rst:139 ../../builds.rst:162
msgid "``pandas``"
msgstr ""
#: ../../builds.rst:140 ../../builds.rst:163
msgid "``pip``"
msgstr ""
#: ../../builds.rst:141 ../../builds.rst:164
msgid "``scipy``"
msgstr ""
#: ../../builds.rst:0 ../../builds.rst:0
msgid "Other packages"
msgstr ""
#: ../../builds.rst:143 ../../builds.rst:170
msgid "``doxygen``"
msgstr ""
#: ../../builds.rst:144
msgid "``graphviz``"
msgstr ""
#: ../../builds.rst:145
msgid "``libevent``"
msgstr ""
#: ../../builds.rst:146 ../../builds.rst:173
msgid "``libjpeg``"
msgstr ""
#: ../../builds.rst:147 ../../builds.rst:174
msgid "``libxml2-dev``"
msgstr ""
#: ../../builds.rst:148
msgid "``libxslt1.1``"
msgstr ""
#: ../../builds.rst:149 ../../builds.rst:176
msgid "``pandoc``"
msgstr ""
#: ../../builds.rst:150 ../../builds.rst:178
msgid "``textlive-full``"
msgstr ""
#: ../../builds.rst:152
msgid ""
"`More details <https://github.com/rtfd/readthedocs-docker-"
"images/blob/releases/2.x/Dockerfile>`__"
msgstr ""
#: ../../builds.rst:155
msgid "3.0 (latest)"
msgstr ""
#: ../../builds.rst:158
msgid "Miniconda 4.4.10"
msgstr ""
#: ../../builds.rst:161
msgid "``numpy``,"
msgstr ""
#: ../../builds.rst:0
msgid "JavaScript"
msgstr ""
#: ../../builds.rst:166
msgid "``jsdoc``"
msgstr ""
#: ../../builds.rst:167
msgid "``nodejs``"
msgstr ""
#: ../../builds.rst:168
msgid "``npm``"
msgstr ""
#: ../../builds.rst:171
msgid "``libevent-dev``"
msgstr ""
#: ../../builds.rst:172
msgid "``libgraphviz-dev``"
msgstr ""
#: ../../builds.rst:175
msgid "``libxslt1-dev``"
msgstr ""
#: ../../builds.rst:177
msgid "``plantuml``"
msgstr ""
#: ../../builds.rst:180
msgid ""
"`More details <https://github.com/rtfd/readthedocs-docker-"
"images/blob/releases/3.x/Dockerfile>`__"
msgstr ""
#: ../../builds.rst:183
msgid "Writing your own builder"
msgstr ""
# ebc648e07b6c485c85285f5e07d54f0f
#: ../../builds.rst:46
#: ../../builds.rst:185
msgid ""
"Builds happen on a server using only the RTD Public API. There is no reason "
"that you couldn't build your own independent builder that wrote into the RTD"
@ -138,32 +368,87 @@ msgid ""
"way than uploading the processed files as a zip."
msgstr ""
# 609c81d8bf394290a3f02e10126d32da
#: ../../builds.rst:48
#: ../../builds.rst:187
msgid ""
"The documentation build system in RTD is made pluggable, so that you can "
"build out your own backend. If you have a documentation format that isn't "
"currently supported, you can add support by contributing a backend."
msgstr ""
# c9d3c709fc1a4bca9b0d4cf7cc4d92aa
#: ../../builds.rst:50
#: ../../builds.rst:189
msgid ""
"The :doc:`api/doc_builder` API explains the higher level parts of the API "
"that you need to implement. A basic run goes something like this::"
"The builders in :doc:`/developer-interface/doc_builder` detail the higher "
"level parts of the API that you need to implement. A basic run goes "
"something like this::"
msgstr ""
# 6f80ca5d2dd545999044449b14c56764
#: ../../builds.rst:61
#: ../../builds.rst:200
msgid "Deleting a stale or broken build environment"
msgstr ""
# 5c23d9f9966147089b03281cbf66820c
#: ../../builds.rst:63
#: ../../builds.rst:202
msgid ""
"RTD doesn't expose this in the UI, but it is possible to remove the build "
"directory of your project. If you want to remove a build environment for "
"your project, hit "
"http://readthedocs.org/wipe/<project_slug>/<version_slug>/. You must be "
"logged in to do this."
"If you're having trouble getting your version to build, try wiping out the "
"existing build/environment files. On your version list page "
"``/projects/[project]/versions`` there is a \"Wipe\" button that will remove"
" all of the files associated with your documentation build, but not the "
"documentation itself."
msgstr ""
#: ../../builds.rst:205
msgid "Build environment"
msgstr ""
#: ../../builds.rst:207
msgid ""
"The *Sphinx* and *Mkdocs* builders set the following RTD-specific "
"environment variables when building your documentation:"
msgstr ""
#: ../../builds.rst:210
msgid "Environment variable"
msgstr ""
#: ../../builds.rst:210
msgid "Description"
msgstr ""
#: ../../builds.rst:210
msgid "Example value"
msgstr ""
#: ../../builds.rst:212
msgid "``READTHEDOCS``"
msgstr ""
#: ../../builds.rst:212
msgid "Whether the build is running inside RTD"
msgstr ""
#: ../../builds.rst:212
msgid "``True``"
msgstr ""
#: ../../builds.rst:214
msgid "``READTHEDOCS_VERSION``"
msgstr ""
#: ../../builds.rst:214
msgid "The RTD name of the version which is being built"
msgstr ""
#: ../../builds.rst:214
msgid "``latest``"
msgstr ""
#: ../../builds.rst:216
msgid "``READTHEDOCS_PROJECT``"
msgstr ""
#: ../../builds.rst:216
msgid "The RTD name of the project which is being built"
msgstr ""
#: ../../builds.rst:216
msgid "``myexampleproject``"
msgstr ""

View File

@ -1,28 +1,26 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2010, Eric Holscher, Charlie Leifer, Bobby Grace
# This file is distributed under the same license as the Read The Docs package.
# 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: 2014-03-01 22:07+0800\n"
"PO-Revision-Date: 2014-03-02 12:03+0000\n"
"Last-Translator: Eric Holscher <eric@ericholscher.com>\n"
"Language-Team: Danish (http://www.transifex.com/projects/p/readthedocs-docs/language/da/)\n"
"POT-Creation-Date: 2018-09-17 19:05-0500\n"
"PO-Revision-Date: 2018-09-18 00:14+0000\n"
"Last-Translator: Anthony <aj@ohess.org>\n"
"Language-Team: Danish (http://www.transifex.com/readthedocs/readthedocs-docs/language/da/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: da\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
# 921a66fbea0649d8ac0f530c9e23d6ae
#: ../../canonical.rst:2
msgid "Canonical URLs"
msgstr ""
# 497295cd991946a1a08f2b94e659d22b
#: ../../canonical.rst:4
msgid ""
"Canonical URLs allow people to have consistent page URLs for domains. This "
@ -30,91 +28,76 @@ msgid ""
"correct page."
msgstr ""
# 3f155754a08e4730b701cbe350cd3a94
#: ../../canonical.rst:8
msgid "Read the Docs uses these in two ways:"
msgstr ""
# ef97d1ca9f8548648e0648254d5bf80e
#: ../../canonical.rst:10
msgid "We point all versions of your docs at the \"latest\" version as canonical"
msgstr ""
# 0bafcc10347b4a7a8b104646ec8b52c1
#: ../../canonical.rst:11
msgid ""
"We point at the user specified canonical URL, generally a custom domain for "
"your docs."
msgstr ""
# aa3a6bd7606a41bf86a11ee25b4b1c05
#: ../../canonical.rst:14
msgid "Example"
msgstr ""
# 9d93513e59be4a12af135bd87158b96d
#: ../../canonical.rst:16
msgid ""
"Fabric hosts their docs on Read the Docs. They mostly use their own domain "
"for them ``http://docs.fabfile.org``. This means that Google will index both"
" ``http://fabric-docs.readthedocs.org`` and ``http://docs.fabfile.org`` for their"
" documentation."
" ``http://fabric-docs.readthedocs.io`` and ``http://docs.fabfile.org`` for "
"their documentation."
msgstr ""
# 8c83b33254cc46ce8275dc9c331e9c74
#: ../../canonical.rst:20
msgid ""
"Fabric will want to set ``http://docs.fabfile.org`` as their canonical URL. "
"This means that when Google indexes ``http://fabric-docs.readthedocs.org``, it "
"will know that it should really point at ``http://docs.fabfile.org``."
"This means that when Google indexes ``http://fabric-docs.readthedocs.io``, "
"it will know that it should really point at ``http://docs.fabfile.org``."
msgstr ""
# fd6280eed84844f8a6c0c55e0672f9af
#: ../../canonical.rst:24
msgid "Enabling"
msgstr ""
# e911c4cf9cc54da580319f31bf125c81
#: ../../canonical.rst:26
msgid ""
"You can set the canonical URL for your project in the Project Admin page. "
"Check your `dashboard`_ for a list of your projects."
"Check your `Domains` tab for the domains that we know about."
msgstr ""
# 28fdbf7c1aec4ae08f92d6224033dfa1
#: ../../canonical.rst:29
msgid "Implementation"
msgstr ""
# 0790df700231421f92d044caaf97967c
#: ../../canonical.rst:31
msgid ""
"If you look at the source code for documentation built after you set your "
"canonical URL, you should see a bit of HTML like this:"
msgstr ""
# c3cc4cfa11e04e33ab7bc636050d7cbe
#: ../../canonical.rst:39
msgid "Links"
msgstr ""
# 74ddc3e7c4674c66ad002c388dc21612
#: ../../canonical.rst:41
msgid ""
"This is a good explanation of the usage of canonical URLs in search engines:"
msgstr ""
# 6e25304294e444dc89d2f579a17aed09
#: ../../canonical.rst:43
msgid "http://www.mattcutts.com/blog/seo-advice-url-canonicalization/"
msgstr ""
# d9ea914b2d594f23bad437c22b67b75c
#: ../../canonical.rst:45
msgid "This is a good explanation for why canonical pages are good for SEO:"
msgstr ""
# 5943978f623a439cb44672b916c22d62
#: ../../canonical.rst:47
msgid ""
"http://moz.com/blog/canonical-url-tag-the-most-important-advancement-in-seo-"

File diff suppressed because it is too large Load Diff

Binary file not shown.

View File

@ -0,0 +1,160 @@
# 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.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Read the Docs 1.0\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2018-09-17 19:05-0500\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Language-Team: Danish (https://www.transifex.com/readthedocs/teams/2534/da/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: da\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
#: ../../code-of-conduct.rst:2
msgid "Code of Conduct"
msgstr ""
#: ../../code-of-conduct.rst:4
msgid ""
"Like the technical community as a whole, the Read the Docs team and "
"community is made up of a mixture of professionals and volunteers from all "
"over the world, working on every aspect of the mission - including "
"mentorship, teaching, and connecting people."
msgstr ""
#: ../../code-of-conduct.rst:9
msgid ""
"Diversity is one of our huge strengths, but it can also lead to "
"communication issues and unhappiness. To that end, we have a few ground "
"rules that we ask people to adhere to. This code applies equally to "
"founders, mentors and those seeking help and guidance."
msgstr ""
#: ../../code-of-conduct.rst:14
msgid ""
"This isnt an exhaustive list of things that you cant do. Rather, take it "
"in the spirit in which its intended - a guide to make it easier to enrich "
"all of us and the technical communities in which we participate."
msgstr ""
#: ../../code-of-conduct.rst:18
msgid ""
"This code of conduct applies to all spaces managed by the Read the Docs "
"project. This includes IRC, the mailing lists, the issue tracker, and any "
"other forums created by the project team which the community uses for "
"communication. In addition, violations of this code outside these spaces may"
" affect a person's ability to participate within them."
msgstr ""
#: ../../code-of-conduct.rst:25
msgid ""
"If you believe someone is violating the code of conduct, we ask that you "
"report it by emailing dev@readthedocs.org."
msgstr ""
#: ../../code-of-conduct.rst:28
msgid "**Be friendly and patient.**"
msgstr ""
#: ../../code-of-conduct.rst:29
msgid ""
"**Be welcoming.** We strive to be a community that welcomes and supports "
"people of all backgrounds and identities. This includes, but is not limited "
"to members of any race, ethnicity, culture, national origin, colour, "
"immigration status, social and economic class, educational level, sex, "
"sexual orientation, gender identity and expression, age, size, family "
"status, political belief, religion, and mental and physical ability."
msgstr ""
#: ../../code-of-conduct.rst:36
msgid ""
"**Be considerate.** Your work will be used by other people, and you in turn "
"will depend on the work of others. Any decision you take will affect users "
"and colleagues, and you should take those consequences into account when "
"making decisions. Remember that we're a world-wide community, so you might "
"not be communicating in someone else's primary language."
msgstr ""
#: ../../code-of-conduct.rst:42
msgid ""
"**Be respectful.** Not all of us will agree all the time, but disagreement "
"is no excuse for poor behavior and poor manners. We might all experience "
"some frustration now and then, but we cannot allow that frustration to turn "
"into a personal attack. Its important to remember that a community where "
"people feel uncomfortable or threatened is not a productive one. Members of "
"the Read the Docs community should be respectful when dealing with other "
"members as well as with people outside the Read the Docs community."
msgstr ""
#: ../../code-of-conduct.rst:50
msgid ""
"**Be careful in the words that you choose.** We are a community of "
"professionals, and we conduct ourselves professionally. Be kind to others. "
"Do not insult or put down other participants. Harassment and other "
"exclusionary behavior aren't acceptable. This includes, but is not limited "
"to:"
msgstr ""
#: ../../code-of-conduct.rst:56
msgid "Violent threats or language directed against another person."
msgstr ""
#: ../../code-of-conduct.rst:57
msgid "Discriminatory jokes and language."
msgstr ""
#: ../../code-of-conduct.rst:58
msgid "Posting sexually explicit or violent material."
msgstr ""
#: ../../code-of-conduct.rst:59
msgid ""
"Posting (or threatening to post) other people's personally identifying "
"information (\"doxing\")."
msgstr ""
#: ../../code-of-conduct.rst:61
msgid "Personal insults, especially those using racist or sexist terms."
msgstr ""
#: ../../code-of-conduct.rst:62
msgid "Unwelcome sexual attention."
msgstr ""
#: ../../code-of-conduct.rst:63
msgid "Advocating for, or encouraging, any of the above behavior."
msgstr ""
#: ../../code-of-conduct.rst:64
msgid ""
"Repeated harassment of others. In general, if someone asks you to stop, then"
" stop."
msgstr ""
#: ../../code-of-conduct.rst:67
msgid ""
"**When we disagree, try to understand why.** Disagreements, both social and "
"technical, happen all the time and Read the Docs is no exception. It is "
"important that we resolve disagreements and differing views constructively. "
"Remember that were different. The strength of Read the Docs comes from its "
"varied community, people from a wide range of backgrounds. Different people "
"have different perspectives on issues. Being unable to understand why "
"someone holds a viewpoint doesnt mean that theyre wrong. Dont forget that"
" it is human to err and blaming each other doesnt get us anywhere. Instead,"
" focus on helping to resolve issues and learning from mistakes."
msgstr ""
#: ../../code-of-conduct.rst:78
msgid ""
"Original text courtesy of the `Speak Up! project "
"<http://web.archive.org/web/20141109123859/http://speakup.io/coc.html>`__. "
"This version was adopted from the `Django Code of Conduct "
"<https://www.djangoproject.com/conduct/>`_."
msgstr ""

Binary file not shown.

View File

@ -0,0 +1,85 @@
# 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.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Read the Docs 1.0\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2018-09-17 19:05-0500\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Language-Team: Danish (https://www.transifex.com/readthedocs/teams/2534/da/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: da\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
#: ../../conda.rst:2
msgid "Conda Support"
msgstr ""
#: ../../conda.rst:4
msgid ""
"This feature is in a beta state. Please file an `issue`_ if you find "
"anything wrong."
msgstr ""
#: ../../conda.rst:7
msgid ""
"Read the Docs supports Conda as an environment management tool, along with "
"Virtualenv. Conda support is useful for people who depend on C libraries, "
"and need them installed when building their documentation."
msgstr ""
#: ../../conda.rst:12
msgid ""
"This work was funded by `Clinical Graphics`_ -- many thanks for their "
"support of Open Source."
msgstr ""
#: ../../conda.rst:15
msgid "Activating Conda"
msgstr ""
#: ../../conda.rst:17
msgid ""
"Conda Support is the first feature enabled with :doc:`yaml-config`. You can "
"enable it by creating a `readthedocs.yml` file in the root of your "
"repository with the contents:"
msgstr ""
#: ../../conda.rst:26
msgid ""
"This Conda environment will also have Sphinx and other build time "
"dependencies installed. It will use the same order of operations that we "
"support currently:"
msgstr ""
#: ../../conda.rst:29
msgid "Environment Creation (``conda env create``)"
msgstr ""
#: ../../conda.rst:30
msgid "Dependency Installation (Sphinx)"
msgstr ""
#: ../../conda.rst:33
msgid "Custom Installs"
msgstr ""
#: ../../conda.rst:35
msgid ""
"If you are running a custom installation of Read the Docs, you will need the"
" ``conda`` executable installed somewhere on your ``PATH``. Because of the "
"way ``conda`` works, we can't safely install it as a normal dependency into "
"the normal Python virtualenv."
msgstr ""
#: ../../conda.rst:40
msgid ""
"Installing conda into a virtualenv will override the ``activate`` script, "
"making it so you can't properly activate that virtualenv anymore."
msgstr ""

View File

@ -1,56 +1,431 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2010, Eric Holscher, Charlie Leifer, Bobby Grace
# This file is distributed under the same license as the Read The Docs package.
# 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: 2014-03-01 22:07+0800\n"
"PO-Revision-Date: 2014-03-02 12:03+0000\n"
"Last-Translator: Eric Holscher <eric@ericholscher.com>\n"
"Language-Team: Danish (http://www.transifex.com/projects/p/readthedocs-docs/language/da/)\n"
"POT-Creation-Date: 2018-09-17 19:05-0500\n"
"PO-Revision-Date: 2018-09-18 00:14+0000\n"
"Last-Translator: Anthony <aj@ohess.org>\n"
"Language-Team: Danish (http://www.transifex.com/readthedocs/readthedocs-docs/language/da/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: da\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
# 351bbc50f2c146168531bb497305344c
#: ../../contribute.rst:4
#: ../../contribute.rst:2
msgid "Contributing to Read the Docs"
msgstr ""
# ab39a6eecace4a8788f0cbb338b75fb1
#: ../../contribute.rst:6
#: ../../contribute.rst:4
msgid ""
"Read the Docs follows the standard Contribution Guidelines set forth at "
"`contribution-guide.org`_. Please read that site and follow the instructions"
" to make sure your patches will be accepted."
"You are here to help on Read the Docs? Awesome, feel welcome and read the "
"following sections in order to know how to ask questions and how to work on "
"something."
msgstr ""
# dedde10fdd2e4e8783d1e8120808bc3c
#: ../../contribute.rst:12
msgid "Tickets"
#: ../../contribute.rst:7
msgid ""
"All members of our community are expected to follow our :doc:`/code-of-"
"conduct`. Please make sure you are welcoming and friendly in all of our "
"spaces."
msgstr ""
#: ../../contribute.rst:11
msgid "Get in touch"
msgstr ""
#: ../../contribute.rst:13
msgid "Ask usage questions (\"How do I?\") on `StackOverflow`_."
msgstr ""
# 312f9d1c0711442b91a7e23799099283
#: ../../contribute.rst:14
msgid "Report bugs, suggest features or view the source code `on GitHub`_."
msgstr ""
#: ../../contribute.rst:15
msgid "Discuss topics on `Gitter`_."
msgstr ""
#: ../../contribute.rst:16
msgid "On IRC find us at `#readthedocs`_."
msgstr ""
#: ../../contribute.rst:24
msgid "Contributing to development"
msgstr ""
#: ../../contribute.rst:26
msgid ""
"There are a set of tickets with a `Feature Overview`_ tag. These tickets "
"have a general overview and description of the work required to finish. If "
"you want to start somewhere, this would be a good place to start. That said,"
" these aren't necessarily the easiest tickets. They are simply things that "
"are explained."
"If you want to deep dive and help out with development on Read the Docs, "
"then first get the project installed locally according to the "
":doc:`Installation Guide <install>`. After that is done we suggest you have "
"a look at tickets in our issue tracker that are labelled `Good First "
"Issue`_. These are meant to be a great way to get a smooth start and won't "
"put you in front of the most complex parts of the system."
msgstr ""
# 53580dc3abfe41bda62913c58f1a9941
#: ../../contribute.rst:25
msgid "Translations"
#: ../../contribute.rst:33
msgid ""
"If you are up to more challenging tasks with a bigger scope, then there are "
"a set of tickets with a `Feature`_ or `Improvement`_ tag. These tickets have"
" a general overview and description of the work required to finish. If you "
"want to start somewhere, this would be a good place to start (make sure that"
" the issue also have the `Accepted`_ label). That said, these aren't "
"necessarily the easiest tickets. They are simply things that are explained. "
"If you still didn't find something to work on, search for the `Sprintable`_ "
"label. Those tickets are meant to be standalone and can be worked on ad-hoc."
msgstr ""
# ca8371d36e1248f4bdc46315d0b1ac5a
#: ../../contribute.rst:27
#: ../../contribute.rst:43
msgid ""
"When contributing code, then please follow the standard Contribution "
"Guidelines set forth at `contribution-guide.org`_."
msgstr ""
#: ../../contribute.rst:46
msgid ""
"We have a strict code style that is easy to follow since you just have to "
"install `pre-commit`_ and it will automatically run different linting tools "
"(`autoflake`_, `autopep8`_, `docformatter`_, `isort`_, `prospector`_, "
"`unify`_ and `yapf`_) to check your changes before you commit them. `pre-"
"commit` will let you know if there were any problems that is wasn't able to "
"fix automatically."
msgstr ""
#: ../../contribute.rst:52
msgid "To run the `pre-commit` command and check your changes::"
msgstr ""
#: ../../contribute.rst:58
msgid "or to run against a specific file::"
msgstr ""
#: ../../contribute.rst:62
msgid ""
"`pre-commit` can also be run as a git pre-commit hook. You can set this up "
"with::"
msgstr ""
#: ../../contribute.rst:67
msgid ""
"After this installation, the next time you run `git commit` the `pre-commit "
"run` command will be run immediately and will inform you of the changes and "
"errors."
msgstr ""
#: ../../contribute.rst:72
msgid ""
"Our code base is still maturing and the core team doesn't yet recommend "
"running this as a pre-commit hook due to the number of changes this will "
"cause while constructing a pull request. Independent pull requests with "
"linting changes would be a great help to making this possible."
msgstr ""
#: ../../contribute.rst:95
msgid "Triaging tickets"
msgstr ""
#: ../../contribute.rst:97
msgid ""
"Here is a brief explanation on how we triage incoming tickets to get a "
"better sense of what needs to be done on what end."
msgstr ""
#: ../../contribute.rst:100
msgid ""
"You will need Triage permission on the project in order to do this. You can "
"ask one of the members of the :doc:`team` to give you access."
msgstr ""
#: ../../contribute.rst:104
msgid "Initial triage"
msgstr ""
#: ../../contribute.rst:106
msgid ""
"When sitting down to do some triaging work, we start with the `list of "
"untriaged tickets`_. We consider all tickets that do not have a label as "
"untriaged. The first step is to categorize the ticket into one of the "
"following categories and either close the ticket or assign an appropriate "
"label. The reported issue …"
msgstr ""
#: ../../contribute.rst:127
msgid "… is not valid"
msgstr ""
#: ../../contribute.rst:113
msgid ""
"If you think the ticket is invalid comment why you think it is invalid, then"
" close the ticket. Tickets might be invalid if they were already fixed in "
"the past or it was decided that the proposed feature will not be implemented"
" because it does not conform with the overall goal of Read the Docs. Also if"
" you happen to know that the problem was already reported, reference the "
"other ticket that is already addressing the problem and close the duplicate."
msgstr ""
#: ../../contribute.rst:120 ../../contribute.rst:141 ../../contribute.rst:153
#: ../../contribute.rst:165 ../../contribute.rst:174 ../../contribute.rst:183
#: ../../contribute.rst:193 ../../contribute.rst:203
msgid "Examples:"
msgstr ""
#: ../../contribute.rst:122
msgid ""
"*Builds fail when using matplotlib*: If the described issue was already "
"fixed, then explain and instruct to re-trigger the build."
msgstr ""
#: ../../contribute.rst:125
msgid ""
"*Provide way to upload arbitrary HTML files*: It was already decided that "
"Read the Docs is not a dull hosting platform for HTML. So explain this and "
"close the ticket."
msgstr ""
#: ../../contribute.rst:144
msgid "… does not provide enough information"
msgstr ""
#: ../../contribute.rst:132
msgid ""
"Add the label **Needed: more information** if the reported issue does not "
"contain enough information to decide if it is valid or not and ask on the "
"ticket for the required information to go forward. We will re-triage all "
"tickets that have the label **Needed: more information** assigned. If the "
"original reporter left new information we can try to re-categorize the "
"ticket. If the reporter did not come back to provide more required "
"information after a long enough time, we will close the ticket (this will be"
" roughly about two weeks)."
msgstr ""
#: ../../contribute.rst:143
msgid ""
"*My builds stopped working. Please help!* Ask for a link to the build log "
"and for which project is affected."
msgstr ""
#: ../../contribute.rst:157
msgid "… is a valid feature proposal"
msgstr ""
#: ../../contribute.rst:147
msgid ""
"If the ticket contains a feature that aligns with the goals of Read the "
"Docs, then add the label **Feature**. If the proposal seems valid but "
"requires further discussion between core contributors because there might be"
" different possibilities on how to implement the feature, then also add the "
"label **Needed: design decision**."
msgstr ""
#: ../../contribute.rst:155
msgid "*Provide better integration with service XYZ*"
msgstr ""
#: ../../contribute.rst:156
msgid ""
"*Achieve world domination* (also needs the label **Needed: design "
"decision**)"
msgstr ""
#: ../../contribute.rst:168
msgid "… is a small change to the source code"
msgstr ""
#: ../../contribute.rst:160
msgid ""
"If the ticket is about code cleanup or small changes to existing features "
"would likely have the **Improvement** label. The distinction for this label "
"is that these issues have a lower priority than a Bug, and aren't "
"implementing new features."
msgstr ""
#: ../../contribute.rst:167
msgid "*Refactor namedtuples to dataclasess*"
msgstr ""
#: ../../contribute.rst:168
msgid "*Change font size for the project's title*"
msgstr ""
#: ../../contribute.rst:176
msgid "… is a valid problem within the code base:"
msgstr ""
#: ../../contribute.rst:171
msgid ""
"If it's a valid bug, then add the label **Bug**. Try to reference related "
"issues if you come across any."
msgstr ""
#: ../../contribute.rst:176
msgid "*Builds fail if conf.py contains non-ascii letters*"
msgstr ""
#: ../../contribute.rst:185
msgid "… is a currently valid problem with the infrastructure:"
msgstr ""
#: ../../contribute.rst:179
msgid ""
"Users might report about web server downtimes or that builds are not "
"triggered. If the ticket needs investigation on the servers, then add the "
"label **Operations**."
msgstr ""
#: ../../contribute.rst:185
msgid "*Builds are not starting*"
msgstr ""
#: ../../contribute.rst:197
msgid "… is a question and needs answering:"
msgstr ""
#: ../../contribute.rst:190
msgid ""
"If the ticket contains a question about the Read the Docs platform or the "
"code, then add the label **Support**."
msgstr ""
#: ../../contribute.rst:195
msgid "*My account was set inactive. Why?*"
msgstr ""
#: ../../contribute.rst:196
msgid "*How to use C modules with Sphinx autodoc?*"
msgstr ""
#: ../../contribute.rst:197
msgid "*Why are my builds failing?*"
msgstr ""
#: ../../contribute.rst:206
msgid "… requires a one-time action on the server:"
msgstr ""
#: ../../contribute.rst:200
msgid ""
"Tasks that require a one time action on the server should be assigned the "
"two labels **Support** and **Operations**."
msgstr ""
#: ../../contribute.rst:205
msgid "*Please change my username*"
msgstr ""
#: ../../contribute.rst:206
msgid "*Please set me as owner of this abandoned project*"
msgstr ""
#: ../../contribute.rst:208
msgid ""
"After we finished the initial triaging of new tickets, no ticket should be "
"left without a label."
msgstr ""
#: ../../contribute.rst:214
msgid "Additional labels for categorization"
msgstr ""
#: ../../contribute.rst:216
msgid ""
"Additionally to the labels already involved in the section above, we have a "
"few more at hand to further categorize issues."
msgstr ""
#: ../../contribute.rst:221
msgid "*High Priority*"
msgstr ""
#: ../../contribute.rst:220
msgid ""
"If the issue is urgent, assign this label. In the best case also go forward "
"to resolve the ticket yourself as soon as possible."
msgstr ""
#: ../../contribute.rst:226
msgid "*Good First Issue*"
msgstr ""
#: ../../contribute.rst:224
msgid ""
"This label marks tickets that are easy to get started with. The ticket "
"should be ideal for beginners to dive into the code base. Better is if the "
"fix for the issue only involves touching one part of the code."
msgstr ""
#: ../../contribute.rst:230
msgid "*Sprintable*"
msgstr ""
#: ../../contribute.rst:229
msgid ""
"Sprintable are all tickets that have the right amount of scope to be handled"
" during a sprint. They are very focused and encapsulated."
msgstr ""
#: ../../contribute.rst:232
msgid ""
"For a full list of available labels and their meanings, see :doc:`issue-"
"labels`."
msgstr ""
#: ../../contribute.rst:236
msgid "Helpful links for triaging"
msgstr ""
#: ../../contribute.rst:238
msgid "Here is a list of links for contributors that look for work:"
msgstr ""
#: ../../contribute.rst:240
msgid ""
"`Untriaged tickets "
"<https://github.com/rtfd/readthedocs.org/issues?q=is:issue+is:open+no:label>`_:"
" Go and triage them!"
msgstr ""
#: ../../contribute.rst:243
msgid ""
"`Tickets labelled with Needed: more information "
"<https://github.com/rtfd/readthedocs.org/issues?utf8=✓&q=is:open+is:issue+label:\"Needed:+more+information\">`_:"
" Come back to these tickets once in a while and close those that did not get"
" any new information from the reporter. If new information is available, go "
"and re-triage the ticket."
msgstr ""
#: ../../contribute.rst:248
msgid ""
"`Tickets labelled with Operations "
"<https://github.com/rtfd/readthedocs.org/issues?q=is:open+is:issue+label:Operations>`_:"
" These tickets are for contributors who have access to the servers."
msgstr ""
#: ../../contribute.rst:251
msgid ""
"`Tickets labelled with Support "
"<https://github.com/rtfd/readthedocs.org/issues?q=is:open+is:issue+label:Support>`_:"
" Experienced contributors or community members with a broad knowledge about "
"the project should handle those."
msgstr ""
#: ../../contribute.rst:255
msgid ""
"`Tickets labelled with Needed: design decision "
"<https://github.com/rtfd/readthedocs.org/issues?q=is:open+is:issue+label:\"Needed:+design+decision\">`_:"
" Project leaders must take actions on these tickets. Otherwise no other "
"contributor can go forward on them."
msgstr ""
#: ../../contribute.rst:261
msgid "Helping on translations"
msgstr ""
#: ../../contribute.rst:263
msgid "If you wish to contribute translations, please do so on `Transifex`_."
msgstr ""

View File

@ -1,95 +0,0 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2010, Eric Holscher, Charlie Leifer, Bobby Grace
# 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: 2014-01-06 23:58-0500\n"
"PO-Revision-Date: 2014-03-02 12:03+0000\n"
"Last-Translator: Eric Holscher <eric@ericholscher.com>\n"
"Language-Team: Danish (http://www.transifex.com/projects/p/readthedocs-docs/language/da/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: da\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
# 9a4df253f71d409e8ec590353f2f7a15
#: ../../custom_installs/customization.rst:2
msgid "Customizing your install"
msgstr ""
# 1028e197ff5c4ddd98d099e447476731
#: ../../custom_installs/customization.rst:4
msgid ""
"Read the Docs has a lot of :doc:`/settings` that help customize your "
"install. This document will outline some of the more useful ways that these "
"can be combined."
msgstr ""
# 3b8b84b2961b4ab389fea741833ec961
#: ../../custom_installs/customization.rst:8
msgid "Have a local settings file"
msgstr ""
# 07a3499807a74d1394062e1bb4e902d1
#: ../../custom_installs/customization.rst:10
msgid ""
"If you put a file named ``local_settings.py`` in the "
"``readthedocs/settings`` directory, it will override settings available in "
"the base install."
msgstr ""
# d15800590d4447888697341be52ffec7
#: ../../custom_installs/customization.rst:13
msgid "Adding your own title to pages"
msgstr ""
# 3ec2cfd4934348b186b2ac3bba32abae
#: ../../custom_installs/customization.rst:15
msgid ""
"This requires 2 parts of setup. First, you need to add a custom "
":setting:`TEMPLATE_DIRS` setting that points at your template overrides. "
"Then, in those template overrides you have to insert your logo where the "
"normal RTD logo goes."
msgstr ""
# b6e4e25845774f08a86ed5f207b569d2
#: ../../custom_installs/customization.rst:17
msgid "This works for any setting you wish to change."
msgstr ""
# b5bcbc37e82f41c1aa0a7089b72c2123
#: ../../custom_installs/customization.rst:19
msgid "Example ``local_settings.py``::"
msgstr ""
# 47b3e3c7e2ff4a4a838b3a0010ef42a4
#: ../../custom_installs/customization.rst:31
msgid "Example ``base.html`` in your template overrides::"
msgstr ""
# 906c4e450b374a54a656b9dcad27da12
#: ../../custom_installs/customization.rst:38
msgid ""
"You can of course override any block in the template. If there is something "
"that you would like to be able to customize, but isn't currently in a block,"
" please `submit an issue`_."
msgstr ""
# e52de36f1bf24ee6a7fda490b7ec9ad8
#: ../../custom_installs/index.rst:2
msgid "Info about custom installs"
msgstr ""
# 1534817d7caf41288543ecf717ac55f3
#: ../../custom_installs/index.rst:4
msgid ""
"Read the Docs is open source, which means you can run your own version of "
"it. There are many reasons to do this, the main one being if you want a "
"private instance. If you have to keep everything behind a firewall of VPN, "
"this is for you."
msgstr ""

View File

@ -7,10 +7,10 @@ msgid ""
msgstr ""
"Project-Id-Version: readthedocs-docs\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2014-03-01 22:07+0800\n"
"POT-Creation-Date: 2014-03-26 11:17+0100\n"
"PO-Revision-Date: 2014-03-02 12:03+0000\n"
"Last-Translator: Eric Holscher <eric@ericholscher.com>\n"
"Language-Team: Danish (http://www.transifex.com/projects/p/readthedocs-docs/language/da/)\n"
"Language-Team: Danish (http://www.transifex.com/readthedocs/readthedocs-docs/language/da/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

View File

@ -7,10 +7,10 @@ msgid ""
msgstr ""
"Project-Id-Version: readthedocs-docs\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2014-03-01 22:07+0800\n"
"POT-Creation-Date: 2014-03-26 11:17+0100\n"
"PO-Revision-Date: 2014-03-02 12:03+0000\n"
"Last-Translator: Eric Holscher <eric@ericholscher.com>\n"
"Language-Team: Danish (http://www.transifex.com/projects/p/readthedocs-docs/language/da/)\n"
"Language-Team: Danish (http://www.transifex.com/readthedocs/readthedocs-docs/language/da/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

Binary file not shown.

View File

@ -1,29 +1,27 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2010, Eric Holscher, Charlie Leifer, Bobby Grace
# This file is distributed under the same license as the Read The Docs package.
#
# 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: 2014-03-01 22:07+0800\n"
"PO-Revision-Date: 2014-03-02 12:03+0000\n"
"Last-Translator: Eric Holscher <eric@ericholscher.com>\n"
"Language-Team: Danish (http://www.transifex.com/projects/p/readthedocs-docs/language/da/)\n"
"POT-Creation-Date: 2018-09-17 19:05-0500\n"
"PO-Revision-Date: 2018-09-18 00:30+0000\n"
"Last-Translator: Anthony <aj@ohess.org>\n"
"Language-Team: Danish (http://www.transifex.com/readthedocs/readthedocs-docs/language/da/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: da\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
# 0ffcac912c414ce2bc4fe1e4721eafc1
#: ../../design.rst:4
#: ../../design.rst:2
msgid "Designing Read the Docs"
msgstr ""
# 24693487558e4666842f76560407c7e8
#: ../../design.rst:6
#: ../../design.rst:4
msgid ""
"So you're thinking of contributing some of your time and design skills to "
"Read the Docs? That's **awesome**. This document will lead you through a few"
@ -31,106 +29,76 @@ msgid ""
"and static assets."
msgstr ""
# c0eacde6575f4e32b75799f2216ecebb
#: ../../design.rst:12
#: ../../design.rst:10
msgid ""
"To start, you should follow the :ref:`installing-read-the-docs` instructions"
" to get a working copy of the Read the Docs repository locally."
"To start, you should follow the :doc:`install` instructions to get a working"
" copy of the Read the Docs repository locally."
msgstr ""
# 4a01bc3189a94716b109c05424af62cd
#: ../../design.rst:16
#: ../../design.rst:14
msgid "Style Catalog"
msgstr ""
# 583b7c2817c84b7193b821de7a354dde
#: ../../design.rst:18
#: ../../design.rst:16
msgid ""
"Once you have RTD running locally, you can open ``http://localhost:8000"
"/style-catalog/`` for a quick overview of the currently available styles."
msgstr ""
# ab68a885f37949cab7d68d251ed1308d
#: ../../design.rst:23
#: ../../design.rst:21
msgid ""
"This way you can quickly get started writing HTML -- or if you're modifying "
"existing styles you can get a quick idea of how things will change site-"
"wide."
msgstr ""
# b0e18fc0c95f47f7a52aff5e43d8ba7f
#: ../../design.rst:28
msgid "Typekit Fonts"
msgstr ""
# fb5a0659e36940d1944a10f3b849dea2
#: ../../design.rst:30
msgid "RTD uses `FF Meta`_ via TypeKit to render most display and body text."
msgstr ""
# 82eb19c46e734002a7202ba7d8b445f8
#: ../../design.rst:32
msgid ""
"To make this work locally, you can register a free TypeKit account and "
"create a site profile for ``localhost:8000`` that includes the linked font."
msgstr ""
# f9ffd461090940d798080d1c54ce8e2d
#: ../../design.rst:38
#: ../../design.rst:26
msgid "Readthedocs.org Changes"
msgstr ""
# e71a8aa519954ee6b9a4be6a4edaa0be
#: ../../design.rst:40
#: ../../design.rst:28
msgid ""
"Styles for the primary RTD site are located in ``media/css`` directory."
msgstr ""
# f94fbab0da9c4dd4a1d0b7e52e5938e0
#: ../../design.rst:42
#: ../../design.rst:30
msgid ""
"These styles only affect the primary site -- **not** any of the generated "
"documentation using the default RTD style."
msgstr ""
# 39338eb3f0a04dcc938b91bf5f8b006d
#: ../../design.rst:46
#: ../../design.rst:34
msgid "Sphinx Template Changes"
msgstr ""
# fd8bb839bc564ef9a39eb8c86e7b2404
#: ../../design.rst:48
#: ../../design.rst:36
msgid ""
"Styles for generated documentation are located in "
"``readthedocs/templates/sphinx/_static/rtd.css``"
msgstr ""
# f8c030db016e4822a0a5197e5f8b1ebf
#: ../../design.rst:50
#: ../../design.rst:38
msgid ""
"Of note, projects will retain the version of that file they were last built "
"with -- so if you're editing that file and not seeing any changes to your "
"local built documentation, you need to rebuild your example project."
msgstr ""
# 800d704d06b54780886a9f1ec58f501c
#: ../../design.rst:55
#: ../../design.rst:43
msgid "Contributing"
msgstr ""
# fcf521b31a984a448d32a736fc9f18eb
#: ../../design.rst:57
#: ../../design.rst:45
msgid ""
"Contributions should follow the :ref:`contributing-to-read-the-docs` "
"guidelines where applicable -- ideally you'll create a pull request against "
"the `Read the Docs GitHub project`_ from your forked repo and include a "
"brief description of what you added / removed / changed, as well as an "
"attached image (you can just take a screenshot and drop it into the PR "
"creation form) of the effects of your changes."
"Contributions should follow the :doc:`contribute` guidelines where "
"applicable -- ideally you'll create a pull request against the `Read the "
"Docs GitHub project`_ from your forked repo and include a brief description "
"of what you added / removed / changed, as well as an attached image (you can"
" just take a screenshot and drop it into the PR creation form) of the "
"effects of your changes."
msgstr ""
# f656ef71dbc64bb8b2c08affac715625
#: ../../design.rst:62
#: ../../design.rst:50
msgid ""
"There's not a hard browser range, but your design changes should work "
"reasonably well across all major browsers, IE8+ -- that's not to say it "

View File

@ -1,52 +0,0 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2010, Eric Holscher, Charlie Leifer, Bobby Grace
# 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: 2014-03-01 17:22+0800\n"
"PO-Revision-Date: 2014-03-02 12:03+0000\n"
"Last-Translator: Eric Holscher <eric@ericholscher.com>\n"
"Language-Team: Danish (http://www.transifex.com/projects/p/readthedocs-docs/language/da/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: da\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
# 122b79afbc2c40909128350187929008
#: ../../design_decisions.rst:2
msgid "Design Decisions"
msgstr ""
# 11926498eff04dc1b97f1cec03dfaaad
#: ../../design_decisions.rst:4
msgid ""
"Read the Docs does some things because we believe they are the proper way. "
"This page will outline some of the philsophy behind the design of the site."
msgstr ""
# 1ed36402a40e44fc94e00ee9b154a26f
#: ../../design_decisions.rst:8
msgid "You must have a repository"
msgstr ""
# f1783334983d426ba9f9954e63427142
#: ../../design_decisions.rst:10
msgid ""
"There is a lot of documentation out in the world, and you can't reproduce "
"it, or download the code around it. Read the Docs is designed around "
"everything having a repository. It's how much of our functionality is "
"implemented, and allows us more power in our interface."
msgstr ""
# c872d5c1056a44a296d60de91dcc4ac1
#: ../../design_decisions.rst:17
msgid ""
"This means that you can't upload static HTML to our site. We believe that "
"forcing you to put your docs into a repository is better for you, and for "
"your users."
msgstr ""

Binary file not shown.

View File

@ -0,0 +1,85 @@
# 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.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Read the Docs 1.0\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2018-09-17 19:05-0500\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Language-Team: Danish (https://www.transifex.com/readthedocs/teams/2534/da/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: da\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
#: ../../docs.rst:2
msgid "Building and Contributing to Documentation"
msgstr ""
#: ../../docs.rst:4
msgid ""
"As one might expect, the documentation for Read the Docs is built using "
"Sphinx and hosted on Read the Docs. The docs are kept in the ``docs/`` "
"directory at the top of the source tree."
msgstr ""
#: ../../docs.rst:8
msgid "You can build the docs by installing ``Sphinx`` and running::"
msgstr ""
#: ../../docs.rst:13
msgid ""
"Please follow these guidelines when updating our docs. Let us know if you "
"have any questions or something isn't clear."
msgstr ""
#: ../../docs.rst:17
msgid "The brand"
msgstr ""
#: ../../docs.rst:19
msgid "We are called **Read the Docs**. The *the* is not capitalized."
msgstr ""
#: ../../docs.rst:22
msgid "We do however use the acronym **RTD**."
msgstr ""
#: ../../docs.rst:25
msgid "Titles"
msgstr ""
#: ../../docs.rst:27
msgid ""
"For page titles, or Heading1 as they are sometimes called, we use title-"
"case."
msgstr ""
#: ../../docs.rst:29
msgid ""
"If the page includes multiple sub-headings (H2, H3), we usually use "
"sentence-case unless the titles include terminology that is supposed to be "
"capitalized."
msgstr ""
#: ../../docs.rst:33
msgid "Content"
msgstr ""
#: ../../docs.rst:35
msgid ""
"Do not break the content across multiple lines at 80 characters, but rather "
"break them on semantic meaning (e.g. periods or commas). Read more about "
"this `here <http://rhodesmill.org/brandon/2012/one-sentence-per-line/>`_."
msgstr ""
#: ../../docs.rst:38
msgid ""
"If you are cross-referencing to a different page within our website, use the"
" ``doc`` directive and not a hyperlink."
msgstr ""

Binary file not shown.

View File

@ -0,0 +1,128 @@
# 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.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Read the Docs 1.0\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2018-09-17 19:05-0500\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Language-Team: Danish (https://www.transifex.com/readthedocs/teams/2534/da/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: da\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
#: ../../embed.rst:2
msgid "Embed API"
msgstr ""
#: ../../embed.rst:4
msgid ""
"Read the Docs allow you to embed content from any of the projects we host. "
"This allows for content re-use across sites, making sure the content is "
"always up to date."
msgstr ""
#: ../../embed.rst:9
msgid "Workflow"
msgstr ""
#: ../../embed.rst:11
msgid ""
"There are many uses of our Embed API. One of our favorites is for inline "
"help. We have started using this on Read the Docs itself to provide inline "
"help on our main site pages. This allows us to keep the official "
"documentation as the single source of truth, while having great inline help "
"in our application as well."
msgstr ""
#: ../../embed.rst:17
msgid ""
"We recommend you point at **tagged releases** instead of ``latest``. Tags "
"don't change over time, so you don't have to worry about the content you are"
" embedding disappearing."
msgstr ""
#: ../../embed.rst:21
msgid ""
"All relative links to pages contained in the remote content will continue to"
" point at the remote page."
msgstr ""
#: ../../embed.rst:24
msgid "How to use it"
msgstr ""
#: ../../embed.rst:28
msgid "Sphinx Extension"
msgstr ""
#: ../../embed.rst:30
msgid ""
"You can embed content directly in Sphinx with builds on Read the Docs. We "
"support default configuration variables for your ``conf.py``:"
msgstr ""
#: ../../embed.rst:33
msgid "readthedocs_embed_project"
msgstr ""
#: ../../embed.rst:34
msgid "readthedocs_embed_version"
msgstr ""
#: ../../embed.rst:35
msgid "readthedocs_embed_doc"
msgstr ""
#: ../../embed.rst:37
msgid ""
"These are overridable per-call as well. Then you simply use the directive:"
msgstr ""
#: ../../embed.rst:56
msgid "Javascript"
msgstr ""
#: ../../embed.rst:58
msgid ""
"We provide a Javascript library that you can embed on any site. An example:"
msgstr ""
#: ../../embed.rst:80
msgid ""
"This will provide a pop-out for a user with the ``How we envision versions "
"working`` section of the ``versions`` page. You can see this in action here:"
msgstr ""
#: ../../embed.rst:103
msgid ""
"All Read the Docs pages already have the library loaded, so you can ignore "
"the ``link`` and first ``script`` tags on all documentation."
msgstr ""
#: ../../embed.rst:107
msgid ""
"We currently do not provide caching on this API. If the remote source you "
"are including changes their page structure or deletes the content, your "
"embed will break."
msgstr ""
#: ../../embed.rst:111
msgid ""
"In Version 2 of this API we will provide a full-formed workflow that will "
"stop this from happening."
msgstr ""
#: ../../embed.rst:116
msgid "Example API Response"
msgstr ""
#: ../../embed.rst:118
msgid "Pure API use will return JSON:"
msgstr ""

Binary file not shown.

View File

@ -1,33 +1,30 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2010, Eric Holscher, Charlie Leifer, Bobby Grace
# This file is distributed under the same license as the Read The Docs package.
# 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: 2014-03-01 22:07+0800\n"
"PO-Revision-Date: 2014-03-02 12:03+0000\n"
"Last-Translator: Eric Holscher <eric@ericholscher.com>\n"
"Language-Team: Danish (http://www.transifex.com/projects/p/readthedocs-docs/language/da/)\n"
"POT-Creation-Date: 2018-09-17 19:05-0500\n"
"PO-Revision-Date: 2018-09-18 00:15+0000\n"
"Last-Translator: Anthony <aj@ohess.org>\n"
"Language-Team: Danish (http://www.transifex.com/readthedocs/readthedocs-docs/language/da/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: da\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
# 2a3b2282fad24d1e89155c9a37d8487c
#: ../../faq.rst:2
msgid "Frequently Asked Questions"
msgstr ""
# 44318c4f248c47ab831084157f6d3b57
#: ../../faq.rst:5
msgid "My project isn't building with autodoc"
msgstr ""
# bd98f5e3986e45da9ade4b1bc579b529
#: ../../faq.rst:7
msgid ""
"First, you should check out the Builds tab of your project. That records all"
@ -38,46 +35,89 @@ msgid ""
"``requirements.txt`` file for your project."
msgstr ""
# 95178481e2734d148fcd4dc77cf6a021
#: ../../faq.rst:9
msgid ""
"If you are still seeing errors because of C library dependencies, please see"
" the below section about that."
" :ref:`faq:I get import errors on libraries that depend on C modules`."
msgstr ""
# 2fb799d0662c4ab9b3545099e95f7db8
#: ../../faq.rst:12
#: ../../faq.rst:13
msgid "How do I change my slug (the URL your docs are served at)?"
msgstr ""
#: ../../faq.rst:15
msgid ""
"We don't support allowing folks to change the slug for their project. You "
"can update the name which is shown on the site, but not the actual URL that "
"documentation is served."
msgstr ""
#: ../../faq.rst:19
msgid ""
"The main reason for this is that all existing URLs to the content will "
"break. You can delete and re-create the project with the proper name to get "
"a new slug, but you really shouldn't do this if you have existing inbound "
"links, as it `breaks the internet "
"<http://www.w3.org/Provider/Style/URI.html>`_."
msgstr ""
#: ../../faq.rst:25
msgid "Help, my build passed but my documentation page is 404 Not Found!"
msgstr ""
#: ../../faq.rst:27
msgid ""
"This often happens because you don't have an `index.html` file being "
"generated. Make sure you have one of the following files:"
msgstr ""
#: ../../faq.rst:30
msgid "`index.rst`"
msgstr ""
#: ../../faq.rst:31
msgid "`index.md`"
msgstr ""
#: ../../faq.rst:33
msgid ""
"At the top level of your built documentation, otherwise we aren't able to "
"serve a \"default\" index page."
msgstr ""
#: ../../faq.rst:36
msgid ""
"To test if your docs actually built correctly, you can navigate to a "
"specific page (`/en/latest/README.html` for example)."
msgstr ""
#: ../../faq.rst:40
msgid "How do I change behavior for Read the Docs?"
msgstr ""
# 11be3f8c3eca4c0194ef1ca62ad65e2f
#: ../../faq.rst:14
#: ../../faq.rst:42
msgid ""
"When RTD builds your project, it sets the `READTHEDOCS` environment variable"
" to the string `True`. So within your Sphinx's conf.py file, you can vary "
"the behavior based on this. For example::"
"When RTD builds your project, it sets the :envvar:`READTHEDOCS` environment "
"variable to the string `True`. So within your Sphinx :file:`conf.py` file, "
"you can vary the behavior based on this. For example::"
msgstr ""
# 65d24a187b024e92b0c5998e70915a46
#: ../../faq.rst:23
#: ../../faq.rst:53
msgid ""
"The ``READTHEDOCS`` variable is also available in the Sphinx build "
"The :envvar:`READTHEDOCS` variable is also available in the Sphinx build "
"environment, and will be set to ``True`` when building on RTD::"
msgstr ""
# abcaeab5d70e4498b27c8d3390f456ca
#: ../../faq.rst:30
#: ../../faq.rst:61
msgid "I get import errors on libraries that depend on C modules"
msgstr ""
# b454a215d37e45f6a43075ce0b1a6fec
#: ../../faq.rst:33
#: ../../faq.rst:64
msgid ""
"Another use case for this is when you have a module with a C extension."
msgstr ""
# 2f93987066bf4704a78dc0bb76c2a155
#: ../../faq.rst:35
#: ../../faq.rst:66
msgid ""
"This happens because our build system doesn't have the dependencies for "
"building your project. This happens with things like libevent and mysql, and"
@ -86,94 +126,102 @@ msgid ""
"imports."
msgstr ""
# ce958ef256c6444ab27de54278e3ae05
#: ../../faq.rst:37
#: ../../faq.rst:68
msgid ""
"You can mock out the imports for these modules in your conf.py with the "
"You can mock out the imports for these modules in your ``conf.py`` with the "
"following snippet::"
msgstr ""
# a733b4a080ff42478554b619e6b924af
#: ../../faq.rst:66
#: ../../faq.rst:81
msgid ""
"Of course, replacing `MOCK_MODULES` with the modules that you want to mock "
"out."
msgstr ""
# 577026ceae464f3ca28d11e500882902
#: ../../faq.rst:69
msgid "Can I make search engines only see one version of my docs?"
msgstr ""
# b612a3b48dab48feb869027f4bbd3713
#: ../../faq.rst:71
#: ../../faq.rst:83
msgid ""
"You can do this for Google at least with a canonical link tag. It should "
"look like:"
"The library ``unittest.mock`` was introduced on python 3.3. On earlier "
"versions install the ``mock`` library from PyPI with (ie ``pip install "
"mock``) and replace the above import::"
msgstr ""
# a66c3c5951214caaba793f4e94b9e55e
#: ../../faq.rst:89
#: ../../faq.rst:88
msgid ""
"If such libraries are installed via ``setup.py``, you also will need to "
"remove all the C-dependent libraries from your ``install_requires`` in the "
"RTD environment."
msgstr ""
#: ../../faq.rst:91
msgid "`Client Error 401` when building documentation"
msgstr ""
#: ../../faq.rst:93
msgid ""
"If you did not install the `test_data` fixture during the installation "
"instructions, you will get the following error::"
msgstr ""
#: ../../faq.rst:98
msgid ""
"This is because the API admin user does not exist, and so cannot "
"authenticate. You can fix this by loading the test_data::"
msgstr ""
#: ../../faq.rst:103
msgid ""
"If you'd prefer not to install the test data, you'll need to provide a "
"database account for the builder to use. You can provide these credentials "
"by editing the following settings::"
msgstr ""
#: ../../faq.rst:111
msgid "Deleting a stale or broken build environment"
msgstr ""
# 0f63c2199db9498f9259644e65f5897a
#: ../../faq.rst:91
#: ../../faq.rst:113
msgid "See :doc:`guides/wipe-environment`."
msgstr ""
#: ../../faq.rst:116
msgid "How do I host multiple projects on one custom domain?"
msgstr ""
#: ../../faq.rst:118
msgid ""
"RTD doesn't expose this in the UI, but it is possible to remove the build "
"directory of your project. If you want to remove a build environment for "
"your project, hit "
"http://readthedocs.org/wipe/<project_slug>/<version_slug>/. You must be "
"logged in to do this."
"We support the concept of subprojects, which allows multiple projects to "
"share a single domain. If you add a subproject to a project, that "
"documentation will be served under the parent project's subdomain or custom "
"domain."
msgstr ""
# d64a9c4e59814eb9b8e671440796e6d7
#: ../../faq.rst:95
msgid "How do I host multiple projects on one CNAME?"
msgstr ""
# d248fd083ffe4642b55b56fdef5d1cd4
#: ../../faq.rst:97
#: ../../faq.rst:122
msgid ""
"We support the concept of Subprojects. If you add a subproject to a project,"
" that documentation will also be served under the parent project's "
"subdomain."
"For example, Kombu is a subproject of Celery, so you can access it on the "
"`celery.readthedocs.io` domain:"
msgstr ""
# bd599bb09c1f4a3c8b2c13e0cf61a9d1
#: ../../faq.rst:101
msgid ""
"For example, Kombu is a subproject of celery, so you can access it on the "
"`celery.readthedocs.org` domain:"
#: ../../faq.rst:126
msgid "http://celery.readthedocs.io/projects/kombu/en/latest/"
msgstr ""
# 798b68b0b4964f8993835a9c9c3318d8
#: ../../faq.rst:105
msgid "http://celery.readthedocs.org/projects/kombu/en/latest/"
#: ../../faq.rst:128
msgid "This also works the same for custom domains:"
msgstr ""
# e842bf158d814b5094cfd9191af141c3
#: ../../faq.rst:107
msgid "This also works the same for CNAME's:"
msgstr ""
# 3653f579d02043da91b0c097e9ee32c3
#: ../../faq.rst:109
#: ../../faq.rst:130
msgid "http://docs.celeryproject.org/projects/kombu/en/latest/"
msgstr ""
# ae4065bff5c9449d9852823d078dd378
#: ../../faq.rst:111
msgid "You can add subprojects in the Admin section for your project."
#: ../../faq.rst:132
msgid "You can add subprojects in the project admin dashboard."
msgstr ""
# 91f3de17f1414d959d75196f1f9ebd06
#: ../../faq.rst:114
#: ../../faq.rst:135
msgid "Where do I need to put my docs for RTD to find it?"
msgstr ""
# 12effb20a28b434db1cfddca96d30ab8
#: ../../faq.rst:116
#: ../../faq.rst:137
msgid ""
"Read the Docs will crawl your project looking for a ``conf.py``. Where it "
"finds the ``conf.py``, it will run ``sphinx-build`` in that directory. So as"
@ -181,13 +229,11 @@ msgid ""
"should Just Work."
msgstr ""
# 72ac1e9f05b74498b8c86dfbdbf25af5
#: ../../faq.rst:119
#: ../../faq.rst:140
msgid "I want to use the Blue/Default Sphinx theme"
msgstr ""
# 71783724ecf641da94f7b36a2b72dad8
#: ../../faq.rst:121
#: ../../faq.rst:142
msgid ""
"We think that our theme is badass, and better than the default for many "
"reasons. Some people don't like change though :), so there is a hack that "
@ -197,104 +243,116 @@ msgid ""
"default behavior."
msgstr ""
# 1bc3b0bcc73d4d3db21bd309263afaef
#: ../../faq.rst:124
#: ../../faq.rst:145
msgid "I want to use the Read the Docs theme locally"
msgstr ""
# c9c9534f9057495e9b84bd9991f8f9d4
#: ../../faq.rst:126
#: ../../faq.rst:147
msgid ""
"There is a repository for that: https://github.com/snide/sphinx_rtd_theme. "
"Simply follow the instructions in the README."
msgstr ""
# b9cfdb74740d44c28e7675a886ccab84
#: ../../faq.rst:130
#: ../../faq.rst:151
msgid "Image scaling doesn't work in my documentation"
msgstr ""
# 9bbab6dab3774a7dbde3de632daf3232
#: ../../faq.rst:132
#: ../../faq.rst:153
msgid ""
"Image scaling in docutils depends on PIL. PIL is installed in the system "
"that RTD runs on. However, if you are using the virtualenv building option, "
"you will likely need to include PIL in your requirements for your project."
msgstr ""
# 56e972973d2c4f548e0adbe0284fd5df
#: ../../faq.rst:135
#: ../../faq.rst:156
msgid "I want comments in my docs"
msgstr ""
# e14cec1a7c764cdc82180c2840350dc8
#: ../../faq.rst:137
#: ../../faq.rst:158
msgid ""
"RTD doesn't have explicit support for this. That said, a tool like `Disqus`_"
" can be used for this purpose on RTD."
" (and the `sphinxcontrib-disqus`_ plugin) can be used for this purpose on "
"RTD."
msgstr ""
# 0a1614a9a4224e46984c18a39680fd06
#: ../../faq.rst:142
#: ../../faq.rst:164
msgid "How do I support multiple languages of documentation?"
msgstr ""
# 3d40651d2a2a428aa72c66d5420262f1
#: ../../faq.rst:144
msgid ""
"This is something that has been long planned. In fact, we have a language "
"string in the URLs! However, it isn't currently modeled and supported in the"
" code base. However, you can specify the conf.py file to use for a specific "
"version of the documentation. So, you can create a project for each language"
" of documentation, and do it that way. You can then CNAME different domains "
"on your docs to them. Requests does something like this with it's "
"translations:"
#: ../../faq.rst:166
msgid "See the section on :doc:`localization`."
msgstr ""
# 83d2b015bcb647bfac218cf2a799d228
#: ../../faq.rst:146
msgid "http://ja.python-requests.org/en/latest/index.html"
msgstr ""
# e72fdc0a57ab41028adb707d187ea8d7
#: ../../faq.rst:147
msgid "http://docs.python-requests.org/en/latest/index.html"
msgstr ""
# 54db48682b794438b6915196d208a3f3
#: ../../faq.rst:150
msgid "Do I need to be whitelisted?"
msgstr ""
# 1c44b08c08084b04840cb43f5a93e19d
#: ../../faq.rst:152
msgid ""
"No. Whitelisting has been removed as a concept in Read the Docs. You should "
"have access to all of the features already."
msgstr ""
# eb19fbd4f3fd439998bc3a0fe469ff71
#: ../../faq.rst:155
#: ../../faq.rst:169
msgid "Does Read The Docs work well with \"legible\" docstrings?"
msgstr ""
# a0d11a2c026c40beb882897d098cb1ed
#: ../../faq.rst:157
#: ../../faq.rst:171
msgid ""
"Yes. One criticism of Sphinx is that its annotated docstrings are too dense "
"and difficult for humans to read. In response, many projects have adopted "
"customized docstring styles that are simultaneously informative and legible."
" The `NumPy "
"<https://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMENT.rst.txt>`_ "
"and `Google <http://google-"
"styleguide.googlecode.com/svn/trunk/pyguide.html?showone=Comments#Comments>`_"
"and `Google "
"<https://google.github.io/styleguide/pyguide.html?showone=Comments#Comments>`_"
" styles are two popular docstring formats. Fortunately, the default Read "
"The Docs theme handles both formats just fine, provided your ``conf.py`` "
"specifies an appropriate Sphinx extension that knows how to convert your "
"customized docstrings. Two such extensions are `numpydoc "
"<https://github.com/numpy/numpydoc>`_ and `napoleon <http://sphinxcontrib-"
"napoleon.readthedocs.org>`_. Only ``napoleon`` is able to handle both "
"napoleon.readthedocs.io>`_. Only ``napoleon`` is able to handle both "
"docstring formats. Its default output more closely matches the format of "
"standard Sphinx annotations, and as a result, it tends to look a bit better "
"with the default theme."
msgstr ""
#: ../../faq.rst:189
msgid ""
"Can I document a python package that is not at the root of my repository?"
msgstr ""
#: ../../faq.rst:191
msgid ""
"Yes. The most convenient way to access a python package for example via "
"`Sphinx's autoapi`_ in your documentation is to use the *Install your "
"project inside a virtualenv using setup.py install* option in the admin "
"panel of your project. However this assumes that your ``setup.py`` is in the"
" root of your repository."
msgstr ""
#: ../../faq.rst:197
msgid ""
"If you want to place your package in a different directory or have multiple "
"python packages in the same project, then create a pip requirements file. "
"You can specify the relative path to your package inside the file. For "
"example you want to keep your python package in the ``src/python`` "
"directory, then create a ``requirements.readthedocs.txt`` file with the "
"following contents::"
msgstr ""
#: ../../faq.rst:206
msgid ""
"Please note that the path must be relative to the file. So the example path "
"above would work if the file is in the root of your repository. If you want "
"to put the requirements in a file called ``requirements/readthedocs.txt``, "
"the contents would look like::"
msgstr ""
#: ../../faq.rst:213
msgid ""
"After adding the file to your repository, go to the *Advanced Settings* in "
"your project's admin panel and add the name of the file to the *Requirements"
" file* field."
msgstr ""
#: ../../faq.rst:221
msgid "What commit of Read the Docs is in production?"
msgstr ""
#: ../../faq.rst:223
msgid ""
"We deploy readthedocs.org from the `rel` branch in our GitHub repository. "
"You can see the latest commits that have been deployed by looking on GitHub:"
" https://github.com/rtfd/readthedocs.org/commits/rel"
msgstr ""

View File

@ -1,28 +1,26 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2010, Eric Holscher, Charlie Leifer, Bobby Grace
# This file is distributed under the same license as the Read The Docs package.
#
# 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: 2014-03-01 22:07+0800\n"
"PO-Revision-Date: 2014-03-02 12:03+0000\n"
"Last-Translator: Eric Holscher <eric@ericholscher.com>\n"
"Language-Team: Danish (http://www.transifex.com/projects/p/readthedocs-docs/language/da/)\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: Danish (http://www.transifex.com/readthedocs/readthedocs-docs/language/da/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: da\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
# ea2788f2c274418da66b4bd2658ba732
#: ../../features.rst:2
msgid "Read the Docs features"
msgstr ""
# fa95000d3a7e4aeba1f97b7d4cfaed2d
#: ../../features.rst:4
msgid ""
"This will serve as a list of all of the features that Read the Docs "
@ -30,12 +28,10 @@ msgid ""
"the docs, others will simply be listed here."
msgstr ""
# b76f9583f25246b88eb15790dbfed33c
#: ../../features.rst:7
msgid "GitHub and Bitbucket Integration"
msgid "GitHub, Bitbucket and GitLab Integration"
msgstr ""
# 8d0f0e8a31304c2e9326610f43e7cd44
#: ../../features.rst:9
msgid ""
"We now support linking by default in the sidebar. It links to the page on "
@ -43,50 +39,54 @@ msgid ""
"requests to contribute to project documentation."
msgstr ""
# bd1c1f0947524265a0952b104a008372
#: ../../features.rst:11
msgid "More information can be found in the :doc:`vcs` page."
msgstr ""
# 40d2a2e8a3d04b38a28fff540fb65326
#: ../../features.rst:14
msgid "Auto-updating"
msgstr ""
# f7ed077a58f44a5781dd12f5b4680429
#: ../../features.rst:16
msgid ""
"The :doc:`webhooks` page talks about the different ways you can ping RTD to "
"let us know your project has been updated. We have official support for "
"GitHub, and anywhere else we have a generic post-commit hook that allows you"
" to POST to a URL to get your documentation built."
"GitHub, Bitbucket and GitLab, and anywhere else we have a generic post-"
"commit hook that allows you to POST to a URL to get your documentation "
"built."
msgstr ""
# 46416dfca7b4485399d73e550023decd
#: ../../features.rst:19
msgid "Internationalization"
msgstr ""
#: ../../features.rst:21
msgid ""
"Read the Docs itself is localized, and we support documentation translated "
"into multiple languages. Read more on the :doc:`localization` and "
":doc:`i18n` pages."
msgstr ""
#: ../../features.rst:24
msgid "Canonical URLs"
msgstr ""
# 796723330dbf4a6b8bfc13b17c56885e
#: ../../features.rst:21
#: ../../features.rst:26
msgid ""
"Canonical URLs give your docs better search performance, by pointing all "
"URLs to one version. This also helps to solve the issues around users "
"landing on outdated versions of documentation."
msgstr ""
# 1e441313658942e18b03e3970482d4ee
#: ../../features.rst:23
#: ../../features.rst:28
msgid "More information can be found in the :doc:`canonical` page."
msgstr ""
# bbb384ca3be948c58fd00161f75c8b1c
#: ../../features.rst:26
#: ../../features.rst:31
msgid "Versions"
msgstr ""
# ce4cb8467bb34ec8b239b36c34121882
#: ../../features.rst:28
#: ../../features.rst:33
msgid ""
"We can build multiple versions of your documentation. Look on the "
"\"Versions\" page of your project's admin (using the nav on the left) to "
@ -98,85 +98,64 @@ msgid ""
"your main project page, e.g., http://my-project.rtfd.org/)."
msgstr ""
# 3e4e295a5bba42c39c907268cecd42e4
#: ../../features.rst:37
#: ../../features.rst:42
msgid "Version Control Support Matrix"
msgstr ""
# d25157bd52c84d7ab5a6a0040c44ffb6
#: ../../features.rst:40
#: ../../features.rst:45
msgid "Git"
msgstr ""
# 9133caa808de46e6aa91799b01a4e9e3
#: ../../features.rst:40
#: ../../features.rst:45
msgid "hg"
msgstr ""
# 5991e6f86e4a4dc79da69c7f2c955809
#: ../../features.rst:40
#: ../../features.rst:45
msgid "bzr"
msgstr ""
# 4a877581815341d4b5b26298ff8c8d54
#: ../../features.rst:40
#: ../../features.rst:45
msgid "svn"
msgstr ""
# 175e2a9e66c1404b9dc3edcc16ea8732
#: ../../features.rst:42
#: ../../features.rst:47
msgid "Tags"
msgstr ""
# 4f77eef4bc3e4dea81c866fff711c653
# 58b2d0bb48ab46ad82f3975e94a99d47
# b760e5d9b26d44028b6bef8bd4d4b5ef
# 9476f81ec835497e9ca808a100be950e
# 6d3217ad88ab4f53a20114d0fb150cad
#: ../../features.rst:42 ../../features.rst:42 ../../features.rst:44
#: ../../features.rst:44 ../../features.rst:44
#: ../../features.rst:47 ../../features.rst:47 ../../features.rst:47
#: ../../features.rst:49 ../../features.rst:49 ../../features.rst:49
msgid "Yes"
msgstr ""
# 6d0a7a7e0dcb4c4c816b6e241501ed46
# 6420be08599d4094b3a5ce543468036e
# c868fda3d10b4a539f224511e4a2c1ca
#: ../../features.rst:42 ../../features.rst:42 ../../features.rst:44
#: ../../features.rst:47 ../../features.rst:49
msgid "No"
msgstr ""
# 5a9758d266554fe28dc92a13f411b6ba
#: ../../features.rst:44
#: ../../features.rst:49
msgid "Branches"
msgstr ""
# 6c26f8a332e24cbabccd65a480f8ff3e
#: ../../features.rst:46
#: ../../features.rst:51
msgid "Default"
msgstr ""
# ce3701f32dcf4b4eb72e5daba9fff9d1
#: ../../features.rst:46
#: ../../features.rst:51
msgid "master"
msgstr ""
# d310a893c5e045fd973efb8f06ab55ef
#: ../../features.rst:46
#: ../../features.rst:51
msgid "default"
msgstr ""
# 5ba221f7ef324d37a7be945c57adb50a
#: ../../features.rst:46
#: ../../features.rst:51
msgid "trunk"
msgstr ""
# 8d6b467f648b42a592c0b7a66f61adc1
#: ../../features.rst:51
#: ../../features.rst:56
msgid "PDF Generation"
msgstr ""
# c8ecf8f5af8d4a7cb4ad3de9b2a4c1b4
#: ../../features.rst:53
#: ../../features.rst:58
msgid ""
"When you build your project on RTD, we automatically build a PDF of your "
"project's documentation. We also build them for every version that you "
@ -184,64 +163,24 @@ msgid ""
"your latest stable releases as well."
msgstr ""
# 8cc55875e97e4811937f454795389009
#: ../../features.rst:56
#: ../../features.rst:61
msgid "Search"
msgstr ""
# 5a3007e4b1ad4d1caad021a480d94821
#: ../../features.rst:58
#: ../../features.rst:63
msgid ""
"We provide full-text search across all of the pages of documentation hosted "
"on our site. This uses the excellent Haystack project and Solr as the search"
" backend. We hope to be integrating this into the site more fully in the "
"future."
"on our site. This uses the excellent Haystack project and Elasticsearch as "
"the search backend. We hope to be integrating this into the site more fully "
"in the future."
msgstr ""
# 58097304a87849cc8c87e923f1ffaebe
#: ../../features.rst:61
#: ../../features.rst:66
msgid "Alternate Domains"
msgstr ""
# 77fe0051816a493bb2d9d7d838ed8b04
#: ../../features.rst:63
msgid ""
"We provide support for CNAMEs, subdomains, and a shorturl for your project "
"as well. This is outlined in the :doc:`alternate_domains` section."
msgstr ""
# 55ad533b17b643238f16c68875464b05
#: ../../features.rst:66
msgid "Intersphinx Support"
msgstr ""
# 0116d749b71d4ca1844ba1a54387cd84
#: ../../features.rst:68
msgid ""
"We host intersphinx catalogs for all projects built on Read the Docs. For "
"more info on this support, read the Sphinx docs on :mod:`Intersphinx "
"<sphinx:sphinx.ext.intersphinx>`. Your configuration should look something "
"like this::"
msgstr ""
# 90edfe6a4e4e4e569b205828a94171a9
#: ../../features.rst:76
msgid ""
"Then usage is pretty similar. You reference something using normal sphinx "
"syntax, but can use the namespace of the project you want to reference, like"
" so:"
msgstr ""
# 820f19ba1aa1403e8767907f3f788c48
#: ../../features.rst:83
msgid ""
"This will create a link to the official Sphinx documentation for "
"intersphinx."
msgstr ""
# 87a876e2d00c4cb0ab2e34067af36aee
#: ../../features.rst:85
msgid ""
"More information can be found on Reinout van Rees' blog: "
"http://reinout.vanrees.org/weblog/2012/12/01/django-intersphinx.html"
"We provide support for custom domains, subdomains, and a shorturl for your "
"project as well. This is outlined in the :doc:`alternate_domains` section."
msgstr ""

View File

@ -1,6 +1,6 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2010, Eric Holscher, Charlie Leifer, Bobby Grace
# This file is distributed under the same license as the Read The Docs package.
# Copyright (C) 2010-2018, Read the Docs, Inc & contributors
# This file is distributed under the same license as the Read the Docs package.
#
# Translators:
# henrikbjorn <henrik@bjrnskov.dk>, 2014
@ -8,140 +8,220 @@ msgid ""
msgstr ""
"Project-Id-Version: readthedocs-docs\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2014-03-03 10:59+0800\n"
"PO-Revision-Date: 2014-03-03 09:00+0000\n"
"Last-Translator: henrikbjorn <henrik@bjrnskov.dk>\n"
"Language-Team: Danish (http://www.transifex.com/projects/p/readthedocs-docs/language/da/)\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: Danish (http://www.transifex.com/readthedocs/readthedocs-docs/language/da/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: da\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
# 94680832b91f4929bf53532994faf20f
#: ../../getting_started.rst:2
msgid "Getting Started"
msgstr "Introduktion"
# b5087c8cfa1a46e6973fb1b5f2468531
#: ../../getting_started.rst:4
msgid ""
"This document will show you how to get up and running with Read the Docs."
msgstr "Dette dokument vil vise dig, hvordan man kommer igang med at bruge Read the Docs."
"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 ""
# c736e6dfba4f4bb5ba95bdde2612f4b9
#: ../../getting_started.rst:6
#: ../../getting_started.rst:8
msgid ""
"If you are already using Sphinx_ for your docs, skip ahead to :ref:`import-"
"docs`."
msgstr "Hvis du allerede bruge Sphinx_ til din dokumentation, kan du hoppe videre til :ref:`import-docs`."
"If you are already using Sphinx or Markdown for your docs, skip ahead to "
":ref:`getting_started:Import Your Docs`."
msgstr ""
# 20869ea4ee9544bb889f53f260a381b5
#: ../../getting_started.rst:9
msgid "There is `a screencast`_ that will help you get started if you prefer."
msgstr "Hvis du hellere vil se `en screencast`_ findes der også sådan en."
# e4bbcc8b5b7e419a805d8b4da78c6aa1
#: ../../getting_started.rst:12
msgid "Write Your Docs"
msgstr "Skriv din dokumentation"
# b90f238da5684b6889e1a7360d8a08d5
#: ../../getting_started.rst:14
msgid ""
"Install Sphinx_, and create a directory inside your project to hold your "
"docs::"
msgstr "Installer Sphinx_, og opret en mappe i dit projekt der skal indeholde selve dokumentationen::"
msgid "You have two options for formatting your documentation:"
msgstr ""
# 7890b8eebc8c4d12ad4fa8f24a186171
#: ../../getting_started.rst:19
#: ../../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 "Hvis du hellere vil se `en screencast`_ findes der også sådan en."
#: ../../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 "Kør ``sphinx-quickstart`` i den mappe::"
# 323c1c64fa134111bfff71af91fe3354
#: ../../getting_started.rst:24
#: ../../getting_started.rst:39
msgid ""
"This 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 "
"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 "Den vil tage dig igennem en basal konfiguration. I de fleste tilfælde vil du bare acceptere den standarder. Når det er færdigt, vil du kunne finde ``index.rst``, ``conf.py`` samt nogle andre filer. Du bør tilføje disse til versions styring."
msgstr ""
# 93b667b94bee4cd998979e17c5e23e4e
#: ../../getting_started.rst:28
#: ../../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 "Register ``index.rst`` og tilføj noget information om dit projekt, skriv så mange detaljer som du ønsker (brug reStructuredText_ syntax eller `dette dokument`_ hvis du har brug for hjælp)."
# b6ecd74d973f4945af1d7ac50f220d77
#: ../../getting_started.rst:34
#: ../../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 "Rediger dine filer og byg din dokumentation indtil du er tilfreds. Commit dine ændringer og push dem til dit offentlige repository. Når du har dokumentation fra Sphinx i dit repository kan du begynde at bruge Read the Docs."
# 621a032741654fbe94eeb8ced1fc4df9
#: ../../getting_started.rst:40
#: ../../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 ""
# 88b6a472072944fba715415ccfb21baa
#: ../../getting_started.rst:42
#: ../../getting_started.rst:98
msgid "To import a repository, visit your dashboard_ and click Import_."
msgstr ""
#: ../../getting_started.rst:100
msgid ""
"`Sign up`_ for an account on RTD, then `log in`_. Visit your dashboard_ and "
"click Import_ to add your project to the site. Fill in the name and "
"description, then specify where your repository is located. This is normally"
" the URL or path name you'd use to checkout, clone, or branch your code. "
"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 ""
# 0eaf2d9626dd463d836655dc4ba299b0
#: ../../getting_started.rst:47
#: ../../getting_started.rst:116
msgid "Git: ``http://github.com/ericholscher/django-kong.git``"
msgstr ""
# 24a01bc5b09549b8bfbe0cfd1f4993e4
#: ../../getting_started.rst:48
msgid "Subversion: ``http://varnish-cache.org/svn/trunk``"
msgstr ""
# 665b40223dd64b77bec199e8951e1d59
#: ../../getting_started.rst:49
#: ../../getting_started.rst:117
msgid "Mercurial: ``https://bitbucket.org/ianb/pip``"
msgstr ""
# a8d5721c75a84481b684f80d1cd11271
#: ../../getting_started.rst:50
#: ../../getting_started.rst:118
msgid "Subversion: ``http://varnish-cache.org/svn/trunk``"
msgstr ""
#: ../../getting_started.rst:119
msgid "Bazaar: ``lp:pasta``"
msgstr ""
# c7c217cabab34ccab46cb0dd90c8e007
#: ../../getting_started.rst:52
msgid "Add an optional homepage URL and some tags, then click \"Create\"."
#: ../../getting_started.rst:121
msgid "Add an optional homepage URL and some tags, and then click **Next**."
msgstr ""
# ecf599bf3bbb4eb9bb31f25c3561e35c
#: ../../getting_started.rst:54
#: ../../getting_started.rst:123
msgid ""
"Within a few minutes your code will automatically be fetched from your "
"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 ""
# 35c76658de93497ba8061846dd24b261
#: ../../getting_started.rst:57
#: ../../getting_started.rst:134
msgid ""
"If you want to keep your code updated as you commit, configure your code "
"repository to hit our `Post Commit Hooks`_. This will rebuild your docs "
"every time you push your code."
"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 ""
# 4b77085452fb4a839b693dd522ed6a3f
#: ../../getting_started.rst:59
#: ../../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."

Binary file not shown.

View File

@ -1,169 +1,406 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2010, Eric Holscher, Charlie Leifer, Bobby Grace
# This file is distributed under the same license as the Read The Docs package.
# 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: 2014-03-01 22:07+0800\n"
"PO-Revision-Date: 2014-03-02 12:20+0000\n"
"Last-Translator: Eric Holscher <eric@ericholscher.com>\n"
"Language-Team: Danish (http://www.transifex.com/projects/p/readthedocs-docs/language/da/)\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: Danish (http://www.transifex.com/readthedocs/readthedocs-docs/language/da/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: da\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
# 255065df5bca4ebb9c16b53b76092ccb
#: ../../gsoc.rst:2
msgid "Google Summer of Code"
msgstr ""
# fe3bc8a13fe14b16a93e2fc39ccb6288
#: ../../gsoc.rst:4
msgid ""
"Read the Docs is hoping to participate in the Google Summer of Code in 2014."
" This page will contain all the information for students and anyone else "
"Thanks for your interest in Read the Docs! We are working hard to update the"
" ideas list now that we are accepted in GSOC. Please give us a little while "
"to work on things, and check back on this page for updates."
msgstr ""
#: ../../gsoc.rst:9
msgid ""
"Read the Docs is participating in the Google Summer of Code in 2018. This "
"page will contain all the information for students and anyone else "
"interested in helping."
msgstr ""
# 4732214d1cba4ba69b6852a4134d638c
#: ../../gsoc.rst:8
msgid "Required Skills"
#: ../../gsoc.rst:13
msgid "Skills"
msgstr ""
# 7f5c26e97cf04bb4984331657cc56038
#: ../../gsoc.rst:10
#: ../../gsoc.rst:15
msgid "Incoming students will need the following skills:"
msgstr ""
# 4080221e9e3a4966aa23268b1cfef07a
#: ../../gsoc.rst:12
msgid "Intermediate python programming"
#: ../../gsoc.rst:17
msgid "Intermediate Python & Django programming"
msgstr ""
# e3f88fb4d62945559d47ccb87012f50d
#: ../../gsoc.rst:13
#: ../../gsoc.rst:18
msgid ""
"Familiarity with Markdown, reStructuredText, or some other plain text markup"
" language"
msgstr ""
# 592dc68be26f4f5e9efb0d4e9cc171b2
#: ../../gsoc.rst:14
#: ../../gsoc.rst:19
msgid "Familiarity with git, or some other source control"
msgstr ""
# 787c39c78a674c93a730892d29a895d0
#: ../../gsoc.rst:15
#: ../../gsoc.rst:20
msgid "Ability to set up your own development environment for Read the Docs"
msgstr ""
# ba795aaeea50484a8de54516cbd81a87
#: ../../gsoc.rst:16
msgid ""
"An interest in documentation and improving open source documentation tools "
"would be great too!"
#: ../../gsoc.rst:21
msgid "Basic understanding of web technologies (HTML/CSS/JS)"
msgstr ""
# 007815e895e346228a00569418f63fe6
#: ../../gsoc.rst:18
#: ../../gsoc.rst:22
msgid ""
"An interest in documentation and improving open source documentation tools!"
msgstr ""
#: ../../gsoc.rst:24
msgid ""
"We're happy to help you get up to speed, but the more you are able to "
"demonstrate ability in advance, the more likely we are to choose your "
"application!"
msgstr ""
# 4dd790b769c047719177a2217205c53a
#: ../../gsoc.rst:21
msgid "Getting Started"
msgstr "Introduktion"
# b51dbe1c16834d04ae0ec44a6d1cf95e
#: ../../gsoc.rst:23
msgid ""
"The :doc:`install` doc is probably the best place to get going. It will walk"
" you through getting a basic environment for Read the Docs setup."
#: ../../gsoc.rst:29
msgid "Mentors"
msgstr ""
# 0d3fdd496a5e4f1c8f2b85a8a81c1f0b
#: ../../gsoc.rst:26
msgid ""
"Then you can look through our :doc:`contribute` doc for information on how "
"to get started contributing to RTD. If you try and submit a patch, or at "
"least comment on a bug before applying, you will be much more likely to be "
"accepted."
#: ../../gsoc.rst:31
msgid "Currently we have a few folks signed up:"
msgstr ""
# ce6c0db7981d40f188ab125c88ef42e3
#: ../../gsoc.rst:33
msgid "Want to get involved?"
msgstr ""
# 305fc2bf5b9443b195ae867996498837
#: ../../gsoc.rst:35
msgid ""
"If you're interested in participating in GSoC 2014 as a student, mentor, or "
"interested community member, you should join the `mailing list`_ and post "
"any questions, comments, etc. you may have"
msgstr ""
# 884ccea0bb1e4502bedd53c729d660b4
#: ../../gsoc.rst:37
msgid ""
"In addition you may be able to find us on IRC at ``#readthedocs`` on "
"``irc.freenode.org``. If no one is available to answer your question, "
"please be patient and post it to the mailing list as well."
msgstr ""
# 418df1960ab54b76b01a7f9ff07aab79
#: ../../gsoc.rst:42
msgid "Project Ideas"
msgstr ""
# 2cdb345643e0457683fe59f933c737cb
#: ../../gsoc.rst:44
msgid ""
"We have some medium sized projects sketched out in our issue tracker with "
"the tag *Feature Overview*. Looking through `these issues`_ is a good place "
"to start."
msgstr ""
# 3dcc1b747bd44985b2f00329e25d0a66
#: ../../gsoc.rst:50
msgid "Possible Mentors"
msgstr ""
# 7374dcbf36cc446e95f2ef3202a24b1e
#: ../../gsoc.rst:52
msgid "Eric Holscher"
msgstr ""
# 1fe0f197fca0482cb558c80de51918c6
#: ../../gsoc.rst:34
msgid "Manuel Kaufmann"
msgstr ""
#: ../../gsoc.rst:35
msgid "Anthony Johnson"
msgstr ""
#: ../../gsoc.rst:37
msgid ""
"Please do not reach out directly to anyone about the Summer of Code. It will"
" **not** increase your chances of being accepted!"
msgstr ""
#: ../../gsoc.rst:41
msgid "Getting Started"
msgstr "Introduktion"
#: ../../gsoc.rst:43
msgid ""
"The :doc:`/install` doc is probably the best place to get going. It will "
"walk you through getting a basic environment for Read the Docs setup."
msgstr ""
#: ../../gsoc.rst:46
msgid ""
"Then you can look through our :doc:`/contribute` doc for information on how "
"to get started contributing to RTD."
msgstr ""
#: ../../gsoc.rst:48
msgid ""
"People who have a history of submitting pull requests will be prioritized in"
" our Summer of Code selection process."
msgstr ""
#: ../../gsoc.rst:51
msgid "Want to get involved?"
msgstr ""
#: ../../gsoc.rst:53
msgid "Wraithan McDonald"
msgid ""
"If you're interested in participating in GSoC as a student, you can apply "
"during the normal process provided by Google. We are currently overwhelmed "
"with interest, so we are not able to respond individually to each person who"
" is interested."
msgstr ""
# bea912ff883d4a178b6689aceab9e150
#: ../../gsoc.rst:54
msgid "Justin Abrahams"
#: ../../gsoc.rst:56
msgid "Project Ideas"
msgstr ""
# 488759a14e7d449f87a6924b9dfde9f2
#: ../../gsoc.rst:55
msgid "Jannis Leidel"
msgstr ""
# 8d7b8c43d4fc4a18b5e2a60ada3be2fc
#: ../../gsoc.rst:58
msgid ""
"We have written our some loose ideas for projects to work on here. We are "
"also open to any other ideas that students might have."
msgstr ""
#: ../../gsoc.rst:61
msgid ""
"**These projects are sorted by priority.** We will consider the priority on "
"our roadmap as a factor, along with the skill of the student, in our "
"selection process."
msgstr ""
#: ../../gsoc.rst:67
msgid "Refactor & improve our search code"
msgstr ""
#: ../../gsoc.rst:69
msgid ""
"Currently we're using a homegrown library for Elastic Search. There is a new"
" `elasticsearch-dsl <http://elasticsearch-dsl.readthedocs.io/en/latest/>`_ "
"library that we should be using. This project will include:"
msgstr ""
#: ../../gsoc.rst:73
msgid "Improving our search indexing"
msgstr ""
#: ../../gsoc.rst:74
msgid ""
"Refactoring how we \"model\" our search data to use elasticsearch-dsl Models"
msgstr ""
#: ../../gsoc.rst:75
msgid ""
"Add additional search data into our indexes, like the programming languages,"
" type of document (tutorial, api, etc.) and other data for users to filter "
"by"
msgstr ""
#: ../../gsoc.rst:76
msgid "(Optional) Improve the UX of the search for users in various ways"
msgstr ""
#: ../../gsoc.rst:79
msgid "Finish YAML config"
msgstr ""
#: ../../gsoc.rst:81
msgid ""
"Currently we have a basic :doc:`/yaml-config` for Read the Docs. It's still "
"considered beta, and there are a number of features that it doesn't support."
" We need to support everying users can currently do from our website "
"dashboard inside the YAML file, and then plan a smooth transition path from "
"the database UI to the YAML file."
msgstr ""
#: ../../gsoc.rst:87
msgid ""
"This is a *large* project and will likely require a good deal of "
"understanding of both Python as well as web technologies. We have a "
"`starting list of issues "
"<https://github.com/rtfd/readthedocs.org/milestone/28>`_ put together, but "
"there will be much more work."
msgstr ""
#: ../../gsoc.rst:92
msgid "API V3"
msgstr ""
#: ../../gsoc.rst:94
msgid ""
"We currently have a \"v2\" API that isn't well documented and doesn't allow "
"users to write to it. We want to continue using Django REST Framework for "
"this, but rethink how we're presenting our information to our users."
msgstr ""
#: ../../gsoc.rst:98
msgid ""
"Currently we're showing everything as simple \"models\", and we want to "
"start exposing \"methods\" on our data, similar to GitHub."
msgstr ""
#: ../../gsoc.rst:102
msgid ""
"This is a large project and should only be done by someone who has done some"
" basic API design previously."
msgstr ""
#: ../../gsoc.rst:105
msgid "Improve Translation Workflow"
msgstr ""
#: ../../gsoc.rst:107
msgid ""
"Currently we have our documentation & website translated on Transifex, but "
"we don't have a management process for it. This means that translations will"
" often sit for months before making it back into the site and being "
"available to users."
msgstr ""
#: ../../gsoc.rst:111
msgid ""
"This project would include puting together a workflow for translations:"
msgstr ""
#: ../../gsoc.rst:113
msgid "Communicate with existing translators and see what needs they have"
msgstr ""
#: ../../gsoc.rst:114
msgid ""
"Help formalize the process that we have around Transifex to make it easier "
"to contribute to"
msgstr ""
#: ../../gsoc.rst:115
msgid "Improve our tooling so that integrating new translations is easier"
msgstr ""
#: ../../gsoc.rst:118
msgid "Support for additional build steps for linting & testing"
msgstr ""
#: ../../gsoc.rst:120
msgid ""
"Currently we only build documentation on Read the Docs, but we'd also like "
"to add additional build steps that lets users perform more actions. This "
"would likely take the form of wraping some of the existing `Sphinx builders "
"<http://www.sphinx-doc.org/en/stable/builders.html>`_, and giving folks a "
"nice way to use them inside Read the Docs."
msgstr ""
#: ../../gsoc.rst:125
msgid "It would be great to have wrappers for the following as a start:"
msgstr ""
#: ../../gsoc.rst:127
msgid ""
"Link Check (http://www.sphinx-"
"doc.org/en/stable/builders.html#sphinx.builders.linkcheck.CheckExternalLinksBuilder)"
msgstr ""
#: ../../gsoc.rst:128
msgid "Spell Check (https://pypi.python.org/pypi/sphinxcontrib-spelling/)"
msgstr ""
#: ../../gsoc.rst:129
msgid ""
"Doctest (http://www.sphinx-doc.org/en/stable/ext/doctest.html#module-"
"sphinx.ext.doctest)"
msgstr ""
#: ../../gsoc.rst:130
msgid ""
"Coverage (http://www.sphinx-doc.org/en/stable/ext/coverage.html#module-"
"sphinx.ext.coverage)"
msgstr ""
#: ../../gsoc.rst:132
msgid ""
"The goal would also be to make it quite easy for users to contribute third "
"party build steps for Read the Docs, so that other useful parts of the "
"Sphinx ecosystem could be tightly integrated with Read the Docs."
msgstr ""
#: ../../gsoc.rst:136
msgid "Collections of Projects"
msgstr ""
#: ../../gsoc.rst:138
msgid ""
"This project involves building a user interface for groups of projects in "
"Read the Docs (`Collections`). Users would be allowed to create, publish, "
"and search a `Collection` of projects that they care about. We would also "
"allow for automatic creation of `Collections` based on a project's "
"``setup.py`` or ``requirements.txt``."
msgstr ""
#: ../../gsoc.rst:142
msgid ""
"Once a user has a `Collection`, we would allow them to do a few sets of "
"actions on them:"
msgstr ""
#: ../../gsoc.rst:145
msgid ""
"Search across all the projects in the `Collection` with one search dialog"
msgstr ""
#: ../../gsoc.rst:146
msgid ""
"Download all the project's documentation (PDF, HTMLZip, Epub) for offline "
"viewing"
msgstr ""
#: ../../gsoc.rst:147
msgid ""
"Build a landing page for the collection that lists out all the projects, and"
" could even have a user-editable description, similar to our project listing"
" page."
msgstr ""
#: ../../gsoc.rst:149
msgid ""
"There is likely other ideas that could be done with `Collections` over time."
msgstr ""
#: ../../gsoc.rst:152
msgid "Integrated Redirects"
msgstr ""
#: ../../gsoc.rst:154
msgid ""
"Right now it's hard for users to rename files. We support redirects, but "
"don't create them automatically on file rename, and our redirect code is "
"brittle."
msgstr ""
#: ../../gsoc.rst:159
msgid "We should rebuild how we handle redirects across a number of cases:"
msgstr ""
#: ../../gsoc.rst:161
msgid ""
"Detecting a file change in git/hg/svn and automatically creating a redirect"
msgstr ""
#: ../../gsoc.rst:162
msgid "Support redirecting an entire domain to another place"
msgstr ""
#: ../../gsoc.rst:163
msgid "Support redirecting versions"
msgstr ""
#: ../../gsoc.rst:165
msgid ""
"There will also be a good number of things that spawn from this, including "
"version aliases and other related concepts, if this task doesn't take the "
"whole summer."
msgstr ""
#: ../../gsoc.rst:169
msgid "Additional Ideas"
msgstr ""
#: ../../gsoc.rst:171
msgid ""
"We have some medium sized projects sketched out in our issue tracker with "
"the tag *Feature Overview*. Looking through `these issues`_ is a good place "
"to start. You might also look through our `milestones`_ on GitHub, which "
"provide outlines on the larger tasks that we're hoping to accomplish."
msgstr ""
#: ../../gsoc.rst:180
msgid "Thanks"
msgstr ""
# f4e1659ba7634ce3aa60063c41af7f51
#: ../../gsoc.rst:60
#: ../../gsoc.rst:182
msgid ""
"This page was heavily inspired by Mailman's similar `GSOC page`_. Thanks for"
" the inspiration."

Binary file not shown.

View File

@ -1,38 +1,35 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2010, Eric Holscher, Charlie Leifer, Bobby Grace
# This file is distributed under the same license as the Read The Docs package.
# 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: 2014-03-01 22:07+0800\n"
"PO-Revision-Date: 2014-03-02 12:03+0000\n"
"Last-Translator: Eric Holscher <eric@ericholscher.com>\n"
"Language-Team: Danish (http://www.transifex.com/projects/p/readthedocs-docs/language/da/)\n"
"POT-Creation-Date: 2018-09-17 19:05-0500\n"
"PO-Revision-Date: 2018-09-18 00:15+0000\n"
"Last-Translator: Anthony <aj@ohess.org>\n"
"Language-Team: Danish (http://www.transifex.com/readthedocs/readthedocs-docs/language/da/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: da\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
# c9e43f99eca0449a9e1d5e7263e9e8c5
#: ../../i18n.rst:4
#: ../../i18n.rst:2
msgid "Internationalization"
msgstr ""
# 9149885c7ec74081911f32fb866dfd07
#: ../../i18n.rst:6
#: ../../i18n.rst:5
msgid ""
"This document covers the details regarding internationalization and "
"localization that are applied in Read the Docs. The guidelines described are"
" mostly based on `Kitsune's localization documentation "
"<http://kitsune.readthedocs.org/en/latest/localization.html>`_."
"<http://kitsune.readthedocs.io/en/latest/localization.html>`_."
msgstr ""
# 6a28612fba2f4f9e91fa8e65ce67e7e3
#: ../../i18n.rst:11
#: ../../i18n.rst:10
msgid ""
"As with most of the Django applications out there, Read the Docs' i18n/l10n "
"framework is based on `GNU gettext <http://www.gnu.org/software/gettext/>`_."
@ -40,33 +37,28 @@ msgid ""
"<https://www.transifex.com/projects/p/readthedocs/>`_."
msgstr ""
# 9bcd64ce020e459f83f94d3c2c691ab5
#: ../../i18n.rst:16
#: ../../i18n.rst:15
msgid ""
"For more information about the general ideas, look at this document: "
"http://www.gnu.org/software/gettext/manual/html_node/Concepts.html"
msgstr ""
# d93dc17ab58b43888851721885e2c449
#: ../../i18n.rst:21
#: ../../i18n.rst:20
msgid "Making Strings Localizable"
msgstr ""
# 14939001fe104c75a31910d3a99c28ea
#: ../../i18n.rst:23
#: ../../i18n.rst:22
msgid ""
"Making strings in templates localizable is exceptionally easy. Making "
"strings in Python localizable is a little more complicated. The short "
"answer, though, is to just wrap the string in ``_()``."
msgstr ""
# 4483bdeca8d046fdbbc7c64e9d651370
#: ../../i18n.rst:29
#: ../../i18n.rst:28
msgid "Interpolation"
msgstr ""
# 49fd2e63ba7f493fb0b720ccf22862f4
#: ../../i18n.rst:31
#: ../../i18n.rst:30
msgid ""
"A string is often a combination of a fixed string and something changing, "
"for example, ``Welcome, James`` is a combination of the fixed part "
@ -74,32 +66,27 @@ msgid ""
"localize the first part and then follow it with the name::"
msgstr ""
# ff851feea93e4df6a4d524fd8992aa00
#: ../../i18n.rst:38
#: ../../i18n.rst:37
msgid "This is **wrong!**"
msgstr ""
# 7cd05e8d838649b2b4b1df84eb075f68
#: ../../i18n.rst:40
#: ../../i18n.rst:39
msgid ""
"In some locales, the word order may be different. Use Python string "
"formatting to interpolate the changing part into the string::"
msgstr ""
# bb963519ef6449da8cd038f985d79194
#: ../../i18n.rst:45
#: ../../i18n.rst:44
msgid ""
"Python gives you a lot of ways to interpolate strings. The best way is to "
"use Py3k formatting and kwargs. That's the clearest for localizers."
msgstr ""
# 2876da01b68e4be7a07d73dc4ad573a7
#: ../../i18n.rst:50
#: ../../i18n.rst:49
msgid "Localization Comments"
msgstr ""
# 79cb67a249d14f219aee1194fa5d07fc
#: ../../i18n.rst:52
#: ../../i18n.rst:51
msgid ""
"Sometimes, it can help localizers to describe where a string comes from, "
"particularly if it can be difficult to find in the interface, or is not very"
@ -108,27 +95,22 @@ msgid ""
" added to the PO file, and visible to localizers."
msgstr ""
# f03625ad63704b48b3dcfc4511298654
# baa45a545c4241b7a1eb19878aebe138
#: ../../i18n.rst:58 ../../i18n.rst:92
#: ../../i18n.rst:57 ../../i18n.rst:91
msgid "Example::"
msgstr ""
# 953557557956454fa4638699ee23c068
#: ../../i18n.rst:75
#: ../../i18n.rst:74
msgid "Adding Context with msgctxt"
msgstr ""
# 541af8ebe3ce47ad918625b3d75ceb40
#: ../../i18n.rst:77
#: ../../i18n.rst:76
msgid ""
"Strings may be the same in English, but different in other languages. "
"English, for example, has no grammatical gender, and sometimes the noun and "
"verb forms of a word are identical."
msgstr ""
# 009d0f2659154fe5a7e7ab8dbc3c479c
#: ../../i18n.rst:81
#: ../../i18n.rst:80
msgid ""
"To make it possible to localize these correctly, we can add \"context\" "
"(known in gettext as *msgctxt*) to differentiate two otherwise identical "
@ -136,41 +118,35 @@ msgid ""
"function for this."
msgstr ""
# c17765da35484f85965668b3729afb2a
#: ../../i18n.rst:85
#: ../../i18n.rst:84
msgid ""
"For example, the string *Search* may be a noun or a verb in English. In a "
"heading, it may be considered a noun, but on a button, it may be a verb. "
"It's appropriate to add a context (like *button*) to one of them."
msgstr ""
# bf4b958ffbcd4837bbcc75502d40b99e
#: ../../i18n.rst:89
#: ../../i18n.rst:88
msgid ""
"Generally, we should only add context if we are sure the strings aren't used"
" in the same way, or if localizers ask us to."
msgstr ""
# 724e38728d39465d87b8caf647fd8666
#: ../../i18n.rst:100
#: ../../i18n.rst:99
msgid "Plurals"
msgstr ""
# dd5e3399f3a04d3c8ce3b09f660b54b9
#: ../../i18n.rst:102
#: ../../i18n.rst:101
msgid ""
"*You have 1 new messages* grates on discerning ears. Fortunately, gettext "
"gives us a way to fix that in English *and* other locales, the "
":func:`~django.utils.translation.ngettext()` function::"
msgstr ""
# 387e45b9e2094940a2ae67d8e5863f22
#: ../../i18n.rst:108
#: ../../i18n.rst:107
msgid "A more realistic example might be::"
msgstr ""
# 30d88f6c367b4a8cbde58c6108da250c
#: ../../i18n.rst:114
#: ../../i18n.rst:113
msgid ""
"This method takes three arguments because English only needs three, i.e., "
"zero is considered \"plural\" for English. Other languages may have "
@ -180,46 +156,39 @@ msgid ""
" gettext makes it possible."
msgstr ""
# c4fceab3f74c457abd79cdfa5c2e6db6
#: ../../i18n.rst:122
#: ../../i18n.rst:121
msgid "Strings in Templates"
msgstr ""
# 316b4d6a58664999926ce27bd333fdcd
#: ../../i18n.rst:124
#: ../../i18n.rst:123
msgid ""
"When putting new text into a template, all you need to do is wrap it in a "
"``{% trans %}`` template tag::"
msgstr ""
# fbf95cb4e8084ec18f0d18d6e24eae59
#: ../../i18n.rst:129
#: ../../i18n.rst:128
msgid "Context can be added, too::"
msgstr ""
# 8e92c1a904af42c9ba8204d2a8fff50f
#: ../../i18n.rst:133
#: ../../i18n.rst:132
msgid ""
"Comments for translators need to precede the internationalized text and must"
" start with the ``Translators:`` keyword.::"
msgstr ""
# b120b3a52ea842768ea9b9c5262e46e4
#: ../../i18n.rst:139
#: ../../i18n.rst:138
msgid ""
"To interpolate, you need to use the alternative and more verbose ``{% "
"blocktrans %}`` template tag — it's actually a block::"
msgstr ""
# 4ef0772c82e04868b8502eba3fd901eb
#: ../../i18n.rst:144
#: ../../i18n.rst:143
msgid ""
"Note that the ``{{ name }}`` variable needs to exist in the template "
"context."
msgstr ""
# fa1b042156d0442486c68097e0a496c3
#: ../../i18n.rst:146
#: ../../i18n.rst:145
msgid ""
"In some situations, it's desirable to evaluate template expressions such as "
"filters or accessing object attributes. You can't do that within the ``{% "
@ -227,82 +196,76 @@ msgid ""
"variable first::"
msgstr ""
# b186878d5f4b49f28c8ae3e50971eede
#: ../../i18n.rst:157
#: ../../i18n.rst:156
msgid ""
"``{% blocktrans %}`` also provides pluralization. For that you need to bind "
"a counter with the name ``count`` and provide a plural translation after the"
" ``{% plural %}`` tag::"
msgstr ""
# 15bc6e4bdfc449cd942eb9a23c67c144
#: ../../i18n.rst:169
msgid ""
"The previous multi-lines examples also use the ``trimmed`` option. This "
"removes newline characters and replaces any whitespace at the beginning and "
"end of a line, helping translators when translating these strings."
msgstr ""
#: ../../i18n.rst:175
msgid "Strings in Python"
msgstr ""
# a969f7db25a1486c8243082a69f91cd6
#: ../../i18n.rst:173
#: ../../i18n.rst:179
msgid ""
"Whenever you are adding a string in Python, ask yourself if it really needs "
"to be there, or if it should be in the template. Keep logic and presentation"
" separate!"
msgstr ""
# 28aa9ed76fb54438afe50865711477b6
#: ../../i18n.rst:177
#: ../../i18n.rst:183
msgid "Strings in Python are more complex for two reasons:"
msgstr ""
# 74d0e17c3aaa4332ae461685cfb2ddad
#: ../../i18n.rst:179
#: ../../i18n.rst:185
msgid ""
"We need to make sure we're always using Unicode strings and the Unicode-"
"friendly versions of the functions."
msgstr ""
# 39ee8e360c6d4ce3b4545a44e31a64da
#: ../../i18n.rst:182
#: ../../i18n.rst:188
msgid ""
"If you use the :func:`~django.utils.translation.ugettext` function in the "
"wrong place, the string may end up in the wrong locale!"
msgstr ""
# ac1a9e475fb848fa91a7a6422d9b4910
#: ../../i18n.rst:185
#: ../../i18n.rst:191
msgid "Here's how you might localize a string in a view::"
msgstr ""
# 730c6c212aab4353bb7267210e7166fe
#: ../../i18n.rst:195
#: ../../i18n.rst:201
msgid "Interpolation is done through normal Python string formatting::"
msgstr ""
# 0d86e29535114f388596b72a64a62733
#: ../../i18n.rst:199
#: ../../i18n.rst:205
msgid ""
"Context information can be supplied by using the "
":func:`~django.utils.translation.pgettext` function::"
msgstr ""
# dd3c2fb2936249afa662a8155b99c571
#: ../../i18n.rst:204
#: ../../i18n.rst:210
msgid "Translator comments are normal one-line Python comments::"
msgstr ""
# 11340a1777864321bdcf23e495976df5
#: ../../i18n.rst:209
#: ../../i18n.rst:215
msgid ""
"If you need to use plurals, import the "
":func:`~django.utils.translation.ungettext` function::"
msgstr ""
# 28589a2eee9e4ab0ac6b256293cc9ee3
#: ../../i18n.rst:219
#: ../../i18n.rst:225
msgid "Lazily Translated Strings"
msgstr ""
# 1feeb4b88c95474a9fd2c9132cce67f5
#: ../../i18n.rst:221
#: ../../i18n.rst:227
msgid ""
"You can use :func:`~django.utils.translation.ugettext` or "
":func:`~django.utils.translation.ungettext` only in views or functions "
@ -311,8 +274,7 @@ msgid ""
"request!"
msgstr ""
# 7bffebf5f269432c8dc76e2301c820ae
#: ../../i18n.rst:226
#: ../../i18n.rst:232
msgid ""
"Examples include strings in module-level code, arguments to functions in "
"class definitions, strings in functions called from outside the context of a"
@ -324,47 +286,40 @@ msgid ""
" passed to ``unicode()``::"
msgstr ""
# 839f81f005af444fa8744c6ae294bd5e
#: ../../i18n.rst:240
#: ../../i18n.rst:246
msgid ""
"In case you want to provide context to a lazily-evaluated gettext string, "
"you will need to use :func:`~django.utils.translation.pgettext_lazy`."
msgstr ""
# 2b9fb631d32d4d17b78c09e846870c37
#: ../../i18n.rst:245
#: ../../i18n.rst:251
msgid "Administrative Tasks"
msgstr ""
# f6c71f03488d48a2b861f18d23f5dfe3
#: ../../i18n.rst:248
#: ../../i18n.rst:255
msgid "Updating Localization Files"
msgstr ""
# b9a1daec64164446ad7a38b86991016c
#: ../../i18n.rst:250
#: ../../i18n.rst:257
msgid ""
"To update the translation source files (eg if you changed or added "
"translatable strings in the templates or Python code) you should run "
"``python manage.py makemessages -l <language>`` in the ``readthedocs/`` "
"``python manage.py makemessages -l <language>`` in the project's root "
"directory (substitute ``<language>`` with a valid language code)."
msgstr ""
# a19ae2dea0b54c2183651f5586d2feb6
#: ../../i18n.rst:255
#: ../../i18n.rst:262
msgid ""
"The updated files can now be localized in a `PO editor "
"<https://en.wikipedia.org/wiki/Category:Software-localization_tools>`_ or "
"crowd-sourced online translation tool."
msgstr ""
# 2491f3818f9c48788384d7b13580df44
#: ../../i18n.rst:263
#: ../../i18n.rst:267
msgid "Compiling to MO"
msgstr ""
# 9462cc9d03004ea4a56fba665a121d65
#: ../../i18n.rst:265
#: ../../i18n.rst:269
msgid ""
"Gettext doesn't parse any text files, it reads a binary format for faster "
"performance. To compile the latest PO files in the repository, Django "
@ -372,15 +327,13 @@ msgid ""
" all the available localizations, just run::"
msgstr ""
# e05f45db25ea470988d01c03e4f8c45a
#: ../../i18n.rst:272
#: ../../i18n.rst:276
msgid ""
"You will need to do this every time you want to push updated translations to"
" the live site."
msgstr ""
# b9fcd9ed05384621b45f38f10ca716ab
#: ../../i18n.rst:275
#: ../../i18n.rst:279
msgid ""
"Also, note that it's not a good idea to track MO files in version control, "
"since they would need to be updated at the same pace PO files are updated, "
@ -388,29 +341,39 @@ msgid ""
"please make sure you don't forcibly add them to the repository."
msgstr ""
# 1ae64e01b8bf4954a7ee917bc24e9ac8
#: ../../i18n.rst:282
#: ../../i18n.rst:286
msgid "Transifex Integration"
msgstr ""
# eb7d364130d242dabc8220901c85b789
#: ../../i18n.rst:284
#: ../../i18n.rst:288
msgid ""
"To push updated translation source files to Transifex, run ``tx push -s`` "
"(for English) or ``tx push -t <language>`` (for non-English)."
msgstr ""
# a6a5608e88c94f1a828807348aeb71dd
#: ../../i18n.rst:287
#: ../../i18n.rst:291
msgid ""
"To pull changes from Transifex, run ``tx pull -a``. Note that Transifex does"
" not compile the translation files, so you have to do this after the pull "
"(see the :ref:`i18n-compiling` section)."
"(see the `Compiling to MO`_ section)."
msgstr ""
# 043ff2cbd78047ee993c599025e10de8
#: ../../i18n.rst:291
#: ../../i18n.rst:295
msgid ""
"For more information about the ``tx`` command, read the `Transifex client's "
"help pages <http://help.transifex.com/features/client/>`_."
msgstr ""
#: ../../i18n.rst:301
msgid ""
"For the Read the Docs community site, we use a `fabric script`_ to follow "
"this process:"
msgstr ""
#: ../../i18n.rst:305
msgid "Update files and push sources (English) to Transifex:"
msgstr ""
#: ../../i18n.rst:311
msgid "Pull changes (new translations) from Transifex:"
msgstr ""

Binary file not shown.

View File

@ -1,99 +1,92 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2010, Eric Holscher, Charlie Leifer, Bobby Grace
# This file is distributed under the same license as the Read The Docs package.
# 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: 2014-03-01 22:07+0800\n"
"PO-Revision-Date: 2014-03-02 12:03+0000\n"
"Last-Translator: Eric Holscher <eric@ericholscher.com>\n"
"Language-Team: Danish (http://www.transifex.com/projects/p/readthedocs-docs/language/da/)\n"
"POT-Creation-Date: 2018-09-17 19:05-0500\n"
"PO-Revision-Date: 2018-09-18 00:30+0000\n"
"Last-Translator: Anthony <aj@ohess.org>\n"
"Language-Team: Danish (http://www.transifex.com/readthedocs/readthedocs-docs/language/da/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: da\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
# 69bb4fe216b04fc297fc0f043fe11b8a
#: ../../index.rst:2
msgid "Welcome to Read The Docs"
msgstr ""
# b8f891b8443f4a45994c9c0a6bec14c3
#: ../../index.rst:4
msgid ""
"`Read the Docs`_ hosts documentation for the open source community. It "
"supports Sphinx_ docs written with reStructuredText_, and can pull from your"
" Subversion_, Bazaar_, Git_, and Mercurial_ repositories. The code is open "
"source, and `available on github`_."
"`Read the Docs`_ hosts documentation for the open source community. We "
"support Sphinx_ docs written with reStructuredText_ and `CommonMark`_. We "
"pull your code from your Subversion_, Bazaar_, Git_, and Mercurial_ "
"repositories. Then we build documentation and host it for you. Think of it "
"as *Continuous Documentation*."
msgstr ""
# 650f82d4b7674e12bbaeb9167916911d
#: ../../index.rst:18
#: ../../index.rst:10
msgid "The code is open source, and `available on GitHub`_."
msgstr ""
#: ../../index.rst:22
msgid ""
"The documentation for the site is organized into a few different sections "
"below:"
"The main documentation for the site is organized into a couple sections:"
msgstr ""
# b940724b82f3481780036c6e9452bef1
#: ../../index.rst:20
msgid ":ref:`site-docs`"
#: ../../index.rst:24
msgid ":ref:`user-docs`"
msgstr ""
# 89306f02cad44949a55ba1eb99d947a0
#: ../../index.rst:21
#: ../../index.rst:25
msgid ":ref:`feature-docs`"
msgstr ""
# 16eed7976a1a4258a968b56ec8932998
#: ../../index.rst:22
msgid ":ref:`dev-docs`"
msgstr ""
# 414c5e7b462242f69544ff1dcfcce26a
#: ../../index.rst:23
msgid ":ref:`design-docs`"
msgstr ""
# c2ad8cf74fae4af3bc294e3fba77188e
#: ../../index.rst:24
#: ../../index.rst:26
msgid ":ref:`about-docs`"
msgstr ""
# 7fd0b59687ba44df9f35eaf039a1d22f
#: ../../index.rst:28
msgid "Information about development is also available:"
msgstr ""
#: ../../index.rst:30
msgid ":ref:`dev-docs`"
msgstr ""
#: ../../index.rst:31
msgid ":ref:`design-docs`"
msgstr ""
#: ../../index.rst:35
msgid "User Documentation"
msgstr ""
# bafccc8f112d4b4bb5f0ff18224e1cca
#: ../../index.rst:44
msgid "Features"
msgstr ""
# d079a4d425fc4809aadc989620da55ed
#: ../../index.rst:62
msgid "Developer Documentation"
msgstr ""
# 49bd75d34ae84246af745b9a7fa96ba9
#: ../../index.rst:80
msgid "Designer Documentation"
msgstr ""
# 2e34898dc4b44a03968e26b8c0ce66e6
#: ../../index.rst:91
#: ../../index.rst:52
msgid "About Read the Docs"
msgstr ""
# 2da908ba87d94b4685277d2482e0fcad
#: ../../index.rst:105
msgid "Custom install Documentation"
#: ../../index.rst:70
msgid "Feature Documentation"
msgstr ""
# 60926664d88d449897c1cde115bac962
#: ../../index.rst:116
msgid "Operations Documentation"
#: ../../index.rst:92
msgid "Developer Documentation"
msgstr ""
#: ../../index.rst:111
msgid "Business Documentation"
msgstr ""
#: ../../index.rst:119
msgid "Custom Install Documentation"
msgstr ""
#: ../../index.rst:127
msgid "Designer Documentation"
msgstr ""

View File

@ -1,210 +1,193 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2010, Eric Holscher, Charlie Leifer, Bobby Grace
# This file is distributed under the same license as the Read The Docs package.
# 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: 2014-03-01 22:07+0800\n"
"PO-Revision-Date: 2014-03-02 12:03+0000\n"
"Last-Translator: Eric Holscher <eric@ericholscher.com>\n"
"Language-Team: Danish (http://www.transifex.com/projects/p/readthedocs-docs/language/da/)\n"
"POT-Creation-Date: 2018-09-17 19:05-0500\n"
"PO-Revision-Date: 2018-09-18 00:15+0000\n"
"Last-Translator: Anthony <aj@ohess.org>\n"
"Language-Team: Danish (http://www.transifex.com/readthedocs/readthedocs-docs/language/da/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: da\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
# 818e4029f377471cb6e9a4b26c5d774f
#: ../../install.rst:4
#: ../../install.rst:2
msgid "Installation"
msgstr ""
# ec9b5e928ffb4a6b94c9cb7ce1e96494
#: ../../install.rst:6
#: ../../install.rst:4
msgid ""
"Installing RTD is pretty simple. Here is a step by step plan on how to do "
"it."
"Here is a step by step plan on how to install Read the Docs. It will get you"
" to a point of having a local running instance."
msgstr ""
# 75b84cca63e24eeb89a1fc1175b6d852
#: ../../install.rst:8
msgid ""
"First, obtain Python_ and virtualenv_ if you do not already have them. Using"
" a virtual environment will make the installation easier, and will help to "
"avoid clutter in your system-wide libraries. You will also need Git_ in "
"order to clone the repository."
"First, obtain `Python 3.6`_ and virtualenv_ if you do not already have them."
" Using a virtual environment will make the installation easier, and will "
"help to avoid clutter in your system-wide libraries. You will also need Git_"
" in order to clone the repository. If you plan to import Python 2.7 project "
"to your RTD then you'll need to install Python 2.7 with virtualenv in your "
"system as well."
msgstr ""
# 3f5466c88c7246b08beef8b9b0e96db3
#: ../../install.rst:17
msgid ""
"Once you have these, create a virtual environment somewhere on your disk, "
"then activate it::"
#: ../../install.rst:25
msgid "Requires Git version >=2"
msgstr ""
# 04545f09671541988788c40bd67e77d5
#: ../../install.rst:24
msgid "Create a folder in here, and clone the repository::"
msgstr ""
# 96dff4cea5f245b2a56667686b96f6fe
#: ../../install.rst:30
msgid ""
"Next, install the dependencies using ``pip`` (included with virtualenv_)::"
msgstr ""
# 183e1512e5464775adb87d63b2e745a5
#: ../../install.rst:37
#: ../../install.rst:29
msgid ""
"If you are having trouble on OS X Mavericks (or possibly other versions of "
"OS X) with building ``lxml``, you probably might need to use Homebrew_ to "
"``brew install libxml2``, and invoke the install with::"
msgstr ""
# a29839c5a8ee454c9099d2dfde2df047
#: ../../install.rst:47
#: ../../install.rst:39
msgid ""
"Linux users may find they need to install a few additional packages in order"
" to successfully execute ``pip install -r requirements.txt``. For example, a"
" clean install of Ubuntu 14.04 LTS will require the following packages::"
msgstr ""
#: ../../install.rst:48
msgid "CentOS/RHEL 7 will require::"
msgstr ""
#: ../../install.rst:52
msgid ""
"Users of other Linux distributions may need to install the equivalent "
"packages, depending on their system configuration."
msgstr ""
#: ../../install.rst:57
msgid ""
"If you want full support for searching inside your Read the Docs site you "
"will need to install Elasticsearch_."
msgstr ""
#: ../../install.rst:60
msgid ""
"Ubuntu users could install this package by following "
":doc:`/custom_installs/elasticsearch`."
msgstr ""
#: ../../install.rst:64
msgid "Besides the Python specific dependencies, you will also need Redis_."
msgstr ""
#: ../../install.rst:66
msgid "Ubuntu users could install this package as following::"
msgstr ""
#: ../../install.rst:71
msgid ""
"You will need to verify that your pip version is higher than 1.5 you can do "
"this as such::"
msgstr ""
#: ../../install.rst:75
msgid ""
"If this is not the case please update your pip version before continuing::"
msgstr ""
#: ../../install.rst:79
msgid ""
"Once you have these, create a virtual environment somewhere on your disk, "
"then activate it::"
msgstr ""
#: ../../install.rst:86
msgid "Create a folder in here, and clone the repository::"
msgstr ""
#: ../../install.rst:92
msgid ""
"Next, install the dependencies using ``pip`` (included inside of "
"virtualenv_)::"
msgstr ""
#: ../../install.rst:97
msgid ""
"This may take a while, so go grab a beverage. When it's done, build your "
"database::"
msgstr ""
# a19bf23fb7cb436c8bfd8e54abc7fee8
#: ../../install.rst:53
#: ../../install.rst:102
msgid "Then please create a superuser account for Django::"
msgstr ""
#: ../../install.rst:106
msgid "Now let's properly generate the static assets::"
msgstr ""
#: ../../install.rst:110
msgid ""
"This will prompt you to create a superuser account for Django. Do that. "
"Then::"
"By now, it is the right time to load in a couple users and a test project::"
msgstr ""
# 0fd46536ec7543ed892340ff65a2d8c0
#: ../../install.rst:57
msgid "Go ahead and load in a couple users and a test projects::"
#: ../../install.rst:116
msgid ""
"If you do not opt to install test data, you'll need to create an account for"
" API use and set ``SLUMBER_USERNAME`` and ``SLUMBER_PASSWORD`` in order for "
"everything to work properly. This can be done by using ``createsuperuser``, "
"then attempting a manual login to create an ``EmailAddress`` entry for the "
"user, then you can use ``shell_plus`` to update the object with "
"``primary=True``, ``verified=True``."
msgstr ""
# 31a93895b45f4120aac2b5165d0e0a50
#: ../../install.rst:61
#: ../../install.rst:123
msgid "Finally, you're ready to start the webserver::"
msgstr ""
# 4bed87a049264508bb97ecf4774bd593
#: ../../install.rst:65
#: ../../install.rst:127
msgid ""
"Visit http://127.0.0.1:8000/ in your browser to see how it looks; you can "
"use the admin interface via http://127.0.0.1:8000/admin (logging in with the"
" superuser account you just created)."
msgstr ""
# 5de5b49a90b44e7aa99aa248025e807c
#: ../../install.rst:69
#: ../../install.rst:131
msgid ""
"For builds to properly kick off as expected, it is necessary the port you're"
" serving on (i.e. ``runserver 0.0.0.0:8080``) match the port defined in "
"``PRODUCTION_DOMAIN``. You can utilize ``local_settings.py`` to modify this."
" (By default, it's ``localhost:8000``)"
msgstr ""
#: ../../install.rst:136
msgid ""
"While the webserver is running, you can build documentation for the latest "
"version of a project called 'pip' with the ``update_repos`` command. You "
"can replace 'pip' with the name of any added project::"
msgstr ""
# 1d166a5c19494c6a91e9809dae75dcbd
#: ../../install.rst:77
msgid "Solr (Search) Setup"
msgstr ""
# a8bc916a941448f7a71906c7649fd680
#: ../../install.rst:79
msgid ""
"Apache Solr is used to index and search documents. This is an optional "
"requirement, and only necessary if you want to develop or use search."
msgstr ""
# 9aa79edc67e6436382cc40e9946cea9b
#: ../../install.rst:83
msgid "Additional python requirements necessary to use Solr::"
msgstr ""
# 425a1619b84d4f5483d29513be8053cc
#: ../../install.rst:88
msgid "Fetch and unpack Solr::"
msgstr ""
# 2bd53ca7849e48bbbd20b53a1235f9d3
#: ../../install.rst:93
msgid "Generate the schema.xml file::"
msgstr ""
# 2314117559ab4b6282d0a809cddc8f21
#: ../../install.rst:97
msgid "Start the server::"
msgstr ""
# 0eb8a8d72e904f05a6621906e203c501
#: ../../install.rst:101
msgid "Index the data::"
msgstr ""
# 0b897f6370294ccc8060ee2277e55e77
#: ../../install.rst:108
msgid ""
"For production environments, you'll want to run Solr in a more permanent "
"servelet container, such as Tomcat or Jetty. Ubuntu distributions include "
"prepackaged Solr installations. Try ``aptitude install solr-tomcat`` or "
"``aptitude install solr-jetty.``"
msgstr ""
# 8b46ce1bef8447cc9f9d145cba128d2d
#: ../../install.rst:113
msgid ""
"See /etc/[solr|tomcat6|jetty] for configuration options. The ``schema.xml``"
" file must be replaced with the version built by django-haystack."
msgstr ""
# ab9c47b2440e4bbd8261075d333ce579
#: ../../install.rst:118
#: ../../install.rst:143
msgid "What's available"
msgstr ""
# 1f03445818ac4295befb24243b239250
#: ../../install.rst:120
#: ../../install.rst:145
msgid ""
"After registering with the site (or creating yourself a superuser account), "
"you will be able to log in and view the `dashboard "
"<http://readthedocs.org/dashboard/>`_."
"<http://localhost:8000/dashboard/>`_."
msgstr ""
# 95ece41f6f6b46dcaa02e62931df127e
#: ../../install.rst:123
#: ../../install.rst:149
msgid "Importing your docs"
msgstr ""
#: ../../install.rst:151
msgid ""
"From the dashboard you can import your existing docs provided that they are "
"in a git or mercurial repo."
msgstr ""
# 63c825883d524731a11131146e7155ec
#: ../../install.rst:128
msgid "Creating new Docs"
msgstr ""
# 18006bd7b7d2406c8ce45b7e5b01ac76
#: ../../install.rst:130
msgid ""
"One of the goals of `readthedocs.org <http://readthedocs.org>`_ is to make "
"it easy for any open source developer to get high quality hosted docs with "
"great visibility! We provide a simple editor and two sample pages whenever "
"a new project is created. From there its up to you to fill in the gaps - "
"we'll build the docs, give you access to history on every revision of your "
"files, and we plan on adding more features in the weeks and months to come."
msgstr ""
# 861d806bbcbb4ee485eebbf20d07f06e
#: ../../install.rst:139
msgid "Importing existing docs"
msgstr ""
# 57d758b04f4140f59290f51a1ac4e871
#: ../../install.rst:141
msgid ""
"The other side of `readthedocs.org <http://readthedocs.org>`_ is hosting the"
" docs you've already built. Simply provide us with the clone url to your "
"repo, we'll pull your code, extract your docs, and build them! We make "
"available a post-commit webhook that can be configured to update the docs on"
" our site whenever you commit to your repo, effectively letting you 'set it "
"and forget it'."
"One of the goals of readthedocs.org is to make it easy for any open source "
"developer to get high quality hosted docs with great visibility! Simply "
"provide us with the clone URL to your repo, we'll pull your code, extract "
"your docs, and build them! We make available a post-commit webhook that can "
"be configured to update the docs whenever you commit to your repo. See our "
":doc:`getting_started` page to learn more."
msgstr ""

Binary file not shown.

View File

@ -0,0 +1,251 @@
# 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.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Read the Docs 1.0\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2018-09-17 19:05-0500\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Language-Team: Danish (https://www.transifex.com/readthedocs/teams/2534/da/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: da\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
#: ../../issue-labels.rst:2
msgid "Overview of issue labels"
msgstr ""
#: ../../issue-labels.rst:4
msgid ""
"Here is a full list of labels that we use in the `GitHub issue tracker`_ and"
" what they stand for."
msgstr ""
#: ../../issue-labels.rst:18
msgid "*Accepted*"
msgstr ""
#: ../../issue-labels.rst:10
msgid ""
"Issues with this label are issues that the core team has accepted on to the "
"roadmap. The core team focuses on accepted bugs, features, and improvements "
"that are on our immediate roadmap and will give priority to these issues. "
"Pull requests could be delayed or closed if the pull request doesn't align "
"with our current roadmap. An issue or pull request that has not been "
"accepted should either eventually move to an accepted state, or should be "
"closed. As an issue is accepted, we will find room for it on our roadmap, "
"either on an upcoming release (point release milestones), or on a future "
"milestone project (named milestones)."
msgstr ""
#: ../../issue-labels.rst:24
msgid "*Bug*"
msgstr ""
#: ../../issue-labels.rst:21
msgid ""
"An issue describing unexpected or malicious behaviour of the readthedocs.org"
" software. A Bug issue differs from an Improvement issue in that Bug issues "
"are given priority on our roadmap. On release, these issues generally only "
"warrant incrementing the patch level version."
msgstr ""
#: ../../issue-labels.rst:27
msgid "*Design*"
msgstr ""
#: ../../issue-labels.rst:27
msgid "Issues related to the UI of the readthedocs.org website."
msgstr ""
#: ../../issue-labels.rst:33
msgid "*Feature*"
msgstr ""
#: ../../issue-labels.rst:30
msgid ""
"Issues that describe new features. Issues that do not describe new features,"
" such as code cleanup or fixes that are not related to a bug, should "
"probably be given the Improvement label instead. On release, issues with the"
" Feature label warrant at least a minor version increase."
msgstr ""
#: ../../issue-labels.rst:37
msgid "*Good First Issue*"
msgstr ""
#: ../../issue-labels.rst:36
msgid ""
"This label marks issues that are easy to get started with. The issue should "
"be ideal for beginners to dive into the code base."
msgstr ""
#: ../../issue-labels.rst:40
msgid "*Priority: high*"
msgstr ""
#: ../../issue-labels.rst:40
msgid "Issues with this label should be resolved as quickly as possible."
msgstr ""
#: ../../issue-labels.rst:43
msgid "*Priority: low*"
msgstr ""
#: ../../issue-labels.rst:43
msgid ""
"Issues with this label won't have the immediate focus of the core team."
msgstr ""
#: ../../issue-labels.rst:50
msgid "*Improvement*"
msgstr ""
#: ../../issue-labels.rst:46
msgid ""
"An issue with this label is not a Bug nor a Feature. Code cleanup or small "
"changes to existing features would likely have this label. The distinction "
"for this label is that these issues have a lower priority on our roadmap "
"compared to issues labeled Bug, and aren't implementing new features, such "
"as a Feature issue might."
msgstr ""
#: ../../issue-labels.rst:54
msgid "*Needed: design decision*"
msgstr ""
#: ../../issue-labels.rst:53
msgid ""
"Issues that need a design decision are blocked for development until a "
"project leader clarifies the way in which the issue should be approached."
msgstr ""
#: ../../issue-labels.rst:58
msgid "*Needed: documentation*"
msgstr ""
#: ../../issue-labels.rst:57
msgid ""
"If an issue involves creating or refining documentation, this label will be "
"assigned."
msgstr ""
#: ../../issue-labels.rst:65
msgid "*Needed: more information*"
msgstr ""
#: ../../issue-labels.rst:61
msgid ""
"This label indicates that a reply with more information is required from the"
" bug reporter. If no response is given by the reporter, the issue is "
"considered invalid after 2 weeks and will be closed. See the documentation "
"about our :ref:`triage process <triage-not-enough-information>` for more "
"information."
msgstr ""
#: ../../issue-labels.rst:69
msgid "*Needed: patch*"
msgstr ""
#: ../../issue-labels.rst:68
msgid ""
"This label indicates that a patch is required in order to resolve the issue."
" A fix should be proposed via a pull request on GitHub."
msgstr ""
#: ../../issue-labels.rst:73
msgid "*Needed: tests*"
msgstr ""
#: ../../issue-labels.rst:72
msgid ""
"This label indicates that a better test coverage is required to resolve the "
"issue. New tests should be proposed via a pull request on GitHub."
msgstr ""
#: ../../issue-labels.rst:77
msgid "*Needed: replication*"
msgstr ""
#: ../../issue-labels.rst:76
msgid ""
"This label indicates that a bug has been reported, but has not been "
"successfully replicated by another user or contributor yet."
msgstr ""
#: ../../issue-labels.rst:80
msgid "*Operations*"
msgstr ""
#: ../../issue-labels.rst:80
msgid "Issues that require changes in the server infrastructure."
msgstr ""
#: ../../issue-labels.rst:84
msgid "*PR: work in progress*"
msgstr ""
#: ../../issue-labels.rst:83
msgid ""
"Pull Requests that are not complete yet. A final review is not possible yet,"
" but every Pull Request is open for discussion."
msgstr ""
#: ../../issue-labels.rst:88
msgid "*PR: hotfix*"
msgstr ""
#: ../../issue-labels.rst:87
msgid ""
"Pull request was applied directly to production after a release. These pull "
"requests still need review to be merged into the next release."
msgstr ""
#: ../../issue-labels.rst:92
msgid "*Sprintable*"
msgstr ""
#: ../../issue-labels.rst:91
msgid ""
"Sprintable are all issues that have the right amount of scope to be handled "
"during a sprint. They are very focused and encapsulated."
msgstr ""
#: ../../issue-labels.rst:96
msgid "*Status: blocked*"
msgstr ""
#: ../../issue-labels.rst:95
msgid ""
"The issue cannot be resolved until some other issue has been closed. See the"
" issue's log for which issue is blocking this issue."
msgstr ""
#: ../../issue-labels.rst:101
msgid "*Status: stale*"
msgstr ""
#: ../../issue-labels.rst:99
msgid ""
"A issue is stale if it there has been no activity on it for 90 days. Once a "
"issue is determined to be stale, it will be closed after 2 weeks unless "
"there is activity on the issue."
msgstr ""
#: ../../issue-labels.rst:106
msgid "*Support*"
msgstr ""
#: ../../issue-labels.rst:104
msgid ""
"Questions that needs answering but do not require code changes or issues "
"that only require a one time action on the server will have this label. See "
"the documentation about our :ref:`triage process <triage-support-tickets>` "
"for more information."
msgstr ""

Some files were not shown because too many files have changed in this diff Show More