Re: Important changes in Docwriter

[Werner LEMBERG]

Hello Nikhil,


six weeks ago you wrote:

> A quick tip: If search does not work for you while browsing the docs
> locally, try running `mkdocs serve' (or `python3 -m mkdocs serve')
> in the `docs/' directory (after `make refdoc').  This serves the
> site on a local server, providing a more website-like experience.

I have problems with that.

  * build a FreeType tarball with `make dist`

  * unpack the tarball

  * change to the `docs` directory (from the tarball) and call `mkdocs
    serve`

The last step fails with

  Config file '.../docs/mkdocs.yml' does not exist.

Note that `mkdocs.yml` gets explicitly removed while calling `make
dist` (see `builds/toplevel.mk`).

What must I do to get local search capabilities?  This is, I want to
open the local file

  docs/reference/index.html

in my browser and be able to use the search field.


    Werner