Opened 18 months ago

Closed 18 months ago

Last modified 18 months ago

#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 strk, 18 months ago

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.

comment:2 by strk, 18 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:3 by Sandro Santilli <strk@…>, 18 months ago

Resolution: fixed
Status: newclosed

In d83e805/git:

Avoid xref to listitem, unsupported by PDF output

Closes #5418

comment:4 by strk, 18 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 strk, 18 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]

Last edited 18 months ago by strk (previous) (diff)
Note: See TracTickets for help on using tickets.