`python setup.py upload_docs`成功，但沒有任何更改在線

我想使用setuptools發佈關於pythonhosted.org的文檔，但python setup.py upload_docs成功時，沒有任何更改在線，並且PyPI上我的軟件包日誌中沒有報告更新文檔。`python setup.py upload_docs`成功，但沒有任何更改在線

然而，我仍然可以手動上傳使用的PyPI網絡接口一個ZIP文件，而這個工作得很好。

我用來構建和部署使用MkDocs文檔：

$ mkdocs build --clean 
$ python setup.py upload_docs

他們沒有報告任何錯誤。新網站已正確生成，可由MkDocs在本地提供。

我試過的Python 3.4.2，3.5和3.6，以及與setuptools的多個版本。我必須失去一些明顯的東西。

下面是upload_docs命令的輸出（與調試信息）。請注意，網站的內容存儲在「./site」下，如所檢測到的。另見我的project configuration，特別是setup.py和setup.cfg。

$ python setup.py upload_docs 
options (after parsing config files): 
options (after parsing command line): 
option dict for 'aliases' command: 
{} 
option dict for 'metadata' command: 
{'description_file': ('setup.cfg', 'README.adoc')} 
option dict for 'upload_docs' command: 
{'upload_dir': ('setup.cfg', 'site')} 
running upload_docs 
Distribution.get_command_obj(): creating 'upload_docs' command object 
setting options for 'upload_docs' command: 
upload_dir = site (from setup.cfg) 
Upload_docs command is deprecated. Use RTD instead. 
Submitting documentation to https://pypi.python.org/pypi/ 
Server response (200): OK

在此先感謝您的幫助。

來源

2017-01-11 Franck

沒有人報告任何錯誤。

從技術上講是真的，但你似乎忽略了一個簡單的警告。從您的輸出：

Upload_docs命令已棄用。改用RTD。

「已棄用」部分is clear enough：此命令不再推薦使用。

的「使用RTD代替」部分不清，我承認。它應該更加明確：它指的是Read the Docs服務。

這是因爲有一個（poorly documented as of 2017-04-05）計劃到remove PyPI文檔託管服務。

來源

2017-04-04 19:36:52 bignose

這並沒有真正回答這個問題。如果真的被禁用，則API上傳返回200毫無意義。它似乎沒有被禁用，因爲它仍然適用於Web表單上傳。 – letmaik

@letmaik，誰在說API是[disabled]（https://en.wiktionary.org/wiki/disable）？不是我，也不是警告。相反，您被告知該API是[棄用]（https://en.wiktionary.org/wiki/deprecate）。該公告（與答案相關）是*計劃在未來一段時間*取消該服務。 – bignose

沒有人說它是殘疾的，但你似乎暗示它在你的答案，否則我不知道答案如何與問題相關。具體問題是頁面在成功上傳upload_docs後不會更新。 – letmaik

`python setup.py upload_docs`成功，但沒有任何更改在線

回答

相關問題