plugin:acmenu
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
plugin:acmenu [2020-01-20 12:53] – [Known Bugs and Issues] thoni56 | plugin:acmenu [2024-02-09 23:25] (current) – [AcMenu Plugin] torpedo | ||
---|---|---|---|
Line 2: | Line 2: | ||
---- plugin ---- | ---- plugin ---- | ||
- | description: | + | description: |
- | author | + | author |
- | email : dcstoyanov@gmail.com | + | email : dcstoyanov@gmail.com |
type : syntax | type : syntax | ||
- | lastupdate : 2019-11-30 | + | lastupdate : 2023-11-22 |
- | compatible : 2017-02-19 " | + | compatible : 2017-02-19 " |
depends | depends | ||
conflicts | conflicts | ||
Line 13: | Line 13: | ||
tags : menu, navigation | tags : menu, navigation | ||
- | downloadurl: | + | downloadurl: |
- | bugtracker : https://bitbucket.org/tormec/acmenu/issues? | + | bugtracker : https://github.com/tormec/AcMenu/issues |
- | sourcerepo : https://bitbucket.org/tormec/acmenu/src | + | sourcerepo : https://github.com/tormec/AcMenu |
donationurl: | donationurl: | ||
screenshot_img : | screenshot_img : | ||
---- | ---- | ||
- | |||
===== Description ===== | ===== Description ===== | ||
- | AcMenu provides an accordion menu which lists the content of namespaces in a tree-like format. | + | AcMenu provides an accordion menu that lists the content of namespaces in a tree-like format. |
- | The tree is built starting from the namespace where the AcMenu' | + | |
+ | The namespace | ||
- | This plugin respects the [[:ACL]] rules and, moreover, | + | This plugin respects the [[:ACL]] rules besides |
Line 38: | Line 38: | ||
===== Syntax ===== | ===== Syntax ===== | ||
- | In the sidebar page, use the syntax: | + | In the [[config:sidebar|sidebar]] |
< | < | ||
< | < | ||
Line 46: | Line 46: | ||
===== Examples ===== | ===== Examples ===== | ||
- | Just some screenshots to give you an overall idea of the final result. | + | Just some screenshots to give an overall idea of the final result. |
- | Suppose you want to create a sub-wiki in your main one, independent from it, as follows: | + | It is supposed the following |
< | < | ||
+--sidebar.txt | +--sidebar.txt | ||
Line 54: | Line 54: | ||
+--products | +--products | ||
| +--start.txt | | +--start.txt | ||
+ | | +--product_a.txt | ||
+--services | +--services | ||
| +--start.txt | | +--start.txt | ||
+ | | +--service_a.txt | ||
+--branch | +--branch | ||
| | ||
| | ||
+ | | ||
+ | | ||
+ | | ||
| | ||
| | ||
+ | | ||
| | ||
- | | ||
- | | ||
+--start.txt | +--start.txt | ||
- | +--confidential.txt | + | +--service_b.txt |
</ | </ | ||
- | Than you can populate each '' | + | where the two '' |
* in '': | * in '': | ||
< | < | ||
Line 76: | Line 80: | ||
</ | </ | ||
- | When a visitor is in '': | + | When a visitor is in '': |
- | If the visitor decides to open the sub-wiki '': | + | If the visitor decides to open the sub-namespace |
- | To deny the access to certain namespaces or pages you should set the appropriate rule in the [[:ACL]] management. In addition, it's possible to conceal those namespaces for which the visitor has no permission | + | To deny access to certain namespaces or pages, the appropriate rule in the [[:ACL]] management |
- | Furthermore it's possible to hide all '' | + | Furthermore, it's possible to hide the '' |
+ | - alternative matches must be separated by '' | ||
+ | - to match a word at the end of a line the '' | ||
+ | - to be sure that the word to match is preceded by '':'' | ||
+ | |||
+ | With that syntax, the following pages will be hidden: | ||
+ | * '': | ||
+ | * '': | ||
+ | * '': | ||
+ | Whereas the following one will remain visible: | ||
+ | * '': | ||
+ | |||
+ | Even if the hidden pages are not listed among the search results, they will still be reachable by typing their exact path in the search bar (eg. '' | ||
+ | )) using the [[config: | ||
< | < | ||
- | (sidebar|other-pages) | + | (?<=:)sidebar$|(?< |
</ | </ | ||
- | The following image is the behaviour | + | The following image is the behavior |
- | {{ https://bitbucket.org/tormec/acmenu/downloads/ | + | {{ https://raw.githubusercontent.com/tormec/AcMenu/ |
- | Since this plugin uses cookies to remember the pages visited (they are automatically deleted as soon as the window browser is closed) if the visitor comes back to '': | + | Since this plugin uses cookies to remember the pages visited (they are automatically deleted as soon as the window browser is closed) if the visitor comes back to '': |
The order in which the directory tree is presented is the following: | The order in which the directory tree is presented is the following: | ||
Line 97: | Line 114: | ||
This means that, if the option [[config: | This means that, if the option [[config: | ||
+ | Note also that the [[config: | ||
- | ===== Configuration and Settings ===== | ||
- | ==== Hide namespaces and pages ==== | + | ===== Customization ===== |
- | First, set the appropriate permissions in your [[:ACL]] management. | ||
- | Then, use the options: | ||
- | * [[config: | ||
- | * [[config: | ||
+ | If doesn' | ||
- | ===== Troubleshooting ===== | + | For instance, the list item markers can be changed with the following code: |
+ | <code css userstyle.css> | ||
+ | .acmenu ul.idx li.closed { | ||
+ | list-style-image: | ||
+ | } | ||
- | **Symptom:** AcMenu doesn' | + | .acmenu ul.idx li.open { |
+ | list-style-image: url(../lib/ | ||
+ | } | ||
+ | </ | ||
- | **Possible solution:** be sure that JavaScript is enabled in your browser, otherwise all namespaces remain open showing their content. | + | It's also possible to change the DokuWiki' |
- | ---- | + | <code css userstyle.css> |
+ | .dokuwiki .acmenu .aside a:visited { | ||
+ | background-color: none; | ||
+ | } | ||
- | **Symptom: | + | .dokuwiki .acmenu span.curid a { |
+ | background-color: | ||
+ | color: black; | ||
+ | } | ||
+ | </ | ||
- | **Possible solution:** be sure that cookies are enabled in your browser, otherwise AcMenu forgets | + | Use the Inspect Tool provided with your browser |
- | ---- | + | |
- | ===== Development | + | ===== Troubleshooting |
- | ==== Known Bugs and Issues ==== | + | **Symptom: |
- | Please, use the relative bug tracker or write here and then I will move there.\\ --- [[dcstoyanov@gmail.com|Torpedo]] // | + | **Possible solution:** be sure that JavaScript and cookies are enabled in your browser, otherwise AcMenu forgets |
- | Looks like AcMenu does not handle international characters well. I get %-displays in the menu for headings containing ' | ||
- | //thoni56 2020-01-20// |
plugin/acmenu.1579521198.txt.gz · Last modified: 2020-01-20 12:53 by thoni56