perforce.js #3

# Change User Description Committed
#3 26953 Paul Allen Move //guest/perforce_software/p4convert to //guest/perforce_software/p4convert/main
#2 14806 Paul Allen Update docs and add +w.
#1 13919 Paul Allen part 1 of copy
//guest/paul_allen/p4convert-maven/docs/perforce/assets/webhelp/js/perforce.js
#1 13895 Paul Allen Copying using p4convert-docbook
//guest/perforce_software/doc_build/main/perforce/assets/webhelp/js/perforce.js
#7 12727 eedwards Further presentation tweaks to the prototype HTML docs:
- improve the presentation of the noscript warning when
  javascript is disabled.
- customize the javascript disabled text to refer to
  'documentation' instead of 'this site'
- remove some stray styles and cruft that interfered with the
  intended presentation
#6 12726 eedwards Tweaks to the TOC presentation in prototype HTML for docs:
- Animated open/close of TOC section
- Reflect open/close state in TOC section expansion button
- Made section nesting more visually apparent
#5 12725 eedwards Fixes for prototype HTML presentation:
- don't attempt to highlight search terms when there are none
- adjust inline-block styling in the header so that the text-overflow
  property takes effect as expected
- use smaller font sizes for headings for narrower browsers,
  and apply transitions to heading font sizes
- unroll transition styles to include all browser-specific transition
  styles.
#4 12723 eedwards Tweaks to search interface in HTML prototype for docs:
- hookup the search field's clear button
- adjust how the wordList is managed to allow for
  dynamic highlighting in the current page
- highlight search terms in the current page
#3 12722 eedwards Fix prototype HTML's javascript, to handle the implicit index.html case.
#2 12721 eedwards Tweaks to the prototype HTML presentation for docs:
- use CSS classes rather than hard-coded values in javascript
  to implement sidebar open/close
- made the search sidebar disappear when not open, not just
  to the right where it can be seen in wide browsers
- made the TOC sidebar disappear when the search sidebar
  appears (at narrow browser widths), and vice-versa.
#1 12720 eedwards Apply better organization for DocBook transformation assets.
In the future, other output target assets will appear as peers
of webhelp, within the assets directory.
//guest/perforce_software/doc_build/main/perforce/webhelp_assets/js/perforce.js
#3 12719 eedwards Minor updates to prototype HTML presentation:
- make ScrollSpy work, so that the current section of the
  documentation is highlighted in the sidebar TOC.
- add expander buttons to the TOC so that users can
  manually explore the TOC.
- remove the now-unused SIDR code.
- remove some cruft.
#2 12718 eedwards WebHelp transformation improvements:
- consolidate the Java indexer's output files into a single
  file to reduce HTTP requests, and tidy up the search assets
  the indexer created
- move the search interface and results into their own pane
  on the right side of the display
- make search incremental as users type
- replace existing navigation links with a TOC sidebar that is
  displayed when the browser is wide enough, or use a footer
  with prev/next links when the browser is too narrow. In the
  narrow presentation, the TOC sidebar can be toggled open.
- Various improvements to colours, formatting, at various
  browser sizes.
#1 12717 eedwards Initial prototype of new HTML generation intended to exist
on the Perforce public web site. The updates features a
more responsive design, removal of frames, styling
improvements.

More work needs to be done to ensure robust presentation
across various devices, and further design tweaks may be
required once various stakeholders get a chance to have
a look.

Future infrastructure work will need to be done:
- incorporate PDF generation
- some organizational tweaks to make additional output
  targets easy to add
- HTML validation assets need to be added/incorporated