User Tools


Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Last revision Both sides next revision
wiki:orientation [2019/07/18 15:57]
sabina.iseli-otto ↷ Page moved from cooperative:wiki:orientation to wiki:orientation
wiki:orientation [2019/08/18 12:46]
sabina.iseli-otto
Line 1: Line 1:
 +====== Q&A ======
  
 +
 +Please list questions about how to get the most out of the Coop wiki.
 +
 +  * **how do I move a page? And are there conventions we should follow to notify people when we *do* move pages?**
 +    * cf https://wiki.libraries.coop/doku.php?id=cooperative:wiki:orientation&do=admin&page=move (but you can DEFINITELY ask for help with this, and probably SHOULD ask for help with full namespace moves)
 +  * **how do I archive a page if I am unsure whether I should delete it?**
 +     * cf z_archive namespace; rename pages to "old_namespace_pagename"
 +  * **are there any tricks for making tables easier? (yes)**
 +     * cf http://donaldmerand.com/code/2012/05/08/convert-a-spreadsheet-to-dokuwiki-format.html
 +     * there is a conflict between sortable tables (which we currently use) and the wysiwyg table editor - if there is enough demand, we can test the wysiwyg editor on our staging server for the wiki, and if it is _that_ much easier, maybe implement instead of the sortables plugin.
 +  * **how can I get two column display on a page?**
 +    * cf "wrap" plugin - https://www.dokuwiki.org/plugin:wrap
 +  * **what are some of the macros and other extensions I can use to make wiki pages work better?**
 +    * cf https://wiki.libraries.coop/doku.php?id=wiki:syntax&do=admin&page=extension
 +    * e.g. https://www.dokuwiki.org/plugin:include
 +    * embed raw html (use sparingly) https://www.dokuwiki.org/wiki:syntax#embedding_html_and_php
 +    * ""~~NOTOC~~"" and "~~NOCACHE~~""
 +    * there is a HUGE number of other ones at https://www.dokuwiki.org/plugins - maybe browse to see if there are some that could be useful, and we can try out on the staging server first.
 +  * **how do you do that slideshow trick?**
 +    * cf https://www.dokuwiki.org/plugin:s5 
 +    * put ''{slideshow}'' at the top of the page, and ''{/slideshow}'' at the end; top level headings represent new slides
 +  * **how do you create the Check boxes in list format (To Do list?)**
 +    * cf https://www.dokuwiki.org/plugin:todo - basically put ''<todo>'' tags around your items
 +  * **There are two namespaces on pages like [[nnels:start|this one]], one for pages that have a :start namespace, and another for pages which do not. What are some good conventions to use when creating a new page?**
 +    * so to create a namespace you create a new page but with a trailing colon, like newspace:
 +    * however, ideally you would create a new namespace by creating a new index [[new page]] first, like newspace:start. Any page named "start" is the default index page for a space. 
 +    * to create a new page, easiest way is to simply edit the URL and create a new path. Also easy to create a link on an  existing page, then click through to it.
 +
 +====== Tips ======
 +
 +===== Removing a Page from a Menu =====
 +
 +Typically, when you delete the contents of the page, you also delete that page unless it has children. If a page also appears in menu, however, you can't remove it by deleting the content: instead, move the page to namespace "z-archive". Only then will it disappear. 
 +
 +===== Subscribing to Wiki Changes =====
 +Subscribe to parts of -- or the whole! -- wiki to receive an email when someone makes changes to pages or namespaces. To subscribe: 
 +  - Navigate to the page or namespace to which you want to subscribe; 
 +  - On the right-hand menu which contains the main edit link on every page, find the envelope with the scroll-over text "Manage Subscriptions"; 
 +  - Choose your preferences and click "Subscribe"
 +  - Repeat for other pages or namespaces! 
 +
 +====== Limiting your Wiki Search ======
 +
 +When getting too many search results, use the tricks [[https://www.dokuwiki.org/search|listed here]]. Specifically useful may be: 
 +
 +===== Phrase search ("") =====
 +
 +You can search for exact phrases by putting double quotes around a set of words, e.g. [ "installing dokuwiki" ].
 +
 +===== Search within a namespace (@)=====
 +
 +You can restrict the search to namespaces. To search pages within a namespace, prefix @ or ns: to the namespace. To not search pages within a namespace, prefix ^ or -ns: to the namespace.
 +
 +For example, the query [ dokuwiki @wiki ^wiki:docs ] will find pages which contain a word “dokuwiki” and are within “wiki” namespace but not within “wiki:docs” namespace. The query [ dokuwiki ns:wiki -ns:wiki:docs ] will do the same thing.
 +
 +Note that you have to search a namespace (e.g. something that has a URL that ends in “:start”) — otherwise you are searching a page. So, searching with [ ns:public:nnels:etext:template-styles ] does not work, but searching in [ ns:public:nnels:etext ] most certainly does. 
 +
 +
 +----
 +
 +
 +~~NOCACHE~~ 
 +<nspages -h1 -subns -exclude:start>
wiki/orientation.txt · Last modified: 2019/08/18 12:46 by sabina.iseli-otto