Revision history for WikkaOnMacOSX


Revision [22866]

Last edited on 2016-05-20 07:38:42 by YanB [Replaces old-style internal links with new pipe-split links.]
Additions:
This page can now be found on the [[Docs:WikkaOnMacOSX | Wikka Documentation Server]].
An archive of [[http://wikkawiki.org/WikkaOnMacOSX/revisions | old revisions of this page]] is still available for reference.<<
Deletions:
This page can now be found on the [[Docs:WikkaOnMacOSX Wikka Documentation Server]].
An archive of [[http://wikkawiki.org/WikkaOnMacOSX/revisions
old revisions of this page]] is still available for reference.<<

Revision [18073]

Edited on 2008-01-27 02:34:53 by YanB [Migrated to doc server]
Additions:
<<===This page has moved===
This page can now be found on the [[Docs:WikkaOnMacOSX Wikka Documentation Server]].
Thanks for updating your bookmarks!
An archive of [[http://wikkawiki.org/WikkaOnMacOSX/revisions
old revisions of this page]] is still available for reference.<<
CategoryMigratedDocs
Deletions:
[[WikkaDocumentation Wikka Documentation]]
=====Installing Wikka Wiki on Mac OS X=====
>>**See also:**
~-[[WikkaInstallation Wikka installation instructions]]
>>{{image src="images/wikka_osx/apple.png" alt="Apple logo" title="Mac OS X"}}
Installing WikkaWiki to run on your Mac takes only a few minutes. All the installation is done through a web-based wizard and you should not need to open the terminal a single time. Once the installation is complete, you will have a full Wikka system running on your machine and ready to play with.
**Table of contents**
""<ol><li><a href="http://wikkawiki.org/WikkaOnMacOSX#hn_1._System_Requirements">System Requirements</a></li>
<li><a href="http://wikkawiki.org/WikkaOnMacOSX#hn_2._Get_the_package">Get the package</a></li>
<li><a href="http://wikkawiki.org/WikkaOnMacOSX#hn_3._Run_the_installation_wizard">Run the installation wizard</a></li>
<li><a href="http://wikkawiki.org/WikkaOnMacOSX#hn_4._Start_playing">Start playing</a></li>
<li><a href="http://wikkawiki.org/WikkaOnMacOSX#hn_5._Forthcoming">Forthcoming</a></li>
</ol>""
====1. System Requirements====
This tutorial assumes your machine is configured to allow installing [[PHP]]/MySQL applications:
~-**Mac OS X** - this tutorial was tested on a 10.3.9 version but should work on any version of OS X, starting from 10.3.
~-**Apache** - the Apache webserver is installed by default on Mac OS X.
~-**[[PHP]]** - the PHP extension is installed by default on your Mac starting from 10.3 (the latest package can be downloaded at [[http://www.entropy.ch/software/macosx/php/ entropy.ch]]).
~-**MySQL** - is not installed by default. The package and install instructions are available at [[http://www.entropy.ch/software/macosx/mysql/ entropy.ch]].
Note that in order to install WikkaWiki, you will be required to fill in your DB parameters (server, DB name, DB user, password).
To create a stand-alone server on your Mac, you can install Apache, PHP and MySQL without starting a script or having to change any configuration files by using [[http://www.mamp.info/en/index.php MAMP]] (open-source).
====2. Get the package====
Download the [[WhatsNew latest]] package from the Wikka website.

{{image class="border" src="images/wikka_osx/wikka_macosx0.jpg" alt="Wikka Installation Screenshot" title="Get the package"}}
Double-click on the downloaded package to unzip it
{{image class="border" src="images/wikka_osx/wikka_macosx0b.jpg" alt="Wikka Installation Screenshot" title="Unzip the package"}}
Copy the Wikka folder to a directory accessible from your localhost, for instance in the Sites folder of your user account:
{{image class="border" src="images/wikka_osx/wikka_macosx1.jpg" alt="Wikka Installation Screenshot" title="Move the Wikka folder to a directory accessible to your local server"}}
====3. Run the installation wizard====
First, open the Sharing panel from your System Preferences and make sure that **Personal Web Sharing** is **on** (this enables your apache server to serve content from your local Sites folder):
{{image class="border" src="images/wikka_osx/wikka_macosx1b.jpg" alt="Wikka Installation Screenshot" title="Make sure that Web Sharing is enabled"}}
Open your browser and point it to the localhost folder where you have copied the Wikka files, in our example: ##""http://localhost/~username/Wikka""##: the Wikka Installation Wizard will appear.
As a first step, you will need to enter your DB settings. You can choose a table prefix for your Wikka installation, in our example: ##mywiki_##
{{image class="border" src="images/wikka_osx/wikka_macosx2.jpg" alt="Wikka Installation Screenshot" title="Set your DB parameters"}}
Unless you want to modify the default settings for the [[SyntaxHighlighter syntax highlighter]] you can skip the **""GeSHi Configuration""** section and go directly to the **Wikka Site Configuration** section and add the name of your site and the starting page.
{{image class="border" src="images/wikka_osx/wikka_macosx3.jpg" alt="Wikka Installation Screenshot" title="Fill in some general information"}}
Add the required information in the **Administrative account configuration**. You can skip the **Wikka URL configuration** section ([[ModRewrite more information]]) and click on "Continue".
{{image class="border" src="images/wikka_osx/wikka_macosx4.jpg" alt="Wikka Installation Screenshot" title="Add an Admin login"}}
The wizard will try to //connect to your database// and create the Wikka tables: if you correctly filled in all the required DB parameters you should see the following screen. Click on "Continue" to continue the installation.
{{image class="border" src="images/wikka_osx/wikka_macosx5.jpg" alt="Wikka Installation Screenshot" title="The DB installation was successful!"}}
As a last step, the wizard will try to //write the system configuration// to a file called ##wikka.config.php## ([[ConfigurationOptions more information]]). If your Wikka folder is write-accessible to your server, you should see the following screen.
{{image class="border" src="images/wikka_osx/wikka_macosx6.jpg" alt="Wikka Installation Screenshot" title="The writing of the configuration was successful!"}}
If you get a write error alert, this means that the wizard is not able to save the configuration file. Two solutions are possible:
~1) make the Wikka folder write-accessible following the instructions given on the screen and retry
~1) simply copy the code in the gray block, paste it in a text editor and save it as wikka.config.php in the Wikka folder.
{{image class="border" src="images/wikka_osx/wikka_macosx6_failed.jpg" alt="Wikka Installation Screenshot" title="The writing of the configuration failed"}}
=====4. Start playing =====
If you arrived at this point, your WikkaWiki should be up and running. The default homepage will look like the following:
{{image class="border" src="images/wikka_osx/wikka_macosx7.jpg" alt="Wikka Installation Screenshot" title="The default Wikka homepage"}}
To start editing it, just double-click anywhere on the page: the edit screen will open to let you modify the content of the page.
{{image class="border" src="images/wikka_osx/wikka_macosx8.jpg" alt="Wikka Installation Screenshot" title="Edit the content of a wiki page"}}
Click on "Store" to save your modifications and you will be redirected to the modified page.
{{image class="border" src="images/wikka_osx/wikka_macosx9.jpg" alt="Wikka Installation Screenshot" title="Save and display the modified page"}}
=====5. Forthcoming=====
~-Installing Wikka on a dedicated virtual host on a Mac
~-Enabling URL rewriting on Mac OS X
**That's all folks...**
//...enjoy your Wikka!//
CategoryDocumentation

Revision [15637]

Edited on 2006-11-13 06:11:32 by YanB [adding link to MAMP]
Additions:
~-**Mac OS X** - this tutorial was tested on a 10.3.9 version but should work on any version of OS X, starting from 10.3.
To create a stand-alone server on your Mac, you can install Apache, PHP and MySQL without starting a script or having to change any configuration files by using [[http://www.mamp.info/en/index.php MAMP]] (open-source).
Deletions:
~-**Mac OS X** - this tutorial was tested on a 10.3.9 version but should work on any version of OS X, starting from 10.3.0.

Revision [14669]

Edited on 2006-06-22 06:08:55 by DarTar [minor link updating]
Additions:
Download the [[WhatsNew latest]] package from the Wikka website.
Deletions:
Download the [[http://prdownloads.sourceforge.net/wikka/ latest]] package from the Wikka website.

Revision [14668]

Edited on 2006-06-22 06:08:25 by DarTar [minor link updating]
Additions:
""<ol><li><a href="http://wikkawiki.org/WikkaOnMacOSX#hn_1._System_Requirements">System Requirements</a></li>
<li><a href="http://wikkawiki.org/WikkaOnMacOSX#hn_2._Get_the_package">Get the package</a></li>
<li><a href="http://wikkawiki.org/WikkaOnMacOSX#hn_3._Run_the_installation_wizard">Run the installation wizard</a></li>
<li><a href="http://wikkawiki.org/WikkaOnMacOSX#hn_4._Start_playing">Start playing</a></li>
<li><a href="http://wikkawiki.org/WikkaOnMacOSX#hn_5._Forthcoming">Forthcoming</a></li>
Deletions:
""<ol><li><a href="http://wikka.jsnx.com/WikkaOnMacOSX#hn_1._System_Requirements">System Requirements</a></li>
<li><a href="http://wikka.jsnx.com/WikkaOnMacOSX#hn_2._Get_the_package">Get the package</a></li>
<li><a href="http://wikka.jsnx.com/WikkaOnMacOSX#hn_3._Run_the_installation_wizard">Run the installation wizard</a></li>
<li><a href="http://wikka.jsnx.com/WikkaOnMacOSX#hn_4._Start_playing">Start playing</a></li>
<li><a href="http://wikka.jsnx.com/WikkaOnMacOSX#hn_5._Forthcoming">Forthcoming</a></li>

Revision [10042]

Edited on 2005-07-17 10:23:56 by DarTar [adding doc heading]
Additions:
[[WikkaDocumentation Wikka Documentation]]
=====Installing Wikka Wiki on Mac OS X=====
Deletions:
======Installing Wikka Wiki on Mac OS X======

Revision [10019]

Edited on 2005-07-16 08:54:49 by DarTar [adding links]
Additions:
Unless you want to modify the default settings for the [[SyntaxHighlighter syntax highlighter]] you can skip the **""GeSHi Configuration""** section and go directly to the **Wikka Site Configuration** section and add the name of your site and the starting page.
Add the required information in the **Administrative account configuration**. You can skip the **Wikka URL configuration** section ([[ModRewrite more information]]) and click on "Continue".
As a last step, the wizard will try to //write the system configuration// to a file called ##wikka.config.php## ([[ConfigurationOptions more information]]). If your Wikka folder is write-accessible to your server, you should see the following screen.
Deletions:
Unless you want to modify the default settings for the syntax highlighter you can skip the **""GeSHi Configuration""** section and go directly to the **Wikka Site Configuration** section and add the name of your site and the starting page.
Add the required information in the **Administrative account configuration**. You can skip the **Wikka URL configuration** section and click on "Continue".
As a last step, the wizard will try to //write the system configuration// to a file called ##wikka.config.php##. If your Wikka folder is write-accessible to your server, you should see the following screen.

Revision [10018]

Edited on 2005-07-16 08:50:09 by DarTar [minor]
Additions:
<li><a href="http://wikka.jsnx.com/WikkaOnMacOSX#hn_5._Forthcoming">Forthcoming</a></li>
=====5. Forthcoming=====
Deletions:
=====Forthcoming=====

Revision [10000]

Edited on 2005-07-15 19:27:54 by DarTar [adding Mac OS X tutorial]
Additions:
======Installing Wikka Wiki on Mac OS X======
Deletions:
======Installing Wikka on Mac OS X======

Revision [9997]

Edited on 2005-07-15 17:05:03 by DarTar [adding Mac OS X tutorial]
Additions:
Installing WikkaWiki to run on your Mac takes only a few minutes. All the installation is done through a web-based wizard and you should not need to open the terminal a single time. Once the installation is complete, you will have a full Wikka system running on your machine and ready to play with.
Deletions:
Installing WikkaWiki to run on your Mac takes only a few minutes. Once the installation is complete, you will have a full Wikka system running on your machine and ready to play with.

Revision [9995]

Edited on 2005-07-15 17:01:41 by DarTar [adding Mac OS X tutorial]
Additions:
=====Forthcoming=====
~-Installing Wikka on a dedicated virtual host on a Mac
~-Enabling URL rewriting on Mac OS X

Revision [9994]

Edited on 2005-07-15 16:58:20 by DarTar [adding Mac OS X tutorial]
Additions:
This tutorial assumes your machine is configured to allow installing [[PHP]]/MySQL applications:
~-**[[PHP]]** - the PHP extension is installed by default on your Mac starting from 10.3 (the latest package can be downloaded at [[http://www.entropy.ch/software/macosx/php/ entropy.ch]]).
~-**MySQL** - is not installed by default. The package and install instructions are available at [[http://www.entropy.ch/software/macosx/mysql/ entropy.ch]].
Deletions:
This tutorial assumes your machine is configured to allow installing PHP/MySQL applications:
~-**PHP** - the PHP extension is installed by default on your Mac starting from 10.3 (the latest package can be downloaded at [[http://www.entropy.ch/software/macosx/php/ entropy.ch]]).
~-**""MySQL""** - is not installed by default. The package and install instructions are available at [[http://www.entropy.ch/software/macosx/mysql/ entropy.ch]].

Revision [9992]

The oldest known version of this page was created on 2005-07-15 16:51:00 by DarTar [adding Mac OS X tutorial]
Valid XHTML :: Valid CSS: :: Powered by WikkaWiki