|
1 | 1 | {
|
2 |
| - "path": "guides/wipe-environment", |
3 |
| - "title": "Wiping a Build Environment", |
4 |
| - "sections": [ |
5 |
| - { |
6 |
| - "id": "wiping-a-build-environment", |
7 |
| - "title": "Wiping a Build Environment", |
8 |
| - "content": "Sometimes it happen that your Builds start failing because the build environment where the documentation is created is stale or broken. This could happen for a couple of different reasons like pip not upgrading a package properly or a corrupted cached Python package.In any of these cases (and many others), the solution could be just wiping out the existing build environment files and allow Read the Docs to create a new fresh one.Follow these steps to wipe the build environment:Click on the Edit button of the version you want to wipe on the right side of the page. Go to the bottom of the page and click the wipe link, next to the “Save” buttonBy wiping the documentation build environment, all the rst, md, and code files associated with it will be removed but not the documentation already built (HTML and PDF files). Your documentation will still online after wiping the build environment.Now you can re-build the version with a fresh build environment!" |
9 |
| - } |
10 |
| - ], |
11 |
| - "domains": [ |
12 |
| - { |
13 |
| - "role_name": "http:get", |
14 |
| - "doc_name": "api/v3.html", |
15 |
| - "anchor": "get--api-v3-users-(str-username)", |
16 |
| - "type_display": "get", |
17 |
| - "doc_display": "API v3", |
18 |
| - "name": "/api/v3/users/(str:username)", |
19 |
| - "display_name": "" |
20 |
| - }, |
21 |
| - { |
22 |
| - "role_name": "http:get", |
23 |
| - "doc_name": "api/v3.html", |
24 |
| - "anchor": "get--api-v3-projects-(string-project_slug)-versions-(string-version_slug)-", |
25 |
| - "type_display": "get", |
26 |
| - "doc_display": "API v3", |
27 |
| - "name": "/api/v3/projects/(string:project_slug)/versions/(string:version_slug)/", |
28 |
| - "display_name": "" |
29 |
| - }, |
30 |
| - { |
31 |
| - "role_name": "http:get", |
32 |
| - "doc_name": "api/v3.html", |
33 |
| - "anchor": "get--api-v3-projects-(string-project_slug)-versions-", |
34 |
| - "type_display": "get", |
35 |
| - "doc_display": "API v3", |
36 |
| - "name": "/api/v3/projects/(string:project_slug)/versions/", |
37 |
| - "display_name": "" |
38 |
| - }, |
39 |
| - { |
40 |
| - "role_name": "http:get", |
41 |
| - "doc_name": "api/v3.html", |
42 |
| - "anchor": "get--api-v3-projects-(string-project_slug)-", |
43 |
| - "type_display": "get", |
44 |
| - "doc_display": "API v3", |
45 |
| - "name": "/api/v3/projects/(string:project_slug)/", |
46 |
| - "display_name": "" |
47 |
| - } |
48 |
| - ] |
| 2 | + "content": "ReadtheDocsWiping a Build Environment\nSometimes it happen that your Builds start failing because the build environment where the is created is stale or broken. This could happen for a couple of different reasons like pip not upgrading a package properly or a corrupted cached Python package.\nIn any of these cases (and many others), the solution could be just wiping out the existing build environment files and allow Read the Docs to create a new fresh one.\nFollow these steps to wipe the build environment:\nGo to Versions\nClick on the Edit button of the version you want to wipe on the right side of the page\nGo to the bottom of the page and click the wipe link, next to the \u201cSave\u201d button\nNote\nBy wiping the build environment, all the rst, md, and code files associated with it will be removed but not the already built (HTML and PDF files). Your will still online after wiping the build environment.\nNow you can re-build the version with a fresh build environment!", |
| 3 | + "headers": [ |
| 4 | + "Wiping a Build Environment" |
| 5 | + ], |
| 6 | + "title": "Wiping a Build Environment", |
| 7 | + "sections": [ |
| 8 | + { |
| 9 | + "content": "\nSometimes it happen that your Builds start failing because the build\nenvironment where the is created is stale or\nbroken. This could happen for a couple of different reasons like <code class=\"xref py py-obj docutils literal notranslate\"><span class=\"pre\">pip</span></code>\nnot upgrading a package properly or a corrupted cached Python package.\n\nIn any of these cases (and many others), the solution could be just\nwiping out the existing build environment files and allow Read the\nDocs to create a new fresh one.\n\nFollow these steps to wipe the build environment:\n\n\n<li>Go to <strong>Versions</strong></li>\n<li>Click on the <strong>Edit</strong> button of the version you want to wipe on the\nright side of the page</li>\n<li>Go to the bottom of the page and click the <strong>wipe</strong> link, next to\nthe \u201cSave\u201d button</li>\n\n\n\n<p class=\"first admonition-title\">Note</p>\n<p class=\"last\">By wiping the build environment, all the <code class=\"xref py py-obj docutils literal notranslate\"><span class=\"pre\">rst</span></code>, <code class=\"xref py py-obj docutils literal notranslate\"><span class=\"pre\">md</span></code>,\nand code files associated with it will be removed but not the\n already built (<code class=\"xref py py-obj docutils literal notranslate\"><span class=\"pre\">HTML</span></code> and <code class=\"xref py py-obj docutils literal notranslate\"><span class=\"pre\">PDF</span></code> files). Your\n will still online after wiping the build environment.</p>\n\n\nNow you can re-build the version with a fresh build environment!\n", |
| 10 | + "id": "wiping-a-build-environment", |
| 11 | + "title": "Wiping a Build Environment" |
| 12 | + } |
| 13 | + ], |
| 14 | + "path": "guides/wipe-environment" |
49 | 15 | }
|
0 commit comments