freetype-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [ft-devel] Problem with `make refdoc'


From: Nikhil Ramakrishnan
Subject: Re: [ft-devel] Problem with `make refdoc'
Date: Thu, 2 Aug 2018 01:30:20 +0530

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

reply via email to

[Prev in Thread] Current Thread [Next in Thread]