Translations of this page?:

Description

This template is intended to make DokuWiki a little easier to use for non technical users by:

  1. Providing a dropdown index, showing pages organised by namespace
  2. Add an easy means of inserting links to valid pages
  3. Replace namespace/page construct with one of pages and subpages
  4. Add a form to directly add new pages (and subpages)
  5. Keep it clean, keep it wiki

Playground

Download

amanuensis.zip

Download does not work!

Operation

Hovering over the page name will produce a dropdown menu, showing pages and their subpages. Hovering over sections of the name will show only those pages beneath that level. Clicking on a pagename will navigate to that page. ACL will control which pages are visible.

When DokuWiki is in edit mode, the pagename and the dropdown menus are rendered in italic text. Clicking on a pagename in edit mode will insert that page name as a link at the caret.

With 'nspages' set to true, the namespace and page construct is replaced by that of pages and subpages. That is linking to a namespace will go to a page of the same name. These namespace descriptive pages do not show in the dropdown menus. This change breaks dokuwikis index, however the index functionality is provided by the dropdowns.

Setting 'addpage' set to true, will show a form to directly add pages and subpages.

There are various stylistic changes. These may be modified by editing the appropriate css.

Cautions

  • This is an initial release. I am not a programmer. Beware.
  • There is currently no cacheing for the menus. On large sites this could result in excessive server load and download time

Code

FIXME add code listing and tech discussion.

Installation

  1. Unpack the zip file into the /lib/tpl/amanuensis directory.
  2. In /conf/local.php set
    $conf['template'] = 'amanuensis';
  3. Copy about.txt and help.txt from the root of the templates directory to /data/wiki
  4. Add the following lines to /conf/local.php
    $conf['amanuensis']['nspages'] = 'true';

    and

    $conf['amanuensis']['addpage'] = 'true';
  5. Replace the logo /lib/tpl/amanuensis/images/logo/amanuensis.png with one of your choosing
  6. Do the following modifications

To show pages describing namespaces:

Note: The following modification will break the index (and it will not apear as an option). Because the index functionality is largely provided by the dropdowns, this may not be a problem.

In /conf/local.php set

$conf['amanuensis']['nspages'] = 'true';

This setting can be set to 'false' to disable this behavior (and reenable the index) after the following mod has been added.

And in /doku.php add the following after line 41

    //!! ADDED FOR 'AMANUENSIS' TEMPLATE TO SHOW NAMESPACE PAGES !!
    if  ($conf['amanuensis']['nspages'] == 'true'){
      $conf['amanuensis']['dokunsmod'] = true;    //flags that mod has been added
        if (!empty($IDX)){
           $ID=$IDX;
          $IDX=NULL;
         $ACT='show';
      }
    }
    //!! END ADDED TO SHOW NAMESPACE PAGES !!

To provide form to add page and subpage:

In /conf/local.php set

$conf['amanuensis']['addpage'] = 'true';

And in /doku.php add the following after line 41 (or after the modification above)

    //!! ADDED FOR 'AMANUENSIS' TEMPLATE TO SHOW ADDPAGE FORM!!
    if  ($conf['amanuensis']['addpage']=='true'){
    $conf['amanuensis']['addpagemod'] = true;    //flags that mod has been added
    if($ACT == 'addpage'){
      if ($_REQUEST['newpagename']){
        if ($_REQUEST['addpage']=='SubPage'){
          $ID.=':'.$_REQUEST['newpagename'];
          $IDX = NULL;
        }
        if ($_REQUEST ['addpage']=='Page'){
          $ID=getNS($ID).':'.$_REQUEST['newpagename'];
          $IDX=NULL;
        }
      }
     $ACT = 'show';
    }
    }
    //!! ADDED FOR ADDPAGE !!

Compatible browsers

Amanuensis works reasonably well in the following browsers:

  • IE win
  • Firefox
  • Opera

Non-compatible browsers

The code for the dropdowns is problematic in some browsers. Please help by listing problematic browsers, so i can add browser sniffing to degrade them gracefully.

  • IE mac

Credits

This template uses a dropdown menu,

SWIM2.0 :: Simple website menu by brothercake http://www.brothercake.com/

Licensed under GPLhttp://www.gnu.org/copyleft/gpl.html

Revision List

  • 2005-11-30 — initial release

Bugs

Feature Requests

Discussion

  • Warning: strpos(): Empty delimiter. in z:\home\public\www\docs\lib\tpl\amanuensis\inc\index.php on line 98 after pasting code from section “To show pages describing namespaces” into doku.php. The rest works fine. — Alexander Kraeved 2005-12-05 17:14
  • This problem is fixed by adding the following line to /conf/local.phpGreen Box 2006-01-07 11:40
 $conf['amanuensis']['nssuffix'] = '-_dx';

Summary Drop Table width

clic to enlargeReally great template, smooth and simple and elegant. Bravo! My only complaint is about the Summary Drop Table on the upper right of a page. It looks like the width of it is really too short, so that each entry is printed in 2 or 3 rows, even with very short titles… Is it a bug with Firefox? Can I change it to a better width? Here is a screenshot, more clear than my weird english.

Up-right menu display question

Am wondering if anyone could suggest as how I could modify to make the up-right menu fully display in the language of my choice (e.g. big5 encoding).
Please refer to this imagehttp://allergy.kmu.edu.tw/.temp/up-right_menu.jpg pertaining to my question, thanks.

Contact

Green Box 2005-11-29 17:09

 
wiki/tpl/amanuensis.txt · Last modified: 2008/07/02 18:41 by 77.251.32.117
 
Imprint Recent changes RSS feed Creative Commons License Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki
WikiForumIRCBugsTranslate