You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
* dokuwiki_server.md
Grammar Check
* Update dokuwiki_server.md
@gannazhyrnova reverted one change as it introduced passive voice and also changed the meaning.
---------
Co-authored-by: sspencerwire <[email protected]>
Copy file name to clipboardExpand all lines: docs/guides/cms/dokuwiki_server.md
+21-21Lines changed: 21 additions & 21 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -16,19 +16,19 @@ tags:
16
16
- Our example will use the [Apache Sites Enabled](../web/apache-sites-enabled.md) for setup. Review that if necessary.
17
17
- This document will use "example.com" as the domain name throughout
18
18
- You must be root or able to `sudo` to elevate privileges
19
-
- Assuming a fresh install of the operating system, however that is not a requirement
19
+
- Assuming a fresh install of the operating system, however, that is not a requirement
20
20
21
21
## Introduction
22
22
23
23
Documentation can take many forms in an organization. Having a repository that you can reference for that documentation is invaluable. A wiki (meaning _quick_ in Hawaiian), is a way to keep documentation, process notes, corporate knowledge bases, and even code examples, in a centralized location. IT professionals who keep a wiki, even secretly, have a built-in insurance policy against forgetting an obscure routine.
24
24
25
-
DokuWiki is a mature, fast, wiki that runs without a database, has built-in security features, and is not complex to deploy. For more information, examine their [web page](https://www.dokuwiki.org/dokuwiki).
25
+
DokuWiki is a mature, fast wiki that runs without a database, has built-in security features, and is not complex to deploy. For more information, examine their [web page](https://www.dokuwiki.org/dokuwiki).
26
26
27
-
DokuWiki is just one of many wikis available, though it is a pretty good one. One big pro is that DokuWiki is relatively lightweight and can run on a server that is already running other services, provided you have space and memory available.
27
+
DokuWiki is one of many wikis available, though it is a good one. One big pro is that DokuWiki is relatively lightweight and can run on a server that is already running other services, provided you have available space and memory.
28
28
29
29
## Installing dependencies
30
30
31
-
The minimum PHP version for DokuWiki is now 7.2, which is exactly what Rocky Linux 8 has by default. Because of modules, Rocky Linux 8 can install up to version 8.2. Rocky Linux 9.0 has PHP version 8.0 by default, and modules that allow up to 8.2. Note that some of the packages listed here might already exist:
31
+
The minimum PHP version for DokuWiki is now 7.2, which Rocky Linux 8 has by default. Because of the modules, Rocky Linux 8 can install up to version 8.2. Rocky Linux 9.0 has PHP version 8.0 by default and modules that allow up to 8.2. Note that some of the packages listed here might already exist:
32
32
33
33
```bash
34
34
dnf install tar wget httpd php php-gd php-xml php-json php-mbstring
@@ -87,7 +87,7 @@ That configuration file will be similar to this:
87
87
</VirtualHost>
88
88
```
89
89
90
-
Note that the "AllowOverride All" above, allows the `.htaccess` (directoryspecific security) file to work.
90
+
Note that the "AllowOverride All" above allows the `.htaccess` (directory-specific security) file to work.
91
91
92
92
Go ahead and link the configuration file into sites-enabled, but do not start web services as yet:
93
93
@@ -111,9 +111,9 @@ In your server, change to the root directory.
111
111
cd /root
112
112
```
113
113
114
-
Since your environment is ready to go, get the latest stable version of DokuWiki. You can find this by going to [the download page](https://download.dokuwiki.org/) and on the left side of the page under "Version" you will see "Stable (Recommended) (direct link)."
114
+
Since your environment is ready to go, get the latest stable version of DokuWiki. You can find this by going to [the download page](https://download.dokuwiki.org/), and on the left side of the page, under "Version," you will see "Stable (Recommended) (direct link)."
115
115
116
-
Right-click on the "(direct link)" portion of this and copy the link. In the console of your DokuWiki server, type `wget` and a space and then paste in your copied link in the terminal. You should get something similar to this:
116
+
Right-click on the "(direct link)" portion of this and copy the link. In the console of your DokuWiki server, type `wget` and a space and then paste your copied link into the terminal. You should get something similar to this:
You do not want that leading named directory when decompressing the archive, so you are going to use some options with `tar` to exclude it. The first option is the "--strip-components=1" that removes the leading directory. The second option is the "-C" option that tells `tar` where you want the archive decompressed to. The decompression will be similar to this:
138
+
You do not want that leading named directory when decompressing the archive, so you will use some options with `tar` to exclude it. The first option is the "--strip-components=1" that removes the leading directory. The second option is the "-C" option, which tells `tar` where you want the archive decompressed. The decompression will be similar to this:
139
139
140
140
```bash
141
141
tar xzf dokuwiki-stable.tgz --strip-components=1 -C /var/www/sub-domains/com.example/html/
142
142
```
143
143
144
144
Once you have run this command, all of DokuWiki should be in your _DocumentRoot_.
145
145
146
-
You need to make a copy of the _.htaccess.dist_ file that came with DokuWiki and keep the old one there too, in case you need to revert to the original in the future.
146
+
You need to make a copy of the _.htaccess.dist_ file that came with DokuWiki and keep the old one there, in case you need to revert to the original.
147
147
148
-
In the process, you will be changing the name of this file to _.htaccess_. This is what _apache_ will be looking for. To do this:
148
+
In the process, you will change this file's name to _.htaccess_. This is what _apache_ will be looking for. To do this:
Before you will be able to access the DokuWiki interface, you will need to set name resolution for this site. For testing purposes, you can use your _/etc/hosts_ file.
162
+
Before you can access the DokuWiki interface, you must set the name resolution for this site. You can use your _/etc/hosts_ file for testing purposes.
163
163
164
-
In this example, assume that DokuWiki will be running on a private IPv4 address of 10.56.233.179. Assume you are modifying the _/etc/hosts_ file on a Linux workstation as well. To do this, run:
164
+
In this example, assume that DokuWiki will run on a private IPv4 address of 10.56.233.179. Assume you are also modifying the _/etc/hosts_ file on a Linux workstation. To do this, run:
165
165
166
166
```bash
167
167
sudo vi /etc/hosts
168
168
```
169
169
170
-
Then change your hosts file to look similar to this (note the IP address above in the example):
170
+
Then change your host file to look similar to this (note the IP address above in the example):
171
171
172
172
```bash
173
173
127.0.0.1 localhost
@@ -182,7 +182,7 @@ ff02::1 ip6-allnodes
182
182
ff02::2 ip6-allrouters
183
183
```
184
184
185
-
Once you have finished testing and are ready to take things live for everyone, you will need to add this host to a DNS server. You could do this by using a [Private DNS Server](../dns/private_dns_server_using_bind.md), or a public-facing DNS server.
185
+
Once you have finished testing and are ready to take things live for everyone, you must add this host to a DNS server. You could use a [Private DNS Server](../dns/private_dns_server_using_bind.md), or a public-facing DNS server.
186
186
187
187
## Starting `httpd`
188
188
@@ -233,17 +233,17 @@ Your wiki is now ready for you to add content.
233
233
234
234
## Securing DokuWiki
235
235
236
-
Besides the ACL policy that you just created, consider:
236
+
Besides the ACL policy that you just created, consider the following:
237
237
238
238
### Your `firewalld` firewall
239
239
240
240
!!! note
241
241
242
-
This firewall example make no assumptions about what other services you might need to allow on your Dokuwiki server. These rules are based on your testing environment and **ONLY** deal with allowing access to a LOCAL network ip block. You will need more services allowed for a production server.
242
+
This firewall example does not assume what other services you might need to allow on your DokuWiki server. These rules are based on your testing environment and **ONLY** deal with allowing access to a LOCAL network IP block. You will need more services allowed for a production server.
243
243
244
-
Before you call everything done, you need to think about security. First, you should be running a firewall on the server.
244
+
Before you call everything done, you need to consider security. First, you should run a firewall on the server.
245
245
246
-
The assumption here is that anyone on the 10.0.0.0/8 network is on your private Local Area Network, and that those are the only people who need access to the site.
246
+
The assumption is that anyone on the 10.0.0.0/8 network is on your private Local Area Network and that those are the only people who need access to the site.
247
247
248
248
If you are using `firewalld` as your firewall, use the following rule syntax:
249
249
@@ -280,8 +280,8 @@ trusted (active)
280
280
281
281
### SSL
282
282
283
-
For the best security, you should consider using an SSL for encrypted web traffic. You can purchase an SSL from an SSL provider or use [Let's Encrypt](../security/generating_ssl_keys_lets_encrypt.md).
283
+
You should consider using an SSL for encrypted web traffic for the best security. You can purchase an SSL from an SSL provider or use [Let's Encrypt](../security/generating_ssl_keys_lets_encrypt.md).
284
284
285
285
## Conclusion
286
286
287
-
Whether you need to document processes, company policies, program code, or something else, a wiki is a great way to get that done. DokuWiki is a product that is secure, flexible, easy to use, relatively easy to install and deploy, and is a stable project that has been around for many years.
287
+
Whether you need to document processes, company policies, program code, or something else, a wiki is a great way to do it. DokuWiki is a secure, flexible, easy-to-use product that is also relatively easy to install and deploy. It is also a stable project that has been around for many years.
0 commit comments