Table of Contents
xref Plugin
Compatible with DokuWiki
- 2023-04-04 "Jack Jackrum" yes
- 2022-07-31 "Igor" yes
- 2020-07-29 "Hogfather" unknown
- 2018-04-22 "Greebo" unknown
This plugin makes linking to a OpenGrok generated documentation easy. You can link to functions, constants, variables, classes tables and filenames. The plugin will figure out what you meant automatically.
Please note, that this plugin is created mainly for the needs of dokuwiki.org and may change in behavior any time.
Download and Installation
Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.
Changes
- Version upped (2023-08-08 23:50)
- Automatically use the right class for deprecated ones (2023-08-08 08:40)
- Version upped (2023-08-07 23:50)
- Merge pull request #5 from splitbrain/codesearch (2023-08-07 18:09)
- some automatic cleanup (2023-08-07 17:53)
- Update Heuristics.php (2023-08-07 17:47)
- Update _test/HeuristicsTest.php (2023-08-07 17:47)
- Update lang/en/lang.php (2023-08-07 17:45)
Usage
The syntax is similar to interwiki links. Just start your link with the xref>
keyword followed by a function, constant, variable, class, table or file name.
Here are a few examples (case-sensitive!):
* A function: [[xref>wl()]] * A function with arguments [[xref>cleanText($text)]] * A global variable: [[xref>$ID]] * A class: [[xref>AuthPlugin]] * A property: [[xref>cando]], [[xref>canPreventDefault]] * A constant: [[xref>AUTH_READ]] * A file: [[xref>inc/auth.php]] * A function with a title: [[xref>cleanID()|This is an important function]]
It looks like this:
- A function: wl()
- A function with arguments cleanText($text), search only for the function name
- A global variable: $ID
- A class: AuthPlugin
- A property: cando, canPreventDefault
- A constant: AUTH_READ
- A file: inc/auth.php
- A function with a title: This is an important function
Configuration
The plugin can be configured through the Configuration Manager. You need to specify where your Xref docs are located in the file system and how they can be accessed from the web.