Support for Confluence 7.12 and Identify Text Passages for technical Texts.
Today we released version 4.12 of the projectdoc Toolbox.
This is a bugfix feature release.
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
Identify Text Passages
For technical documents, such as specifications, it is useful to make text elements inside a section identifiable.
This version allows to render an identifier with the Content Marker Macro by
PDAC-1442
-
Merge Paragraphs
Done
,
PDAC-1443
-
Content Marker Count
Done
, and
PDAC-1449
-
Debug Mode for Index Entries Table
Done
.
The above example shows definitions (Def...) and explanations (Expl...) numbered. The content is explicitly marked with the Content Marker Macro and tagged to be identified as definition or explanation. The numbers are added per position of the content.
For more information please refer to the tips Identify Document Elements and Merge Content.
Debug Mode
Some macros will provide a special debug mode that will render issues inside the page. One use case is to render terms of the glossary in a glossary section. If a term is not already defined, the missing term will be rendered in a box if debug mode is enabled.
For more information please refer to Debug Mode. For this version of the projectdoc Toolbox only the Index Entries Table Macro support this feature.
Upgrade Instructions
Please follow this short guide to update to this new version of the projectdoc Toolbox. For detailed information on dependencies, please consult the documentation of the add-ons.
Installation Order
Please install the projectdoc Toolbox first, then the extensions.
So this is the basic order:
- projectdoc Toolbox
- extension add-ons (start with Web API Extension)
Please install only those add-ons that are actually used! In case you do not use the Web API, there is no need to install it.
List of Changes
The following changes are part of the latest projectdoc Toolbox for Confluence.
Key | Summary | T | P | Description |
---|---|---|---|---|
PDAC-1454 | Support Confluence 7.12 |
|
|
Confluence 7.12 seems to no longer support the confluence-extractor-api-plugin. Also there is an issue with filesystem.filestore components. |
PDAC-1448 | Debug Mode |
|
![]() |
Support a space property named 'projectdoc.debug-mode' to control whether or not encountered issues should be presented in the rendered content. |
PDAC-1443 | Content Marker Count |
|
![]() |
Provide a parameter that allows to render a counter for the Content Marker Macro. This allows to autonumber content elements on a page. |
PDAC-1442 | Merge Paragraphs |
|
![]() |
A parameter of the Content Marker Macro allows to merge multiple paragraph elements. |
PDAC-1444 | Content Marker Wrapper Element Fix |
|
![]() |
The Wrapper Element parameter does not work if identifier is set for users with edit privileges. The specified element name must be checked to be a valid html tag. |
PDAC-1449 | Debug Mode for Index Entries Table |
|
|
Use the space property 'projectdoc.debug-mode' to render issues with undefined terms. |
PDAC-1455 | Fix Table Merger with named Columns |
|
|
If the column names to create a merged table are specified and the column name translation is used, the tables render incorrectly. Instead of merging the columns with different names, all columns are added despite the specified column names. |
PDAC-1453 | Performance Issue on Page Move |
|
|
On a page move the Move event is processed two times: On start and on end. |
PDAC-1452 | Performance Issue on Page Update |
|
|
When updating a page the artificial properties are calculated more than once with the same load strategy. |
PDAC-1451 | Page Preview for Table Merger Macro |
|
|
The Table Merger Macro should support page preview, but fails. |
PDAC-1447 | Unknown Space Tag Handling in Queries |
|
|
In the context of querying documents: If an unknown space category is specifed in a query (for instance with the Display Table Macro) and there is no other space in the query specified, then the result must be empty. |
PDAC-1446 | Cache Update on Attachment Delete |
|
|
When a referenced attachment is deleted, the document is not removed from the cache. Then the link is still rendered as existing, but should be rendered as non existing. |
PDAC-1445 | Typo in Intro Text of Ressources (DE) |
|
|
The introductional text of the Resource section contrains a typo for the Locale DE. |
Related Releases
Extension Add-ons
The following extension are required to be updated for the projectdoc Toolbox.
Doctype Add-on | Version |
---|---|
9.1.1 | |
3.3.0 |
Web API Extension
The following changes are part of the latest Web API Extension.
Key | Summary | T | P | Status | Resolution | Description |
---|---|---|---|---|---|---|
PDEXWAPI-60 | Ready for Read-Only Mode |
|
![]() |
Done | Fixed |
As part of data center support the read-only mode must be considered by the event processing and REST services. This makes the extension ready to support read-only mode. |
PDEXWAPI-57 | Reference Space |
|
![]() |
Done | Fixed |
Support the reference space space property provided by the projectdoc Toolbox 4.10. |
PDEXWAPI-59 | Documents Search fails to Sort |
|
![]() |
Done | Fixed |
The query parameter sort-by does not work. |
Information Systems Extension
The following changes are part of the latest Information Systems Extension.
Key | Summary | T | P | Status | Resolution | Description |
---|---|---|---|---|---|---|
PDEXINFOSY-43 | Identifier Link Macro |
|
![]() |
Done | Fixed |
Add a macro to render pseudo-URLs. |
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.