I apologize in advance for such a large PR, and for inadequate commit messages. My changes snowballed and ended up being rather intertwined :-/. Please let me know if you need parts of this separated out.
Here are the changes I made, excerpted from vgtc.cls:
author-facing changes and documentation
added Supplemental Materials and Figure Credits sections at the end.
added supplemental materials instructions and goals, an example project
on OSF, and an OSF link in abstract.
replaced paper count figure with newly-made ones and the source files
and instructions for creating them. This goes along with the supplemental
material examples.
added \authororcid command and instructions for adding hyperlinked ORCID ID
icons for each author.
moved figures to /fig folder.
expanded discussion of figures, esp. vector graphics.
added figure credits for CypressView after digital archaeology to track it down.
added an example appendix and consolidated troubleshooting advice there.
changed to hyperlink DOIs by default, but removed URL hyperlinking
of references. Additionally, only hyperlinks on the DOIs themselves.
more emphasis on asking for DOIs by default.
added cleveref package and instructions for use, rather than using autoref.
changed cross references to point to the top of the target float, rather than the caption.
added blue hyperlink coloring, now that electronic has long been the default.
added subcaption package and instructions for using it for subfigures and referencing them.
lists are now more compact.
widereview option now works without errors.
simplified the example .tex file
simplified instructions for which class options to use.
applied automatic then manual formatting to .cls file to increase readability.
moved \ifpdf decisions to .cls file.
moved loading standard classes, where possible, to .cls file.
no longer need to call \vgtcinsertpkg in the .tex file.
replaced lorem ipsum text with content and calls to \lipsum from the lipsum package.
removed sample.pdf & sample.eps.
removed Google Scholar fields from template.bib.
updated Readme.md and added Overleaf links. NOTE: I did not test readme.md
makefile instructions.
non-author-facing changes
eliminated redundant hyperref code (which removed the need for \vgtcinsertpkg
in the .tex file).
consolidated errors for using old commands like \vgtcinsertpkg.
eliminated the unused electronic option (which has been the default) but kept its code.
the widereview option fix motivated the class-wide change to using etoolbox
toggles rather than plain LaTeX if statements to avoid unexpected problems:
https://tex.stackexchange.com/a/5896.
applied automatic then manual formatting to .cls file to increase readability,
esp. for nested if statements.
removed commented code that seemed to no longer serve a purpose.
added comments with my name for potential future code to remove.
tested all changes with the options in the template.tex file using both pdflatex
and dvips from MikTeX on Windows 11.
One change that I did not make, but would like to, would be to switch to BibLaTeX rather than BibTeX.
I apologize in advance for such a large PR, and for inadequate commit messages. My changes snowballed and ended up being rather intertwined :-/. Please let me know if you need parts of this separated out.
Please see the
template.tex
file compiled usingpdflatex
here: template.pdf. It is also on Google Drive astvcg-journal-latex-template-2022-12-23.pdf
, where viewers can comment on parts of it.Here are the changes I made, excerpted from
vgtc.cls
:One change that I did not make, but would like to, would be to switch to BibLaTeX rather than BibTeX.