Downloaded PDF Handbook – formatting issues
Type
musescore.org
Frequency
Few
Severity
S4 - Minor
Reproducibility
Always
Status
active
Regression
No
Workaround
No
Project
Re: New website
There are still formatting issues with the downloaded pdf manual.
(1) Certain html/CSS tags cause the text within to be squashed against the previous character:
(2) Only same-page links of the following structure
work in the pdf handbook. The other type of link gives a pop-up dialog offering to connect you to the website handbook.
(3) Most if not all links seem to be squashed against the character immediately preceding the link.
(c) Bold text may also be squashed against the previous character:
Comments
Not sure how and why this should be related to the new Website, it is the same PDF on the old and the new one I think? And I seem to remember (most of) these to be long standing issues.
The page-to-page link issue (2) has been reported quite a while ago in #142006: Not all links in handbook html/pdf export are internalised
BTW, there is a single page HTML version, see
https://musescore.org/en/print/book/export/html/36546?toc=1
There is quite some work still to be done with the handbook html/pdf version. I will come back to this ticket as soon as it's ready for testing.
I don't think any of this is specific to the new website.
How is the PDF handbook created?
The musescore.org website offers a printable friendly version of the handbook for each language. For english, it's here https://musescore.org/en/print/book/export/html/36546?pdf
It also provide a cover page https://musescore.org/en/handbook-cover
The following project https://github.com/musescore/handbook2PDF runs every day on Travis-CI, download handbook and cover page for each language and use https://wkhtmltopdf.org/ to create a PDF. The PDF is then uploaded to the musescore-nightlies share of the OSUOSL FTP.
The TOC for the PDF is generated with this XSL file https://github.com/musescore/handbook2PDF/blob/master/custom.xslt
I just created this reference page https://musescore.org/en/developers-handbook/references/user-handbook-p…
Thanks for referencing to the xlst lasconic. Exactly what we need to style the PDF issues raised by geetar.
@geetar As for the "Only same-page links of the following structure", could you see if you can reproduce the same problem in the html output at https://musescore.org/en/print/book/export/html/36546 and for the new site at https://new.musescore.org/en/print/book/export/html/36546 Thanks for your help!
I noticed that yesterday already, in https://musescore.org/en/print/book/export/html/36546 all the internal links work, same page or not, same for https://musescore.org/en/print/book/export/html/36546?pdf. Which is rather strange, assuming that this file is the source for the PDF
Re: The html handbook at the OLD website: https://musescore.org/en/print/book/export/html/36546
The same problem. i.e. only links of this type,
![link1.PNG]( "link1.PNG")
, lead to the same page. Other links take the user to the website handbook.
Re: The html handbook at the NEW website: https://musescore.org/en/comment/reply/239461/760546
Nothing happens when you click on any link.
@geetar I can't reproduce the link issue you have with the new handbook html output. Which browser/OS are you on?
@Thomas. Mozilla Firefox (54.0.1) on Windows 10. What happens is that the address bar updates correctly when I click on any link, but the browser does not load the new page.
@geetar thanks again. I can reproduce it. We'll work on it on Monday. Keeping you posted.
(Win 10/Mozilla Firefox 54.0.1). The link problem is now fixed, both in the downloaded pdf handbook and the on-line html pages (Old and new websites).
We still need to improve some styling for the handbook to improve readability. Once done, we can close this issue.
The third problem still exists, it's the most obvious issue in the generated PDF.