From: Carsten K. <car...@us...> - 2001-12-31 01:46:07
|
Update of /cvsroot/phpwiki/phpwiki/doc In directory usw-pr-cvs1:/tmp/cvs-serv10288 Modified Files: INSTALL.MacOSX Log Message: minor reformatting with emacs Index: INSTALL.MacOSX =================================================================== RCS file: /cvsroot/phpwiki/phpwiki/doc/INSTALL.MacOSX,v retrieving revision 1.10 retrieving revision 1.11 diff -C2 -r1.10 -r1.11 *** INSTALL.MacOSX 2001/12/31 00:38:02 1.10 --- INSTALL.MacOSX 2001/12/31 01:46:04 1.11 *************** *** 1,2 **** --- 1,3 ---- + Using PhpWiki 1.3 with Mac OS X / Darwin *************** *** 26,36 **** don't rely on PB's text colors too much, it doesn't always properly handle coloring for \"escaped quotes\" which are frequently called for ! in PHP when generating HTML code. \\" <--(kludge for broken syntax coloring) Instructions for using Project Builder with PhpWiki can be found at the bottom of this document. Database -------- A suitable database for PhpWiki is not included with Mac OS X 10.1. If you decide to use one of the more popular (and free) database packages --- 27,40 ---- don't rely on PB's text colors too much, it doesn't always properly handle coloring for \"escaped quotes\" which are frequently called for ! in PHP when generating HTML code. ! \\" <--(kludge for broken syntax coloring) Instructions for using Project Builder with PhpWiki can be found at the bottom of this document. + Database -------- + A suitable database for PhpWiki is not included with Mac OS X 10.1. If you decide to use one of the more popular (and free) database packages *************** *** 47,50 **** --- 51,55 ---- Apache PHP Module ----------------- + The default PHP module for Apache as supplied by Apple does work with PhpWiki but is missing support for the zlib and GD libraries. Wiki *************** *** 76,79 **** --- 81,85 ---- Obtaining and Installing mySQL and libphp4.so --------------------------------------------- + Mark Liyanage has graciously provided precompiled Mac OS X versions of mySQL, an updated PHP module for Apache and some installation *************** *** 81,85 **** want to compile these programs for yourself. ! <http://www.entropy.ch/software/macosx/> Note that whether you use the built-in PHP module or another PHP --- 87,91 ---- want to compile these programs for yourself. ! <http://www.entropy.ch/software/macosx/> Note that whether you use the built-in PHP module or another PHP *************** *** 91,122 **** can be used with Mac OS X are listed at: ! <http://versiontracker.com/macosx/> PHP 4.1 and Mac OS X -------------------- The version of PHP 4.1 from Mark Liyanage's web site requires an updated PEAR library. PhpWiki seems to work anyway but it will produce ! warnings about a depreciated user function with each page load. Move ! the current contents of '/System/Library/PHP' into a backup folder, ! such as '/System/Library/PHP/PEAR-4.0.6'. Take the contents of the ! 'pear' folder from the official PHP 4.1 tarball (php-4.1.0.tar.gz) and ! move it into '/System/Library/PHP'. A precompiled PHP 4.1 module for ! Apache and the PearDB support files are also available at: ! <http://homepage.mac.com/carstenklapp/> PhpWiki Configuration Notes --------------------------- Move the phpwiki folder into the directory used by the web server. In Mac OS X 10.1 this folder will be "/Library/WebServer/Documents" ! (unless you previously changed it to somewhere else in the ! configuration file "/private/etc/httpd/httpd.conf"). Follow the generalized installation instructions described in INSTALL ! but with the changes below. - 1. The Mac OS X Apache web server runs as user "www" and this works fine with PhpWiki so long as "Everyone" has at least read-only --- 97,133 ---- can be used with Mac OS X are listed at: ! <http://versiontracker.com/macosx/> PHP 4.1 and Mac OS X -------------------- + The version of PHP 4.1 from Mark Liyanage's web site requires an updated PEAR library. PhpWiki seems to work anyway but it will produce ! warnings about a depreciated user function with each page load. ! ! 1. Move the current contents of '/System/Library/PHP' into a backup ! folder, such as '/System/Library/PHP/PEAR-4.0.6'. ! 2. Take the contents of the 'pear' folder from the official PHP 4.1 ! tarball (php-4.1.0.tar.gz) and move it into '/System/Library/PHP'. + A precompiled PHP 4.1 module for Apache and the PearDB support files + are also available at: + <http://homepage.mac.com/carstenklapp/> + + PhpWiki Configuration Notes --------------------------- + Move the phpwiki folder into the directory used by the web server. In Mac OS X 10.1 this folder will be "/Library/WebServer/Documents" ! (unless you previously changed it to somewhere else in the config file ! "/private/etc/httpd/httpd.conf"). Follow the generalized installation instructions described in INSTALL ! but with the changes to sections 1 and 2 listed below. 1. The Mac OS X Apache web server runs as user "www" and this works fine with PhpWiki so long as "Everyone" has at least read-only *************** *** 135,139 **** order to use "nice" URLs with PhpWiki such as: ! http://somehost/wiki?GoodStyle Open the terminal and type in the following to edit the web server --- 146,150 ---- order to use "nice" URLs with PhpWiki such as: ! http://somehost/wiki?GoodStyle Open the terminal and type in the following to edit the web server *************** *** 172,177 **** sudo apachectl graceful ! Next, edit the following lines in part five of index.php to match ! the following: define('DATA_PATH', '/wiki'); --- 183,188 ---- sudo apachectl graceful ! Next, edit the following lines in part five of index.php to match the ! following: define('DATA_PATH', '/wiki'); *************** *** 198,207 **** Using Apple's Project Builder with PhpWiki ! ------------------------------------------ A PB project file is ! available on the SourceForge CVS server to allow you to easily edit ! PhpWiki's source code using Apple's Project Builder. If you have not ! yet updated to PB 1.1.1 (Dec 2001 DevTools) it is highly recommended ! you do so because the PhpWiki source are written in ISO-8859-1, and ! some of the bug fixes are pertinent to file encoding. PB 1.1 has some bugs which makes it impossible to select the correct --- 209,220 ---- Using Apple's Project Builder with PhpWiki ! ------------------------------------------ ! ! A PB project file is available on the SourceForge CVS server to allow ! you to easily edit PhpWiki's source code using Apple's Project ! Builder. If you have not yet updated to PB 1.1.1 (Dec 2001 DevTools) ! it is highly recommended you do so because the PhpWiki source are ! written in ISO-8859-1, and some of the bug fixes are pertinent to file ! encoding. PB 1.1 has some bugs which makes it impossible to select the correct *************** *** 222,230 **** contains your "phpwiki" folder. Project Builder 1.1.1 can be used with Sourceforge's CVS but there is ! a little bit of work to get it set up the first time. The following instructions were based on a tip from macosxhints.com. Preparation: Checkout phpwiki with the cvs command line tools. Make sure that your ssh keys have been uploaded to your account at Sourceforge and that --- 235,248 ---- contains your "phpwiki" folder. + + How to use SSH with Project Builder + ----------------------------------- + Project Builder 1.1.1 can be used with Sourceforge's CVS but there is ! a little bit of work to get it set up the first time. The following instructions were based on a tip from macosxhints.com. Preparation: + Checkout phpwiki with the cvs command line tools. Make sure that your ssh keys have been uploaded to your account at Sourceforge and that *************** *** 232,235 **** --- 250,254 ---- Instructions: + 1. Download and install "keychain" from: *************** *** 239,244 **** easily have one long-running ssh-agent process per system, rather than per login session. This dramatically reduces the number of times you ! need to enter your passphrase from once per new login session to once ! every time your local machine is rebooted. 2. Add the following to your .cshrc file (if you use the default tcsh --- 258,263 ---- easily have one long-running ssh-agent process per system, rather than per login session. This dramatically reduces the number of times you ! need to enter your passphrase, from once per new terminal window ! session to once every time your local machine is rebooted. 2. Add the following to your .cshrc file (if you use the default tcsh *************** *** 255,258 **** --- 274,278 ---- (bash users would substitute the following lines in the above script for their .bashrc file:) + CVS_RSH=ssh; EXPORT CVS_RSH source ~/.ssh-agent-${HOSTNAME} *************** *** 260,281 **** 3. Close the terminal window then open a new one. Keychain will ! activate ssh-agent which will ask for your ssh key password. It keeps ! running in the background and won't ask for your password again until ! you log out or restart. 4. From now on, YOU MUST open Project Builder from the Terminal shell ! for it's CVS to work with SSH. This is why We created a command alias ! in .cshrc to launch Project Builder. If it is already running because ! you double-clicked the PB icon, quit it, then launch it from the terminal ! by typing pb. Once PB is running you can safely double-click a ! project file to open it. Using the above method, ProjectBuilder will successfully connect to ! the Sourceforge CVS with SSH. Any other server which requires ssh ! instead of rsh should work too. Emacs Users: You can add custom Alt-key bindings to Project Builder ! for some common Emacs stuff: *Note the wrapped url! http://developer.apple.com/techpubs/macosx/Cocoa/TasksAndConcepts/ ProgrammingTopics/TextDisplay/Tasks/TextDefaultsAndBindings.html --- 280,313 ---- 3. Close the terminal window then open a new one. Keychain will ! activate ssh-agent which will ask for your ssh key password. It ! keeps running in the background and won't ask for your password ! again until you log out or restart. 4. From now on, YOU MUST open Project Builder from the Terminal shell ! for it's CVS to work with SSH. This is why We created a command ! alias in .cshrc to launch Project Builder. If it is already running ! because you double-clicked the PB icon, quit it, then launch it ! from the terminal by typing pb. Once PB is running you can safely ! double-click a project file to open it. Using the above method, ProjectBuilder will successfully connect to ! the Sourceforge CVS with SSH. Any other server which requires cvs ! connections via ssh instead of rsh should work too. ! ! Note: Renaming /usr/bin/rsh and replacing it with ssh doesn't seem to ! work; Project Builder simply MUST be launched from the command line ! for it to work at all with ssh. ! ! Hopefully SSH support will be improved in the future. Send an email ! to: mac...@gr... to let the team know that ! full support for SSH in Project Builder is important. + Emacs Key Bindings for Project Builder + -------------------------------------- + Emacs Users: You can add custom Alt-key bindings to Project Builder ! for some common Emacs stuff: *Note the wrapped url! ! http://developer.apple.com/techpubs/macosx/Cocoa/TasksAndConcepts/ ProgrammingTopics/TextDisplay/Tasks/TextDefaultsAndBindings.html *************** *** 289,294 **** $Id$ - - - - --- 321,322 ---- |