Closed brosenan closed 7 years ago
Thanks for the information.
Please note that the seemingly roman numerals are, in fact, text figures. The sans-serif used for Figure captions is Fira Sans, which does not posses text figures:
The inconsistency between footnote definition and reference is indeed strange. Alas, I cannot reproduce this here.
PS: Please do not use 'Fig. 1' with the programming
class. Either write Figure \ref{..}
or better \autoref{...}
We used:
Fig.~\ref{fig:A-Comparison-between}
in our source code
Please use either
Figure~\ref{fig:A-Comparison-between}
or (preferred)
\autoref{fig:A-Comparison-between}
The use of the XCharter OS font for numbers can be misleading. For example:
refers to:
but actually looks like it refers to figure 2 (II being Roman 2).
I can understand that. However, if there is a figure 11, there has already been figures 1 and 2, and confusion is avoided. Also note that this would only look too similar if someone used small caps roman numerals:
Note that \autoref{fig:A-Comparison-between} produces "figure~"... instead of "Figure~"''... because \figureautorefname}{figure}. You may want to fix that in programming.cls
Yea, I that was a slip above.
"figure .." (lowercase) is the preferred spelling. (as is "table" and "listing")
Chicago vs. APA style... What about Sect. vs Section vs section? BTW, when referring to a Figure in the text, the word "Figure" is usually abbreviated as "Fig.", while "Table" is not abbreviated. Both words are spelled out completely in descriptive legends.
Here's the relevant part:
\defcaptionname{english}{\figureautorefname}{figure}
\defcaptionname{english}{\tableautorefname}{table}
\defcaptionname{english}{\lstlistingautorefname}{listing}
\defcaptionname{english}{\lstnumberautorefname}{line}
\defcaptionname{english}{\subsectionautorefname}{\sectionautorefname}
\defcaptionname{english}{\subsubsectionautorefname}{\sectionautorefname}
Since \sectionautorefname
is “section”, both subsections and subsubsections also use this term.
In short: All reference names are lowercase and spelled out.
We moved to using \autoref
, but we see the following issues:
Problem alleviated by using \usepackage[noabbrev]{cleveref}, which provides \cref and \Cref as alternatives to \autoref
Again, thanks for the feedback.
The digit 1 appears sometimes as a an Arabic numeral (1) and sometimes as a Roman numeral (I). This is especially a problem in some cases where the caption for an object uses one representation, and references to this object use the other representation. The images below are taken from a footnote in the example provided with this project. The reference to the footnote uses Arabic numerals:
and the caption in the footnote itself uses Roman numerals:
![image](https://cloud.githubusercontent.com/assets/2514000/22034066/9c312018-dcf3-11e6-87d9-3100860ad796.png)
In our paper, reference to Fig. 1 uses Roman numerals:
while the caption of that figure uses Arabic numerals:
![image](https://cloud.githubusercontent.com/assets/2514000/22034274/6c91e0da-dcf4-11e6-9e8e-98dc8f8b5f78.png)