#5418 closed defect (fixed)
Don't know what gentext to create for xref to: "listitem" (linkend=tiger_geocoder_loading_data)
Reported by: | strk | Owned by: | robe |
---|---|---|---|
Priority: | medium | Milestone: | PostGIS 3.4.0 |
Component: | documentation | Version: | master |
Keywords: | Cc: |
Description
Building PDF currently fails with this error:
Don't know what gentext to create for xref to: "listitem" (linkend=tiger_geocoder_loading_data)
See https://debbie.postgis.net/job/PostGIS_Make_Dist/4714/label=debbie/console
Change History (5)
comment:1 by , 17 months ago
comment:2 by , 17 months ago
Regina are you ok with linking the section containing the listitem rather than the specific listitem ? I know it's suboptimal, as it works in HTML, but maybe we can move on with PDF. The HTML version of it would look like this:
Refer to Section 2.4.1, “Tiger Geocoder Enabling your PostGIS database” for instructions on how to run the generate script.
comment:4 by , 17 months ago
For the record: the error in the subject is not the cause of PDF build failure, as it ALSO happens in the 3.2 branch without preventing a successful build of the pdf:
Don't know what gentext to create for xref to: "qandaentry" (linkend=legacy_faq) ... 'postgis-3.2.6dev.pdf' successfully built
comment:5 by , 17 months ago
Now that PDF generation works (#5419) I confirm the listitem target warning does not prevent building the PDF, but if would result in this text:
Refer to [?listitem] for instructions on how to run the generate script.
Instead of this:
Refer to Section 2.4.1 for instructions on how to run the generate script.
And the [?listitem]
word would not even be clickable, so I'd keep [d83e805/git]
The HTML version uses a made up number as the generated text. Maybe the PDF output is unable to do that.
Refer to 4 for instructions on how to run the generate script. This only needs to be done once.