לפעמים אני נתקל במקרים שאנשי הקוד הפתוח פשוט לא מבינים מאיפה אנשי ווינדווס מגיעים. תקראו לזה איך שאתם רוצים (אם אתם אנשי אופן סורס אז תקראו לזה עצלנים, שטחיים, אם אתם אנשי ווינדוס תקראו לזה פרקטיים שמתעסקים במה שחשוב) – אין לי ספק שבסופו של דבר מפסידים שני הצדדים – אנשי החלונות לא משתמשים במוצרים טובים ואנשי האופן סורס נתקלים בתקרת זכוכית בהפצה.
אחת הפעמים הללו קרתה היום בבוקר, כשרציתי להתקין את המסמכים (documentation) של דג’נגו לוקלית בלפטופ שלי לקראת טיסה לחו”ל בה הרשת לא תהיה זמינה. הפרטים ברשת היו די ברורים: התקן דג’נגו והרץ make על הMakefile שבספריית הDOCS. כמובן, אין make בהתקנה רגילה של ווינדוס, וכאן הדברים מתחילים להסתבך. אז הנה הסבר צעד אחר צעד אם גם אתם נתקלים בבעיה.
אני מניח שיש לכם python ו-django מותקנים במערכת.
המטרה שלכם – להפוך את ספריית הdocs המותקנת בדג’נגו לספריית html או PDF, עם קישורים, תמונות וכו.
הפורמט של הספרייה הזו הוא sphinx, אבל כמו שהאתר אומר, השיטה הקלה ביותר להתקין ספינקס היא ע”י שימוש בפקודה
easy_install -U Sphinx
שבשבילה צריך להוריד את easy_install (אם אין לכם עדיין). כאן יש תחכום עדין ולא ברור שבו יש הורדה שונה לכל גירסת פייטון המותקנת לכם במערכת. מוזר מאוד. ההתקנה תכשל אם תורידו את הגירסה הלא נכונה. עד כמה שיכולתי לראות, ההבדל היחידי בהתקנות הוא הספרייה בה מחפשים את הפייטון בregistry. אחחח.
אם יש לכם windows 7 ב64 ביט, יש באג בהתקנה של פייטון. עליכם לערוך בצורה ידנית את הregistry: הוסיפו את ספריית הפייטון שלכם במפתח הזה: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Python\PythonCore\2.6\InstallPath
(כמובן שגירסת הפייטון תלויה במה שיש לכם).
חזרו לcommand, והתקינו את ספינקס (כאמור: easy_install –U Sphinx).
עכשיו, מתוך הספרייה הראשית של דג’נגו, הקישו (כדי ליצור html):
sphinx-build -b djangohtml docs html/
