https://jira.whamcloud.com This file is an XML representation of an issue en-us 9.4.14 940014 05-12-2023 https://jira.whamcloud.com/browse/LUDOC-13 Lustre Documentation <p>I suggest that the Makefile be enhanced with a 'make htmldiff'. </p> <p>I have had some success with:</p> <ol> <li>Build a manual.html (xhtml-1_1) from MASTER: <div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent"> <pre class="code-java">xsltproc --stringparam fop1.extensions 1 --stringparam section.label.includes.component.label 1 --stringparam section.autolabel 1 --stringparam chapter.autolabel 1 --stringparam appendix.autolabel 1 --xinclude -o /tmp/newmanual.html /usr/share/xml/docbook/stylesheet/docbook-xsl-ns/xhtml-1_1/docbook.xsl ./index.xml </pre> </div></div></li> <li>Build a newmanual.html (xhtml-1_1) from REVIEW.</li> <li>Create a diff.html with diff annotation using <a href="http://www.aaronsw.com/2002/diff/" class="external-link" target="_blank" rel="nofollow noopener">diff.py</a></li> <li>Point browser at diff.html.</li> </ol> LUDOC-13

reviewing changes is difficult in docbook xml

Improvement Minor Open Unresolved Lustre Manual Triage Richard Henwood QInfrastructure Fri, 15 Jul 2011 16:38:21 +0000 Thu, 15 Sep 2016 14:44:06 +0000 0 2 <p>The current html build task does not produce xhtml-1_1. Using diff.py on the current html output does not produce a useful result.</p> <p>It is probably prudent to wait for <a href="http://jira.whamcloud.com/browse/LUDOC-8" class="external-link" rel="nofollow">LUDOC-8</a> to complete first. This should enable simple addition of a xhtml build target.</p> <p>First draft at this feature:</p> <p><a href="http://review.whamcloud.com/#change,1127" class="external-link" target="_blank" rel="nofollow noopener">http://review.whamcloud.com/#change,1127</a></p> <p>NOTE: This depends on MASTER branch xhtml being built and available on build.whamcloud.com. This is not currently available.</p> <p>Change,1127 has landed. However, xhtml is still not being built. </p> <p>Either <a href="https://jira.whamcloud.com/browse/LUDOC-8" title="Use Makefile to validate, build manual on hudson." class="issue-link" data-issue-key="LUDOC-8"><del>LUDOC-8</del></a> needs to land or a manual build job modification needs to be made.</p> <p>I believe the problem here is that the xhtml artifacts are not appearing in the expect place at the end of the build:</p> <p><a href="http://jira.whamcloud.com/browse/IT-44" class="external-link" rel="nofollow">http://jira.whamcloud.com/browse/IT-44</a></p> <p>Joshua has fixed IT-44, progress continues...</p> <p>A couple of tweaks to the make file and ./diff.py are available here:</p> <p><a href="http://review.whamcloud.com/1909" class="external-link" target="_blank" rel="nofollow noopener">http://review.whamcloud.com/1909</a></p> <p>An additional enhancement is now available:</p> <p><a href="http://review.whamcloud.com/#change,2118" class="external-link" target="_blank" rel="nofollow noopener">http://review.whamcloud.com/#change,2118</a></p> <p>I've recently needed to do a diff again, and found that:</p> <p><a href="https://github.com/cygri/htmldiff" class="external-link" target="_blank" rel="nofollow noopener">https://github.com/cygri/htmldiff</a></p> <p>produces ok output on my test (but is slow.)</p> <p>I've been playing with daisydiff locally. It is fast and appears to be sensible.</p> <p><a href="http://code.google.com/p/daisydiff/" class="external-link" target="_blank" rel="nofollow noopener">http://code.google.com/p/daisydiff/</a></p> <p>Is there a plan to integrate this upstream somehow? Ideally it would be available in Gerrit.</p> <p>I haven't worked on this feature for a while - so the status of this ticket is currently 'dormant', with no plan to up-stream.</p> <p>UPDATE: We haven't found any resources to work on this recently - but we are interested in pursuing this when the opportunity arises.</p> Business Value 25.0 Development Rank 1|hzvl7j: Rank (Obsolete) 7197