On Thu, Apr 15, 2021 at 02:47:45PM +0900, Akira Yokosawa wrote: > On Wed, 14 Apr 2021 22:11:33 -0700, Paul E. McKenney wrote: > > On Thu, Apr 15, 2021 at 12:49:18PM +0900, Akira Yokosawa wrote: > >> On Wed, 14 Apr 2021 10:31:23 -0700, Paul E. McKenney wrote: > >>> On Wed, Apr 14, 2021 at 07:47:51PM +0900, Akira Yokosawa wrote: > >>>> Hi Paul, > >>>> > >>>> A change in upstream hyperref package (v7.00j) breaks code in > >>>> qqz.sty. > >>>> Now, \refstepcounter in vertical mode can cause a page break. > >>>> Our use of \refstepcounter in framed Quick Quiz is in vertical > >>>> mode and if a page break happens at that point, destination point > >>>> set by \refstepcounter is discarded by tcolorbox, which results in > >>>> a missing destination. > >>>> > >>>> This can be fixed by leaving vertical mode in front of \refstepcounter, > >>>> which is what Patch 1/5 does. > >>>> > >>>> The updated code is compatible with older versions of hyperref as > >>>> long as our usage patterns are concerned. > >>>> Aa a bonus, new link-target positions look nicer (not too close to the > >>>> "Quick Quiz" labels). > >>>> > >>>> Patches 2/5--4/5 are (in my opinion) improvements to the -nq build. > >>>> Seeing both Quizzes and Answers in the final section, one would > >>>> just see the answer without taking time to think about a quiz. > >>>> So these patches modify the -nq build so that chapter-wise sections > >>>> have only the quiz parts. > >>>> Answers are presented in Appendix E in the same way as the other > >>>> builds. > >>>> > >>>> Patch 5/5 adds page references in the answers of non-nq builds. > >>> > >>> Good points, queued and pushed, thank you! > >>> > >>> On interesting thing is that if you click on the small bubble in the > >>> text, you are taken to the corresponding QQ at the end of that chapter. > >>> If you click on the square, you are taken to the answer. If you click > >>> on the page number in the square in the upper right-hand corner of the > >>> QQ question, you get taken back to the original small bubble, all of > >>> which is goodness. > >>> > >>> However, if you click on the either black square at the end of the > >>> question or the white shadowed square at the end of the answer, you get > >>> taken back to the small bubble in the text. > >> > >> Ya, that's as described in the commit log of Patch 2/5: > >> > >> o Hyperlinks are made in the following way: > >> > >> - Inline QQ marker -> Chapter-wise Quiz -> Answer in Appendix > >> - Page number marker in Quiz part -> Inline QQ marker > >> - Answer in Appendix -> Inline QQ marker > > > > OK, my reading comprehension was clearly substandard. :-/ > > > >>> Is it possible that some of our readers will expect that these two squares > >>> will instead take them back to the question at the end of the chapter? > >> > >> It is possible, but the white box at the end of the answer is supposed > >> to be a short-cut for those wanting to resume reading text. > > > > True enough. > > > >> So, appended is a compromise modifying the links of "Quick Quiz" > >> and black box in the answer to go back to chapter-wise quiz section. > >> > >> Thoughts? > > > > It does work well, and removes one layer of clicking that otherwise > > needs to happen. Let's see what people think about it. > > > > We also have the page-number marker that goes back to the text, so we do > > have the option of making the black and white boxes go to the beginning > > and end of the quick-quiz box at the end of the chapter. > > No, my point in making white box to go back to the end of the quiz > in normal builds was to help people reach the text following the > quiz. > So linking white box to a quiz at the end of the chapter spoils > this purpose. A page-number marker can be far away from the white > box when the answer is long. > > > But again, > > let's see how this patch works for people. > > > > Any objection to my pushing it as is, or should I wait for a second > > version. (I have queued it, but not yet pushed it out.) > > I'm OK with your pushing it as is. Done! Thanx, Paul > Thanks, Akira > > > > > Thanx, Paul > > > >> Thanks, Akira > >> > >>> This is probably not a big deal, given that clicking on the small bubble > >>> will take them to that list, but I figured that it was worth asking > >>> the question. > >>> > >>> Thanx, Paul > >>> > >>>> Thanks, Akira > [...]
