HTML Publisher Plugin

Plugin Information

Plugin ID htmlpublisher
Latest Release 1.2
Latest Release Date May 15, 2013
Sources Github
Support Eclipse Hudson Forum
Issue Tracking Eclipse Bugzilla

This plugin publishes HTML reports.

Note: Requires Hudson 2 version 1.341 or greater (1.312 or greater for version 0.1.0). Requires Hudson 3 version 3.0.0-M4 or greater.

Installation Steps:

1. Go to Hudson Dashboard
2. Click on the link that says "Manage Hudson"
3. On the Plugin Manager page, go to the "Available" tab next to Updates tab
4. Look for the html publisher plugin, select the checkbox and click install. Wait for it come back with status "Success".
5. Restart the hudson by clicking the provided link on the success page, or if using tomcat, executing <tomcat-Hudson>/bin/shutdown.sh and <tomcat-Hudson>/bin/startup.sh

How to use HTML Publisher Plugin:

HtmlPublisher plugin is useful to publish the html reports that your build generates to hudson webpage. Below are the steps to publish and archive the html report files

1. Click on the Configure option for your Hudson job.

2. In the post build portion, look for the Publish HTML Reports option and select the checkbox. See the screen shot below

Fill the path to the directory containing the html reports in the "HTML directory to archive" field. Specify the pages to display (default index.html); you can specify multiple comma-separated pages and each will be a tab on the report page. Finally, give a name in the Report Title field, which will be used to provide a link to the report.

3. After saving the configuration, run build once. The published HTML reports are available to view from within Hudson with convenient links in the dashboard.

Version History

Version 0.6 (Jan 20th, 2011)

  • added Zip option to HTML Report View - this will provide a Zip file of the contents of the particular report (issue #8163)

Version 0.5 (Jan 20th, 2011)

  • this version unintentionally left blank

Version 0.4 (May 24th, 2010)

  • the "Back to Hudson" link is now "Back to JOBNAME" and goes back to the job instead of the hudson root (issue #6521)

Version 0.3 (May 10th, 2010)

  • display per-build report links after a restart (only works for builds after the upgrade, alas) (issue #5775)
  • don't display report links if there aren't reports yet (issue #5683)
  • "Back to Hudson" link triggers a back action in the browser if the user hasn't configured the Hudson URL (issue #6434)

Version 0.2.2 (Feb 17th, 2010)

  • show all project-level reports on the project page, not just the first (issue #5069)

Version 0.1.0

  • initial release from abstraction of NCover plugin, allowing for archiving and displaying of HTML report directories

Labels:

plugin-upload plugin-upload Delete
tier3-hudson-plugin tier3-hudson-plugin Delete
Enter labels to add to this page:
Wait Image 
Looking for a label? Just start typing.
  1. Jan 27, 2011

    Anna Saranti says:

    Hi, I am archiving the results of a Hudson job run according to the Job'sName a...

    Hi,

    I am archiving the results of a Hudson job run according to the Job'sName and BuildNumber.

    For that I'm using the environmental variables %JOB_NAME% and %BUILD_NUMBER%.

    Is it possible to use this variables into the path of the .html file in "HTML directory to archive"?

    For example C:\MyResults%JOB_NAME%_%BUILD_NUMBER%

    Thanks

  2. Jun 24, 2011

    Guozheng Ge says:

    Sorry, I could not figure out how to create a new bug ticket (joined at two plac...

    Sorry, I could not figure out how to create a new bug ticket (joined at two places and still cannot create a ticket in the opening issues). Anyways, here is my issue:

    We are using HTML publisher plugin in hudson v. 1.381. The build job is configured to use HTML reporter to show an index.html, which is a test report. But the report only gets created when there is failure in the tests. So, when all tests pass, there is no index.html, and we get this error:

    [htmlpublisher] Archiving HTML reports...
    [htmlpublisher] Archiving at PROJECT level <path1> to <path2>
    ERROR: Directory '<path1>' exists but failed copying to '<path2>'.
    ERROR: This is especially strange since your build otherwise succeeded.

    Is this caused by the plugin trying to find this html file, but could not find it? Is it possible to report the missing file in some other way rather than make the build fail?

  3. Sep 26, 2011

    katja says:

    htmlpublisher will modify the page encoding attribute of my program-generated HT...

    htmlpublisher will modify the page encoding attribute of my program-generated HTML file from utf-8 to iso-8859-1~

    That is from <meta http-equiv="Content-Type"  content="text/html; charset=UTF-8" />  to <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" >

    Hence, my reports are filled with a bunch of gibberish instead of Chinese characters~

    I wonder if anyone knows the solution here?

  4. Oct 06, 2011

    alfred hitchcock says:

    Hi, I have the same question what Anna Saranthi asked above. I am trying to give...

    Hi, I have the same question what Anna Saranthi asked above. I am trying to give the path as

    C:\Hudson-Payments\results%JOB_NAME%/%BUILD_NUMBER%/test-output

    The global variables are not being parsed. it actually is creating folders with %JOB_NAME% and %BUILD_NUMBER%

    Anna Saranthi: did you find any solution to this.

    was anybody able to do this.

  5. Oct 14, 2011

    katja says:

    For my question, I've already found the answer myself. In this directory on my ...

    For my question, I've already found the answer myself.

    In this directory on my machine :home/hudson/.hudson/plugins/htmlpublisher/WEB-INF/classes/htmlpublisher/HtmlPublisher

    There is this header.html, which is the default header attached to my code-generated html files.

    Modify the charset and xml:lang="en" of the header.html~ the problem will be solved.