Opened 7 years ago

Closed 4 years ago

#6739 closed (fixed)

How to add symbolic links in Windows Vista

Reported by: kwill Owned by: nobody
Component: Documentation Version: master
Severity: Keywords: windows vista symbolic link installation development version svn
Cc: Triage Stage: Accepted
Has patch: no Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: UI/UX:

Description

On: http://www.djangoproject.com/documentation/install/

Section: Installing the development version

Point: 3. Next, make sure that the Python interpreter can load Django’s code.

A symbolic link can also be created in Windows Vista using the mklink command from the command prompt. Assuming the Python site-packages folder is at C:\Python25\Lib\site-packages and the trunk SVN is at d:\code\django-trunk, this can be done as follows:

  1. Open command line window in Administrator mode
  1. Go to site-packages directory (in our example C:\Python25\Lib\site-packages)
  1. Execute mklink /d django d:\code\django-trunk\django
  1. The output should appear as follows:
C:\Python25\Lib\site-packages>mklink /d django d:\code\django-trunk\django
symbolic link created for django <<===>> d:\code\django-trunk\django

C:\Python25\Lib\site-packages>dir
 Volume in drive C is SYSTEM
 Volume Serial Number is D038-E46A

 Directory of C:\Python25\Lib\site-packages

2008/03/09  11:03 AM    <SYMLINKD>     django [d:\code\django-trunk\django]
(plus more folders in site-packages)

Attachments (2)

tweak-install.diff (2.4 KB) - added by adamv 4 years ago.
Attempt at tweaking the install doc a bit.
6739.diff (5.1 KB) - added by SmileyChris 4 years ago.

Download all attachments as: .zip

Change History (7)

comment:1 Changed 7 years ago by jacob

  • Needs documentation unset
  • Needs tests unset
  • Patch needs improvement unset
  • Triage Stage changed from Unreviewed to Accepted

comment:2 Changed 4 years ago by adamv

mklink is available in Vista and later, but is not without problems. Share a folder containing links and then hit it with clients running XP, for instance. The Python docs ( http://docs.python.org/using/windows.html#finding-modules ) don't mention using mklinks on Windows either, so it is perhaps better to adhere to the tradition of installing directly into site-packages, using a .pth file, or adding a new folder to the PYTHONPATH, rather than suggest using mklinks.

comment:3 Changed 4 years ago by SmileyChris

Alternatively, I think the docs should just recommend creating a .pth file, as mentioned here: http://docs.python.org/install/index.html#modifying-python-s-search-path

comment:4 Changed 4 years ago by SmileyChris

And by "alternatively", I mean that I didn't read the whole of adamv's comment before replying. But yeah, my vote's for .pth

Changed 4 years ago by adamv

Attempt at tweaking the install doc a bit.

Changed 4 years ago by SmileyChris

comment:5 Changed 4 years ago by SmileyChris

  • Resolution set to fixed
  • Status changed from new to closed

(In [14686]) Fixes #6739 -- better development installation docs. Thanks to Adam Vandenberg for inspiration.

Note: See TracTickets for help on using tickets.
Back to Top