Bug#872944: www.debian.org: Debian Policy Manual not fully published

Sean Whitton <[email protected]> writes:

> The Debian Policy Manual just changed its HTML output and while the HTML
> has published, the CSS and included images have not.

> Looking at [1], the CSS and included images should have been published
> because they're still installed to
> /usr/share/doc/debian-policy/policy.html/.  So I think this is a problem
> on your end rather than ours.  Please do reassign this bug if I'm wrong
> about that, and thanks in advance for your help.

> [1]  https://anonscm.debian.org/cgit/debwww/cron.git/tree/parts/7doc

Hi debian-www folks,

Just a heads-up that we're fixing some more stuff and Policy 4.1.1.0 will
be a bit different again (it's not yet uploaded).  Here's what I currently
have staged for the next version:

* usr/share/doc/debian-policy/policy.html/ in the package will have the
  multi-file HTML version.  This is a directory with a couple of
  subdirectories, and all the internal HTML links should be relative.
  However, please note that some of the Javascript is symlinks to files
  that are shipped in the libjs-sphinxdoc package, so you may need a bit
  of machinery to turn those symlinks into real files.

* usr/share/doc/debian-policy/policy-1.html will be the single-file HTML
  version.  However, the Sphinix single-file version still requires static
  assets in usr/share/doc/debian-policy/{_images,_static} that will need
  to be in the right position relative to policy-1.html.  These have the
  same symlinks to libjs-sphinxdoc.

The current state in the archive right now only has the single-file
version, and it is in the policy.html subdirectory.  But we got feedback
after this release that people really wanted both versions available.

Unfortunately things might be just a touch chaotic for a bit as we work
through finishing this reStructuredText conversion.  Apologies for the
extra work!  We think the long-term result will be worth it both in terms
of better output and in terms of a more maintainable Policy document.