Differences

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

--- dokuwiki [2025/11/16 00:09] – [Upgrade 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==/
 =====Upgrade dokuwiki=====
-The content resides in the curriculum project.\\
+Locations:
-The wiki software resides in the samwiki project.\\
+  * 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.
-See more detailed upgrade instructions in a txt file in the curriculum project. \\
+Therefore, samwiki can be upgraded or reinstalled anytime without affecting the user content.
-Also, see the upgrade.log file in the samwiki project. \\
-Why are samwiki upgrade instructions in the curriculum project?\\
+Here is the procedure to upgrade samwiki/dokuwiki to the latest release,\\
-In case the samwiki project gets deleted or needs to be recreated for whatever reason.\\
+largely copied from https://www.dokuwiki.org/install:upgrade.
+  # First, just to be safe, git commit all changes in the curriculum project.
-  # git commit all changes in the curriculum project
+  # move to the samwiki folder
-Upgrade dokuwiki to the latest release in the samwiki project.
+  cd <production>/samwiki
-  # backup the current installation (optional)
+  # backup the current installation (just to be safe)
   tar zcpfv dokuwiki-backup.tar.gz dokuwiki
@@ Line 195: / 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/
+===Notes===
+In the samwiki 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?)
+A complete list of the dokuwiki releases can be found here:
+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 205: / Line 230: @@
   #    1. the wiki data is version-controlled by the github curriculum project, and
   #    2. the dokuwiki executable can be reinstalled, without risking loss of data.
   # how to install into a2hosting
@@ Line 213: / Line 238: @@
   tar -xzvf dokuwiki-stable.tgz
   mv dokuwiki-2022-07-31a/ dokuwiki
   # 2. if necessary, upgrade PHP version at a2hosting CPanel "select PHP version"
@@ Line 273: / 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]]