Links in PDF Handbook
Recently there has been something of an effort to improve cross-linking between Handbook pages—e.g., when a page mentions "text edit mode," change that to "[node:35996,fragment="text-edit-mode",title="text edit mode"]" for the effect of "text edit mode ."
I was just greatly surprised to discover that in the PDF version of the Handbook (meant to be downloaded for offline use) those links direct to the web page version, instead of linking internally to the relevant section of the PDF.
Is it possible to automatically convert those links to Handbook pages from web links to intra-PDF links (there may be a more technical term)? This might not be a straightforward implementation; since occasionally a "node" link is to a How To, for example, instead of a Handbook page, it might be necessary to set up a very targeted filter for every specific node number that is a Handbook page, and leave other nodes alone. Still, I think if this can be done, it should be.
Comments
It's supposed to work so it's a bug.
In reply to It's supposed to work so it's by Thomas
The culprit is some caching mechanism. I have purged the cache and the problem is gone. So I will have to dig into the code some more.
I can confirm the problem.
There are also blank pages at:
* Voices
* How to enter a chord
There may be others …
This issue seems to have returned again in the Handbook of July 19 2015.
In reply to This issue seems to have by Isaac Weiss
Thanks for notifying. I have manually reset the cache to resolve the problem, but I will have to revisit this issue to make a permanent fix.
The problem of internal links redirecting to external links is still there.
In reply to The problem of internal links by geetar
I'm afraid I don't know the cause of the issue yet. I'll revisit it in the future with a fresh mind and hopefully it will lead to a fix.
In reply to I'm afraid I don't know the by Thomas
Couldn't you just disable caching?
I'm going to suggest that the PDF Handbook should be discontinued until this can be fixed.
For what it's worth, I can't duplicate any of these on Ubuntu except one, and that is a problem with the online documentation, not the PDF document. Perhaps you need a different PDF viewer?
Someone wrote that
"There are also blank pages at:
* Voices".
That's explicitly an external link, and the online documentation is indeed blank.
There are some blank HALF pages in the PDF, apparently because the screen shots are just a little too large to fit on the page.
In any case, it looks fine to me. I definitely do not suggest suspending the manual.
In reply to For what it's worth, I can't by RexC
Voices ain't blank for me? https://musescore.org/en/handbook/voices-0
In reply to Voices ain't blank for me? by Jojo-Schmitz
"Voices ain't blank for me? https://musescore.org/en/handbook/voices-0"
I'm sorry, I got the wrong one. It's "How to enter a chord" on p. 32.
https://musescore.org/en/node/11188
In reply to "Voices ain't blank for me? by RexC
As far as I can tell, that page truly is blank - I go to edit it and theres nothing of substance there.
In reply to As far as I can tell, that by Marc Sabatella
That one was a bogus attempt of a new user to ask a question. It has been emptied on purpose and could probably get deleted
In reply to That one was a bogus attempt by Jojo-Schmitz
Link to essentially blank page removed. The page does have a link to a YouTube video on entering chords, which is not displayed. It may or may not be obsolete (didn't look close).
If the page is fixed, someone can add the link back to the doc.
I discovered I can edit this stuff instead of just reporting it. Duly done.
In reply to That one was a bogus attempt by Jojo-Schmitz
Hmm, actually it is not empty, not anymopre, but does contain a tutorial video of Katie Waordrobe
Guess we may add it back to the handbook again?
In reply to Hmm, actually it is not by Jojo-Schmitz
When I deleted the link I didn't realize that the page wasn't actually empty. It displays as blank on all my browsers. I don't know how to fix it, so I just left it. I wouldn't be at all offended if someone fixes the page and reverts my change.
In reply to When I deleted the link I by RexC
The problem with the empty page is caused by the youtube video being embedded through http and not https. I will make a fix for this.
In reply to The problem with the empty by Thomas
See https://musescore.org/en/node/76056, caused by that fix or caused be it not being fixed yet?
In reply to See by Jojo-Schmitz
Everything looks fine. I think the only problem is on the user's computer.
In reply to When I deleted the link I by RexC
I did revert that change to the handbook page
In reply to For what it's worth, I can't by RexC
It appears today is one of the days that the links in the PDF work, or perhaps Thomas has implemented a final fix?
As to the blank pages, on the day that that comment was written, they were blank, but that was fixed almost immediately, and there's doesn't seem to be a problem now.
Also, I wasn't suggesting "suspending the manual" per se. Just the offline version, which seemed to be constantly defeating its own purpose.
In reply to It appears today is one of by Isaac Weiss
The problem is certainly present again now.
In reply to The problem is certainly by Isaac Weiss
I changed the script that generates the PDFs. Hopefully it solved the problem. We will see at next generation.
In reply to I changed the script that by [DELETED] 5
Thank you very much for looking at this. Unfortunately, it has not solved the problem.
Just so we're clear here, the problem of links in the PDF file pointing to external links rather than internal links is still there. It's a very separate matter from the "How to enter a chord" link, which is _supposed_ to be external, and is now fixed.
The internal links in the handbook are still not working.