====== Dokuwiki ======

===== 2026 09 13 =====

  * dokuwiki runs on macqueen.us at dnsexit.com
  * dokuwikiAndroid https://github.com/fabienli/DokuwikiAndroid

==== save pages as .md files ====
<code>To save DokuWiki pages as .md files, you must use the MarkdownExtra plugin, 
as DokuWiki natively requires pages to have a .txt extension. 

Plugin Installation: Install the markdownextra plugin (available on GitHub or 
Bitbucket) to enable native Markdown parsing within DokuWiki. 

File Naming Convention: Save your files with a dual extension, specifically .md.txt 
(e.g., page.md.txt).  DokuWiki requires the .txt suffix to recognize the file as a 
valid wiki page, while the plugin uses the .md suffix to trigger Markdown parsing. 
Usage: Pages ending in .md are automatically parsed using PHP Markdown Extra.  You 
can also embed Markdown content in other pages using a specific markdown block.

Front Matter: The plugin supports front matter (text blocks delimited by ---) at 
the top of .md pages, which allows metadata to be placed outside the rendered HTML, 
enabling compatibility with plugins like tag. </code>



===== 2025-1-7 =====

  * Dokuwiki not a supported package in Synology DSM 7.
  * Followed these directions (https://www.youtube.com/watch?v=vgB9aJ-fRzY) about installing a farm. Did not work.
  * Copied this install to both macqueen.us/dokuwiki and allthatjas.us/dokuwiki and all was well.
  * going to 10.0.0.124 in a web browser lands you in /volume1/web
  * both wikis are dmmacq s1 u2
  * wiki name is in conf/local.php
===== 2023-12-7 =====

  * Many many problems upgrading to current version.
  * Current version wanted PHP 7.4
  * On Diskstation, deleted all PHP versions < 7.4, and updated WebStaion to use PHP 7.4 and Apache to use 2.4
  * Backed up old version to dokuwiki20231205.zip
  * See https://www.dokuwiki.org/install:synology for changes needed to PHP
  * Download and installed latest DW version.
  * Created new start.txt page.
  * Changed **Directory for saving data** option to point to /volume/synshare/web/macqueen.us/dokuwiki/data/pages
  * Copied older data/pages/*.txt files to that directory, but no change.
  * Searched all drives for start.txt.
  * Changed DW config option **Reveal full path of pages in the footer** to show full path of currently displayed file and found it in /volume1/web/dokuwiki/data/pages 
  * "find / -name start.txt" did not find it. had to use sudo.
  * Final change was option **Use fully canonical URLs**
  * Copied older plugins only if not newer
  * Executables are in /volume1/web/dokuwiki and are not backed up. 
  * This may not be true ^^^ but it works and I'm not fooling with it anymore right now.
  * Data is in /volume/synshare/web/macqueen.us/dokuwiki/data/pages and does get backed up

===== 2019-5-2 =====

  * Dokuwiki lives in /etc, /usr/share/lib, and /var/lib.
  * All of the above should be chown -R www-data.
  * dokuwiki.php is the global config
  * local.php is the local config override
  * must change apache2.conf
  * must install all of php5, so that there is a php5.conf file in apache
  * [[https://www.dokuwiki.org/wiki:syntax | Dokuwiki syntax]]
  * [[https://www.dokuwiki.org/faq:backup | how to backup dokuwiki]]
  * to fix write errors, ssh to 192.168.1.17 (admin/lowell01), then cd to /volume1/synshare/web/macqueen.us/test/data, and do <code>sudo chgrp -R http * and sudo chown -R http *</code>
  * there is a backup plugin that writes to /volume1/synshare/web/dokuwiki/data/media/wiki/backup
  * there is an update plugin that works