Differences

This shows you the differences between two versions of the page.

--- dokuwiki [2025/11/16 01:22] – [Update dokuwiki] jhagstrand
+++ dokuwiki [2025/11/24 02:42] (current) – [Google Doc to dokuwiki] jhagstrand
@@ Line 170: / Line 170: @@
   %s/\\\\\n\n\( \+\)\*/\r\1\*/
+  %s/\\\\\n\n\( \+\)\-/\r\1\-/
+,$s/===\(.*\)===/==\1==/
-=====Update dokuwiki=====
+=====Upgrade dokuwiki=====
-The content resides in the curriculum project, which is in git.
+Locations:
+  * The user content resides in the curriculum project, which is in git.
+  * The wiki software resides in the samwiki project, which is NOT in git.
-The wiki software resides in the samwiki project, which is NOT in git.
+Therefore, samwiki can be upgraded or reinstalled anytime without affecting the user content.
-samwiki can be updated or reinstalled anytime without affecting the user content.
+Here is the procedure to upgrade samwiki/dokuwiki to the latest release,\\
+largely copied from https://www.dokuwiki.org/install:upgrade.
-Just to be safe, before updating samwiki, git commit all changes in the curriculum project.
-Here is the procedure to update samwiki/dokuwiki to the latest release.\\
+  # First, just to be safe, git commit all changes in the curriculum project.
+  # move to the samwiki folder
   cd <production>/samwiki
-  # backup the current installation (optional)
+  # backup the current installation (just to be safe)
   tar zcpfv dokuwiki-backup.tar.gz dokuwiki
@@ Line 193: / Line 197: @@
   # cp the new release on top of the current installation
-  # this will overwrite the executables, but does not affect the user data
+  # this overwrites the executables, but does not affect the user data
   cp dokuwiki-2025-05-14b/* dokuwiki/
-# https://www.dokuwiki.org/install:upgrade
 ===Notes===
-in samwiki
+In the samwiki folder:
-  * dokuwiki is the production folder
+  * the dokuwiki subfolder contains the production installation
   * the other files in samwiki are working files and can be deleted
+Some notes about the cp command.
+  * After the cp command you may see messages like: "cp: omitting directory ‘dokuwiki-2025-05-14b/bin’". This is normal.  It means directory itself was not copied.  The files within each directory were copied successfully.
+  * Many of the source directories are empty. Like data/pages for instance.  That's how the cp effects an upgrade without overwriting the user data.
+  * The source data/pages/folder contains two subfolders: playground and wiki.  These are not copied because cp does not create directories that are not pre-existing in the destination.
+When to upgrade?\\
+When dokuwiki has issued a new release, you will see a message like this at the top of every page in the wiki.
+  Hotfix release available: 2025-05-14b "Librarian". upgrade now! [56.2] (what's this?)
-===Update history===
+A complete list of the dokuwiki releases can be found here:
-  * 2025 11 15 install the 2025-05-14b hotfix release
+https://download.dokuwiki.org/archive
+Notice that a new release comes out every year, and lately each release has two hotfix releases: a, and b.
+===Upgrade history===
+  * 2025 11 15 upgraded to the 2025-05-14b "Librarian" hotfix-b release
 =====Reinstall dokuwiki=====
@@ Line 283: / Line 298: @@
   #     @ALL none
   #     @user none
+=====todo=====
+fold these to files into this page
+  * markdown_to_dokuwiki_macro.txt
+  * sample_dokuwiki_syntax.txt
+[[sample dokuwiki page]]