DocJGenerator / Blog: Recent posts

Use MDIUtilities 1.2.36
Use jEditor 1.2.12
Remove JavaFX dependencies from the core jar (that makes the tool directly usable on versions of the JRE greater than Java 9 without having to add the JavaFX library)
Fix the tool not working on Linux-like platforms (tested on Mac OS X)
Add the new T-SQL name for the tsql syntax, and the bash name for the shell syntax
Add new parameters for the messageBox element to add an optional caption on the box
Improve the lisibility of the messageBox for the error type
Improve the layout when using a messageBox after a pre element

Change the incremental generation option name to incrementalGeneration
Change the incremental generation file option name to incrementalGenerationFile

Add an emptyLines property to specify how empty lines in the source would appear
Fix some cases where empty lines would not appear in the middle of a sentence
The references on the index article must have the Home page name (ie "Home" in English for example), rather than "INDEX"
Allow to explicitly refer to the index article
Fix the references on the index article which were not working
Fix an inversion in the GUI between the "showGlossaryErrors" and the "checkHTTPLinks" options
Fix the default text on resources links not being set
Improve the layout of images which are first in their line
Avoid to generate many times the same image for message boxes for default types icons
Fix cases where invalid javadoc links where seen as valid since an Oracle website update
Add Java 17 , Java 18, and Java 19 APIs
Add an update mode
Use MDIUtilities 1.2.34
Use jsoup 1.15.3
Use jEditor 1.2.11
Update to commons.io 2.11.0 for jEuclid
Add a "docjVersion" property for the version of the generator used for the generation of the wiki
Add alternate names for some highlighting syntaxes

Fix the library not being included anymore in the binary distribution (regression)
Fix the tutorials zip file being incomplete
Fix the docx generation for tables with specified columns widths which was incorrect and could lead to content not shown in the docx result
Add conditions for articles
Add a "hasNotProperty" condition type for the conditions
Fix the count of articles being incorrect in some cases where disambiguation articles are created automatically
Fix the redirections not being taken into account in the mediawiki format
Allow conditions inside a list or a table
Protect against cases where image ids or infobox ids have spaces before or after the id
The library replace accented characters to their equivalent unaccented character for article names and titles rather than completely remove them

Change the DocGeneratorAPI methods to reference to another article to point to XMLParentArticle elements rather than XMLArticle elements
Rename the getVoidArticle method as getOpaqueArticle in the DocGeneratorAPI
Fix several cases in the DocGeneratorAPI where references where not normalized, which could lead to parsing errors at resolve
Fix the alignment of table rows when some rows have custom widths
Change the addInternalMenuItem in the DocGeneratorAPI to use a XMLParentArticle rather than a XMLArticle
Fix some exceptions related to the use of OpaqueArticle elements in the DocGeneratorAPI

Add a "hasTOC" property to allow to specify that articles should not have a table of content
Add a "tocThreshold" property to specify the threshold of the table of content for articles
Fix the API included in the main docGenerator.jar file
Fix the check of Java API for arrays which did not work when accessing the API through a Java installation or jar file
Fix the check and link of java APIs when using arrays as arguments
Fix the check and link of java APIs when using varargs as arguments
Fix some cases where the generation of a table row with a custom width was incorrect
Fix cleaning the left menu not working in the API
Reorganize some unit tests to put them in folders for their categories
Change and improve the way APIs are parsed and checked
Use jsoup 1.15.2
Use MDIUtilities 1.2.31
Add a "hasDictionary" property to allow to specify if the wiki must have a dictionary
Add a "hasCategories" property to allow to specify if the wiki must have categories
Fix the check and link of java APIs when using generics as arguments
By default creating an API now does not reset the configuration. A new constructor allows to force the reset of the configuration
Fix the header of tables not having a border (regression)

Add methods in the API to create a header or a footer
Support colors defined on table rows
Add methods in the API to set the content of menus
Add methods in the API to add an external link
Allow to completely customize the left menu
Fix the alternate titles being incorrectly spelled for the categories
Support the "checkLink" attribute for external links
Colors in table rows are supported on PDF or DOCX
Fix the PDF generation throwing a NPE if there is no header on a table
Add methods in the API to automatically convert new lines or tabulations to break or tabulations elements in html
Fix the generation of tables when there are rows with specified widths
Support tabs in PDF and DOCX generation
Support the manual glossary on DOCX
Use jsoup 1.15.1

Fix the glossary having a manual policy by default
Support hand-written html articles in PDF
Fix the first page for PDF documents being empty
Add the title page for the docx and pdf format if specified
Add new methods in the API to avoid to specify a parent
Fix the addItem method in the XMLList element which did not correctly added the item
Add new methods in the XMLList element to add a sub-list as an item in the list, or a leaf item in the list
Add a method in the XMLArticle element to add a category to the article
Fix the category creation triggering a NPE in the API
Add new methods in the API to add an article in categories at the article creation
Add the capability to not have a border for one row only
Add the capability to set the width of a table
Check the validity of named font sizes
Allow to set glossary words on titles or articles
Allow to set the color of an entire row in a table
Allow to set the alignment of a table cell or table column
Fix the colspan and rowspan of table cells not correctly parsed
Fix the API zip file not containing all the jar files it needed
Be more lenient with the pattern for the coords attribute on images areaRefs
Fix the values of the areaRef coordinates for images which have a specified width or height
Support a search with custom categories
Support the manual glossary in the docx generation
Allow to set the border of table rows appearance, and implement them with html and docx
Allow to add a style to an anchor, and add the "format" attribute for the "anchor" element
Allow to remove separately the horizontal or vertical borders in a table row
Allow to specify specifically the widths of one table row

Allow the "subscript" and "superscript" values for the "type" attribute of the "font" element, in addition to "sub" and "super"
Fix the size attribute of the "font" element not being correctly handled, now the writer always writes the associated text with a CSS style (the result is valid HTML5)
Support anchors for the Help format
Avoid to add unwanted ending span content in raw html titles
Correctly parse font declarations with several times the same font format declaration
Add the "removeNav" attribute for hand-written html articles to remove "nav" content in the html file
Add the "removeH1Titles" attribute for hand-written html articles to skip h1 titles
Support hand-written html files for the help format
Fix a regression where full text search would not be handled anymore since 1.6b2
Support the strikethrough value for the "type" attribute of the "font" element
Fix some cases where the first line of a "pre" content would be off by one space
Fix a StackOverflowException which would happen if there are several articles with identical alternate titles
Add the "comment" element and add a mode to review the wiki content
Add a manual way to define the glossary words associated articles
Allow to use a circle or a polygon for the areaRef element
Add a Imagemap Converter tool which helps to generate the coordinates for an areaRef
Add options to specify how the content is scrolled or not scrolled in a "pre" element
Allow the user to redimension the left menu
Add support for lists and images for hand-written html files in the docx generation

Fix some cases where a text with only a font family would be written with the default font
Allow to name the "dictionary" element "dictionary" rather than "dictionnary" (the old naming is still allowed)
Allow to name the "dictionary" attribute in alternate titles "dictionary" rather than "dictionnary" (the old naming is still allowed)
Fix the alternate titles always being put in the dictionary even if the "dictionary" attribute value was false
Add the "pruneAltTitles" property to allow to not put alternate titles in the dictionary if their content is sufficiently similar to the article title
Make the progress messageBox more readable by tweaking the luminosity of the background and how the hyperlinks are shown inside the box
Handle hand-written html pages for the html and ePub output types
Fix some cases where "br" where skipped
Avoid to print error text when parsing css content for PDF or DOCX content if the css URL has invalid content
Fix a problem when parsing CSS selectors for the PDF or DOCX format when there was more than one class attribute for one selector
Use MDIUtilities 1.2.30

Add a "searchable" attribute for titles and chapter to allow the title or chapter not to be searchable in the search box
Fix the Class-Path property in the framework manifest which could prevent the project to be built on Mac OS X or Linux
Add a search option to also search the anchors in articles
Add an option to put a background under "code" and "source" elements
Add an option to put a background by default under "pre" elements
Add an API to allow to use docJGenerator as a library in another Java application
Increase the padding around the "messageBox" boxes
Add an optional "id" for chapter or titles to refer to it
Allow to name the "face" element as "family" for "font"
Allow to force the identifier for the table of content for a title or chapter in an article
Allow to add tables under li elements
Allow to specify the padding of table rows

Fix some cases where empty lines were not shown in the middle of pre content
Add a "checkLink" attribute for elements which have external links to allow to specifically not check an external link for an element
Fix cases where specifying members for .NET apis would create warnings if external links were checked

Fix a NPE which could be thrown if there are lots of exceptions because of unfound links
Add a maxWith and maxHeight attributes for img elements to avoid the image to exceed the native image width or height
Improve error messages when an anchor is not found on an article

Fix the generator (on windows) still not taking correctly into account cases where several images or resources files have a different name ignoring the case

Add an attribute for alternate titles to not put the alternate title in the dictionary or categories
Fix the generator not taking correctly into account cases where several images or resources files have the same name (even if they are defined in different directories)
Support links to python documentation
Add the fullTextSearchMetaphone and fullTextSearchRemoveAccents properties to further configure the full text search

Use jSoup 1.14.3
Use jElasticlunr 1.7
Use MDIUtilities 1.2.25.6
Fix the source distribution not containing one jpg image resource
Increase the line height for the table of contents
Show the path of files for errors relative to the root directory
Allow to open the source of the articles where errors were detected during the parsing from the error window
Allow to save as HTML the content of the error window
Update the handling of parsing errors to be sure that the ordering of the errors files will always be identical
Fix the external links not being checked for the Mediawiki or Markdown articles
Fix the handling of some incorrect html content of math content
Fix cases where there is more than one index in the wiki source
Emit an error if there is no index in the wiki source. In that case a default empty index is added to the output
Fix a regression since 1.5.5 where HTML links checking was not performed the second time when using the GUI twice

Use jEditor 1.2.9
Use MDIUtilities 1.2.25.4
Use JSoup 1.14.2
Use epublib2 1.3.1
Fix some cases where the pre syntax thrown an exception
Allow to use external files for the pre content
Fix references not taken into account in messageBox elements
Add a menu which allows to generate a configuration properties file from the GUI
It is now possible to use the "input" text field in the GUI to specify the input directory
Fix the handling of the chapter element
Allow to create images with a transparent background
Support the cover option in the configuration
Add the "progress" type for messageBox

Use MDIUtilities 1.2.25.2
Improve performance for checking http links
Add new detailed performance statistics
Add a new mode which uses threaded parsing. This mode greatly improves parsing performance

Fix some cases where an IndexOutOfBoundsException was thrown when writing the content of the wiki
Use MDIUtilities 1.2.25.1
Fix some cases where the last character in a "pre" was skipped
Add the "color" attribute to set the background of a "pre" element
Fix not being able to refer to the glossary in menus
Improve performance when parsing options or articles
Add a "showDetailedGenerationTimes" option to show more detailed informations about the generation time
Fix some Java API links which were incorrectly checked as valid when they were not since 1.5.4
Fix some links anchor checks which were incorrect

Options specified as command-line arguments are overriding those specified in the configuration file
Fix a typo in an error message
Fix a NPE when using a "moreInfo" for an article which have a name already used by another article
Fix some problems when creating automatically disambiguation articles
Fix the library not working on Linux systems
Fix cases where Java API links validity check result was incorrectly invalid
Use MDIUtilities 1.2.25
Use jsoup 1.14.1

Fix the description case for "info" elements in "moreInfo"

Add a "-version" option to get the version of the DocJGenerator library on the console
Fix the layout of the full text search page which could be incorrect when using a background image
Use MDIUtilities 1.2.17
Use jEditor 1.2.8
Take into account the articles selection in the search field or in the links to scroll the tree to the selected articles in the JavaFX or Swing help viewer
Allow to keep the order of specified articles in the help specification
Now articles which are specifically added to a help chapter are sure to be in this chapter even if they are in a category added to another chapter of a greater priority
Now articles which are specifically added to a document chapter are sure to be in this chapter even if they are in a category added to another chapter of a greater priority
Allow to keep the order of specified articles in the document content specification
Fix the PDF writer having a glossary in the table of content even if there is no glossary

Use MDIUtilities 1.2.14
Use scriptHelper 1.5.15
Add JAVA 16 to the predefined Java APIs
Add new capabilities in the help content specification: it is now possible to add explicitly an article, exclude an article, or add or exclude a group of categories
Add new capabilities in the document content specification: it is now possible to add explicitly a group of categories
Simplify the way to write derived names for references
Fix the SwingHelpContentViewer help component importing JavaFX classes by default, even if using Swing for html pages, which could lead to an exception at initialization if JavaFX classes are not available
Fix the setLoadHTMLInSwing in the SwingHelpContentViewer not setting correctly the viewer state if using Swing
Fallback to Swing for html pages when using the Swing content viewer if the JavaFX classes are not available
Fix the full text search in the help component not working for compressed indexes

The width of images which are defined as a percentage is kept at 100% for the help format to improve readability

Fix another error when generating the help format