Stream: shorthand
Topic: Page numbering
David Hay (May 20 2020 at 22:11):
What's the best way to ensure that the page numbers are consistent with the tab order?
Chris Moesel (May 20 2020 at 22:15):
I think this is more of a question for @Lloyd McKenzie as I think the approach for numbering pages is governed by the templating framework (or the templates themselves). @Lloyd McKenzie -- do you have any guidance regarding how that works? Is it documented somewhere?
Lloyd McKenzie (May 20 2020 at 23:10):
Tabs and page numbering are orthogonal. Page numbering is driven by the hierarchy of the pages. The main menu is driven by what things you think implementers are going to want to be able to jump to quickly. They're not necessarily the same. The order of stuff within the menu will typically be similar, but it won't always be the same.
David Hay (May 20 2020 at 23:18):
Can you give more detail about how to set the page hierarchy?
Lloyd McKenzie (May 21 2020 at 02:45):
Dunno how shorthand does it, but in the ImplementationGuide, you'll have a root page (generally the table of contents) which will contain other pages (which may themselves contain other pages). The HL7 template assigns the root page the number '0'. The first page within it 1, the second 2, etc. Sub pages under 1 will be 1.1, 1.2, etc. Sections within page 1 will be 1.0.1, 1.0.2, etc.
David Hay (May 21 2020 at 03:31):
Thanks @Lloyd McKenzie - that explains what's happening. Is there a way to turn the numbering off? Or is it needed to change the templates? If so, then is it straightforward to do that?
Lloyd McKenzie (May 21 2020 at 04:04):
You'd have to change the templates. It'd be a pretty significant change. You'd have to redo all of the layouts, which is a major change. Why don't you want the numbers? They're super helpful when people are trying to communicate what part of the spec they're talking about...
David Hay (May 21 2020 at 04:49):
Main reason is that they don't (in my IG) line up nicely with the tabs so it looks kinda weird that the index page is 1, but the next tab is 8 then page 5 & so on. Maybe it's just me :)
David Hay (May 21 2020 at 04:52):
And I take your point of the value in referring to the spec - though I suspect that people would start with the tab when pointing to a specific part...
Chris Moesel (May 21 2020 at 12:26):
@David Hay -- with the new SUSHI beta you have control over the page list (if you want it) -- so you could change the order of your pages to match the menu/tabs. Alternately, you also have control over the menu, so you could change the order of the tabs to match the pages...
Lloyd McKenzie (May 21 2020 at 16:15):
The main menu tabs in the FHIR spec have never been in numeric order - and I don't think anyone's ever asked why or complained...
David Hay (May 21 2020 at 17:31):
Well, I never noticed! So much for that issue then... :)
Last updated: Apr 12 2022 at 19:14 UTC
