-
-
Notifications
You must be signed in to change notification settings - Fork 167
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Added windows support in install Plone with pip docs #1858
Conversation
Thanks for submitting your first pull request! You are awesome! 🤗 |
@pranshustuff did you use Windows Subsystem for Linux (WSL) on Windows or Windows alone? I'm hesitant to recommend installation steps for Windows alone if they don't actually result in a functional Plone site, and I have no way to verify that. See the Important admonition at https://6.docs.plone.org/install/create-project-cookieplone.html#prerequisites-for-installation. If you used WSL, then we might want to include that admonition into the pip installation docs. |
I used Windows only. I can add the admonition instead. Although, I would like to leave in the activation of venv and installation of cookiecutter through pip directly instead of pipx as an alternative, since my issue with pipx was with something to do with file path, which I assume can happen with WSL too. I can write a WSL version for those. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I'm on the fence about adding commands for Windows for this installation method until and unless we have feedback confirming that a fully functional Plone site is running.
If we do go about it, then I would prefer to use Sphinx Design's synchronized tabs to better display the options, as in this example, with Linux as the default selected tab.
I am closing the pull request and moving this discussion to the forums. Thank you for your time and guidance! I learnt a lot today. |
Description
I made this contributing as I was trying to install Plone with pip on my Windows laptop to test its feature. These are fixes to errors I faced along the way.
The command
venv/bin/
is for Linux/MacOSFor Windows it is
.\venv\Scripts
Plus I was facing issues with pipx run cookie cutter.
If you're already in a venv, you can install cookiecutter with pip, so I added instructions for that.
Page which was modified
https://6.docs.plone.org/admin-guide/install-pip.html
📚 Documentation preview 📚: https://plone6--1858.org.readthedocs.build/admin-guide/install-pip.html