GNOME Bugzilla – Bug 600456
Making a mallard index doesn't work when the path has non-ASCII characters
Last modified: 2020-03-03 18:36:17 UTC
I had a guide/index page and a topic page, both in a path with a non-ASCI character. Running "make" (Makefile to be attached) did generate valid xhtml files, but index.xhtml didn't have an entry about the topic page. Changing the files to a path without non-ASCII characters made the process work flawlessly. Please make sure the building tolerates non-ASCII characters.
This bug is still true for GNOME 2.30 (gnome-doc-utils 0.20). There's no need for a Makefile any more, but this bug can be reproduced by having a direcory with non-ASCII characters in the name, and running inside it "gnome-doc-tool html *.page"
You don't have to convert Mallard pages to (X)HTML to have issues with the non-ASCII characters. I you wipe everything except for the *.page files, and then run "yelp $directory", it will only work if the directory path doesn't contain any non-ASCII character.
gnome-doc-utils has been superseded by yelp-xsl, yelp-tools, and itstool. gnome-doc-utils will not see any further development, hence closing as WONTFIX. See https://gitlab.gnome.org/Infrastructure/Infrastructure/issues/255