- Created by Robert Reiner, last modified on 01. Jun 2023
Template Support for Table Columns, Box Support for Transclusion, Space Console Construction for nameless Space Homepages, Doctype Homepage Property, and Scroll Office Boxes Support for Name List Macro
Today we released version 2.3.0 of the projectdoc Toolbox on the Atlassian Marketplace!
This release provides some new features and fixes some issues.
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 following changes may be the most interesting of this release.
Template Support for Table Columns
This new version allows to specify a template for rendering a column with the Display Table Macro. Now you can render more than one property in a table cell using a template (like the one used by the Display Document Properties Macro).
Use Templates to render complex values in a column cell. The syntax to specify a template is
#COLUMN_NAME{TEMPLATE_SPECIFICATION}
The column name is the label to use for the column heading. It may be replaced using Header Translations.
The template specification uses placeholders to reference properties.
Example Template Specification
#My Label{${Doctype} / ${Iteration}}
The template will access the Doctype and Iteration property to render the specified string for each row in the given column.
Tool Support
This new feature is actually not directly relevant for users of the projectdoc Toolbox. It provides services to interface with the new tool model provided by the Doctypes Maven Plugin.
The new Core Doctypes provide a new version of the Documentation Dashboard takes advantage of this feature.
Please update Core Doctypes to version 11.0 for the new Documentation Dashboard!
Box Support for Transclusion
projectdoc boxes are now first-class citizens in respect to transclusion.
Every box provides its name (e.g. 'pending-box' for the Pending Box Macro) as a default tag.
Using the new Documentation Dashboard allows now to track boxes more conveniently.
Doctype Homepage Property
There is a new artificial property called 'Doctype Homepage' that is a link to the document's doctype homepage.
This feature was supported by the Display Table Macro by automatically rewriting the values in the Doctype column. The new approach is much cleaner and is supported by all macros.
Note, since this is a new artificial property, to have it provided by existing documents, a reindex is required. Otherwise only new and updated documents will provide this property.
Which artificial Properties are provided?
To list all properties of a projectdoc document, including the artificial properties, use the Display All Document Properties Macro. Or use a bookmarklet to render this information in a new window.
Upgrade Instructions
Install the new OBR of the projectdoc Toolbox.
To support the new artificial property Doctype Homepage, run a reindex. If you do not use this new property, a reindex is not required.
Updating the following doctype add-ons is recommended.
Related Releases
Doctype Add-ons
Doctype add-ons provide space and page blueprints based on the projectdoc Toolbox.
Doctype add-ons typically provide blueprints based on macros provided by the projectdoc Toolbox. These add-ons need a licensed version of the projectdoc Toolbox to be installed.
projectdoc Core Doctypes
List of changes in this add-on.
projectdoc Developer Diaries
List of changes in this add-on.
Extension Add-ons
Extension add-ons extends the functionality of the projectdoc Toolbox.
Extension add-ons for the projectdoc Toolbox provide additional features. Extensions need a licensed version of the projectdoc Toolbox to be installed.
Web API Extension
List of changes in this add-on.
Resources
- Release Notes for the projectdoc Toolbox
- Information on all released versions of the projectdoc Toolbox for Confluence.
- Glossary
- Terms used in and defined for projectdoc.
- FAQs
- Questions and answers related to the projectdoc Toolbox and Confluence.