Hi, running > > pip install --user docwriter > > was successful! However, if I now say > > make refdoc > > I get > > $ make refdoc > Running docwriter... > python -m docwriter \ [...] > > /usr/bin/python: No module named docwriter > > Reason is that my `pip' is actually `pip3', while my `python' is > actually `python2.7'. Sigh. I guess this is due to the fact that > I've installed python3 on my openSuSE box after python2... >
There are usually two packages, `python-pip' and `python3-pip' available in most distros, maybe you installed the `3' version. > I thus suggest that you change the order of checked binaries for both > python and pip in `configure.raw': > > AC_CHECK_PROGS([PYTHON], [python3 python2 python], [missing]) > AC_CHECK_PROGS([PIP], [pip3 pip2 pip], [missing]) > > This will work with `make' but I will have to hard-code these values in `unixddef.mk' (or use the defaults, which are `python' and `pip'), so it may still cause problems with `make devel'. Some comments (after running `make refdoc' with python2.7). > > * I see that there is `docs/reference/site/404.html'. This looks > strange. I would rather expect this file to be the top-level entry > point to the API reference (which actually is > `docs/reference/site/ft2-toc/index.html'). > Ah, generation of 404.html is a mkdocs thing that can't be disabled. Version 1.0 is in release candidate which removes the `page/index.html' format and instead directly creates `page.html'. Also, the top-level entry can be achieved by naming one of the files `index.md' (ideally the TOC). This will create a `docs/reference/index.html' file (which will be the TOC). Should I do this? > * Loading > > file:///.../docs/reference/site/ft2-toc/index.html > > in my browser(s) the search field doesn't work. Is this expected? > No, I am able to use search on `ft2-toc/index.html'. Is the search bar unresponsive, or does it not display any results? > * In Firefox, the magnifying glass left to the search field is > displayed as a missing glyph 0xE8B6 (i.e., a box containing these > four digits). This doesn't happen if I go to > > https://www.dxdy.ooo/freetype-web-jekyll/docs/reference/ft2-toc/ > > A similar issue happens for the small arrows in the left panel – it > seems that you have to load the corresponding web font – 0xE8B6 and > friends are characters from the Private Unicode Area (PUA); this > means they are font-specific and not generic. > Firefox comes with a very strict "file uri origin" policy by default. This prevents the local page from accessing the file system to get the required font(s). A workaround is to go to `about:config', filter by fileuri and toggle the preference security.fileuri.strict_origin_policy to set it to `false'. I'll see how this can be solved without changing browser policies. > * In Chrome, after opening a submenu in the left panel, pressing F5 to > reload the page doesn't close this submenu if I look at the local > site. However, looking at dxdy, it works as expected. > > [Note that Firefox doesn't close this even for dxdy – it would be > nice if there is a JavaScript fix possible.] > I can reproduce this. I'll look into it, and check if there is a solution. -- Nikhil
_______________________________________________ Freetype-devel mailing list [email protected] https://lists.nongnu.org/mailman/listinfo/freetype-devel
