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.
#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.
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.
Add-on for the projectdoc Toolbox | Version |
---|---|
11.0.0 | |
6.0.2 | |
3.0.1 |
List of Changes
The complete list of changes for this release.
The following changes are part of the latest projectdoc Toolbox for Confluence.
Key | Summary | T | P | Status | Resolution | Description |
---|---|---|---|---|---|---|
PDAC-878 | Template Support for Table Columns |
|
|
Done | Fixed |
The Display Table Macro should support templates for columns. Use #COLUMN_NAME{TEMPLATE} as syntax to specify a template (with references to properties) for a column. The COLUMN_NAME should be used as the column heading. The template is applied to each cell in the column. |
PDAC-879 | Box Support for Transclusion |
|
![]() |
Done | Fixed |
Box macros need to be able to be transcluded. |
PDAC-877 | Tool Support |
|
![]() |
Done | Fixed |
Support tools for Model Projects. |
PDAC-875 | Scroll Office Boxes Support for Name List Macro |
|
![]() |
Done | Fixed |
The Name List Macro allows to render Boxes styled by CSS. Unfortunately the boxes do not render with Scroll Office since the structure we render does not match that of the status macro. We need to follow the structure of the status macro to be rendered in the generated Word document. |
PDAC-874 | Support Calender in every Content Provider |
|
![]() |
Done | Fixed |
Currently only one Content Provider add date information. Since some blueprints require date and some other feature we need to provide the date service to all Content Providers. |
PDAC-872 | Doctype Homepage Property |
|
![]() |
Done | Fixed |
Provide an artificial property called 'Doctype Homepage' that renders a link to the doctype's homepage. This is currently what the Display Table does for the 'Doctype' property automatically (but maybe should not in future). Provding a new artificial property allows this feature to use in all context where properties of documents are accessed. Note that this feature requires a reindex since the new artificial property needs to be created. |
PDAC-871 | Space Console Construction for nameless Space Homepages |
|
![]() |
Done | Fixed |
Creating a default Name Property from the Title Property for the Nameless Document Feature fails if the space homepage (or related pages) do themselves not provide a Name property. Since we do not want to force users to provide a Name property, this needs to be fixed. |
PDAC-876 | Heading Styles Fix for Display Table |
|
|
Done | Fixed |
Styles fail to be applied to the correct header column in case the counter column is activated. |
PDAC-873 | hide-metadata-for-printing fails for Word |
|
|
Done | Fixed |
Using the space hide-metadata-for-printing works for PDF export, but not for Word. Word supposedly does not support CSS. |
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.
Key | Summary | T | P | Status | Resolution | Description |
---|---|---|---|---|---|---|
PDCORED-152 | Documentation Dashboard |
|
|
Done | Fixed |
Provide a tool where author boxes are being tracked. Instead of the first version, the boxes should be listed on different pages. |
PDCORED-155 | Docsection Support for Homepages and Index Pages |
|
![]() |
Done | Fixed |
To make it easier to provide additional views on documents, the section on homepages and index pages should display additional docsections (as children to the homepage) automatically. |
PDCORED-153 | Add Documentation Section to Role |
|
![]() |
Done | Fixed |
Since Audience is part of every document, listing the documents with the role seems quite natural. |
PDCORED-156 | Translation missing for Duration |
|
|
Done | Fixed |
The translation for the property duration is missing for locale DE for the resource doctype. |
PDCORED-154 | Stimulus Selection for Role Doctype |
|
|
Done | Fixed |
The role doctype fails to translate the stimulus localization key. |
PDCORED-151 | Typo in Subordinate Excerpts Heading (DE) |
|
|
Done | Fixed |
The Heading "excerpt.xmle" must read "Exzerpte". |
projectdoc Developer Diaries
List of changes in this add-on.
Key | Summary | T | P | Status | Resolution | Description |
---|---|---|---|---|---|---|
DEVDIARY-66 | Restrict Mood Search on Year Doctype |
|
|
Done | Fixed |
The year template needs to restrict the search for the mood graph to its children. |
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.
Key | Summary | T | P | Status | Resolution | Description |
---|---|---|---|---|---|---|
PDEXWAPI-22 | Properties Input Problem |
|
|
Done | Fixed |
Posting a properties file fails with java.lang.IllegalArgumentException: argument type mismatch |
PDEXWAPI-21 | HTML Rendering fails |
|
|
Done | Fixed |
Choosing HTML as rendering option for sections fails to render the Confluence storage format input properly. |
Resources
- Release Notes for the projectdoc Toolbox
- Relevant information on changes to the projectdoc Toolbox for Confluence introduces by new versions of this app.
- Glossary
- Terms used in and defined for projectdoc.
- FAQs
- Questions and answers related to the projectdoc Toolbox and Confluence.