oreillymedia / HTMLBook

Let's write books in HTML!
http://oreillymedia.github.io/HTMLBook
MIT License
650 stars 100 forks source link

TOOLSREQ-7235: xref-number-and-title Format Change #238

Closed nadamsoreilly closed 3 years ago

nadamsoreilly commented 3 years ago

To better conform with the Chicago Manual of Style, Production has requested we change the way we style the titles generated by cross-references to Appendixes, Chapters, and Parts. Previously they were italicized:

Appendix A, Example Appendix Title Chapter 1, Example Chapter Title Part I, Example Part Title

This PR changes them to be normal font surrounding by quotation marks:

Appendix A, “Example Appendix Title” Chapter 1, “Example Chapter Title” Part I, “Example Part Title”

There are three files changes, xrefgen.xsl was changed to remove the template that added the italics. localizations/en.xml was changed to add the quotation marks, and xspec/xrefgen.xspec was changed to update a test to match the new format (note that this test is not currently working for other reasons). More details are in each commit.

Ticket: TOOLSREQ-7235