Add a guide on how to setup Python on Windows to work well with Quarto

[cderv]

This is a topic that comes up often and I think our current guide is not enough and needs to be updated. Also some improvment needs to be made first. Context below

To solve

• Support other python on Windows than py.exe supported ones (like pyenv) #1463

Related

• ModuleNotFoundError: No module named 'sympy' #4716

Resources

• Windows python setup FAQ

[abigailhaddad]

Following on the last thread -- the content of kernel.json is the following:

{
"argv": [
"python",
"-m",
"ipykernel_launcher",
"-f",
"{connection_file}"
],
"display_name": "Python 3 (ipykernel)",
"language": "python",
"metadata": {
"debugger": true
}
}

jupyter kernelspec list produces the following error:

Fatal error in launcher: Unable to create process using '"C:\Python311\python.exe" "C:\Users\abiga\AppData\Roaming\Python\Python311\Scripts\jupyter.exe" kernelspec list': The system cannot find the file specified.

But the bigger usability issue with quarto and Python for me isn't this, because I can hard-code my package locations - although not ideal. The plotly issues I don't have a workaround for -- the "“Unable to display output for mime type(s): text/html” when I try to put a figure in a docx or PDF file (in contrast with an HTML file, which works), and the errors that I get with trying to workaround this by writing out the file to a .PNG and then embedding it.

[cderv]

The plotly issues I don't have a workaround for -- the "“Unable to display output for mime type(s): text/html” when I try to put a figure in a docx or PDF file (in contrast with an HTML file, which works),

This is another issue indeed. Plotly generate interactive HTML and HTML can't be embed in PDF output. There is no automatic screenshot of your Plotly graph by Jupyter - knitr does that for R. So you need to use conditional content to adapt your code to the output.

and the errors that I get with trying to workaround this by writing out the file to a .PNG and then embedding it.

Please to open a discussion item about this to share your tires and issue. I don't know what you are trying to export a plotly to PNG or PDF, but following this part of Plotly docs works for me: https://plotly.com/python/static-image-export/

Anyhow, discussion for another issue.

[JuanCruzC97]

But the bigger usability issue with quarto and Python for me isn't this, because I can hard-code my package locations - although not ideal. The plotly issues I don't have a workaround for -- the "“Unable to display output for mime type(s): text/html” when I try to put a figure in a docx or PDF file (in contrast with an HTML file, which works), and the errors that I get with trying to workaround this by writing out the file to a .PNG and then embedding it.

Any updates on this?