Add a 'docs-doc2dash' Tox target.#1702
Add a 'docs-doc2dash' Tox target.#1702tseaver merged 2 commits intogoogleapis:masterfrom tseaver:docs-add_doc2dash_tox_target
Conversation
googlebot
added
the
cla: yes
|
Do we actually need this? |
|
Yea - confused. What's the goal ? |
|
I know a decent number of people that use Dash. If this works as is and is low maintenance, I vote to use it. |
|
@tseaver Shall we close this PR? |
Generates a Dash-style docset from the Sphinx-rendered HTML.
|
I've rebased it to resolve the conflict in If we automated building the Dash docsets and pushing them to Dash as part of our tag-release deployment, that seems like a low-cost win to me: users who like using offline docs will be able to consume them with their preferred tool. |
tox.ini
Outdated
| PYTHONPATH = {toxinidir}/_testing | ||
| basepython = {[testenv:docs]basepython} | ||
| commands = | ||
| sphinx-build -W -b html -d docs/_build_doc2dash/doctrees docs docs/_build_doc2dash/html |
This comment was marked as spam.
This comment was marked as spam.
Sorry, something went wrong.
|
@tseaver Feel free to merge when my request is addressed. Are you going to automate the process of creating and publishing this target? |
Replace 'gcloud-python' with 'google-cloud-python' in docset name.
I'm thinking about it. There seem to be two options:
Automating the first seems quite feasible; the second seems infeasible. |
…udPlatform/python-docs-samples#1702) * Update enhanced models and auto punctuation to GA * Update model-slection to GA
…udPlatform/python-docs-samples#1702) * Update enhanced models and auto punctuation to GA * Update model-slection to GA
…udPlatform/python-docs-samples#1702) * Update enhanced models and auto punctuation to GA * Update model-slection to GA
…udPlatform/python-docs-samples#1702) * Update enhanced models and auto punctuation to GA * Update model-slection to GA
* chore(deps): update all dependencies * revert --------- Co-authored-by: Anthonios Partheniou <partheniou@google.com>
5 participants
Generates a Dash-style docset from the Sphinx-rendered HTML using doc2dash.
I've copied the docset manually into my Zeal library, and it looks pretty good.
Follow-up to my comment on #1690.