Differences

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

--- dokuwiki [2025/11/15 22:50] – [Google Doc to 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 upgrade instructions in a txt file in the curriculum project. \\
+Therefore, samwiki can be upgraded 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.
+  # 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 (just to be safe)
+  tar zcpfv dokuwiki-backup.tar.gz dokuwiki
+  # download and unzip the new release
+  wget http://download.dokuwiki.org/src/dokuwiki/dokuwiki-2025-05-14b.tgz
+  tar zxvf dokuwiki-2025-05-14b.tgz
+  # cp the new release on top of the current installation
+  # 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=====
+  # The dokuwiki executable is installed in samwiki.
+  # The pages, media, and conf files are stored in curriculum.
+  # Therefore,
+  #    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
+  # 1. unzip dokuwiki into ~/webprod/samwiki
+  cd ~/webprod/samwiki
+  wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz
+  tar -xzvf dokuwiki-stable.tgz
+  mv dokuwiki-2022-07-31a/ dokuwiki
+  # 2. if necessary, upgrade PHP version at a2hosting CPanel "select PHP version"
+  # 3. run the dokuwiki install
+  http://curriculum.voyc.com/install.php
+  # Wiki Name: Curriculum
+  # Superuser: jhagstrand
+  # Real name: John Hagstrand
+  # E-Mail: john@hagstrand.com
+  # Password: know9
+  # once again: know9
+  # Initial ACL policy: Public Wiki
+  # Allow users to register themselves: no
+  # License: Public Domain
+  # 4. Point wiki pages, media, and conf files back to curriculum.
+  cd ~/webprod/samwiki/dokuwiki
+  ln -s ~/webprod/curriculum/curriculum/doc/dokuwiki/conf/userall.css conf/userall.css
+  ln -s ~/webprod/curriculum/curriculum/doc/dokuwiki/conf/entities.local.conf conf/entities.local.conf
+  mv data/pages data/pages-orginal
+  ln -s ~/webprod/curriculum/curriculum/doc/dokuwiki/data-pages data/pages
+  mv data/media data/media-orginal
+  ln -s ~/webprod/curriculum/curriculum/doc/dokuwiki/data-media data/media
+  # 5. Point curriculum to samwiki
+  cd ~/webprod/curriculum/curriculum
+  ln -s ~/webprod/samwiki/dokuwiki html
+  # 6. delete the install.php file
+  cd ~/webprod/samwiki/dokuwiki/
+  rm install.php
+  # 7. Install the mathjax plugin for equations.
+  cd ~/webprod/samwiki/dokuwiki/lib/plugins/
+  wget https://github.com/liffiton/dokuwiki-plugin-mathjax/archive/master.zip
+  # unzip and rename folders: lib/plugins/mathjax
+  unzip master.zip
+  mv dokuwiki-plugin-mathjax-master mathjax
+  #8. Install the yalist extension for definition lists.
+  # see https://www.dokuwiki.org/plugin:yalist
+  # Admin -> Extension Manager
+  # Search Extension: yalist
+  # yalist Plugin by Mark Prins  ::  Install
+  # after install, modify the style.css file as follows
+  vi ~/webprod/samwiki/dokuwiki/lib/plugins/style.css
+  # div.dokuwiki .dt {
+  #     color: black;      /* __text_alt__; */
+  #     max-width: 50%;    /* 30%           */
+  #     float: none;       /* left;         */
+  # div.dokuwiki dd {
+  #     margin-bottom: 0.5em;  /* (new) */
+  # 9. Test extensions on "curriculum - appendix - dokuwiki" page.
+  #10. Upload logo.png in Media Manager.
+  #11. In Administrator, ACL, set permissions on draft namespace.
+  #     @ALL none
+  #     @user none
+=====todo=====
+fold these to files into this page
+  * markdown_to_dokuwiki_macro.txt
+  * sample_dokuwiki_syntax.txt
+[[sample dokuwiki page]]