Easier Linking, Create Links for Name List Macros, more Support for Placeholders in Templates, plus Enhancements to Artificial Properties, Autocomplete, and Deep Links.
Today we released version 4.6 of the projectdoc Toolbox on the Atlassian Marketplace!
This release provides new features, improvements, and bugfixes.
The projectdoc Toolbox is an add-on for Confluence supporting agile software development teams to collaborate on process, project, system, and product documentation.
If you want to learn more about the projectdoc Toolbox and how it helps to create good project documentation, please refer to the introduction video!
The following image is a link to a video on YouTube. When you click the link your browser will serve a page from youtube.com.
Very interesting, but way too fast?
Step through at your own pace with with our Prezi Presentation (external link to prezi.com)!
In the Online Manual you’ll find additional video material that introduces you in the concepts of the projectdoc Toolbox.
Refer to use cases and show cases for information on how to use the projectdoc Toolbox.
New and Noteworthy
The advantage using the link macros is the rendering of a tooltip on mouse over. The default tooltip text is the short description of the referenced document.
Another use case is rendering links using a publishing process. Typically there is a set of spaces with which the team works. At publishing time the content of some spaces is copied to the published spaces. Dynamic links allow to render the correct links dependent on the Space Closure.
The following table lists the supported parameters of the three macros.
| Use Case | Parameter | Static Link Macro | Dynamic Link Macro | Term Link Macro |
|---|---|---|---|---|
| Link whole document | Page / Title | Document | Document Title (Title) | Term (Title) |
| Space Closure |  |  |  | |
| Link into document | Anchor | | | |
| Control label | Label | | | |
| Lower Case | | | | |
| Tooltip | | | | |
| Abbreviation Mode | | | | |
| CSS Classes | | | | |
| Document creation | Link Rendering Control | | | |
| Blueprint | | | | |
| Remote Control | Request Parameters | | | |
| Toggle Feature | Request Toggle Label | | | |
| Request Toggle Tooltip | | | |
Since the Static Link Macro is referencing a document similar to a Confluence link by space key and page title, there is no need to specify the space key separately. There is also no need to specify the space closure. All other use cases are supported.
The Term Link Macro is designed for simplified use and therefore does not provide parameters for use cases beyond rendering a reference to an item in the glossary. Although a space key is required to calculate the link to a document, the macro does not allow to specify the space closure as a parameter. The delegate space is required to be set correctly. This requires that a space defines its attachment space for glossary items.
Create Links
The Name List Macro (and its cousins) are rendering create links if the Space Property named Document Creation for Name List is set to true (which is the default value).
This feature also updates links in Name List Macros on creation, rename, and deletion of documents.
This feature requires a reindex of the projectdoc Confluence cache. Please refer to Troubleshooting Reindexer for projectdoc Documents for details.
Update Category Doctype
The Category doctype requires an improvement on defining its name. In previous version of the Core Doctypes the name of the category started with a blank character. With PDCORED-271 - Getting issue details... STATUS the name has been corrected. This fix is required by the Create Links Feature to successfully update the link with the Name List Macro.
