====== Extracting the DokuWiki tgz ======

[[wiki:DokuWiki]] is distributed in a [[man>gzip]]'ed [[man>tar]] archive, often called tgz or tarball. This is a very common UNIX archiving format similar to the popular ZIP format many Windows user probably know. Here is how to extract such a file in different Operating Systems.

===== Unix/Linux Users =====

Probably all of you can use the following:

  tar -xzvf dokuwiki-YYYY-MM-DD.tgz

This will extract the tarball in the current directory.

On some non-Linux systems you might find the GNU [[man>tar]] program under the name ''gtar'', therefore use:

  gtar -xzvf dokuwiki-YYYY-MM-DD.tgz

If this does not work for you because you are on some proprietary Unix system the following should work but you probably know that better anyway ;-)

  cat dokuwiki-YYYY-MM-DD.tgz |gzip -d | tar -xf -



===== Windows Users =====

Windows-Users may need to rename the file from ''dokuwiki-YYYY-MM-DD.tgz'' to ''dokuwiki-YYYY-MM-DD.tar.gz'' to make their archive tool recognize the file format correctly (See [[bug>209]]).

To extract the tarball you need an extraction tool. There are hundreds of different programs available and there is a good chance that you already have one. If not, here is a short selection:

  * [[http://www.7-zip.org|7-Zip]] Free and Open Source
  * [[http://peazip.sourceforge.net/|PeaZip]] Free and Open Source
  * [[http://www.tugzip.com|TUGZip]] Freeware
  * [[http://www.paehl.de/german.php|Simplyzip]] German Freeware
  * [[http://www.winzip.com|WinZIP]] Shareware
  * [[http://www.rarlab.com/|WinRAR]] Shareware
  * [[http://www.winace.com/|WinACE]] Shareware

===== Mac Users =====

Usually double-clicking on the .tgz file will extract it. Since Mac OS X has a unixoid system under the hood, the description for Linux/Unix above works in the Terminal.app. StuffIt Expander version 8.02 and higher handles .tgz correctly. Earlier versions of Stuffit Expander may as well. 

---