====== Information ======

  * DokuWiki ((https://www.dokuwiki.org))
  * [[Information:Realm of Espionage]]
  * https://wiki.realmofespionage.xyz ((you are here :p))

===== Prerequisites =====

  * [[windows;10|Windows 10 (21H2)]]
  * [[servers;windows;nginx_php_php-cgi|nginx + PHP + PHP-CGI]]
  * [[servers;windows;nginx;lets_encrypt|Certbot (Let's Encrypt)]]
  * [[programs;windows;git|Git]]

====== Dependencies ======

  * https://www.dokuwiki.org/requirements
  * https://www.dokuwiki.org/install:php
  * https://github.com/dokuwiki/dokuwiki/blob/master/composer.json

====== Download Source ======

  * https://github.com/dokuwiki/dokuwiki/commits/master/

  "%ProgramFiles%\Git\bin\git.exe" clone --branch "master" --depth "1" --recurse-submodules "https://github.com/splitbrain/dokuwiki.git" "%SystemDrive%\www\wiki"

====== Environment ======

===== PHP =====

  "notepad.exe" "%SystemDrive%\www\php\wiki.ini"

<code>
[PHP]
extension_dir = ".\ext"
extension = "bz2"
extension = "gd"
extension = "intl"
extension = "mbstring"
extension = "openssl"
extension = "sodium"

error_reporting = "~E_ALL"
display_errors = "Off"
log_errors = "Off"

[Date]
date.timezone = "America/New_York"

; End</code>

  "php.exe" -c "%SystemDrive%\www\php\wiki.ini" -m

====== nginx + PHP-CGI Configuration ======

===== PHP-CGI =====

  "notepad.exe" "%SystemDrive%\www\nginx\default.d\wiki.conf"

<code>
location "~" "\.(php)(/.*)?$" {

 fastcgi_split_path_info "^(.+\.(?:php))(/.*)$";
 fastcgi_intercept_errors "on";
 fastcgi_index "doku.php";
 include "C:/www/nginx/conf/fastcgi_params";
 fastcgi_param "SCRIPT_FILENAME" "$document_root$fastcgi_script_name";
 fastcgi_param "PATH_INFO" "$fastcgi_path_info";
 fastcgi_param "HTTPS" "on";

 fastcgi_pass "127.0.0.1:9002";
 
}

# End</code>

===== Server Block =====

  "notepad.exe" "%SystemDrive%\www\nginx\vhosts.d\wiki.conf"

<code>
server {

 listen "443" "ssl";
 http2 "on";
 server_name "wiki.realmofespionage.xyz";
 root "C:/www/wiki";
 index "doku.php";

 include "C:/www/nginx/default.d/wiki.conf";
 include "C:/www/nginx/default.d/headers.conf";

 client_max_body_size "10M";

 add_header "Content-Security-Policy" "default-src 'self'; script-src 'self' 'unsafe-inline'; style-src 'self' 'unsafe-inline'; img-src 'self' data:" "always";

# access_log "logs/wiki-access.log";
# error_log "logs/wiki-error.log";

# location = "/install.php" {
#  deny "all";
# }

# location "~" "/(conf|bin|inc)/" {
#  deny "all";
# }

# location "~" "/data/" {
#  internal;
# }

 location "/" {
  try_files "$uri" "$uri/" "@dokuwiki";
 }

 location "@dokuwiki" {
  rewrite "^/_media/(.*)" "/lib/exe/fetch.php?media=$1" "last";
  rewrite "^/_detail/(.*)" "/lib/exe/detail.php?media=$1" "last";
  rewrite "^/_export/([^/]+)/(.*)" "/doku.php?do=export_$1&id=$2" "last";
  rewrite "^/(.*)" "/doku.php?id=$1&$args" "last";
 }

}

# End</code>

  "%SystemDrive%\www\scripts\nginx\Reload.bat"

====== Scripts ======

  MKDIR "%SystemDrive%\www\scripts\wiki"

  "explorer.exe" "%SystemDrive%\www\scripts\wiki"

===== PHP-CGI =====

  "notepad.exe" "%SystemDrive%\www\scripts\wiki\PHP-CGI.bat"

<code>
@echo off

SET "PHP_FCGI_MAX_REQUESTS=0"
SET "PHP_FCGI_CHILDREN=1"

START "Wiki PHP-CGI" /MIN "php-cgi.exe" -b "127.0.0.1:9002" -c "%SystemDrive%\www\php\wiki.ini" -q

:: End</code>

  "%SystemDrive%\www\scripts\wiki\PHP-CGI.bat"

===== Update =====

  "notepad.exe" "%SystemDrive%\www\scripts\wiki\Update.bat"

<code>
@echo off

TITLE Wiki Updater

"%ProgramFiles%\Git\bin\git.exe" -C "%SystemDrive%\www\wiki" reset --hard "origin/master"
"%ProgramFiles%\Git\bin\git.exe" -C "%SystemDrive%\www\wiki" pull origin "master" --rebase

"php.exe" "%SystemDrive%\www\wiki\bin\indexer.php" --clear

:: End</code>

  "%SystemDrive%\www\scripts\wiki\Update.bat"

===== Back-up =====

  * ''D:\Servers\Scheduled Backups''

  "notepad.exe" "%SystemDrive%\www\scripts\wiki\Back-up.bat"

<code>
@echo off

TITLE Wiki Back-up

:: User\Downloads
::"tar.exe" -czf "%UserProfile%\Downloads\dokuwiki-files-auto-%RANDOM%.tar.gz" -C "%SystemDrive%\www\wiki" "data/pages" "data/meta" "data/media" "data/media_meta" "data/attic" "data/media_attic" "conf"

:: NAS
"tar.exe" -czf "D:\Servers\Scheduled Backups\dokuwiki-files-auto-%RANDOM%.tar.gz" -C "%SystemDrive%\www\wiki" "data/pages" "data/meta" "data/media" "data/media_meta" "data/attic" "data/media_attic" "conf"

:: End</code>

  "%SystemDrive%\www\scripts\wiki\Back-up.bat"

===== Maintenance =====

  "notepad.exe" "%SystemDrive%\www\scripts\wiki\Maintenance.bat"

<code>
@echo off

TITLE Wiki Maintenance

CALL "%SystemDrive%\www\scripts\wiki\Git Fix.bat"

:: End</code>

  "%SystemDrive%\www\scripts\wiki\Maintenance.bat"

===== Git Fix =====

  * :!: Set email for ''user.email''

  "notepad.exe" "%SystemDrive%\www\scripts\wiki\Git Fix.bat"

<code>
@echo off

TITLE Wiki Git Fix

RMDIR /S /Q "%SystemDrive%\www\wiki\.git"

"%ProgramFiles%\Git\bin\git.exe" -C "%SystemDrive%\www\wiki" init --initial-branch="master"
"%ProgramFiles%\Git\bin\git.exe" -C "%SystemDrive%\www\wiki" add "."
"%ProgramFiles%\Git\bin\git.exe" -C "%SystemDrive%\www\wiki" config "user.email" "espionage724@x"
"%ProgramFiles%\Git\bin\git.exe" -C "%SystemDrive%\www\wiki" commit --message="x"

"%ProgramFiles%\Git\bin\git.exe" -C "%SystemDrive%\www\wiki" remote add "origin" "https://github.com/dokuwiki/dokuwiki.git"
"%ProgramFiles%\Git\bin\git.exe" -C "%SystemDrive%\www\wiki" pull --depth "1" --recurse-submodules "origin" "master" --rebase
"%ProgramFiles%\Git\bin\git.exe" -C "%SystemDrive%\www\wiki" reset --hard "origin/master"

"%ProgramFiles%\Git\bin\git.exe" -C "%SystemDrive%\www\wiki" gc --aggressive --prune="all"
"%ProgramFiles%\Git\bin\git.exe" -C "%SystemDrive%\www\wiki" fsck --full --strict

:: End</code>

  "%SystemDrive%\www\scripts\wiki\Git Fix.bat"

====== Shortcuts ======

===== Autostart =====

==== PHP-CGI ====

  "explorer.exe" "%AppData%\Microsoft\Windows\Start Menu\Programs\StartUp"

  "%SystemDrive%\www\scripts\wiki\PHP-CGI.bat"

  Wiki PHP-CGI

====== Task Scheduler ======

****

  taskschd.msc

===== Update =====

  * ''12:00:00 AM'' daily

  Wiki Update

  "%SystemDrive%\www\scripts\wiki\Update.bat"

===== Back-up =====

  * Weekly -> Recur every ''1'' weeks on ''Monday''
  * ''12:15:00 AM''

  Wiki File Back-up

  "%SystemDrive%\www\scripts\wiki\Back-up.bat"

===== Maintenance =====

  * Monthly -> All months -> Days: ''1''
  * ''12:30:00 AM''

  Wiki Maintenance

  "%SystemDrive%\www\scripts\wiki\Maintenance.bat"

====== Initial Setup ======

  * https://wiki.realmofespionage.xyz/install.php

====== Settings ======

===== Deny Directives =====

  * Uncomment commented sections (except logs)
  * Do after initial setup and check warning in Admin panel

  "notepad.exe" "%SystemDrive%\www\nginx\vhosts.d\wiki.conf"

  "%SystemDrive%\www\scripts\nginx\Reload.bat"

===== Admin =====

  * DokuWiki -> Advanced -> ''userewrite'': ''.htaccess''
  * Links -> ''target»extern'': ''_tab''

==== Template Style Settings ====

  * Alternative background color: ''#484848'' (dark gray)
  * The general link color: ''#3d8bff'' (blue)
  * Width of full site: ''85%''
  * Width of sidebar: ''25%''
  * :?: Color options may vary on the OS ((Windows doesn't show a HTML color code picker for the above ''#''s))

===== Double-hyphen Convert Disable =====

  * This prevents -- from becoming a – (long hyphen) which breaks some command's syntax

  "notepad.exe" "%SystemDrive%\www\wiki\conf\entities.local.conf"

<code>--      --</code>

====== Files ======

===== Backup =====

****

  "tar.exe" -czf "%UserProfile%\Downloads\dokuwiki-files-manual-%RANDOM%.tar.gz" -C "%SystemDrive%\www\wiki" "data/pages" "data/meta" "data/media" "data/media_meta" "data/attic" "data/media_attic" "conf"

====== TODOs ======

  * https://www.dokuwiki.org/plugin:searchindex
  * https://www.dokuwiki.org/interwiki

===== Find Orphaned Pages =====

  * https://www.dokuwiki.org/cli?s%5B%5D=wantedpages.php

  "php.exe" "%SystemDrive%\www\wiki\bin\wantedpages.php"

  "php.exe" "%SystemDrive%\www\wiki\bin\wantedpages.php" --help