Skip to content

Commit 8058b67

Browse files
dokuwiki_server.md (#2474)
* 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]>
1 parent d92bbfd commit 8058b67

File tree

1 file changed

+21
-21
lines changed

1 file changed

+21
-21
lines changed

docs/guides/cms/dokuwiki_server.md

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -16,19 +16,19 @@ tags:
1616
- Our example will use the [Apache Sites Enabled](../web/apache-sites-enabled.md) for setup. Review that if necessary.
1717
- This document will use "example.com" as the domain name throughout
1818
- 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
2020

2121
## Introduction
2222

2323
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.
2424

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).
2626

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.
2828

2929
## Installing dependencies
3030

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:
3232

3333
```bash
3434
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:
8787
</VirtualHost>
8888
```
8989

90-
Note that the "AllowOverride All" above, allows the `.htaccess` (directory specific security) file to work.
90+
Note that the "AllowOverride All" above allows the `.htaccess` (directory-specific security) file to work.
9191

9292
Go ahead and link the configuration file into sites-enabled, but do not start web services as yet:
9393

@@ -111,9 +111,9 @@ In your server, change to the root directory.
111111
cd /root
112112
```
113113

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)."
115115

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:
117117

118118
```bash
119119
wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz
@@ -125,7 +125,7 @@ Before we decompress the archive, examine the contents with `tar ztf`:
125125
tar ztvf dokuwiki-stable.tgz
126126
```
127127

128-
Notice the named dated directory ahead of all the other files that looks similar to this:
128+
Notice the named dated directory ahead of all the other files that look similar to this:
129129

130130
```text
131131
... (more above)
@@ -135,17 +135,17 @@ dokuwiki-2020-07-29/inc/lang/fr/recent.txt
135135
... (more below)
136136
```
137137

138-
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:
139139

140140
```bash
141141
tar xzf dokuwiki-stable.tgz --strip-components=1 -C /var/www/sub-domains/com.example/html/
142142
```
143143

144144
Once you have run this command, all of DokuWiki should be in your _DocumentRoot_.
145145

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.
147147

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:
149149

150150
```bash
151151
cp /var/www/sub-domains/com.example/html/.htaccess{.dist,}
@@ -159,15 +159,15 @@ chown -Rf apache.apache /var/www/sub-domains/com.example/html
159159

160160
## Setting up DNS or `/etc/hosts`
161161

162-
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.
163163

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:
165165

166166
```bash
167167
sudo vi /etc/hosts
168168
```
169169

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):
171171

172172
```bash
173173
127.0.0.1 localhost
@@ -182,7 +182,7 @@ ff02::1 ip6-allnodes
182182
ff02::2 ip6-allrouters
183183
```
184184

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.
186186

187187
## Starting `httpd`
188188

@@ -233,17 +233,17 @@ Your wiki is now ready for you to add content.
233233

234234
## Securing DokuWiki
235235

236-
Besides the ACL policy that you just created, consider:
236+
Besides the ACL policy that you just created, consider the following:
237237

238238
### Your `firewalld` firewall
239239

240240
!!! note
241241

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.
243243

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.
245245

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.
247247

248248
If you are using `firewalld` as your firewall, use the following rule syntax:
249249

@@ -280,8 +280,8 @@ trusted (active)
280280

281281
### SSL
282282

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).
284284

285285
## Conclusion
286286

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

Comments
 (0)