Modifications to DokuWiki

This is a log of modifications made to this DokuWiki install, that would not persist through updates.

Tweaks made to plugins. If plugin is updated, check if the modifications are still necessary, and recreate the modifications as needed.

Bootstrap Wrapper Plugin: https://www.dokuwiki.org/plugin:bootswrapper

Problem with PHP8 throwing errors. Note: The errors don't actually seem to impact anything, but still not ideal.

1. Grab a patched(-ish) version from GitHub here: https://github.com/41-north/dokuwiki-modifications/tree/main/plugins/bootswrapper
2. SFTP to NFSN/wiki.41n.co and navigate to /lib/plugins/bootswrapper
3. Replace the copies of script.js and /syntax on the server with the copies downloaded from the GitHub fork.
4. (If you have admin access), check the DokuWiki logs to see if bootswrapper is still throwing array errors.

Modifications to the DokuWiki core files, images, etc.

Modified .conf (configuration) files are located at https://github.com/41-north/dokuwiki-modifications/tree/main/conf_files.

As of 2024-12-31, the following modified .conf files are in use:

• interwiki.local.conf ^{DokuWiki Documentation}
• smileys.local.conf ^{DokuWiki Documentation}

Icon: Material Symbols open_in_new ^Link

Icon color #888888 / rgb(136 136 136)

Changing this icon involves tweaking the Bootstrap3 theme files. To make these changes:

1. Repossess the correct theme file (due to restrictive web server file permissions)
   1. Log in to the NFSN member portal.
   2. Go to Sites, select wiki.41n.co
   3. In Actions on the right, click on Repossess Files
   4. Paste in public/wiki.41n.co/lib/tpl/bootstrap3/css/template.less and hit Request Repossession
   5. Check the Recent Event Log to make sure that the request went through
2. Modify the CSS template file:
   1. Open the CSS template file: /home/public/wiki.41n.co/lib/tpl/bootstrap3/css/template.less
   2. Scroll down to lines 28-30, starts with a.urlextern
   3. Update line 29 the icon identifier is icon=mdi-earth-arrow-right.svg&color=%23666666
      1. TIP: See a modified copy of this file on GitHub.
   4. Save the file and push back to the server
3. Fix the file permissions back: chgrp web /home/public/wiki.41n.co/lib/tpl/bootstrap3/css/template.less

Icon: Octicons repo-locked ^Link

Icon color #595959 / rgb(89 89 89)

Finish this section. Using Interwiki links to the internal namespace. —THH 2025-01-02T1519-05

Changes and additions to the built-in smileys.

Things to note:

• Custom smileys live on GitHub here, and on the web server at /home/public/wiki.41n.co/lib/images/smileys/local
• The custom smileys conf file is on GitHub here and on the web server at /home/public/wiki.41n.co/conf/smileys.local.conf
• Custom smileys should not be overwritten on a DokuWiki upgrade since they are in a local directory and have a .local.conf file.
• After uploading additional smileys, fix file permissions with chgrp -R web /home/public/wiki.41n.co/lib/images/smileys/local
• After making changes to smileys, clear the DokuWiki cache via the admin tools menu

See the DokuWiki documentation for more information about working with custom smileys.

You can refer to Wiki Labels for more info about building custom smileys and/or “labels”.