I created a folder “Appendix” under which I add several documents (actually a tree of document), so A1 - appendix one, A2 - appendix two, A2.1 - subitem in appendix 2.
I regularly add footnotes to text that should point to such an appendix. So, for example a footnote that should read “See appendix 2.1”
Obviously the numbering should remain intact when reordering documents in the appendix.
I managed to get this working in normal text, using prefix tile and <$hn> with a link to the document in question.
However, this does not work with Footnotes. As footnote text I canNOT type “See Appendix <$hn>” and have the compiler add in the correct number, so it comes out as “See Appendix 2.1”.
Been struggling with this for many hours. Hope anyone knwos the solution to this…
I assume you mean a footnote in the inspector, which use would have technical limitations involving internal links.
For cases where you need a footnote to host a link, for whatever reason, you must use the inline footnote variant instead. As inline footnotes (and annotations) are a special kind of formatting in the main editor, they have very few limitations and are thus the standard tool to use when you need complex formatting or functionality from a footnote or comment.
You can easily get what you need converted over, by selecting the highlighted footnote range corresponding the footnote that needs a link, and using the command in the Edit ▸ Transformations submenu to convert to inline footnote.
That’s a real pitty. I tried your workaround, but I do not like it. The inline footnotes distract because they make the text itself very hard to read. Unformtunately there seems not to be something like “Hide markup” to get rid the text as to be able to properly focus on the text itself.
Seem like I have to start typing the cross references by had everywhere (which is quite intensive and error prone).
Suggestion to fix suck kinds of cross referencing this in the future. (I can hardly believe it is not possible yet, as it is so very common to use a footnote to point to an appendix).
This is a dedicated feature doing precisely what is intended to do, rather than a temporary fix to get around a bug; it is not a workaround.
That aside, yes, I would not strongly advocate for using Scrivener vanilla for the forms of writing that require more infrastructure like this. Scrivener is much better when it is combined with a writing method designed for this kind of work, and it has extensive built-in support for integrating with Markdown. You will have far greater flexibility, more professional file formats to convert to, better quality documents, and it is an easier typing convention to work with than Scrivener’s in my opinion. I would only find the latter suitable for a few cross-references here or there.
With Markdown, you simply type in Refer to [Binder Title] like that, and that can often be all you need. You can of course type brackets wherever you want, in any software, or any area of the software (such as footnotes); you don’t need special technology. But furthermore, this format makes it very clear what you are referring to, as a writer, you don’t have to hover over a link and wait for a tooltip to see the target. That is how I type in the many hundreds of cross-references in our user manual PDF. The post-processing I use (LaTeX), handles the nomenclature and all the numbering for me, and Markdown handles the formatting of putting it into parentheses when the reference is given as an aside. It is also capable of targeting tables and figures directly, which is something Scrivener cannot do.
Better cross-referencing is only one small benefit of using this more powerful side of Scrivener though. If you are already familiar with Markdown, have a look at Chapter 21 in the user manual. This mainly covers where Scrivener goes beyond your typical Markdown editor though, for the basic rudiments of how it works with it, this post is a good starter, along with the post it links to toward the top.
And again, I left it implied, but the user manual PDF is written in Scrivener using Markdown. So that is a showcase of some of what this approach is capable of.
Thanks for the elaborate answer and sorry for my use of the word ‘workaround’ ;-). I just got things set up in a way that works pretty well, so starting all over with latex or markdown, postprocessing or whatever is not something I can quite afford to dig into right now, as I need to finish some document with a nasty deadline.
I will quickly scan Chapter 21 and the link you send to see if I feel comfortable turning things over.
I am kind of surprised though that in text I can just type <$hn>, select it and link to the document to get exactly what is needed: the chapter number (better: appendix nummer) I need.
The same cannot be done in the inspector, which kind of surprises me.
Nevertheless, thanks for the quick reply. Much appreciated!
Yes, it is a technical limitation though, in that the bits of code we need to make such links work are not there. Any other method would ultimately end up looking more like Markdown as it would have to reference the binder name by title, so at some point the matter of diminishing returns sets in. Why gradually reinvent what is already there, and supported by armies of developers and users around the world.
Fully understand not wanting, or being able to, switch gears in the middle of a big project! It’s something to think about for the next time though. With how Scrivener uses this technology, there are some that barely even use it at all in the text editor, and in fact could probably compile their projects “normally”. I myself prefer way more markup than that, I actually find it appealing to write that way, but for those that do not, the “ramp” is a lot more gradual and gentle than you might think.
I have today turned to the forums for the first time to find out a solution to exactly this and have also just discovered the same limitation.
Despite being a little clunky visibly, I could accept doing it in the inline footnote. I don’t quite understand how to get the number to work in “See Appendix (number)” (I am using Roman numerals for reference).
Would it be possible to get a slightly more detailed description how to do that?
I could imagine trying to do it in Markdown. But I also didn’t understand if that is actually possible or not?
Refer to §10.1.4, in the user manual PDF, under the subheading, *Creating Cross-References for your Readers". Chances are you may not need to do anything other than linking, depending on whether the default settings work for you.
I could imagine trying to do it in Markdown. But I also didn’t understand if that is actually possible or not?
Sure, it’s very easy to state your intentions toward this purpose in Markdown, I described the method in this post right above, third paragraph, and then proceed to link to guidance on how to get started with Markdown+Scrivener.
I made a little progress. I at least got as far as managing to get links directly within my text (not as footnotes) to page number and appendix number with <$p> and <$R> respectively and linking them.
But so far it is not working within Inline Footnotes, which I thought from this discussion it should be possible. Any more suggestions what I can look at? Or do I misunderstand what should be possible?
Ah, sorry, I had forgotten there could be an issue with this approach on Windows. This capability is indeed hampered by a noted bug in the Windows version.
Since the bug involves hyperlinks splitting the footnote into multiple pieces, around each link, you can in fact avoid the bug by going into the General Options tab in the compiler, on the right side of the main window, and looking for the Remove all hyperlinks option. If the intended output is print, that should be fine anyway, and in fact maybe even desirable, as who wants grey underscored text in their book.
The tokens will still evaluate though, with the links being stripped dynamically in this fashion. A link to “Refer to Red Book (pg. <$p>)” will compile to “Refer to Chapter Two (pg. 6)”, for example, if that is how the section layout would print section headings for it.
I made an image to show the output in my “latest and greatest” attempt to get this working. The key point is that in the 2nd item in the footnotes, I am trying to get it to read “See Appending I and also This is the Manual on page 2.
So far it seemed that Remove all hyperlinks made more things not work, particularly the page numbers in the normal text. This is shown in this image (the key point being there are no page numbers)
I am trying to compile it in Windows. Might it work differently on a Mac?
I had already isolated my attempts to get this working into a small project. Perhaps looking at it you would see the issue I am encountering / if there is anything specific I am doing incorrectly? Footnote_Test.zip (360.5 KB)
I did run a test to confirm the workaround, prior to recommending that approach. I’m a bit puzzled by the result, as I gave your test project a look and managed to get it working by switching on hyperlink removal. Here is the result:
