It breaks the index generation in each swh-* package.

and thus prevent sphinx from complaining about rst files not being included in
a toctree without having to insert :orphan: everywhere.

so we do not build each swh-* twice with unavaoidable sphinx wrnings when
building each repo locally.

see D538 in which this swh-db-init command is added.

Closes T1264

Reviewers: anlambert, ardumont

Differential Revision: https://forge.softwareheritage.org/D458

Related P302

This document is supposed to be just the bare minimum to have a working
local swh-environment. Users shouldn't need any information about
advanced PostgreSQL setup and should just use the easiest auth method
(peer authentication).

Antoine Pietri authored 6 years ago and Stefano Zacchiroli committed 6 years ago

Reviewers: zack

Subscribers: zack

Differential Revision: https://forge.softwareheritage.org/D430

As a consequence of rDWAPPSb06167c8ab05

there is no need of separately creating the webpack

Closes T1193

we have a better bin/update now

Related T1193

Related T1193

the default highlighting directive put between page anchor got in the way of
extracting page title, making the page non-referencable

Related T1193

still to do: dependency installation, web app

Related T1193

Related T1193

This commit slighly modifies Makefiles in order to be able to build
the documentation on Debian stretch (using sphinx 1.4.9) but also
with the latest sphinx version to date (1.7.5).

Changes notably includes:

  - remove the --implicit-namespaces option for sphinx-apidoc as:

     * it is not needed
     * it is not supported on sphinx 1.4.9
     * output is not correct with sphinx 1.7.5

  - use sphinx -b option instead of -M for building html doc
    as an exception is raised otherwise when using sphinx 1.4.9

Related T1067

  - use the Alegreya font as in the other swh websites

  - add top navigation bar to efficiently jump between swh websites

Related T1065

This commit adds a postprocessing step on the generated html documentation for swh.
Its purpose is to modify the indices and search scope in each swh subproject doc.

Prior to that, when browsing a subproject doc, indices and search were scoped
to all swh projects. This was not really convenient for the reader who only
wanted to focus on a specific subproject. Now indices and search are only scoped
to each swh subproject content.

Nevertheless, global indices and search are still available from the
root documentation index.