Differences

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

--- dokuwiki [2019/02/27 16:13]
127.0.0.1 external edit
+++ dokuwiki [2020/09/23 04:09] (current)
@@ Line 1: / Line 1: @@
 ====== DokuWiki ======
-This is Paul's DokuWiki. It is running on his awesome droplet. It is served by
+I use [[https://www.dokuwiki.org/|DokuWiki]] to build this website.  It is
-Apache2. The domain name paulsammut.com points to it and a virtual host on port
+running on one awesome droplet. It is served by Apache2. The domain name
-picks up the traffic.
+paulsammut.com points to it and a virtual host on port 80 picks up the traffic.
+==== Change Log ====
 The following are modifications I have done to it.
@@ Line 9: / Line 11: @@
   * Changed theme to Boostrap3
   * Removed the footer by deleting everything inside ''%%dokuwiki/lib/tpl/dokuwiki/tpl_footer.php%%''
-  * Removed the trace bar
+  * Added a google analytics plugin
+  * Added a mathjax plugin
+  * Added a discussion plugin for comments
 ===== Vim Editing =====
@@ Line 27: / Line 31: @@
 I added a function in my ''%%.vimrc%%'' that checks if the file is a DokuWiki file and
 sets this syntax automatically. It does this with two checks:
-  * File extension is *.txt
+  * File extension is ''%%*.txt%%''
-  * First line contains "=====" which is DokuWiki syntax for main heading
+  * First line contains ''%%=====%%'' which is DokuWiki syntax for main heading
 It then sends keys to unfold the doc, as the doc opens fully folded by default.
@@ Line 54: / Line 58: @@
   * Adds hours of reshuffling for no appreciable gain
   * The DokuWiki site doesn't use namespaces for its content
+===== Plugins =====
+I use various plugins to get the functionality I wanted.
+==== Discussion Plugin ====
+I use the [[https://www.dokuwiki.org/plugin:discussion|DokuWiki Discussion
+Plugin]] to add comments. I tried using the ''%%plugin»discussion»automatic
+%%'' setting and turning off discussion where I didn't want it, but this did not
+work.  So I had to add the string ''%%%%'' at the end of every
+%page using this commnad:
+<code bash>
+printf "\n" | tee -a *.txt
+</code>
+==== Analytics Plugin ====
+I set up Google Analytics using the
+[[https://www.dokuwiki.org/plugin:googleanalytics|Google Analytics DokuWiki
+plugin]] [[https://www.dokuwiki.org/plugin:googleanalytics|link]]. I just had to
+enter the tracking ID into the plugin configuration.
+===== Syntanx Highlighting =====
+I have tried all kinds of code blocks and settled on using the default one with
+line numbers.
+I use this for pseudo code. There isn't actually a pseudo code coloring syntax
+but i type it in there because if you don't have a syntax option the line
+numbers don't show up:
+<code>
+<code cpp [enable_line_numbers="true"]>
+<code pseudo [enable_line_numbers="true"]>
+</code>
+===== Mac Vim Editing =====
+I use ssfs to mount the droplet dokuwiki directory and edit the files directly
+on the server. I could use unison to do it but whatever.
+I sometimes run into issues with read only files and file owner corruption with
+mac's version of sshfs. I set the user to paul and group to www-data on the
+droplet.
+''sudo chown -R paul:www-data /var/www/dokuwiki/''
+''sudo chmod g+w /var/www/dokuwiki/data/pages/''