Skip to content

Commit 84e5643

Browse files
committed
Fix nightly link and reorder win install docs.
1 parent 38d890a commit 84e5643

File tree

1 file changed

+64
-56
lines changed

1 file changed

+64
-56
lines changed

doc/sources/installation/installation-windows.rst

Lines changed: 64 additions & 56 deletions
Original file line numberDiff line numberDiff line change
@@ -13,73 +13,28 @@ See :ref:`install-nightly-win-dist`. See also :ref:`upgrade-win-dist`.
1313
.. warning::
1414

1515
Python 3.5 is currently not supported on Windows due to issues with MinGW and
16-
Python 3.5.
16+
Python 3.5. Support is not expected for some time. See
17+
`here <http://bugs.python.org/issue4709>`_ for details. If required,
18+
3.5 MSVC builds should be posssible, but have not been attempted.
1719

18-
What are wheels, pip and wheel
19-
------------------------------
20-
21-
To install Kivy wheels, `Python <https://www.python.org/downloads/windows/>`_ first
22-
needs to be installed. Multiple versions of Python can be installed side by side.
23-
24-
In Python, packages such as Kivy can be installed with the python package
25-
manager, `pip <https://pip.pypa.io/en/stable/>`_. Some packages such as Kivy
26-
require additional steps, such as compilation, when installing using the Kivy
27-
source code with pip. Wheels (with a ``.whl`` extension) are pre-built
28-
distributions of a package that has already been compiled and do not require
29-
additional steps to install.
30-
31-
When hosted on `pypi <https://pypi.python.org/pypi>`_ one installs a wheel
32-
using ``pip``, e.g. ``python -m pip install kivy``. When downloading and installing
33-
a wheel directly, ``python -m pip install wheel_file_name`` is used, such as:
34-
35-
``python -m pip install C:\Kivy-1.9.1.dev-cp27-none-win_amd64.whl``
36-
37-
38-
Kivy's dependencies
39-
-------------------
40-
41-
We offer wheels for Kivy and its dependencies separately so only desired
42-
dependencies need be installed. The dependencies are offered as
43-
`namespace <https://www.python.org/dev/peps/pep-0420/>`_
44-
packages of Kivy.deps, e.g. ``kivy.deps.sdl2``.
45-
46-
Currently on Windows, we provide the following dependency
47-
wheels: ``gstreamer`` for audio and video and `glew` and ``sdl2`` for graphics
48-
and control. ``gstreamer`` is an optional dependency which only needs to be
49-
installed if video display is desired.
50-
51-
Command line
52-
------------
53-
54-
Know your command line. To execute any of the ``pip``
55-
or ``wheel`` commands, one needs a command line tool with python on the path.
56-
The default command line on Windows is
57-
`CMD <http://www.computerhope.com/issues/chusedos.htm>`_, but we recommend
58-
`Git for Windows <https://git-for-windows.github.io/>`_ which offers a bash
59-
command line as `well <http://rogerdudler.github.io/git-guide/>`_ as
60-
`git <https://try.github.io>`_. Note, CMD can still be used even if bash is
61-
installed.
62-
63-
Walking the path! To add your python to the path, simply open your command line
64-
and then us the ``cd`` command to change the current directory to where python is
65-
installed, e.g. ``cd C:\Python27``. Alternatively if you only have one python
66-
version installed, permanently add the python directory to the path for
67-
`CMD <http://www.computerhope.com/issues/ch000549.htm>`_ for
68-
`bash <http://stackoverflow.com/questions/14637979/how-to-permanently-set-path-on-linux>`_.
20+
To use Kivy you need `Python <https://www.python.org/downloads/windows/>`_.
21+
Multiple versions of Python can be installed side by side, but Kivy needs to
22+
be installed for each Python version that you want to use Kivy.
6923

7024
.. _install-win-dist:
7125

7226
Installation
7327
------------
7428

75-
Now that python is available on the command line, which can checked by typing
76-
``python --version``, do the following to install.
29+
Now that python is installed, open the :ref:`Command line` and make sure python
30+
is available by typing ``python --version``. Then, do the following to install.
7731

7832
#. Ensure you have the latest pip and wheel::
7933

8034
python -m pip install --upgrade pip wheel setuptools
8135

82-
#. Install the dependencies (skip gstreamer (~90MB) if not needed)::
36+
#. Install the dependencies (skip gstreamer (~90MB) if not needed, see
37+
:ref:`Kivy's dependencies`)::
8338

8439
python -m pip install docutils pygments pypiwin32 kivy.deps.sdl2 kivy.deps.glew \
8540
kivy.deps.gstreamer --extra-index-url https://kivy.org/downloads/packages/simple/
@@ -101,7 +56,7 @@ Nightly wheel installation
10156
issues during development. If you encounter any bugs, please report them.
10257

10358
Snapshot wheels of current Kivy master are created every night. They can be found
104-
`here <https://drive.google.com/drive/folders/0B1_HB9J8mZepOV81UHpDbmg5SWM>`_.
59+
`here <https://drive.google.com/folderview?id=0B1_HB9J8mZepOV81UHpDbmg5SWM&usp=sharing>`_.
10560
To use them, instead of doing `python -m pip install kivy` we'll install one of
10661
these wheels as follows.
10762

@@ -113,6 +68,59 @@ these wheels as follows.
11368
#. Install it with ``python -m pip install wheel-name`` where ``wheel-name``
11469
is the name of the renamed file.
11570

71+
72+
Kivy's dependencies
73+
-------------------
74+
75+
We offer wheels for Kivy and its dependencies separately so only desired
76+
dependencies need be installed. The dependencies are offered as
77+
`namespace <https://www.python.org/dev/peps/pep-0420/>`_
78+
packages of Kivy.deps, e.g. ``kivy.deps.sdl2``.
79+
80+
Currently on Windows, we provide the following dependency
81+
wheels: ``gstreamer`` for audio and video and `glew` and ``sdl2`` for graphics
82+
and control. ``gstreamer`` is an optional dependency which only needs to be
83+
installed if video display or audio is desired.
84+
85+
What are wheels, pip and wheel
86+
------------------------------
87+
88+
In Python, packages such as Kivy can be installed with the python package
89+
manager, `pip <https://pip.pypa.io/en/stable/>`_. Some packages such as Kivy
90+
require additional steps, such as compilation, when installing using the Kivy
91+
source code with pip. Wheels (with a ``.whl`` extension) are pre-built
92+
distributions of a package that has already been compiled and do not require
93+
additional steps to install.
94+
95+
When hosted on `pypi <https://pypi.python.org/pypi>`_ one installs a wheel
96+
using ``pip``, e.g. ``python -m pip install kivy``. When downloading and installing
97+
a wheel directly, ``python -m pip install wheel_file_name`` is used, such as::
98+
99+
python -m pip install C:\Kivy-1.9.1.dev-cp27-none-win_amd64.whl
100+
101+
Command line
102+
------------
103+
104+
Know your command line. To execute any of the ``pip``
105+
or ``wheel`` commands, one needs a command line tool with python on the path.
106+
The default command line on Windows is
107+
`CMD <http://www.computerhope.com/issues/chusedos.htm>`_, and the quickest way
108+
to open it is to press `Win+R` on your keyboard, type ``cmd``
109+
in the window that opens, and then press enter.
110+
111+
Alternate linux style command shells that we reccomend is
112+
`Git for Windows <https://git-for-windows.github.io/>`_ which offers a bash
113+
command line as `well <http://rogerdudler.github.io/git-guide/>`_ as
114+
`git <https://try.github.io>`_. Note, CMD can still be used even if bash is
115+
installed.
116+
117+
Walking the path! To add your python to the path, simply open your command line
118+
and then us the ``cd`` command to change the current directory to where python is
119+
installed, e.g. ``cd C:\Python27``. Alternatively if you only have one python
120+
version installed, permanently add the python directory to the path for
121+
`CMD <http://www.computerhope.com/issues/ch000549.htm>`_ for
122+
`bash <http://stackoverflow.com/questions/14637979/how-to-permanently-set-path-on-linux>`_.
123+
116124
.. _dev-install-win:
117125

118126
Use development Kivy

0 commit comments

Comments
 (0)