User Tools

Site Tools


DokuWiki

DokuWiki is a simple to use and highly versatile Open Source wiki software that doesn't require a database. It is loved by users for its clean and readable syntax. The ease of maintenance, backup and integration makes it an administrator's favorite. Built in access controls and authentication connectors make DokuWiki especially useful in the enterprise context and the large number of plugins contributed by its vibrant community allow for a broad range of use cases beyond a traditional wiki. To get started, begin by downloading and extracting the latest archival copy (distribution tarball) of your DokuWiki’s files of PHP code. Press the download link and a GZ archive will be downloaded to your computer in the folder designated in your web browser’s preferences settings. In most cases that will be your “Downloads” folder.

Then follow the steps illustrated in the screencast install_new.swf. (https://www.dokuwiki.org/install:screencast)

To reiterate the above in a form that can be handled by Google Translate, see the following discussion:

Required software:

A regular web browser such as Firefox. (I discovered that Safari cannot handle all aspects of the user interface of the company that sells me its web hosting services and domain registration services. Opera seems to reject my Dokuwiki site without any valid reason being given.)

An archiving application. Macintosh computer users will find everything needed already just a double-click away.

An FTP client. I use Transmit on my Macintosh. Do a web search for “best free ftp clients” if you do not already have a favorite.

Step by Step

Download and extract the component documents of Dokuwiki as prepared for distribution to you. The vanilla link, the files that most beginning users of Dokuwiki, is http://download.dokuwiki.org/ When you make a selection and click on the related link, a gzip compressed tar archive of more than 3 MB will be delivered to your hard drive. If you can’t remember where your web browser deposits downloads, just search for “dokuwiki” or for files that have the file extension “tgz.” On a Macintosh, double-clicking on this “tarball” archive will activate “Archive Utility.” Other operating systems may require you to explicitly activate an archiving application.

After you have expanded the compressed file, you will discover a new folder called “dokuwiki” that is larger than 31 MB.

You must have a Domain, and you must have a URL established for a folder located under that domain. (There may be some necessary files relevant to your domain that need to be kept separate from your Dokuwiki site materials.)

When I open my stuff on the user interface provided by my web hosting system, I see something like this:

root
+stats
+Mikocosmos_Wiki_Stuff (a made-up name)
+Micocosmos_Website_Stuff (a made-up name)
+Old_Wiki_Stuff (for backup, does not have an URL)

There are also some files not in any folder, ones that pertain to root, e.g.:

.htaccess
favicon.ico

With the cooperation of my web host provider, things were arranged so that the URL

http∶∕∕www。Mikocosmos_Wiki.org

directs users to the folder Mikrocosmos_Wiki_Stuff
and

http∶∕∕www。Microcosmos _Website.org

directs users to the folder Microcosmos_Website_Stuff
and if you tried to access Old_Wiki_Stuff by entering
http∶∕∕www。Old_Wiki.org
you would get a rejection because there is no URL set up for that folder. You would have to pay for another domain to make that folder available via a URL.

Once you have everything set up on your account with your web host provider, you are ready to use your FTP client to move all of the files in the folder on your hard drive that your TGZ file was expanded into, the one that is about 31 MB in size.

You want to move all of the files in that folder into the remote folder just set up above, the one I have given the pseudonym Mikocosmos_Wiki_Stuff. (Call your folder whatever you want, just as long as your web host provider knows if you change that folder name so they can adjust things so the URL still points to that folder.)

Initializing your new wiki

Now you have a working DokuWiki. However, you can’t do much with it until the site is configured to reflect the name of your wiki, set yourself up as the administrator, give yourself a password, etc.

N.B. Don’t be a dummy like me and forget the password, the email address to use to send notifications to you, etc. Write or copy this stuff into separate document on your own computer, and print out a copy to save among your paper documents.

To begin this initiation process, go to your web browser and type in your new URL followed by a slash and “doku.php.” So that would be, using the above described pseudonymous URL for the new wiki:
http://www.Mikocosmos_Wiki.org/doku.php

You can only do this one time. After you’ve used it and then left the “doku.php” page, your new wiki site will be marked as “already installed,” and it won’t let you run doku.php again.

N.B.

Do not be mislead by directions such as, “Open the install.php file in your browser.” If you just type in “install.php” into the address field of your browser, you will get web search results for topics such as “PHP installation and Configuration,” You do not want to install a PHP compiler or interpreter on your home computer. Entering “http∶ ∕ ∕ www。install.php/“ will lead to the warning, “This site can’t be reached.” The correct entry is your URL followed by a slash and then by “install.php”.

N.B.

Do not be misled by instruction for using the installer, where it says,
“http∶ ∕ ∕[dokuwikiPath]/install.php”
because a path is different from a URL. You could actually get the path to your wiki folder if you ask your web host provider what it is. The path is complicated, and you couldn’t guess it. You don’t need it. You only need the URL.

Once you have finished and saved the install.php page, you will be able to access your new website by entering the simple URL into your web browser, so for the pseudonominous website, just enter:
http∶ ∕ ∕www。mikrocosmos_wiki.org

☼.txt · Last modified: 2022/09/29 01:42 by kc