Opened 3 years ago

Closed 3 years ago

#5006 closed defect (fixed)

PDF version of Kea User's Guide 1.1.0-beta looks ugly

Reported by: tomek Owned by: fdupont
Priority: medium Milestone: Kea1.1-final
Component: documentation Version: git
Keywords: Cc:
CVSS Scoring: Parent Tickets:
Sensitive: no Defect Severity: N/A
Sub-Project: DHCP Feature Depending on Ticket:
Estimated Difficulty: 1 Add Hours to Ticket: 0
Total Hours: 1 Internal?: no

Description

There are several issues:

  1. the logo takes too much space at the top, so the header overlaps with the text below. See table of contents as a good example of this problem.
  1. Some text is overflowing for example on page 5 (section 2.1)
  1. The Kea logo has a small horizontal line in its left bottom corner.

Subtickets

Change History (8)

comment:1 Changed 3 years ago by tomek

  • Milestone changed from Kea-proposed to Kea1.1-final

comment:2 Changed 3 years ago by fdupont

For 2 I propose to add -P filename.as.url=0 in Makefile.am (BTW -P does the same than --param= and as it is shorter IMHO should be used (and not --param=).

comment:3 Changed 3 years ago by fdupont

For 1 I had good success by add a scale=50, unfortunately it broke the html rendering. So I propose:
-P imagedata.default.scale="maxwidth=50px,maxheigth=35px"
Note it applies to all images, fortunately there is only one!

It can't see 3, perhaps it is the small thing after Manual in each page top title? On my Fedora VM it is very light grey so IMHO we can live with that.

To finish if you like my proposals please give the ticket to me.

comment:4 Changed 3 years ago by fdupont

  • Owner set to fdupont
  • Status changed from new to accepted

comment:5 Changed 3 years ago by fdupont

  • Estimated Difficulty changed from 0 to 1
  • Owner changed from fdupont to UnAssigned
  • Status changed from accepted to reviewing
  • Total Hours changed from 0 to 1

comment:6 Changed 3 years ago by stephen

  • Owner changed from UnAssigned to stephen

comment:7 Changed 3 years ago by stephen

  • Owner changed from stephen to fdupont

Reviewed commit 03242b6be67406116db01fd466ac4704cf78a60a

The changes look OK. I've made two further changes:

dhcp4-srv.xml
Moved the "hosts-storage4" ID from the "title" tag to the preceding "section" tag. This gets rid of a warning message Don't know what gentext to create for xref to: "title" (linkend=hosts-storage4)

kea-guide.xml
Altered the logo and title so that the logo appears to the left of the title instead of the right. I think that looks more natural in the page header.

Please review these.

Otherwise, OK to merge.

comment:8 Changed 3 years ago by fdupont

  • Resolution set to fixed
  • Status changed from reviewing to closed

Merged. Closing.

Note: See TracTickets for help on using tickets.