Differences

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

--- dokuwiki_annoyances [2023.07.27 09:31] – Steve Isenberg
+++ dokuwiki_annoyances [2024.09.20 13:20] (current) – Steve Isenberg
@@ Line 2: / Line 2: @@
 =====Dokuwiki Annoyances=====
+//These are notes for Dokuwiki functions that I find helpful and that I've used throughout this wiki.  This information is not intended to replace the plugin and Dokuwiki documentation, as that is the basis for what I've extracted here.//
 ====The dropdowns in upper-right don't work====
@@ Line 28: / Line 29: @@
 Using | in a table\\
-Normally, when you use a | inside a table, it's treated as start-next-column.  If you want it to be treated as a regular character (for example: ''ls | more'' in Linux, where the | is part of the command sequence, then surround the | in two pair of % or use nowiki.
+Normally, when you use a ''|'' inside a table, it's treated as start-next-column.  If you want it to be treated as a regular character (for example: ''ls | more'' in Linux, where the | is the pipe command, then surround the | with a double ''%'' or surround it with %%<%%nowiki%%>%%.
-|paging file listing|ls -lt %%|%% more|ls -lt <nowiki>|</nowiki> more|
+<code>
+|paging file listing | ls -lt %%|%% more | ls -lt <nowiki>|</nowiki> more |
+</code>
+|paging file listing | ls -lt %%|%% more | ls -lt <nowiki>|</nowiki> more |
 ===Coloring a cell===
-<nowiki>|@palegreen:cell1|@:cell2|@#FF00FF:cell3|</nowiki>\\
+<code>
-|@palegreen:cell1|@:cell2|@#FF00FF:cell3|
+| @palegreen:cell1 | @:cell2 | @#FF00FF:cell3 |
+</code>
+| @palegreen:cell1 | @:cell2 | @#FF00FF:cell3 |
 ===Coloring text===
-<nowiki><color /#ccccff>text1 background</color> <color green>text2</color> <color #00FFFF>text3</color> <color red/green>text4</color></nowiki>\\
+<code>
-<color /#ccccff>text1 background</color> <color green>text2</color> <color #00FFFF>text3</color> <color red/green>text4</color>
+<color /#ccccff> text-1 </color> <color green> text-2 </color> <color #00FFFF> text-3 </color> <color red/green> text-4 </color>
+</code>
+<color /#ccccff> text-1 </color> <color green> text-2 </color> <color #00FFFF> text-3 </color> <color red/green> text-4 </color>
 ===Specifying column widths====
-Put this on the line before the start of the table.  This example shows a spec for a 4-column table. 100% means you're dealing with the entire table width. 14%, 10%, and 1% specify the relative width for those three columns; the - means the rest of the width goes into that table.\\
+Put this on the line before the start of the table.  This example shows a spec for a 4-column table. 100% means the table will fill the page horizontally.  The 14%, 10%, and 1% specify the relative width for those three columns; the ''-'' means to use whatever is left in that column (in this case it will be 100-14-10-1 or about 75%).
-<nowiki>|< 100% 14% - 10% 1%>|</nowiki>
+<code>
 |< 100% 14% - 10% 1%>|
 |Col1|Column 2, the wordy column.|Column 3|4th|
-\\
+</code>
+|< 100% 14% - 10% 1%>|
+|Col1|Column 2, the wordy column.|Column 3|4th|
 This example is for a 3-column table, that's only using 3/4 of page width.  The first two columns are smaller and the remainder of the table is taken by the contents of the 3rd column.
-<nowiki>|< 75% 10% 13% ->|</nowiki>
+<code>
+|< 75% 10% 13% ->|
+|July 4, 2023|watch fireworks|Now is the time for all good people to view fireworks. From a safe distance.|
+</code>
 |< 75% 10% 13% ->|
 |July 4, 2023|watch fireworks|Now is the time for all good people to view fireworks. From a safe distance.|
@@ Line 53: / Line 74: @@
 The Hidden plugin does the job.
-If you use: ''<nowiki><hidden click to show>the text to be shown or hidden</hidden></nowiki>'' it works like this:\\
+<code>
 <hidden click to show>the text to be shown or hidden</hidden>
-\\ \\
+</code>
-If you want to control initial state visible/not and change text shown depending on visible/not, use:\\
-''<nowiki><hidden initialState="visible" onVisible="Click to hide" onHidden="click to show ">Text to be seen or not seen</hidden></nowiki>'' and it works like this:\\
+<hidden click to show>the text to be shown or hidden</hidden>
-<hidden initialState="visible" onVisible="Click to hide" onHidden="click to show ">Text to be seen or not seen</hidden>
+\\
+If you want to control initial state visible/not and change text shown depending on visible/not, use:
+<code>
+<hidden initialState="visible" onVisible="Click to hide" onHidden="click to show ">Text initially visible</hidden>
+<hidden initialState="hidden" onVisible="Click to hide" onHidden="click to show ">Text starts off hidden</hidden>
+</code>
+<hidden initialState="visible" onVisible="Click to hide" onHidden="click to show ">Text initially visible</hidden>
+<hidden initialState="hidden" onVisible="Click to hide" onHidden="click to show ">Text starts off hidden</hidden>
+----
+====Insert spreadsheet contents to wiki====
+Use the CSV Plugin.  Insert using CSV or reference a CSV file that's in the wiki.
+**//Inline CSV//**\\
+Save the spreadsheet page as a CSV file, then open the file using text editor, copy all and paste between the csv's:
+<code>
+<csv>
+copied,csv,file,goes,here
+</csv>
+</code>
+**//use file in media area//**\\
+You copy the CSV file to your media area.  Maybe it's in namespace ''abc'' and file is named ''mystuff.csv''.
+<code>
+<csv abc:mystuff.csv></csv>
+</code>
+**//Options of note//**
+  * Format first (eg) 2 rows as column headers: ''hdr_rows=2''
+  * Format first (eg) 1 column as column header: ''hdr_cols=1''
+  * Limit result to 12 rows: ''maxlines=12''
+  * Skip first 7 rows in file: ''offset=7''
+For example
+<code>
+<csv hdr_rows=1>
+abc,def,ghi
+jkl,mno,pqr
+</csv>
+</code>
+<csv hdr_rows=1>
+abc,def,ghi
+jkl,mno,pqr
+</csv>
+----
+====Using the Gallery Plugin====
+==Add photos by using a namespace==
+<code>
+{{gallery>:namespace}}
+</code>
+All image files in that namespace will be added to the gallery.  Don't forget the colon, '':''
+==Options of note==
+Aligning the pictures
+<code>
+{{gallery> :namespace?options go here}}    (right aligned)
+{{gallery>:namespace?options go here }}    (left aligned)
+{{gallery> :namespace?options go here }}   (centered)
+</code>
+^Option name   ^example^note^
+|thumbnail size     |150x150 |lower-case x|
+|lightbox size      |1024X768|capital X|
+|limit to 10 images |=10|
+|sort pix randomly  |random|
+|sort by mod date   |modsort|
+|sort by create date|datesort|
+|show filename below thumbnails|showname|
+|don't crop pix     |nocrop|cropping is enabled by default|
+|don't search subdirs|norecursive|recursive search enabled by default|
+Example: Photos with name, not cropped, reasonable expanded size, landscape thumbnails:
+<code>
+{{gallery>:namespace?showname&nocrop&1024X768&200x150}}
+</code>
+====Add text from a file with wrapping====
+You have text you want to add to a wiki page, and you want to make sure that it's inserted with line wraps.
+For example if you have the text
+<code>
+:29:43 message to everyone:
+	Sabine Hossenfelder (born 1976) is a German professional YouTuber, theoretical physicist, science communicator, author, musician, and singer. She is the author of Lost in Math: How beauty leads physics astray, which explores the concept of elegance in fundamental physics and cosmology, and of Existential Physics: A scientist’s guide to life’s biggest questions.
+</code>
+But you want it to look like this, note that you don't have to scroll left and right to read the whole line:
+<WRAP prewrap>
+<code>
+:29:43 message to everyone:
+	Sabine Hossenfelder (born 1976) is a German professional YouTuber, theoretical physicist, science communicator, author, musician, and singer. She is the author of Lost in Math: How beauty leads physics astray, which explores the concept of elegance in fundamental physics and cosmology, and of Existential Physics: A scientist’s guide to life’s biggest questions.
+</code>
+</WRAP>
+You surround the lines as follows:
+<file>
+<WRAP prewrap>
+<code>
+:29:43 message to everyone:
+	Sabine Hossenfelder (born 1976) is a German professional YouTuber, theoretical physicist, science communicator, author, musician, and singer. She is the author of Lost in Math: How beauty leads physics astray, which explores the concept of elegance in fundamental physics and cosmology, and of Existential Physics: A scientist’s guide to life’s biggest questions.
+</code>
+</WRAP>
+</file>
+When the wiki processes this, it'll do the line wrapping on the Sabine line.
+====Change the wiki logo====
+The logo is a 128x128 pixel file named wiki:logo.png
+Consider using https://looka.com to create your logo then use your photo editing software (e.g., Photoscape X) to fine-tune and save it as a 128x128 pixel .png.