Issues with the online version

[jonasmalacofilho]

Fixes:

• overflowing math (consider Switch TeX math rendering engines for HTML #101 if necessary) (PR Mathjax linebreaks #203)
• markers for (numbered/unnumbered) lists under heavy nesting (PR CSS: lists #204)
• properly style DTitle output (currently proxied by DParagraph(Highlight(...))) (PR CSS: DTitle #205)
• fix \url generation within captions (and, possibly, other elements) (PR CSS: headings adjustments #185)
• add next link at the bottom of each page for linear readers (PR Next button #189)

Additional output features:

• fix the generated headings levels for structural elements and figures/tables etc. (PR CSS: headings adjustments #185)
• implement "click to anchor/link" (and UI element to copy the link) to headings, figures, tables, boxes and paragraph titles (basically any vertical element with an id) (PR CSS: headings adjustments #185)
• fix placement of id attribute in figures for scrolls triggered by URL fragments (PR CSS: headings adjustments #185)
• generate a sitemap to help external search engines, check Search functionality #145 for possible additional requirements (WIP Sitemap Generation #179)

[craice]

sitemap

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"|urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">

  <url>
    <loc>https://brtguide.itdp.org/branch/master/guide/</loc>
    <lastmod>2017-06-19</lastmod>
    <changefreq>monthly</changefreq>
    <priority>0.5</priority>
  </url>

  (...)

</urlset>

<url> : Parent tag for each URL entry.
<loc>: URL of the page.
<lastmod>: The date of last modification of the file.
<changefreq>: How frequently the page is likely to change.
<priority>: The priority of this URL relative to other URLs on your site.

If we can set lastmod as the last time that page was changed, that would be better, but the last build will work too. The default priority of a page is 0.5 and I would use it for most of the pages and 1 for pages like the table of contents. I'm not sure about the changefreqparameter, I think that should be defined by the search engine.

for more: https://www.sitemaps.org/protocol.html

[jonasmalacofilho]

Id placement on figures causes issues when trying to link to them: since the ids are in the captions, the browser scroll past the actual image when navigating to the corresponding fragment.

Btw, @craice, I guess I had already started experimenting (without success) with the whole click-to-anchor thing. I'm not even sure that commit can be cleanly applied anymore, but it might give you some insight.