This page documented all changes which affect public usage. For a complete list see JIRA project releases.
General
- Upgrade to Java 8
- Upgrade to Maven 3.2.5 prerequisite
- Move to SLF4J everywhere
- Replace Plexus Container with Sisu Shim
- Use JSR 330 annotations instead of Plexus one
Stack
The entire stack consists of multiple components which make up the entire system to produce and render documents for Maven sites and report plugins.
Doxia 2.0.0
- Remove Doxia Logging API (replaced by SLF4J)
- Remove deprecated macros (SWF, SSI)
- Remove deprecated modules:
- old formats: Confluence, DocBook, TWiki
- page-oriented output formats: FOP, iText, LaTeX, RTF
- Remove deprecated code
- Replace XHTML module with XHTML5 as default
- Section titles (see Doxia API sectionTitle(int) API) are now converted to HTML
<h1>
to<h5>
(Doxia API sectionTitle1() to Doxia API sectionTitle5()) for XHTML5 instead of from<h2>
- Upgrade to Flexmark 0.62.2
- Remove all non-HTML5 elements and attributes
- Use id attribute for XHTML5 throughout instead of name for anchors
Doxia Sitetools 2.0.0
- Upgrade to Doxia 2.0.0
- Remove DocRenderer = document-oriented rendering, leaving only SiteRenderer in place = site-oriented rendering
- Remove deprecated code
- Fail if deprecated
${reports}
,${parentProject}
or${modules}
is found - Upgrade to Velocity 2.3 and Velocity Tools 3.1
- Require a skin if a site descriptor (
site.xml
) has been provided - Don't inject bannerLeft is none is set
- Locale must not be
null
- Deprecate Google-related site descriptor properties
- Don't create anchors behind the user's back (avoid mess and duplication)
- Remove internal (pseudo) skin and use Maven Fluido Skin by default
- Overhaul locale support (make
Locale#ROOT
instead ofLocale#ENGLISH
default and use full locale)
Maven Reporting API 4.0.0
- Upgrade to Doxia 2.0.0
- Locale must not be null (use
Locale#ROOT
instead)
Maven Reporting Impl 4.0.0
- Upgrade to Maven Reporting API 4.0.0
- Upgrade to Doxia 2.0.0
- Upgrade to Doxia Sitetools 2.0.0
- Render with a skin when report plugin is run in standalone mode (defaults to Maven Fluido Skin)
- Notify skin via Velocity context property whether running in standalone or site mode
Maven Reporting Exec 2.0.0
- Upgrade to Maven Reporting API 4.0.0
- Upgrade to Doxia 2.0.0
Maven Site Plugin 4.0.0
- Upgrade to Maven Reporting API 4.0.0
- Upgrade to Doxia 2.0.0
- Upgrade to Doxia Sitetools 2.0.0
- Upgrade to Maven Reporting Exec 2.0.0
- Execute reports for all configured locales
- Overhaul locale support (make
Locale#ROOT
instead ofLocale#ENGLISH
default and use full locale)
Progress
Necessary changes performed at our (reporting) plugins
Format: {jira-project}
: {last-doxia-1.x-compat}
; {branch-for-doxia-2.0.0}
: {version-next}
- MPIR: api-3.1.1/impl-3.2.0 [X]; doxia-2.0.0: 4.0.0-SNAPSHOT
- MPLUGIN: api-3.1.1/impl-3.2.0 [X]; doxia-2.0.0: 3.8.0-SNAPSHOT
- JXR: api-3.1.1/impl-3.2.0 [X]; doxia-2.0.0: 4.0.0-SNAPSHOT
- MPMD: api-3.1.1/impl-3.2.0 [X]; doxia-2.0.0: 4.0.0-SNAPSHOT
- MJAVADOC: api-3.1.1 [X]
- MCHECKSTYLE: api-3.1.1/impl-3.2.0 [X]; doxia-2.0.0: 4.0.0-SNAPSHOT
- MCHANGES: Won't do, plugin has too many dependencies
- MPH: api-3.1.1 [X]; doxia-2.0.0: 4.0.0-SNAPSHOT
- MSUREFIRE: api-3.1.1/impl-3.2.0 [X]
- MPDF: api-3.1.1 [X]; no upgrade, page-oriented support has been removed
- MDEP: api-3.1.1/impl-3.2.0 [X]; doxia-2.0.0: X-SNAPSHOT
- MINVOKER: api-3.1.1/impl-3.2.0 [X]; open
- MSKINS Fluido: 1.11.x; master: 2.0.0-M2
Migration Notes
Reporting Plugin Maintainers
- Sink tables must start with
Sink#table()
+Sink#tableRows()
and end withSink#tableRows_()
+Sink#table_()
- Runs UTs and ITs and compare HTML output with Doxia 1.x stack. If anything breaks for you, report with us.
- Anchors must be placed before the target element
Skin Writers
- Table border attribute is not used anymore, it has been replaced with the CSS class
bodyTableBorder
Maven Site Plugin Users
- When using multiple locales, make sure that you supply
default
as well otherwise no root site will be generated - You must supply a skin if you are using a
site.xml