Hello community,
here is the log from the commit of package texlive-specs-b for openSUSE:Factory checked in at 2020-05-29 21:16:51
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Comparing /work/SRC/openSUSE:Factory/texlive-specs-b (Old)
and /work/SRC/openSUSE:Factory/.texlive-specs-b.new.3606 (New)
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Package is "texlive-specs-b"
Fri May 29 21:16:51 2020 rev:40 rq:806882 version:unknown
Changes:
--------
--- /work/SRC/openSUSE:Factory/texlive-specs-b/texlive-specs-b.changes 2019-11-07 23:09:47.336083852 +0100
+++ /work/SRC/openSUSE:Factory/.texlive-specs-b.new.3606/texlive-specs-b.changes 2020-05-29 21:21:54.003875337 +0200
@@ -1,0 +2,60 @@
+Mon May 18 08:47:10 UTC 2020 - Dr. Werner Fink
+
+- Enhance spec file generator to find missing .so man page
+ links for better dependency resolution (bsc#1171682)
+
+-------------------------------------------------------------------
+Wed May 13 13:59:14 UTC 2020 - Dr. Werner Fink
+
+- Modify patch texdoc_cnf.dif to ignore tlpkg/texlive.tlpdb as
+ kpathsea uses the ls-R files as well
+
+-------------------------------------------------------------------
+Tue May 12 09:03:38 UTC 2020 - Dr. Werner Fink
+
+- Correct obsoletes for new packages
+
+-------------------------------------------------------------------
+Wed May 6 11:27:35 UTC 2020 - Dr. Werner Fink
+
+- Scan *.def files as well for RequirePackage
+
+-------------------------------------------------------------------
+Tue May 5 13:55:07 UTC 2020 - Dr. Werner Fink
+
+- Add Requires to tex(epstopdf-base.sty) to fix package split
+ of texlive-epstopdf
+
+-------------------------------------------------------------------
+Mon May 4 09:00:25 UTC 2020 - Dr. Werner Fink
+
+- Skip *-dev packages from file dependendcy scanner as otherwise
+ we see doubling name space for some style files like amsmath.sty
+
+-------------------------------------------------------------------
+Mon Apr 27 06:52:15 UTC 2020 - Dr. Werner Fink
+
+- Add patch pythontex_p2top3.dif and a removes file to fully
+ switch pythontex packages of TeXLive to python3
+
+-------------------------------------------------------------------
+Mon Apr 20 10:29:02 UTC 2020 - Dr. Werner Fink
+
+- Update to TeXLive 2020
+ * Port patches
+ kpathsea_cnf.dif
+ latexpand_perl.dif
+ luaotfload_varfonts.dif
+ luatex_cnf.dif
+ musixtex_various.dif
+ * Delete patches not needed anymore as files have moved
+ tetex_scripts.dif
+ * Delete patche updmap-map_roboto.dif as fixed upstream
+ * Add new patches to catch moved files
+ texlive-scripts-extra_scripts.dif
+ texlive-scripts_scripts.dif
+ * Add new patch xetex_conf.dif to fit FHS location
+ * Remove TeXLive installer files breaking rpm database
+ texlive-scripts.removes
+
+-------------------------------------------------------------------
Old:
----
babel-spanglish.doc.tar.xz
babel-spanglish.tar.xz
New:
----
arraycols.doc.tar.xz
arraycols.tar.xz
askinclude.doc.tar.xz
askinclude.tar.xz
asmejour.doc.tar.xz
asmejour.tar.xz
atbegshi.doc.tar.xz
atbegshi.tar.xz
atenddvi.doc.tar.xz
atenddvi.tar.xz
attachfile2.doc.tar.xz
attachfile2.tar.xz
atveryend.doc.tar.xz
atveryend.tar.xz
authordate.doc.tar.xz
authordate.tar.xz
autofancyhdr.doc.tar.xz
autofancyhdr.tar.xz
auxhook.doc.tar.xz
auxhook.tar.xz
axessibility.doc.tar.xz
axessibility.tar.xz
barracuda.doc.tar.xz
barracuda.tar.xz
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Other differences:
------------------
++++++ texlive-specs-b.spec ++++++
++++ 11738 lines (skipped)
++++ between /work/SRC/openSUSE:Factory/texlive-specs-b/texlive-specs-b.spec
++++ and /work/SRC/openSUSE:Factory/.texlive-specs-b.new.3606/texlive-specs-b.spec
++++++ ascmac.doc.tar.xz ++++++
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/doc/latex/ascmac/LICENSE new/doc/latex/ascmac/LICENSE
--- old/doc/latex/ascmac/LICENSE 2018-03-09 23:47:18.000000000 +0100
+++ new/doc/latex/ascmac/LICENSE 2020-01-13 22:25:41.000000000 +0100
@@ -1,5 +1,5 @@
Copyright (c) 2010 ASCII MEDIA WORKS
-Copyright (c) 2016-2018 Japanese TeX Development Community
+Copyright (c) 2016-2020 Japanese TeX Development Community
All rights reserved.
Redistribution and use in source and binary forms, with or without
@@ -12,9 +12,9 @@
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
-* Neither the name of platex nor the names of its
- contributors may be used to endorse or promote products derived from
- this software without specific prior written permission.
+* Neither the name of the copyright holder nor the names of its contributors
+ may be used to endorse or promote products derived from this software
+ without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/doc/latex/ascmac/README.md new/doc/latex/ascmac/README.md
--- old/doc/latex/ascmac/README.md 2018-03-09 23:47:18.000000000 +0100
+++ new/doc/latex/ascmac/README.md 2020-01-15 22:48:01.000000000 +0100
@@ -26,6 +26,6 @@
## Release Date
-2018-03-09
+2020-01-15
Japanese TeX Development Community
Binary files old/doc/latex/ascmac/ascmac.pdf and new/doc/latex/ascmac/ascmac.pdf differ
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/tlpkg/tlpobj/ascmac.doc.tlpobj new/tlpkg/tlpobj/ascmac.doc.tlpobj
--- old/tlpkg/tlpobj/ascmac.doc.tlpobj 2019-02-28 03:15:51.000000000 +0100
+++ new/tlpkg/tlpobj/ascmac.doc.tlpobj 2020-01-16 01:55:17.000000000 +0100
@@ -1,9 +1,9 @@
name ascmac.doc
category Package
-revision 46904
+revision 53411
shortdesc doc files of ascmac
relocated 1
-docfiles size=40
+docfiles size=42
RELOC/doc/latex/ascmac/LICENSE
RELOC/doc/latex/ascmac/README.md
RELOC/doc/latex/ascmac/ascmac.pdf
++++++ ascmac.tar.xz ++++++
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/fonts/map/dvips/ascmac/ascmac.map new/fonts/map/dvips/ascmac/ascmac.map
--- old/fonts/map/dvips/ascmac/ascmac.map 1970-01-01 01:00:00.000000000 +0100
+++ new/fonts/map/dvips/ascmac/ascmac.map 2020-01-15 22:48:01.000000000 +0100
@@ -0,0 +1,3 @@
+ascgrp TeX-ascgrp =0.85)
- \pdfextension mapline{+ascgrp https://github.com/texjporg/ascmac
catalogue-ctan /macros/latex/contrib/ascmac
-catalogue-date 2018-04-29 07:15:59 +0200
catalogue-license bsd3
catalogue-topics boxing japanese
-catalogue-version 2.0h
+catalogue-version 2.1
++++++ asmeconf.doc.tar.xz ++++++
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/doc/latex/asmeconf/README.md new/doc/latex/asmeconf/README.md
--- old/doc/latex/asmeconf/README.md 2019-04-07 23:26:15.000000000 +0200
+++ new/doc/latex/asmeconf/README.md 2020-04-15 23:33:36.000000000 +0200
@@ -1,47 +1,58 @@
+ #asmeconf: A template for ASME conference papers#
+
+ Version 1.18 dated 2020/04/14.
+
+ ####Overview####
This class provides a template to format ASME Conference papers according to
- the requirements on ASME's web pages (as posted in March 2019).
+ the requirements on ASME's web pages (as posted in early 2020).
+
+ [www.asme.org/publications-submissions/proceedings/formatting-the-paper](https://www.asme.org/publications-submissions/proceedings/formatting-the-pap...)
This work is not a publication of ASME itself.
Files in this distribution are:
- README.md -- this file
- asmeconf.cls -- the class file
- asmeconf.bst -- bibtex style for ASME conference format
- asmeconf-template.tex -- a latex template/example for this class
- asmeconf-template.pdf -- documentation/sample paper
- asmeconf-sample.bib -- a sample bibliography file
+ README.md -- this file
+ asmeconf.cls -- the class file
+ asmeconf.bst -- bibtex style for ASME conference format
+ asmeconf-template.tex -- a latex template/example for this class
+ asmeconf-template.pdf -- documentation/sample paper
+ asmeconf-sample.bib -- a sample bibliography file
*
- sample-figure-1.pdf, sample-figure-2a.pdf, sample-figure-2b.pdf -- figures for the example
+ sample-figure-1.pdf,
+ sample-figure-2a.pdf,
+ sample-figure-2b.pdf -- figures for the example
The .tex and .cls files are commented and should be self-explanatory.
- This is version 1.03 dated 2019/04/06.
This template was designed to approach the following aims:
- - match ASME's font current specifications and layout
-
- - match ASME's current citation formats
-
- - support use of hyperref package (hyperlink references to figures, tables, citations, and web)
-
- - support pdf bookmarks
-
- - use the newtxtext and newtxmath font packages, which enable a variety of text and math features
-
- - support math and footnotes in section headings
-
- - include sans serif greek font for use in captions and headings
-
- - provide automatic layout of author blocks for up to nine addresses
+- match ASME's font current specifications and layout, including the most recent author layout
+
+- match ASME's current citation formats
+
+- support hyperref package (hyperlinks to figures, tables, references, web)
+
+- support pdf bookmarks and metadata
+
+- enable various math and text features with newtxmath and newtxtext packages
+- support bold face, sans serif math in section headings
+- support footnotes in section headings
- Author:
+- provide automatic layout of author and addresses in one of two styles
+
+- provide line numbers for editing and review
+
+- support balancing of columns on last page
+
+
+ ####Author####
John H. Lienhard V
@@ -52,12 +63,42 @@
Cambridge, MA 02139-4307 USA
- =========================================================
-
+ ---
+
+ ####Change log####
+
+ v1.18 (2020/04/14): edit and expand documentation; revise sample .bib file; extensive edits to asmeconf.bst, to better support hyperlinks, to correct eid error, and for better conformance to ASME style (details listed in .bst file); add foreign language example.
+
+ v1.17: set T1 font encoding with utf-8 input, ensure LuaLaTeX compatibility; load hologo and metalogo packages; edit documentation.
+
+ v1.16: remove xpatch and comment packages from class file; disable \\( and \\) in pdf bookmarks to avoid warnings; edit documentation.
+
+ v1.15: correct extra space left by \\CorrespondingAuthor when that author is not last; correct breakage of \\ref in captions. Thanks to Bret Van Poppel for reporting these issues.
+
+ v1.14: edit documentation; use 2020 IMECE header in layout example
+
+ v1.13: add babel options for language support; minor text edits; adjust nomenclature list penalties
+
+ v1.12: add support for line numbers for editing; add support for final column balancing; edit skips in nomenclature; adjust \\tolerance and \\emergencystretch (for line breaking); improve support for equation tags in captions; adopt standard \\maketitle and \\title commands; include \\versionfootnote for tracking revisions of draft.
+
+ v1.11: minor adjustments to title, author, and affiliation layout
+
+ v1.1: revise several parts of the layout to match ASME's updated specifications from Summer 2019 (including author block, abstract font, placement of nomenclature, and minor spacings); add .bst support for online references and eprints; expand documentation significantly; guidance on fitting equations into columns.
+
+ v1.07: improve support for numbered section headings; allow omission of corresponding author email; edit documentation
+
+ v1.06: automate bold sans math in captions and headings; small adjustments to default spacings; adjust font of paper number to 18 pt; edit documentation
+
+ v1.05: minor code clean-up; change to keyvalue for to control font for superiors
+
+ v1.04: fix option passing for mathalfa package; adjust \\entry to create nomenclature subheadings efficiently.
+
+
+ ---
- LICENSE:
+ ####License####
- Copyright (c) 2019 John H. Lienhard
+ Copyright (c) 2020 John H. Lienhard
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
associated documentation files (the "Software"), to deal in the Software without restriction,
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/doc/latex/asmeconf/asmeconf-sample.bib new/doc/latex/asmeconf/asmeconf-sample.bib
--- old/doc/latex/asmeconf/asmeconf-sample.bib 2019-04-02 23:11:08.000000000 +0200
+++ new/doc/latex/asmeconf/asmeconf-sample.bib 2020-04-15 23:33:36.000000000 +0200
@@ -1,198 +1,179 @@
+%% Revised 14 April 2020
+%% John H. Lienhard, MIT
+
@article{ning2002,
- title = {On the Sliding Friction Characteristics of Unidirectional Continuous FRP Deposits},
- journal = {ASME Journal of Tribology},
- year = {2002},
- volume = {48},
- number = {5},
- pages = {2000--2008},
- author = {Xiang Ning and Mary Rose Lovell},
- doi = {10.1115/1.4042912},
- URL = {https://doi.org/10.1115/1.4042912},
-}
-%% There's no need to give the URL if it is simply the DOI; the DOI itself will be hyperlinked.
+ author = {Xiang Ning and Mary Rose Lovell},
+ title = {On the Sliding Friction Characteristics of Unidirectional Continuous FRP Deposits},
+ journal = {ASME Journal of Tribology},
+ year = {2002},
+ volume = {48},
+ number = {5},
+ pages = {2000--2008},
+ doi = {10.1115/1.4042912},
+}
+%% article supports these fields: author, year, title, journal, volume, number, pages OR eid (and numpages),
+%% doi, url, eprint with archive, note.
+%% There's no need to give the URL if it is simply the DOI, since the DOI itself will be hyperlinked.
+%% url = {https://doi.org/10.1115/1.4042912}. ASME requests that a URL point to the abstract.
@BOOK{gibson2008,
- title = {The Big Book of Cellular Studies},
+ title = {The Big Book of Cellular Studies},
publisher = {John Wiley and Sons},
- year = {2008},
- author = {Tom A. Gibson and Matthew A. Tucker},
- address = {New York},
- doi = {10.1115/1.4042912},
- URL = {https://doi.org/10.1115/1.4042912},
+ year = {2008},
+ author = {Tom A. Gibson and Matthew A. Tucker},
+ address = {New York},
}
-%% There's no need to give the URL if it is simply the DOI; the DOI itself will be hyperlinked.
-
+%% book supports these fields: author OR editor, year, title, edition, series, volume OR number
+%% publisher, address, doi, url, eprint with archive, note.
@INCOLLECTION{stevens1999,
- title = {Stochastic Fields and Their Digital Simulation},
- publisher = {Martimius Publishers},
- pages = {22--36},
- year = {1999},
+ author = {Thomas T. Stevens},
+ title = {Stochastic Fields and Their Digital Simulation},
booktitle = {Stochastic Methods},
- author = {Thomas T. Stevens},
- address = {Dordrecht},
- doi = {10.1115/1.4042912},
- URL = {https://doi.org/10.1115/1.4042912},
-}
-%% There's no need to give the URL if it is simply the DOI; the DOI itself will be hyperlinked.
-
+ publisher = {Martimius Publishers},
+ address = {Dordrecht},
+ year = {1999},
+ pages = {22--36},
+}
+%% incollection supports these fields: author, year, title, booktitle, edition, editor, series,
+%% volume OR number, publisher, address, type,
+%% chapter, pages, doi, note, eprint with archive, url, urldate.
+%% type = { } changes default "Chap." to something else.
@inproceedings{wions2005,
- author = {Thomas Wions and Christopher D. Mills},
- title = {Structural Dynamics in Parallel Manipulation},
+ author = {Thomas Wions and Christopher D. Mills},
+ title = {Struct\-ur\-al Dynamics in Parallel Manipulation},
booktitle = {Proceedings of the ASME IDETC/CIE},
- year = {2005},
- pages = {777--798},
- number = {DETC2005-99532},
- doi = {10.1115/1.4042912},
- URL = {https://doi.org/10.1115/1.4042912},
- venue = {New Orleans, LA},
- confmonth = {September 10--13},
-}
-% Note that venue and confmonth are specific to this .bst style
-% There's no need to give the URL if it is simply the DOI; the DOI itself will be hyperlinked.
-
+ number = {DETC2005-99532},
+ venue = {New Orleans, LA},
+ eventdate = {September 10--13},
+ year = {2005},
+ pages = {777--798},
+ doi = {10.1115/1.4042912},
+ url = {https://doi.org/10.1115/1.4042912},
+}
+%% inproceedings supports these fields: author, year, title, booktitle, edition, editor, volume,
+%% organization OR publisher, address, venue, eventdate,
+%% [paper] number, pages, doi, note, eprint with archive, url, urldate.
+%% Note that venue and eventdate are specific to the asmeconf.bst style.
+%% There's really no need to give the URL if it is simply the DOI because the DOI itself will be hyperlinked.
+%% ASME requests that the URL point to the abstract.
@phdthesis{smith2002,
- author = {Robert Smith},
- title = {Conformal Lubricated Contact of Cylindrical Surfaces Involved in a Non-Steady Motion},
- school = {Rochester Institute of Technology},
- address = {Rochester, NY},
- year = {2002},
- doi = {10.1115/1.4042912},
- URL = {https://doi.org/10.1115/1.4042912},
-}
-% type = {Sc{D} Thesis}, could be added to change the type of thesis. See example below.
-% There's no need to give the URL if it is simply the DOI; the DOI itself will be hyperlinked.
-
-
-@techreport{watson1982,
- author = {David Watson},
- title = {Evaporative Heat Transfer in the Contact Line of a Mixture},
- year = {1982},
- number = {HTL-26, CFD-4},
- institution = {Iowa State University},
- address = {Ames, IA},
- doi = {10.1115/1.4042912},
- URL = {https://doi.org/10.1115/1.4042912},
-}
-% type can be changed here also, see example below
-% see example below.
+ author = {Robert Smith},
+ title = {Conformal Lubricated Contact of Cylindrical Surfaces Involved in a Non-Steady Motion},
+ school = {Rochester Institute of Technology},
+ address = {Rochester, NY},
+ year = {2002},
+ doi = {10.1115/1.4042912},
+ url = {https://doi.org/10.1115/1.4042912},
+}
+% type = {Sc{D} {T}hesis}, could be added to change the type of thesis. See two examples below.
+% There's no need to give the URL if it is simply the DOI; the DOI itself will be hyperlinked.
+% eprint with archive is also supported.
+%% ASME requests that the URL point to the abstract.
@mastersthesis{smith1998,
- author = {Robert Smith},
- title = {Conformal Lubricated Contact of Cylindrical Surfaces Involved in a Steady Motion},
- school = {Rochester Institute of Technology},
- address = {Rochester, NY},
- year = {1998},
-}
+ author = {Robert Smith},
+ title = {Conformal Lubricated Contact of Cylindrical Surfaces Involved in a Steady Motion},
+ school = {Rochester Institute of Technology},
+ address = {Rochester, NY},
+ year = {1998},
+}
+%% mastersthesis supports these fields: author, year, title, type, school, address, note.
+%% These fields are also supported, but don't use them all: doi, eprint with archive, url, urldate, urltype
+%% type={} can optionally be used to change the type of thesis. Default is "Master's thesis"
@mastersthesis{smith1996,
-author = {Robert Smith},
-title = {Cylindrical Surfaces Involved in a Steady Motion},
-type = {{BS} Thesis},
-school = {Rochester Institute of Technology},
-address = {Rochester, NY},
-year = {1996},
+ author = {Robert Smith},
+ title = {Cylindrical Surfaces Involved in a Steady Motion},
+ type = {{BS} {T}hesis},
+ school = {Rochester Institute of Technology},
+ address = {Rochester, NY},
+ year = {1996},
}
+%% To get a bachelor's thesis, use type = {} as above.
-
-@techreport{watson1981,
-author = {David Watson},
-title = {Evaporative Heat Transfer in the Contact Line of a Mixture},
-year = {1981},
-number = {TN-1234},
-institution = {National Aeronautics and Space Administration},
-address = {Washington, DC},
-URL = {https://doi.org/10.1115/1.4042912},
-type = {NASA Technical Memorandum No.}
-}
-
-@BOOK{bejan,
- title = {Advanced Engineering Thermodynamics},
- publisher = {John Wiley {\&} Sons, Inc.},
- year = {1988},
- author = {Adrian Bejan},
- address = {New York, NY},
+@techreport{watson1982,
+ author = {David Watson},
+ title = {Evaporative Heat Transfer in the Contact Line of a Mixture},
+ institution = {Iowa State University},
+ address = {Ames, IA},
+ number = {HTL-26, CFD-4},
+ year = {1982},
+ doi = {10.1115/1.4042912},
+ url = {https://doi.org/10.1115/1.4042912},
+}
+%% techreport supports the fields: author, title, number, institution, address, year, doi, url,
+%% eprint with archive, note.
+% if type = is omitted, it will default to "Tech. Rep." See the example below for changing this.
+
+@techreport{reynolds58,
+ author = {W. C. Reynolds and W. M. Kays and S. J. Kline},
+ title = {Heat Transfer in the Incompressible Turbulent Boundary Layer. {I}--{C}onstant Wall Temperature},
+ type = {Memorandum},
+ institution = {NASA},
+ address = {Washington, DC},
+ number = {12-1-58W},
+ year = {1958},
+ eprint = {2060/19980228020},
+ archive = hdl,
}
+% if type = is omitted, it will default to "Tech. Rep."
@incollection{DKE70,
- author = {Donald K. Edwards},
- title = {Thermal Radiation Measurements},
- editor = {Ernst R. G. Eckert and Richard J. Goldstein},
- booktitle = {Measurement Techniques in Heat Transfer},
- chapter = {9},
- pages = {353--396},
- volume ={130},
- series ={{AGARD}ograph},
- month = {November},
- type = {{C}hapter},
- publisher = {Technivision Services},
- address = {Slough, England},
- year ={1970},
- note ={Published by the Advisory Group for Aerospace Research and Development of {NATO}},
-}
-
-@incollection{Lienhard2017,
- author = {John H. Lienhard and Karan H. Mistry and Mostafa H. Sharqawy and Gregory P. Thiel},
- title ={Thermodynamics, Exergy, and Energy Efficiency in Desalination Systems},
- editor = {Hassan A. Arafat},
- booktitle = {Desalination Sustainability},
- chapter = 4,
- pages = {127--206},
- publisher ={Elsevier Publishing Co.},
- address = {Amsterdam},
- year =2017,
- month = {June},
- url = {https://www.elsevier.com/books/desalination-sustainability/unknown/978-0-12-809791-5},
+ author = {Donald K. Edwards},
+ title = {Thermal Radiation Measurements},
+ editor = {Ernst R. G. Eckert and Richard J. Goldstein},
+ booktitle = {Measurement Techniques in Heat Transfer},
+ chapter = {9},
+ pages = {353--396},
+ volume = {130},
+ series = {{AGARD}ograph},
+ publisher = {Technivision Services},
+ address = {Slough, England},
+ year = {1970},
+ note = {Published by the Advisory Group for Aerospace Research and Development of {NATO}},
}
+%% If you need to change "Chap." to something else, use for example: type = {{C}hapter},
+%% It's uncommon to have the "series" field as above.
@article{Lienhard2019b,
- title = "Exterior Shape Factors from Interior Shape Factors",
- journal = "ASME Journal of Heat Transfer",
- year = "2019",
- doi = "10.1115/1.4042912",
- author = {John H. Lienhard},
- note = {In press},
-}
-
-@misc{narayan2017,
- author = {Prakash Narayan Govindan and Steven Lam and Maximus G. {St. John}},
- title = {Systems including a condensing apparatus such as a bubble column condenser},
- year = {2017},
+ author = {Lienhard, V, John H.},
+ title = {Exterior Shape Factors from Interior Shape Factors},
+ journal = jht,
+ doi = {10.1115/1.4042912},
+ volume = {141},
+ number = {6},
+ eid = {061301},
+ year = {2019},
+}
+%% Note eid field rather than page numbers. Will not produce "pp." before the eid number.
+%% May include numpages = {} to get "eid (numpages pages)"
+%% Note use of jht macro for title title (produces "ASME J. Heat Transfer"). All ASME journals have macros.
+
+@misc{govindan2017,
+ author = {Prakash Narayan Govindan and Steven Lam and Maximus G. {St. John}},
+ title = {Systems Including a Condensing Apparatus Such As a Bubble Column Condenser},
howpublished = {US Patent {\#}9700811},
+ year = {2017},
+ url = {https://patents.google.com/patent/US9700811B2},
}
-@conference{Swaminathan2017IDABRO,
- Author = {Swaminathan, Jaichander and Stover, Richard L. and Tow, Emily W. and Warsinger, David M. and Lienhard, John H.},
- Booktitle = {Proceedings of IDA World Congress on Desalination and Water Reuse},
- Title = {Effect of practical losses on optimal design of batch {RO} systems},
- Year = {2017},
- Month = 10,
- Publisher = {International Desalination Association},
- address = {Topsfield, MA},
- venue ={S{\~a}o Paulo, Brazil},
- confmonth = {October 15--20},
- number = {IDA17WC-58334},
- url = {http://hdl.handle.net/1721.1/111971},
-}
-% number = {Paper No.\ IDA17WC-58334}, could be used instead.
-
@misc{Fong2015,
- title = {Analytical Methods for Squaring the Disc},
- author = {Chamberlain Fong},
+ title = {Analytical Methods for Squaring the Disc},
+ author = {Chamberlain Fong},
howpublished = {{\itshape ArXiv e-prints}},
- eprint = {1509.06344},
- year = {2015},
- month = {sep},
+ year = {2015},
+ eprint = {1509.06344},
+ archive = arxiv,
}
-% URL = {https://arxiv.org/abs/1509.06344v3},
+% eprint + arxiv produces the same result as: url = {https://arxiv.org/abs/1509.06344v3},
@manual{GSL,
- title = {{GNU} Scientific Library Release 2.4},
- URL = {https://www.gnu.org/software/gsl/},
- author = {Mark Galassi
+ title = {{GNU} Scientific Library Release 2.4},
+ author = {Mark Galassi
and Jim Davies
and James Theiler
and Brian Gough
@@ -201,43 +182,150 @@
and Michael Booth
and Fabrice Rossi
and Rhys Ulerich},
- year = 2017,
- organization = {Free Software Foundation},
- address = {Boston, MA},
- month = {June},
+ organization = {Free Software Foundation},
+ address = {Boston, MA},
+ year = 2017,
+ url = {https://www.gnu.org/software/gsl/},
}
+%% manual supports these fields: author, year, title, edition, organization, address, doi, eprint with archive, urldate, url, note.
-@manual{mpl,
- title={mpl colormaps},
- author={St{\'e}fan {van der Walt} and Nathaniel Smith},
- URL = {http://bids.github.io/colormap/},
- note = {Accessed 26 August 2018},
- year = 2015,
- organization = {GitHub},
- address = {San Francisco, CA},
- month = {September},
-}
-
+@online{mpl,
+ title = {mpl colormaps},
+ author = {St{\'e}fan {van der Walt} and Nathaniel Smith},
+ organization = {GitHub},
+ address = {San Francisco, CA},
+ year = 2015,
+ url = {http://bids.github.io/colormap/},
+ urldate = {August 26, 2018},
+}
+%% online supports these fields: author OR editor, year, title, organization, address,
+%% note, url OR eprint with archive, urldate, urltype
+%% You can change "Accessed" with "urltype", e.g., urltype = {retrieved},
@BOOK{johnson1980,
- title = {Title of edited book},
+ editor = {Howard Johnson},
+ title = {Title of Edited Book},
publisher = {John Wiley and Sons, Inc.},
- year = {1980},
- editor = {Howard Johnson},
- address = {New York, NY},
+ address = {New York, NY},
+ year = {1980},
}
@proceedings{proceedings,
- title = {The title of the proceedings},
- year = 2015,
- editor = {Howard Johnson},
- volume = 2,
- address = {Address of publisher},
- organization = {The organization},
- publisher = {Name of publisher},
- note = {Optional note}
+ title = {The Title of the Proceedings},
+ year = 2015,
+ editor = {Al Yankovich and Howard Stern},
+ volume = {15},
+ organization = {Organization},
+ venue = {Boston, MA},
+ eventdate = {April 27--28},
+ url = {http://web.mit.edu},
+ note = {Optional note},
+}
+%% proceedings supports these fields: author OR editor, year, title, edition, editor,
+%% series, volume OR number, organization, publisher,
+%% address [of organization or publisher], venue, eventdate,
+%% doi, url, eprint with archive.
+%% The organization will appear as author/editor if those fields are empty.
+%% In most instances, the publisher is the organization so only one should be given
+
+@online{amsmath,
+ author = {{American Mathematical Society} and {LATEX3 Project}},
+ title = {User's Guide for the \textsf{amsmath} Package, Version 2.1},
+ organization = {Comprehensive \TeX\ Archive Network},
+ year = {2018},
+ url = {https://ctan.org/tex-archive/macros/latex/required/amsmath/amsldoc.pdf},
+ urldate = {July 5, 2019},
+}
+
+@online{sharpe1,
+ author = {Michael Sharpe},
+ title = {New {TX} Font Package, Version 1.554},
+ organization = {Comprehensive \TeX\ Archive Network},
+ year = {2018},
+ url = {https://ctan.org/pkg/newtx},
+ urldate = {April 27, 2019},
+}
+
+@online{sharpe2,
+ author = {Michael Sharpe},
+ title = {The \textsf{mathalfa} Package, Version 1.10},
+ organization = {Comprehensive \TeX\ Archive Network},
+ year = {2018},
+ url = {https://ctan.org/pkg/mathalfa},
+ urldate = {April 27, 2019},
+}
+
+@online{tolusis,
+ author = {Sigitas Tolu{\v{s}}is},
+ title = {The \textsf{flushend} Package, Version 3.3},
+ organization = {Comprehensive \TeX\ Archive Network},
+ year = {2017},
+ url = {https://www.ctan.org/pkg/flushend},
+ urldate = {October 1, 2019},
+}
+
+@online{bottcher,
+ author = {Stephan I. B{\"o}ttcher and Uwe L{\"u}ck},
+ title = {\textsf{lineno.sty}: A {\LaTeX} Package to Attach Line Numbers to Paragraphs, Version 4.41},
+ organization = {Comprehensive \TeX\ Archive Network},
+ year = {2005},
+ url = {https://www.ctan.org/pkg/lineno},
+ urldate = {August 17, 2019},
+}
+
+@online{oostrum,
+ author = {Piet van Oostrum},
+ title = {The \textsf{fancyhdr} and \textsf{extramarks} Packages, Version 3.10},
+ organization = {Comprehensive \TeX\ Archive Network},
+ year = {2019},
+ url = {https://www.ctan.org/pkg/lineno},
+ urldate = {August 17, 2019},
+}
+
+@online{fairbairns,
+ author = {Robin Fairbairns and Sebastian Rahtz and Leonor Barroca},
+ title = {A Package for Rotated Objects in \LaTeX, Version 2.16d},
+ organization = {Comprehensive \TeX\ Archive Network},
+ year = {2016},
+ url = {https://www.ctan.org/pkg/rotating},
+ urldate = {October 2, 2019},
+}
+
+@BOOK{book,
+ author = {James Tiberius Kirk},
+ year = {2288},
+ title = {Decline and Fall of the Romulan Empire},
+ edition = {7},
+ series = {Humankind's Greatest Writings},
+ volume = {23},
+ url = {http://web.mit.edu},
+ publisher = {Vulcan Free Press},
+ address = {T'Paal},
+ note = {to appear},
+}
+
+@inbook{inbook,
+ author = {Winston S. Churchill},
+ year = {1948},
+ title = {The Gathering Storm},
+ edition = {1},
+ series = {The Second World War},
+ volume = {1},
+ chapter = {5},
+ pages = {66--89},
+ publisher = {Houghton Mifflin Co.},
+ address = {Boston},
+ note = {{``The Locust Years''}},
+}
+%% inbook supports these fields: author OR editor, year, title, edition, version, series, volume OR number, doi, url, eprint with archive, publisher, address, note. type={} field changes "Chap." to something else.
+
+@book{fourier1822,
+ author = {Jean Baptiste Joseph Fourier},
+ year = {1822},
+ title = {Th\'{e}orie Analytique de la Chaleur},
+ publisher = {Firmin Didot, P\`{e}re et Fils},
+ address = {Paris},
+ url = {https://archive.org/details/analyticaltheory00fourrich},
}
-% series = {Series A,
-
-
+
Binary files old/doc/latex/asmeconf/asmeconf-template.pdf and new/doc/latex/asmeconf/asmeconf-template.pdf differ
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/doc/latex/asmeconf/asmeconf-template.tex new/doc/latex/asmeconf/asmeconf-template.tex
--- old/doc/latex/asmeconf/asmeconf-template.tex 2019-04-07 23:26:15.000000000 +0200
+++ new/doc/latex/asmeconf/asmeconf-template.tex 2020-04-15 23:33:36.000000000 +0200
@@ -1,15 +1,21 @@
+% !TEX encoding = UTF-8 Unicode
%%
%% This file is asmeconf-template.tex, a template to format ASME Conference papers according to
-%% the requirements on ASME's conference web pages (as posted in March 2019).
+%% the requirements on ASME's conference web pages.
%%
-%% This file is version 1.03 dated 2019/04/06
+%% This file is version 1.18 dated 2020/04/14
+%%
+%% As of version 1.11, this template follows ASME's newer conference guidelines first posted July 2019.
+%% The new guidelines have changed the requested author block formatting to be inline.
+%% (This template supports the old grid format as a package option.)
+%% Nomenclature now follows the abstract. Abstract is in italics.
%%
%% Author: John H. Lienhard V
%% Department of Mechanical Engineering
%% Massachusetts Institute of Technology
%% Cambridge, MA 02139-4307 USA
%%
-%% Class options are described in the asmeconf.cls file. These include:
+%% Class options are set up in the asmeconf.cls file. These include:
%%
%% * Math options from M. Sharpe's newtxmath package: upright integrals [upint]; and
%% * varvw for a v and w that are better distinguished from greek nu; and also
@@ -17,14 +23,38 @@
%% * is recommended.
%%
%% * Many options for calligraphic, script, and fraktur fonts from the mathalfa package; the
-%% * default values are: scr=dutchcal,cal=euler
+%% * example value used is: mathalfa=cal=euler (use Euler font for \mathcal)
+%% * some other options for cal are: dutchcal, zapfc, cm (default), boondox,...
+%% * frak (fraktur), bb (blackboard bold), scr (script) may also be controlled.
%%
%% * An option to omit the ASME copyright footer: nofoot
%%
-%% * An option not to use newtxtext's superiors font for footnotes [nodefaultsups] and an option
+%% * An optional to use newtxtext's superiors font for footnotes [nodefaultsups] and an option
%% * for slightly larger small capitals, largesc
%%
-%% For details of newtxmath and mathalfa, refer to their documentation (available on CTAN: http://ctan.org)
+%% * An option to balance the heights of columns on the last page [balance].
+%% * This option is NOT compatible with the [lineno] option.
+%%
+%% * An option to include line numbers [lineno]. The lineno package does not number equation
+%% * lines, captions, tables, etc. You must run _twice_ for proper placement of the line numbers.
+%% * This option will disable balancing column height on final page if that option has been invoked.
+%% * The lineno package won't always number the lines preceding displayed math in a paragraph because
+%% * paragraph has not ended. See that package's documentation for macros to address this problem, or
+%% * just leave a blank line above the displayed equation while you are editing and then remove the
+%% * blank line and [lineno] option when you move to your final version.
+%%
+%% * An option to use the old grid arrangement of author names [oldauthors]. See Appendix B for usage,
+%% * because the authors and affiliations must be entered different in this case.
+%%
+%% * An option to allow hyphenation of the typewriter font [hyphenate]
+%% * Hyphenation is normally suppressed for typewriter mode because it is often used for code.
+%%
+%% * Options to set (for the babel package) a primary language [lang= ], and secondary or tertiary
+%% * languages, [lang-second] and [lang-third]. English is the default when no language is set.
+%% * If a secondary or tertiary language is set, the main language must also be set.
+%% * The spanish module makes "." active, clashing with some code; \spanishdeactivate{.} stops this.
+%%
+%% For details of newtxmath and mathalfa, refer to their documentation (available on CTAN: http://ctan.org).
%%
%% The use of commands defined or modified by the asmeconf class is illustrated below. In particular,
%% ASME requires capitalized, sans-serif section headings, and as a result some care is needed
@@ -34,7 +64,7 @@
%%
%% LICENSE:
%%
-%% Copyright (c) 2019 John Lienhard
+%% Copyright (c) 2020 John Lienhard
%%
%% Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
%% associated documentation files (the "Software"), to deal in the Software without restriction,
@@ -54,36 +84,17 @@
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
%% Class options are described above.
-\documentclass[varvw,largesc,upint]{asmeconf}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-%% Editing tools, can delete if not using them
-
-\usepackage{lipsum} % Generates paragraphs of gibberish latin for checking layout ... e.g. \lipsum[2-4] produces
- % paragraphs 2 through 4 of the text.
-\usepackage{comment} % for commenting out passages. See package documentation for usage.
-
-%% Filler names for Author and affiliation blocks on title page
-\def\AuthorName{Name[s] of Author[s]}
-\long\def\Affiliation{Department of Mechanical Engineering\\
- Institution or Company Name\\
- Street address\\
- City, State, Country}
+\documentclass[varvw,largesc,upint,mathalfa=cal=euler,hyphenate,balance,lang-second=french,lang=english,colorlinks]{asmeconf} % <=== remove colorlinks before submission to ASME!
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%%%%%%%%%%%%%%%%%%%%%% Fields to be completed %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-%%%%% pdf metadata and colors %%%%%%%%%%%%%%%%%%%%%%%%%%
-%%%%% The user should edit as desired %%%%%%%%%%%%
+%%%%% pdf metadata %%%%%%%%%%%%
+%%%%% The user should edit %%%%%%%%%%%%
\hypersetup{%
- colorlinks=true,% <=== change to false to get black type for links (ASME may request this)
- linkcolor=blue, %
- citecolor=blue, % SeaGreen4,
- urlcolor=blue, % Red3,
pdftitle={ASME Conference Paper Template}, % <=== change to YOUR pdf file title
pdfkeywords={ASME, Paper, Template, \LaTeX, Research}, % <=== change to YOUR pdf keywords
pdfauthor={John H. Lienhard}, % <=== change to YOUR name[s]!!!
@@ -93,36 +104,46 @@
\begin{document}
-% Change these fields to the right content for your conference!
+% Change these fields to the right content for your conference.
% You can comment these out if for some reason you don't want a header.
+% Use title case (first letters capitalized), not all capitals
+
+\ConfName{Proceedings of the ASME 2020\linebreak International Mechanical Engineering Congress and Exposition}
+\ConfAcronym{IMECE20}
+\ConfDate{November 14-19, 2020}
+\ConfCity{Portland, OR, USA}
+\PaperNo{IMECE2020-XXXX}
-\ConfName{Proceedings of the ASME 2018 \linebreak International Mechanical Engineering Congress and Exposition}
-\ConfAcronym{IMECE18}
-\ConfDate{November 9-15, 2018}
-\ConfCity{Pittsburgh, PA, USA}
-\PaperNo{IMECE2018-XXXX}
-\PaperTitle{Our research paper: the latest developments in cutting-edge engineering}
+% Units of measure and other specialty lowercase terms in the title should be
+% enclosed in \NoCaseChange{...} to maintain lower case type
+% LaTeX will automatically set the title in all capital letters.
+
+\title{Place Title Here: Place Subtitle After Colon} % <=== change to YOUR title
-% Change to your name[s] and addresses, in the desired order of authors. Up to nine author blocks.
-% Note usage below for joint first authors and for corresponding author.
-% (Most of the example names below are not real people, just very common names.)
-\SetAuthorBlock{Luis Hern\'{a}ndez\JointFirstAuthor}{\Affiliation}
-\SetAuthorBlock{Maria Silva\JointFirstAuthor}{\Affiliation}
+%% Put author names into the order you want. Use the same order for affiliations.
+%% \affil{#} tags the author's affiliation to the address in \SetAffiliation{#}.
+%% No space between last name and \affil{#}, separate names with commas.
+%%
+%% \CorrespondingAuthor{email} follows that author's affiliation, no spaces.
+%% If multiple corresponding authors, put both email addresses in the same command and place after both authors.
+%%
+%% \JointFirstAuthor, if applicable, follows the affiliation of the relevant authors, no spaces.
-\SetAuthorBlock{Henry Tudor, Catherine Parr}{Hampton Court Palace \\ Richmond, England}
-\SetAuthorBlock{Jinsoo Kim}{\Affiliation}
-\SetAuthorBlock{Yusuf Yilmaz}{\Affiliation}
-%\SetAuthorBlock{Amelia Smith}{\Affiliation}
-%\SetAuthorBlock{Aadhya Acharya}{\Affiliation}
-%\SetAuthorBlock{Omar Abu Bakr}{\Affiliation}
+\SetAuthors{Luis Hern\'andez\affil{1}\JointFirstAuthor , Maria Silva\affil{2}\JointFirstAuthor, Henry Tudor\affil{3}, Catherine~Parr\affil{3}, John H.\ Lienhard V\affil{4}\CorrespondingAuthor{lienhard@mit.edu}}
-\SetAuthorBlock{\CorrespondingAuthor{John H.\ Lienhard V}{lienhard@mit.edu}}{%
-Rohsenow Kendall Heat Transfer Lab \\ Department of Mechanical Engineering
-\\ Massachusetts Institute of Technology \\ Cambridge, MA 02139 USA}
+\SetAffiliation{1}{Institution or Company Name, City, State}
+\SetAffiliation{2}{Institution or Company Name, City, Province, Canada}
+\SetAffiliation{3}{Hampton Court Palace, Richmond, England}
+\SetAffiliation{4}{Massachusetts Institute of Technology, Cambridge, MA }
+
+\maketitle
-\MakeTitlePage
+%%% Use this footnote for tracking various versions of your draft. Change text to suit your own needs.
+%%% Remove from final version.
+%%% \date{..} calls the same command.
+\versionfootnote{Documentation for \texttt{asmeconf.cls}. Version \versionno; \today.}% <=== Delete before final submission.
%%% Change these to your keywords. Keywords are automatically printed at the end of the abstract.
@@ -134,34 +155,78 @@
%%%%%%%%%%%%%%%%%%%%% End of fields to be completed. Now write! %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%% Abstract %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%
+%% Abstract should be no more than 200 words
\begin{abstract}
-This paper is an example and template for the \texttt{asmeconf} class. Papers typeset in this class will follow ASME Conference guidelines for margins, fonts, headings, captions, and reference formats. Standard \LaTeX\ commands are used. The class is compatible with the \texttt{hyperref} package. The class defines new environments for abstract and nomenclature. The optional argument of \verb|\section| has been modified for manually setting pdf bookmarks when macros or complicated mathematics are included in section headings. The class is intended to be used with the \texttt{asmeconf.bst} \textsc{Bib}\negthinspace\TeX\ style, which is part of this distribution. The class may be invoked with several options, most of which address math fonts. The class calls a number of packages, all of which are in \TeX\textsc{live}\ and on CTAN (\href{http://ctan.org}{ctan.org}).
+This paper is an example of and a template for typesetting ASME Conference Papers in {\upshape\LaTeX} using the {\upshape\texttt{asmeconf}} class. This class follows ASME guidelines for margins, fonts, headings, captions, and reference formats as of early 2020. The class is intended to be used with the {\upshape\texttt{asmeconf.bst} \hologo{BibTeX}} style, which is part of this distribution. The class is compatible with the {\upshape\texttt{hyperref}} package, so that pdfs will contain internal and external hyperlinks, pdf bookmarks, and metadata. Links may be colored, for online use, or black, for publication. Section headers may contain mathematics, references, citations, and footnotes. The class enables inline author names, following ASME's current style, but is backward compatible to the traditional block style. The class includes many options, e.g., for math fonts. The class calls a number of packages, all of which are in {\upshape\TeX\ Live} and on CTAN. The class is compatible with {\upshape\hologo{pdfLaTeX}} or {\upshape\hologo{LuaLaTeX}}.
\end{abstract}
+%%%%%%%%% NOMENCLATURE (OPTIONAL) %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%
+%% To change space between the symbols and definitions, use \begin{nomenclature}[Xcm] where X is a number
+%% The unit cm can be replaced by any LaTeX unit of dimension: pt, in, ex, em, pc, etc.
+%% Default is 2em.
+
+%% Leave off second argument of \entry to produce a subheading (e.g., \entry{Greek letters} )
+
+\begin{nomenclature}
+\entry{Roman letters}
+\entry{$k$}{Thermal conductivity [W m$^{-1}$ K$^{-1}$]}
+\entry{$\vec{q}$}{Heat flux vector [W m$^{-2}$]}
-\section*{Introduction}
-For ASME conference papers, the labels Figure and Equation should be abbreviated when they do not start a sentence, as in Fig.~\ref{fig:1} and Eq.~\eqref{eqn:dw}. Figure~\ref{fig:1} is spelled out when it starts a sentence. Equation~\eqref{eqn:dw} is spelled out when it starts a sentence.
+\entry{Greek letters}
+\entry{$\alpha$}{Thermal diffusivity [m$^2$ s$^{-1}$]}
+\entry{$\nu$}{Kinematic viscosity [m$^2$ s$^{-1}$]}
-References are automatically numbered \cite{ning2002}. They should be inserted at the appropriate point using a \verb|\cite{ref}| command~\cite{gibson2008,stevens1999}. The references will be automatically sorted and compressed as well if they are given in a set \cite{stevens1999,ning2002,gibson2008,wions2005,smith2002,watson1982,smith1998}. See the \texttt{asmeconf-sample.bib} file for examples of how to enter your references.
+\entry{Dimensionless groups}
+\entry{Pr}{Prandtl number, $\nu/\alpha$}
+\entry{Sc}{Schmidt number, $\nu/\mathcal{D}_{1,2}$}
-Equations are typeset in the usual way. The class file loads the \texttt{amsmath} and \texttt{mathtools} packages. Further, the \texttt{newtxmath} package used for the math fonts includes many additional features.
-\begin{equation}\label{eqn:fourier}
-\vec{q} = -k\nabla T
-\end{equation}
-ASME does not specify a standard nomenclature list. Be sure to put your symbols into the nomenclature list, including SI units.
+\entry{Superscripts and subscripts}
+\entry{b}{bulk value}
+\entry{$\infty$}{free stream value}
+\end{nomenclature}
-%% Use title case for subsections and subsubsections
-\subsection*{Section Headings and Captions}
-ASME requires that section headings and captions be set in an uppercase, bold face, sans serif font. The class will do this automatically. You can place \verb|\cite{..}|, \verb|\ref{..}|, \verb|\label{..}|, and into headings and captions directly, as you would in the main text. Do not enclose them braces, e.g.\ \verb|{\cite{..}}|, which will cause errors. You can place \verb|\footnote{..}| into headings, but not into captions.\footnote{See \texttt{tex-stackexchange} for various approaches to footnotes in captions, if you really want to have them.}
+%%%%%%%%% BODY OF PAPER %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\section{Introduction}
+The \texttt{asmeconf} class file will typeset papers with margins, fonts, headings, captions, and reference formats that follow those specified for conference papers of the American Society of Mechanical Engineers (ASME). Internal and external hyperlinks will be set automatically, and the pdf file will contain bookmarks and metadata. This class is not a publication of ASME.
+
+The \texttt{.tex} file may be written using standard \LaTeX\ commands, although some specific initial commands are needed to format the blocks containing the author[s], title, and abstract. This class loads a number of other packages, all of which are contained in up-to-date versions of \href{https://www.tug.org/texlive/}{\TeX\ Live}, \href{http://www.tug.org/mactex/}{Mac\TeX}, and similar distributions. If you find you are missing one of these packages, you may obtain it at no cost from CTAN (\href{http://ctan.org}{ctan.org}).
+
+\subsection{Essential Initial Commands}
+To begin, fill in the fields to be completed at top of the \texttt{asmeconf-template.tex} file. These fields include the headers for your conference and your paper number. Specified metadata will be placed into the pdf file itself.
+The title should be placed into \verb|\title{..}|.
-Simple math can be used in either captions or section headings, but see the \texttt{asmeconf.tex} source file for examples of how to deal with more complicated expressions.
+Put author names into the \verb|\SetAuthors{name, name,...}| command in the desired order; follow the syntax illustrated \texttt{asmeconf-template.tex} file. Put each distinct address sequentially into a separate \verb|\SetAffiliation{n}{address}|, where $n = 1,2,\ldots$ Tag each author with the right affiliation by putting \verb|\affil{n}| after that author's name inside the \verb|\SetAuthors{..| command.
-To get bold math, you can use the \verb|\bm{..}| macro from the \texttt{bm} package, which is loaded by the class. To get sans serif math, you can use \verb|\mathsf{..}|. So, you can write \verb|\bm{\mathsf{A+B}}| to put a bold, sans serif expression in a caption. The class file provides for sans serif greek letters by using \verb|\sfalpha| and similar expressions (e.g.\ $\sfalpha, \sfbeta, \sfgamma, \sfdelta \ldots$) for use in captions and headings (see Fig.\ \ref{fig:1}).
+Author addresses are to be kept short. List the author institution, and the City, State (US authors), City, Province, Canada (Canadian authors), or City, Country (for other international authors).
-For a section heading that includes more complicated math (and macros), you may use the optional argument of \verb|\section[..]{..}| to create a pdf bookmark without losing characters or producing warnings or errors. See the \texttt{asmeconf.tex} source file for examples of this. These bookmarks should usually be text expressions, although some math is supported.
+One author (or more) may be designated as the corresponding author by placing \verb|\CorrespondingAuthor{email}| after \verb|\affil{#}|. Two or more authors may be joint first authors by putting \verb|\JointFirstAuthor| after \verb|\affil{#}|.
+
+After setting up the headers, authors, and title, issue the \verb|\maketitle| command.
+
+The abstract text must be placed into \verb|\begin{abstract}| \ldots \verb|\end{abstract}|. The abstract will automatically be italicized. Keywords may be included using the \verb|\keywords{..}| command. The \texttt{keyword} command \textit{must} be issued before the abstract environment.
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\section{Referring to Citations, Figures, and Equations}
+Citations are automatically numbered \cite{ning2002}. They should be inserted at the appropriate point using a \verb|\cite{ref}| command~\cite{gibson2008,stevens1999}. The citations will be automatically sorted and compressed if they are given in a set \cite{stevens1999,ning2002,gibson2008,wions2005,smith2002,watson1982}.
+A specific reference may be named with an abbreviation, as in Ref.~\cite{watson1982}.
+See the \texttt{asmeconf-sample.bib} file and Sect.~\ref{sec:references} for examples of how to enter your references.
+
+For ASME conference papers, the labels Equation and Figure should be abbreviated when they do not start a sentence, as in Eq.~\eqref{eqn:dw} and Fig.~\ref{fig:1}. Figure~\ref{fig:1} is spelled out when it starts a sentence. Equation~\eqref{eqn:dw} is spelled out when it starts a sentence.
+
+Equations are typeset in the usual way and will be automatically numbered. The class file loads the \texttt{amsmath} and \texttt{mathtools} packages. Further, the \texttt{newtxmath} package used for the math fonts includes many additional features (see Sect.~\ref{sec:moremath}).
+\begin{equation}\label{eqn:fourier}
+\vec{q} = -k\nabla T
+\end{equation}
+
+ASME prefers SI units. (U.S.\ style units may follow in parentheses.) Be sure to put all symbols into the nomenclature list, including their units.
-Text in section headings and captions will not be capitalized if enclosed in a \verb|\NoCaseChange{...}| command.
%%%%%%%%%%%%% begin figure %%%%%%%%%%%%%%%%%
@@ -169,25 +234,29 @@
\begin{figure}
\centering\includegraphics[width=0.7\linewidth]{sample-figure-1.pdf}
-\caption{A figure caption with math, $\bm{\mathsf{z = (r,\sfphi)}}$ \cite{Lienhard2019b}\label{fig:1}}
-%% note: \sfphi is sans serif \phi, defined by the class file.
+\caption{Figure caption with math, eqn.~\eqref{eqn:fourier}: $z = (r,\phi)$ \cite{Lienhard2019b}\label{fig:1}}
\end{figure}
%%%%%%%%%%%%% end figure %%%%%%%%%%%%%%%%%%%
-\subsubsection*{Subsection Headings in Title Case}
-Subsections and sub-subsection headings should be in title case (first letter of primary words capitalized).
-The rest of this text uses Latin to show layout and usage. Refer to the \texttt{.tex} file for further details.
-\subsubsection*{Latin for Layout}
-\lipsum[4-5] % <=== This command generates paragraphs of fake Latin. Delete it here and elsewhere!
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+%% Use title case for subsections and subsubsections
+
+\section{Section Headings and Captions}
+ASME requires that section headings and captions be set in an uppercase, sans serif font. The class will do this automatically. You can place \verb|\cite{..}|, \verb|\ref{..}|, \verb|\label{..}|, and mathematics into headings and captions directly, as you would in the main text. Do not enclose them braces, e.g.\ \verb|{\cite{..}}|, which will cause errors. You can place \verb|\footnote{..}| into headings, but not into captions.\footnote{See \texttt{tex-stackexchange} for various approaches to footnotes in captions, if they seem necessary. For footnotes in tables, use the \texttt{tablefootnote} package.}\footnote{Sequential footnotes are automatically separated by a comma.}
+Text in section headings and captions will not be capitalized if enclosed in a \verb|\NoCaseChange{..}| command.
-%% Dealing with complicated math in a section heading: optional argument provides the pdfbookmark
-%% without losing characters or producing warnings/errors.
-\section*[Math in a section heading: u\cdot\omega=0]{Math in a section heading: $\bm{\vec{\mathsf{u}}\cdot\vec{\sfomega}=\mathsf{0}}$}
+Sections may either be numbered or left unnumbered.
-\lipsum[6-7] % <=== This command generates paragraphs of fake Latin. Delete it here and elsewhere!
+Simple mathematical expressions can be used in either captions or section headings. For a section heading that includes more complicated math (and macros), you may use the optional argument of \verb|\section[..]{..}| to create a pdf bookmark without losing characters or producing warnings or errors. See the \texttt{asmeconf-template.tex} source file for examples of this procedure. These bookmarks should usually be text expressions, although some math is supported.
+
+If you wish to override the default math format in captions, put \verb|\mathversion{normal}| in the caption.
+
+\subsection{Subsection and Sub-subsection Headings}
+Subsections and sub-subsection headings should be entered in title case, with the first letter of primary words capitalized. Sub-subsections (i.e., paragraphs) are never numbered.
%%%%%%%%%%%%%%% begin simple table %%%%%%%%%%%%%%%%%%%%%%%%%%
@@ -210,13 +279,12 @@
%%%%%%%%%%%%%%%% end table %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
%%%%%%%%%%%%%%% begin more complicated table %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\begin{table}[t]
\caption{Table with more complicated columns}\label{tab:2}%
\centering{%
-\begin{tabular}{!{\hspace*{0.5cm}} >{\raggedright\hangindent=1em} p{3cm} d{3} @{\hspace*{1cm}} d{3} !{\hspace*{0.5cm}}}
+\begin{tabular}{!{\hspace*{0.5cm}} >{\raggedright\hangindent=1em} p{3cm} d{3.3} @{\hspace*{1cm}} d{3.3} !{\hspace*{0.5cm}}}
\toprule
Experiment & \multicolumn{1}{c@{\hspace*{1cm}}}{$u$ [m/s]} & \multicolumn{1}{c!{\hspace*{0.5cm}}}{$T$ [\textdegree C]} \\
\midrule
@@ -230,60 +298,19 @@
%%%%%%%%%%%%%%%% end table %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\section{Tables and Figures}
-%%%%%%%%%%%%%%%%% begin wide figure %%%%%%%%%%%%%%%%%%%%%%%%%%%
+Table \ref{tab:1} is an example of a simple table. Table captions should be placed above tables.
+The class loads the \texttt{booktabs} package (used for horizontal rules in both Table \ref{tab:1} and \ref{tab:2}), and the \texttt{array} and \texttt{dcolumn} packages which provide extended capabilities for columns in the \texttt{tabular} environment (used in Table \ref{tab:2}). Table \ref{tab:3} is an example of a table that spans two columns. Two column tables (and figures) will always float to the top of a later page.
-\begin{figure*}[t]
-\begin{minipage}[c]{0.5\textwidth}
-\centering{
- \includegraphics{sample-figure-2a.pdf}
-\subcaption{Interior region\label{fig:interior-region}}
-}\end{minipage}
-%%%%%%%%%%%%%
-\begin{minipage}[c]{0.5\textwidth}
-\centering{
-\includegraphics{sample-figure-2b.pdf}
-\subcaption{Exterior region\label{fig:exterior-region}}
-}\end{minipage}
-\caption{A figure with two subfigures \cite{Lienhard2019b}}
-\end{figure*}
+Figure captions go below figures. Figure~\ref{fig:2} is an example of a figure that spans two columns and includes subfigures. The text in figures (and tables) should be no smaller than 6~point type. Images in figures are handled by the standard \texttt{graphicx} package.
-%%%%%%%%%%%%%%%%%%% end wide figure %%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+Landscape figures and tables may be produced at full-page size by putting \verb|\usepackage[figuresright]{rotating}| in your \texttt{.tex} file's preamble and using the \texttt{sidewaystable*} and \texttt{sidewaysfigure*} environments~\cite{fairbairns}.
-
-
-\section*{Entropy generation\footnote{If you have text in a section heading or caption that you do not want to be capitalized, enclose it in a \texttt{\textbackslash NoCaseChange} command.} is always interesting and important \cite{bejan}}
-
-\lipsum[7-8] % <=== This command generates paragraphs of fake Latin. Delete it here and elsewhere!
-
-
-
-%% Subsections with math do not need any special handling because they are neither uppercased nor bookmarked
-%% Note that \dot or \vec must go outside of \mathsf{..}
-\subsection*{Subsection with Math: $\bm{\dot{\mathsf{S}}_{\textsf{gen}}}$ \cite{bejan}.}
-
-\lipsum[10] % <=== This command generates paragraphs of fake Latin. Delete it here and elsewhere!
-
-
-\subsubsection*{Sub-subsection\footnote{Another longer footnote to show the leading and line breaking, and how it will sit at the bottom of a column. Another longer footnote to show the leading and line breaking, and how it will sit at the bottom of a column.} Heading}
-
-\lipsum[12-13] % <=== This command generates paragraphs of fake Latin. Delete it here and elsewhere!
-\begin{equation}\label{eqn:dw}
-d\vec{w} =
- \begin{pmatrix}
- du \\ dv
- \end{pmatrix} =
- \underbrace{\begin{pmatrix}
- \partial u/\partial x & \partial u/\partial y \\
- \partial v/\partial x & \partial v/\partial y
- \end{pmatrix}}_{=\,\mathbf{J}_1} \begin{pmatrix}
- dx \\ dy
- \end{pmatrix}
-\end{equation}
-
-%%%%%%%%%%%%%%% begin table %%%%%%%%%%%%%%%%%%
-\begin{table*}[t]
-\caption{A table spanning two columns}\label{tab:3}%
+%%%%%%%%%%%%%%% begin two column table %%%%%%%%%%%%%%%%%%
+\begin{table*}
+\caption{A table spanning two columns\label{tab:3}}%
\centering{%
\begin{tabular*}{0.8\textwidth}{@{\hspace*{1.5em}}@{\extracolsep{\fill}}ccc!{\hspace*{3.em}}ccc@{\hspace*{1.5em}}}
\toprule
@@ -309,72 +336,252 @@
\bottomrule\end{tabular*}
}
\end{table*}
-%%%%%%%%%%%%%%%% end table %%%%%%%%%%%%%%%%%%%
-\lipsum[16] % <=== This command generates paragraphs of fake Latin. Delete it here and elsewhere!
+%%%%%%%%%%%%%%%%% end two column table %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\section{Reference Formatting with \NoCaseChange{\texttt{asmeconf.bst}}\footnote{If you have text in a section heading or caption that you do not want to be capitalized, such as an SI unit, enclose it in a \texttt{\textbackslash NoCaseChange} command.}}\label{sec:references}
+
+The {\upshape\texttt{asmeconf.bst}} \hologo{BibTeX} style follows the reference styles shown on ASME's conference web site in early 2020. Examples for these and many other cases are given in the \texttt{asmeconf-sample.bib} file, which is part of this distribution. Citations and references are managed by the standard \texttt{natbib} package. Nevertheless, a few comments are necessary.
+
+%% sub-subsections should *not* be numbered
+\subsubsection*{DOI, URL, and eprint} Include DOI numbers when they are available. URL's may alternatively be given. ASME requests that URLs point to a document's abstract.
-\section*{Acknowledgements}
-\lipsum[17] % <=== This command generates paragraphs of fake Latin. Delete it here and elsewhere!
+Elementary support for \texttt{eprint} numbers is also included, generating a url at the end of the citation. The \texttt{archive} type may be specified using the macros \texttt{arxiv, googlebooks, hdl, jstore, oclc}, or \texttt{pubmed} (e.g., \texttt{archive=hdl}, \textit{without} braces). Both \texttt{eprint} and \texttt{archive} fields \textit{must} be given. Other root urls may be invoked using \verb|archive = {http://another.url.org/}|.
+\subsubsection*{Online Sources} A bibliography field \verb|@online{..| is included for citation of online sources, such as web pages. A \texttt{url} or \texttt{eprint} with \texttt{archive} must be included. See the examples of use in the \texttt{asmeconf-sample.bib} file.
+\subsubsection*{Date Accessed} The \verb|urldate={..}| field may be used to provide the date on which a given url was accessed. By default, the text printed will be \texttt{Accessed `date',}. The word ``Accessed'' may be changed using the \verb|urltype={..}| field.
-%%% NOMENCLATURE %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\subsubsection*{Conference Location and Date} For the entry types \verb|@inproceeedings{..| and \verb|@proceeedings{..|, you may include \verb|venue={..}| and \verb|eventdate={..}| to specify the city and the date of a conference.
+
+\subsubsection*{Capitalization of Titles} ASME's bibliography style requires that document titles be in title case. The first letters of principal words are capitalized. Do this when writing the \texttt{.bib} file.
+
+
+
+%%%%%%%%%%%%%%%%% begin two column figure %%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\begin{figure*}
+\begin{subfigure}[t]{0.5\textwidth} %subfigure is basically the same as minipage
+\vbox{
+\vspace*{1.7em}
+\centering{
+ \includegraphics{sample-figure-2a.pdf}
+}
+\vspace*{1.7em}
+}
+\subcaption{Interior region\label{fig:interior-region}}
+\end{subfigure}%
+%%%%%%%%%%%%% no spaces or line breaks between these two subfigures
+\begin{subfigure}[t]{0.5\textwidth}
+\centering{%
+\includegraphics{sample-figure-2b.pdf}
+\subcaption{Exterior region\label{fig:exterior-region}}
+}\end{subfigure}
+\caption{A figure with two subfigures \cite{Lienhard2019b}}\label{fig:2}
+\end{figure*}
+
+%%%%%%%%%%%%%%%%%%% end two column figure %%%%%%%%%%%%%%%%%%%%%%%%%%
+
+
+%%%%%%%%%%%%%%% MORE ON MATH %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+%% Dealing with complicated math in a section or subsection heading:
+%% the optional argument to \section will provide the pdf bookmark
+%% without losing characters or producing warnings/errors.
%%
-%% To change space between the symbols and definitions, use \begin{nomenclature}[Xcm] where X is a number
-%% The unit cm can be replaced by any LaTeX unit of dimension: pt, in, ex, em, pc, etc.
-%% Default is 2em.
+%% In this heading, letter u is forced to be upright with \mathrm{u}
+%%
+\section[More on math: u\cdot\omega=0]{More on math: $\vec{\mathrm{u}}\cdot\vec{\omega}=0$}\label{sec:moremath}
-\begin{nomenclature}
-\entry{\textit{Roman letters}}{}
-\entry{$k$}{Thermal conductivity [W m$^{-1}$ K$^{-1}$]}
-\entry{$\vec{q}$}{Heat flux vector [W m$^{-2}$]}
+In most cases, the need for a wide equation can be eliminated by using one of the multiline equation environments defined by
+\texttt{amsmath}, such as \texttt{align}, \texttt{split}, or \texttt{multline}~\cite{amsmath}. The following equation is set with the
+\texttt{multline} environment:
+\begin{multline}\label{eqn:energy}
+\frac{\partial}{\partial t}\left[\rho\bigl(e + \lvert\vec{u}\rvert^2\big/2\bigr)\right] + \nabla\cdot\left[\rho\bigl(h + \lvert\vec{u}\rvert^2\big/2 \bigr)\vec{u}\right] \\
+ ={}-\nabla \cdot \vec{q} + \rho \vec{u}\cdot\vec{g}+ \frac{\partial}{\partial x_j}\bigl(d_{ji}u_i\bigr) + \dot{Q}_v
+\end{multline}
+An example using \texttt{align} appears in Appendix~\ref{appendix:a}.
-\entry{\textit{Greek letters}\rule{0pt}{13pt}}{}
-\entry{$\alpha$}{Thermal diffusivity [m$^2$ s$^{-1}$]}
-\entry{$\nu$}{Kinematic viscosity [m$^2$ s$^{-1}$]}
+An alternative solution may be to set large equations into two-column-wide tables or figures. While a package exists for setting equations that span two columns (\texttt{widetext.sty}), that code is erratic in relation to floats and page breaks.
-\entry{\textit{Dimensionless groups}\rule{0pt}{13pt}}{}
-\entry{Pr}{Prandtl number, $\nu/\alpha$}
+Math italics are used for roman and greek letters by default. If you want an upright letter in math, you can use the relevant math alphabet, e.g., \verb|\mathrm, \mathbf, \mathsf|:
+\begin{equation}\label{eqn:dw}
+\vec{F} = m \vec{a} \quad\textrm{or}\quad \vec{\mathrm{F}} = m \vec{\mathrm{a}} \quad\textrm{or}\quad \mathbf{F} = m \mathbf{a} \quad\textrm{or}\quad \vec{\mathsf{F}} = m \vec{\mathsf{a}}
+\end{equation}
+To get additional symbols in bold math, you can use the \verb|\bm{..}| macro from the \texttt{bm} package, which is loaded by the class.
-\entry{\textit{Superscripts and subscripts}\rule{0pt}{13pt}}{}
-\entry{b}{bulk value}
-\entry{$\infty$}{free stream value}
+The class file also provides upright sans-serif greek letters with \verb|\sfalpha| and similar expressions (e.g., $\sfalpha, \sfbeta, \sfgamma, \sfdelta$ \ldots $\bm{\sfalpha, \sfbeta, \sfgamma, \sfdelta \ldots}$), in case they are needed (but note that the \verb|newtxmath| options \verb|frenchmath| and \verb|slantedGreek| also affect how greek letters are presented).
+
+\subsection{The \texttt{newtxmath} and \texttt{mathalpha} Packages~\cite{sharpe1,sharpe2}} The \texttt{newtxmath} package~\cite{sharpe1}, loaded by default, includes a large number of options for mathematics, most of which can be called as options to \verb|\documentclass|. For example, the \texttt{upint} option of \texttt{newtxmath} selects upright integral signs (rather than slanted integral signs):
+\begin{quote}
+\verb|\documentclass[upint]{asmeconf}|.
+\end{quote}
+These math options are discussed further in the \texttt{asmejour-template.tex} file.
+
+In addition, many options for calligraphic, fraktur, and script fonts are available as options to the \texttt{mathalfa} package, which is also loaded. These may be invoked, for example, as
+\begin{center}
+\verb|\documentclass[mathalfa=cal=euler]{asmeconf}|
+\end{center}
+which selects the Euler font for \verb|\mathcal| (this is our default). To find all the font options, refer to the \texttt{mathalfa} package documentation \cite{sharpe2}.
+
+The typewriter font loaded is \texttt{inconsolata} (which is sans serif), as suggested by the \texttt{newtx} package documentation.
+
+The \texttt{asmeconf} class is not set up for use with the \texttt{fontspec} or \texttt{unicode-math} packages.
+
+
+%%%%%%%%%%%%%%% ADDITIONAL PACKAGE OPTIONS %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\section{Additional Options for \NoCaseChange{\texttt{asmeconf.cls}}}
+The class accepts a number of options in addition to those already described. These options are discussed next.
+
+\subsection{Colored hyperlinks}
+ASME requires that all text be \textbf{in black} when the paper is submitted for publication. For other uses, authors may
+obtain colored hyperlinks with the [\texttt{colorlinks}] option.
+
+\subsection{Final Column Balancing} The option \texttt{[balance]} invokes the the \texttt{flushend} package~\cite{tolusis}.
+This package will attempt to give equal height to the two columns on the last page. The performance of this package is sometimes inconsistent (with odd page layout or, very rarely, errors), so use this option with caution.
+
+\subsection{Line Numbers} The option \texttt{[lineno]} invokes the the \texttt{lineno} package~\cite{bottcher}. This option will produce line numbers in the margins. You must run \LaTeX\ \textit{twice} for proper placement of the numbers. Tables, captions, and footnotes will not be numbered. Line numbers can be helpful for review and editing, but should not be used in your final manuscript. See the documentation of the \texttt{lineno} package for further commands to control line numbering.
+
+The \texttt{lineno} package is not compatible with the \texttt{flushend} package that makes final short columns the same height. Balancing is automatically disabled when this option is called.
+
+\subsection{Changing the Footer Text} The option \texttt{[nofoot]} will omit the ASME copyright from the first page footer.
+The footers are generated with the \texttt{fancyhdr} package~\cite{oostrum}, so you can change them in any way you like using the commands of that package. Only the default arrangement of footers matches ASME's style, however.
+
+\subsection{Superiors Font} The \texttt{newtxtext} package includes a superiors font (both numbers and letters) for use in footnote markers and superscripts. To enable this font, use the option \texttt{[nodefaultsups]}.
+
+\subsection{Old-style Author Grid} The option \texttt{[oldauthors]} invokes ASME's old grid-style arrangement of author names. The authors and affiliations must be entered differently in this case. See Appendix \ref{appendix:b} for usage.
+
+\subsection{Hyphenation of Typewriter Font} The option \texttt{[hyphenate]} will allow hyphenation of the typewriter font.
+Hyphenation is normally suppressed for typewriter mode because this font is often used for code.
+
+\subsection{Support for Other Languages} The package can be adapted to incorporate (or entirely use) languages other than English. See Appendix \ref{appendix:c} for details.
+
+%%%%% Conclusions %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\section{Conclusion}
+Provide a brief conclusion (3-4 lines).
+
+
+%%%%% Acknowledgments %%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\section*{Acknowledgments}
+Place any acknowledgments here.
-\end{nomenclature}
%%% REFERENCES %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%
%% Put your references into your .bib file in the usual way. Run latex once, bibtex once, then latex twice.
-%% This specific .bst style allows: venue = {location of conference}, and confmonth = {Month days}
+%% The asmeconf.bst style allows: venue = {Location of Conference}, and eventdate = {Month, days}
+%% for @inproceedings and @proceedings
%%
-\nocite{*} %% <=== delete this line unless you want to typeset the entire contents of your .bib file.
-\bibliographystyle{asmeconf} %% .bst file following ASME conference format. Do not change.
-\bibliography{asmeconf-sample} %% <=== change this to name of your bib file
+\nocite{*} %% <=== Delete this line unless you want to typeset the entire contents of your .bib file!
+
+\bibliographystyle{asmeconf} %% .bst file following ASME conference format. Do not change.
+\bibliography{asmeconf-sample} %% <=== change this to name of your bib file
+
%%% APPENDICES %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\appendix
%% Note that appendices will be "numbered" A, B, C, ... etc. Use \section, not \section*
-%% Equations should be numbered sequentially following those in the paper. Don't reset the counter.
+%% Equations will be numbered sequentially following those in the paper. Do not reset the equation counter.
%% Here we use the optional argument for the pdf bookmark.
-\section[The vector product A\times B]{The vector product $\bm{\vec{\mathsf A}\times\vec{\mathsf B}}$}
+\section[The vector product A\times B]{The vector product $\vec{A}\times\vec{B}$}\label{appendix:a}
-\lipsum[21] % <=== This command generates paragraphs of fake Latin. Delete it here and elsewhere!
+This brief illustration of an appendix shows the numbering of the appendix and equations. Equations are numbered
+consecutively, following those in the paper.
\begin{align}
\frac{d\Gamma}{dt} &{}= \int_{\mathcal{C}} \frac{D\mathbf{u}}{Dt} \cdot d\mathbf{r}\\
&{}= \iint_{\mathcal{S}} \nabla \times \frac{D\mathbf{u}}{Dt} \cdot d\mathbf{A}\\
&{}= \iint_{\mathcal{S}} \nabla p \times \nabla \left( \frac{1}{\rho}\right) \cdot d\mathbf{A}
\end{align}
-%% Subsection headings are no numbered in appendices
-\subsection*{Subsection Heading}
-\lipsum[22] % <=== This command generates paragraphs of fake Latin. Delete it here and elsewhere!
+\section{Option to use an author grid}\label{appendix:b}
+
+ASME's most recent templates place author names inline, with affiliations for all authors in rows below.
+This style is the default for this template.
+
+The historical style of authors with affiliation in a grid of blocks may be invoked with
+the option [\texttt{oldauthors}]. When using this form, the author names and addresses should be entered as below:
+
+\smallskip
+\noindent\verb|\SetAuthorBlock{Name\JointFirstAuthor}{%|
+ \hbox{}\hfil\verb|Institution \\ City, State}|
+\verb|\SetAuthorBlock{Name\JointFirstAuthor}{%|
+ \hbox{}\hfil\verb|Institution \\ City, Country}|
+\verb|\SetAuthorBlock{Name, Name}{%|\hfil\hbox{}
+ \noindent\hbox{}\hfil\verb|Institution \\ City, Country}|
+\verb|\SetAuthorBlock{\CorrespondingAuthor{John Lienhard%|
+ \hbox{}\hfil\verb|}{lienhard@mit.edu}}{Institution \\ City, State}|
+
+Directly usable code is contained at the very end of the \texttt{asmeconf-template.tex} file.
+
+%% directly usable code follows the \end{document} command below.
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\section{Language Support}\label{appendix:c}
+
+ASME publishes in English, but the \texttt{babel} package is loaded for
+users who may wish to include other languages. Options are supported to load a primary language, \texttt{lang=},
+as well as a secondary and tertiary language, \texttt{lang-second} and \texttt{lang-third}.
+The primary language must be specified explicitly if a secondary language is loaded.
+If no language option is given, the package defaults to English. An example of use is
+shown in \selectlanguage{french}\appendixname\ \ref{app:fourier}.\selectlanguage{english}
+
+The standard caption and section names will follow \texttt{babel}'s dictionary for primary languages other than English. Users may additionally change ``Keywords'', ``Nomenclature'', ``Corresponding author'', and ``Joint first authors'' by renewing the commands \verb|\keywordname|, \verb|\nomname|, \verb|\CAwords|, and \verb|\JAwords|. Changes to the page footer were described earlier. The pdf bookmark for ``Appendices'' may be changed by renewing \verb|\appendicesname|.
+
+Font encoding is set to T1 with utf-8 input supported:
+%% If you have trouble with the next line, your file may not be saved in utf-8 format. You can delete that line to resolve the issue.
+\typeout{If you have trouble with the next line, your file may not be saved in utf-8 format. You can delete that line to resolve the issue.}
+àáâäæãåā èéęëêēė îïíīįì ôöòóœøōõ ûüùúū çćč ł ñń ßśš ÿ žźż.
+
+No effort has been made to support customization of language-specific fonts, although this is possible by modifying the class file (examples are given in the \texttt{newtx} documentation). The bibliography style, \texttt{asmeconf.bst}, is designed in English and aimed at \hologo{BibTeX}. Multilingual bibliographies can be supported using \texttt{BibLaTeX}.
+
+\selectlanguage{french}
+\section{Discours Préliminaire de Fourier}\label{app:fourier}
+
+Les causes primordiales ne nous sont point connues; mais elles sont assujetties à des lois simples et constantes, que l'on peut découvrir par l'observation, et dont l'étude est l'objet de la philosophie naturelle.
+
+La chale ur pénètre, comme la gravité, toutes les substances de l'univers, ses rayons occupent toutes les parties de l'espace. Le but de notre ouvrage est d'exposer les lois mathématiques que suit cet élément. Cette théorie formera désormais une des branches les plus importantes de la physique générale~\cite{fourier1822}.
+
+\selectlanguage{english}
\end{document}
+
+%%% This is the set-up for the old author block style, a grid of blocks.
+
+% Can also put multiple emails and use command more than once for multiple corresponding authors.
+% Change to your name[s] and addresses, in the desired order of authors. Up to nine author blocks.
+% Note usage below for joint first authors and for corresponding author.
+% First name, middle initial, last name
+% Use title case (upper and lower case letters)
+% (Most of the example names below are not real people, just very common names.)
+
+\SetAuthorBlock{Luis Hern\'{a}ndez\JointFirstAuthor}{Institution or Company Name, City, State}
+\SetAuthorBlock{Maria Silva\JointFirstAuthor}{Institution or Company Name, City, Province, Canada}
+
+\SetAuthorBlock{Henry Tudor, Catherine Parr}{Hampton Court Palace \\ Richmond, England}
+\SetAuthorBlock{Jinsoo Kim}{Institution or Company Name, City, Country}
+\SetAuthorBlock{Yusuf Yilmaz}{Institution or Company Name, City, Country}
+
+% Can omit second argument of \CorrespondingAuthor if putting email into address
+% i.e., can just use \CorrespondingAuthor{name}.
+% Can also put multiple emails in the command and use more than once for multiple corresponding authors.
+
+\SetAuthorBlock{\CorrespondingAuthor{John H.\ Lienhard V}{lienhard@mit.edu}}{%
+Massachusetts Institute of Technology \\ Cambridge, MA}
+
+
Binary files old/doc/latex/asmeconf/sample-figure-2a.pdf and new/doc/latex/asmeconf/sample-figure-2a.pdf differ
Binary files old/doc/latex/asmeconf/sample-figure-2b.pdf and new/doc/latex/asmeconf/sample-figure-2b.pdf differ
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/tlpkg/tlpobj/asmeconf.doc.tlpobj new/tlpkg/tlpobj/asmeconf.doc.tlpobj
--- old/tlpkg/tlpobj/asmeconf.doc.tlpobj 2019-04-08 01:39:21.000000000 +0200
+++ new/tlpkg/tlpobj/asmeconf.doc.tlpobj 2020-04-16 01:56:53.000000000 +0200
@@ -1,9 +1,9 @@
name asmeconf.doc
category Package
-revision 50845
+revision 54758
shortdesc doc files of asmeconf
relocated 1
-docfiles size=95
+docfiles size=170
RELOC/doc/latex/asmeconf/README.md
RELOC/doc/latex/asmeconf/asmeconf-sample.bib
RELOC/doc/latex/asmeconf/asmeconf-template.pdf
++++++ asmeconf.tar.xz ++++++
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/bibtex/bst/asmeconf/asmeconf.bst new/bibtex/bst/asmeconf/asmeconf.bst
--- old/bibtex/bst/asmeconf/asmeconf.bst 2019-04-02 23:11:08.000000000 +0200
+++ new/bibtex/bst/asmeconf/asmeconf.bst 2020-04-15 23:33:36.000000000 +0200
@@ -1,10 +1,10 @@
%%%%%
%%%%% *** This .bst produces the reference format for ASME conference papers. ***
-%%%%% *** Follows the examples given on ASME's conference web pages in early 2019. ***
+%%%%% *** Follows the examples given on ASME's conference web pages in early 2020. ***
%%%%% *** https://www.asme.org/shop/proceedings/conference-publications/references ***
-%%%%% *** The examples given by ASME do not cover all possibilities ***
+%%%%% *** The examples given by ASME do *not* cover all possibilities ***
%%%%%
-%%%%% This file is version 1.0 dated 2019/03/24
+%%%%% This file is version 1.11 dated 2020/04/14
%%%%%
%%%%% Author: John H. Lienhard V
%%%%% Department of Mechanical Engineering
@@ -15,13 +15,32 @@
%%%%% conformance to ASME specifications. Two new fields have been introduced for ASME
%%%%% conference papers:
%%%%%
-%%%%% venue = {city of conference},
-%%%%% confmonth = {month, day[s] on which conference was held},
+%%%%% venue = {city of conference},
+%%%%% eventdate = {month, day[s] on which conference was held}, %% called confmonth in version 1.0
%%%%%
%%%%% This approach leaves the address field as publisher's address,
%%%%% and it leaves the notes field open for other uses.
%%%%%
-%%%%% A simple version of eprint can be used with @misc.
+%%%%% Added fields: eventdate, urldate, urltype, venue
+%%%%% Added: @online{...} for web publications (and aliased it to @www and @electronic)
+%%%%% Added: urlprefix = {}, format.web.urldate, bbl.urldate; urltype field changes "accessed" to something else.
+%%%%% Added: venue and eventdate to @inproceedings
+%%%%%
+%%%%% Edits in version 1.11, 2020/04/14:
+%%%%% correct error in journal eid code.
+%%%%% remove comma between Vol. and No. in article, per ASME style
+%%%%% capitalize "Thesis", per ASME style
+%%%%% insert "." after techreport number, per ASME style
+%%%%% edits to @inbook, @proceedings, @incollection related to chapter and series.
+%%%%% make punctuation after "(ed.)" consistent across entries.
+%%%%% adjust block breaks in @online.
+%%%%% allow for venue and eventdate in @proceedings
+%%%%% add macros for ASME journal titles. add hdl as an equivalent to hndl archive macro.
+%%%%% add numpages functionality for eid: "eid (numpages pages)"
+%%%%% remove "doi" field from @online (since doi is a digital object identifier, not a web page).
+%%%%% add "urldate" to eprint format, for optional use.
+%%%%% warn in @online not to use both eprint and url, and warn if neither is given.
+%%%%% remove series and add volume to @inproceedings.
%%%%%
%%%%% Feel free to edit this file to suit your own needs, but please make note of changes in this header.
%%%%%
@@ -29,7 +48,7 @@
%% LICENSE:
%% This file is a derivative work from the generated file, as envisioned by the LaTeX Project Public License.
%%
-%% Copyright (c) 2019 John Lienhard
+%% Copyright (c) 2020 John Lienhard
%%
%% Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
%% associated documentation files (the "Software"), to deal in the Software without restriction,
@@ -89,17 +108,16 @@
ENTRY
{ address
archive
- archivePrefix
author
booktitle
chapter
collaboration
- confmonth
doi
edition
editor
eid
eprint
+ eventdate
howpublished
institution
journal
@@ -110,14 +128,15 @@
numpages
organization
pages
- primaryClass
publisher
school
series
title
type
url
- venue
+ urldate
+ urltype
+ venue
volume
year
}
@@ -316,6 +335,9 @@
FUNCTION {bbl.in}
{ "in" }
+FUNCTION {bbl.paperno}
+{ "" }
+
FUNCTION {bbl.pages}
{ "pp." }
@@ -332,10 +354,10 @@
{ "Technical Report" }
FUNCTION {bbl.mthesis}
-{ "Master's thesis" }
+{ "Master's Thesis" }
FUNCTION {bbl.phdthesis}
-{ "Ph.D. thesis" }
+{ "Ph.D. Thesis" }
FUNCTION {bbl.first}
{ "1st" }
@@ -364,6 +386,10 @@
FUNCTION {bbl.th}
{ "th" }
+FUNCTION {bbl.urldate}
+ { "Accessed" }
+
+
MACRO {jan} {"Jan."}
MACRO {feb} {"Feb."}
@@ -409,6 +435,79 @@
if$
}
+MACRO {arxiv} {"https://arxiv.org/abs/"}
+
+MACRO {googlebooks} {"http://books.google.com/books?id="}
+
+MACRO {hdl} {"http://hdl.handle.net/"}
+MACRO {hndl} {"http://hdl.handle.net/"}
+
+MACRO {jstor} {"http://www.jstor.org/stable/"}
+
+MACRO {oclc} {"http://www.worldcat.org/oclc/"}
+
+MACRO {pubmed} {"http://www.ncbi.nlm.nih.gov/pubmed/"}
+
+
+MACRO {amr} {"Appl. Mech. Rev."}
+
+MACRO {lds} {"ASME Letters Dynamic Systems"}
+
+MACRO {jru} {"ASME J. Risk Uncertainty"}
+
+MACRO {jsbc} {"ASME J. Sustainable Bldg. and Cities"}
+
+MACRO {jam} {"ASME J. Appl. Mech."}
+
+MACRO {jbe} {"ASME J. Biomed. Eng."}
+
+MACRO {jcnd} {"ASME J. Comput. Nonlin. Dyn."}
+
+MACRO {jcise} {"ASME J. Comput. Inf. Sci. Eng."}
+
+MACRO {jds} {"J. Dyn. Syst.-T. ASME"}
+
+MACRO {jep} {"ASME J. Electron. Packag."}
+
+MACRO {jert} {"ASME J. Energy Resour."}
+
+MACRO {jegtp} {"ASME J. Eng. Gas Turbines Power"}
+
+MACRO {jem} {"ASME J. Eng. Mater."}
+
+MACRO {jfe} {"ASME J. Fluids Eng."}
+
+MACRO {jfcst} {"ASME J. Fuel Cell Sci. Tech."}
+
+MACRO {jht} {"ASME J. Heat Transfer"}
+
+MACRO {jmse} {"ASME J. Manuf. Sci. E."}
+
+MACRO {jmd} {"ASME J. Mech. Des."}
+
+MACRO {jmr} {"ASME J. Mech. Robot."}
+
+MACRO {jmdv} {"ASME J. Med. Devices"}
+
+MACRO {jmnm} {"ASME J. Micro Nano-Manuf."}
+
+MACRO {jnem} {"ASME J. Nanotech Eng. Med."}
+
+MACRO {joma} {"ASME J. Offshore Mech. Arct."}
+
+MACRO {jpv} {"ASME J. Press. Vess."}
+
+MACRO {jse} {"ASME J. Sol. Energy"}
+
+MACRO {jtsea} {"ASME J. Therm. Sci. Eng. Appl."}
+
+MACRO {jtb} {"ASME J. Tribol."}
+
+MACRO {jtm} {"ASME J. Turbomach."}
+
+MACRO {jva} {"ASME J. Vib. Acoust."}
+
+
MACRO {acmcs} {"ACM Computing Surveys"}
MACRO {acta} {"Acta Informatica"}
@@ -486,24 +585,48 @@
if$
}
+FUNCTION {format.web.urldate}
+{ urldate empty$
+ {""}
+ {urldate "urldate" bibinfo.check
+ urltype duplicate$ empty$
+ { pop$ bbl.urldate }
+ 'skip$
+ if$
+ "urltype" bibinfo.check
+ swap$ duplicate$ empty$
+ { pop$ "t" change.case$ }
+ { tie.or.space.prefix * * }
+ if$
+ ", " *
+ }
+ if$
+}
FUNCTION {format.eprint}
-{ eprint empty$
- { ""}
- {"\href{http://arxiv.org/abs/" eprint * "}{" * eprint "}" * *}
- if$
+{ eprint duplicate$ empty$
+ 'skip$
+ { "\eprint"
+ archive empty$
+ { "there's an eprint but no archive in " cite$ * warning$ }
+ { "[" * archive * "]" * }
+ if$
+ "{" * swap$ * "}" *
+ format.web.urldate swap$ *
+ }
+ if$
}
-
FUNCTION {format.url}
{
url
duplicate$ empty$
{ pop$ "" }
- { "\urlprefix\url{" swap$ * "}" * }
+ { "\urlprefix\url{" swap$ * "}" *
+ format.web.urldate swap$ *
+ }
if$
}
-
INTEGERS { nameptr namesleft numnames }
@@ -573,7 +696,6 @@
FUNCTION {format.editors}
{ editor "editor" format.names duplicate$ empty$ 'skip$
{
- "," *
" " *
get.bbl.editor
"(" swap$ * ")" *
@@ -745,6 +867,20 @@
}
if$
}
+
+FUNCTION {format.paper.number}
+{ number "number" bibinfo.check
+ type duplicate$ empty$
+ { pop$ bbl.paperno }
+ 'skip$
+ if$
+ "type" bibinfo.check
+ swap$ duplicate$ empty$
+ { pop$ "t" change.case$ }
+ { tie.or.space.prefix * * }
+ if$
+}
+
FUNCTION {format.number.series}
{ volume empty$
{ number empty$
@@ -757,7 +893,7 @@
if$
number tie.or.space.prefix "number" bibinfo.check * *
bbl.in space.word *
- series "series" bibinfo.check *
+ series emphasize "series" bibinfo.check *
}
if$
}
@@ -896,19 +1032,21 @@
{ eid "eid" bibinfo.check
duplicate$ empty$ 'pop$
{ swap$ duplicate$ empty$ 'skip$
- {
+ {
" " *
- }
- if$
- swap$ *
- numpages empty$ 'skip$
- { bbl.eidpp numpages tie.or.space.prefix
- "numpages" bibinfo.check * *
- " (" swap$ * ")" * *
+ format.year * ": " *
+ swap$
+ *
+ numpages empty$ 'skip$
+ { numpages bbl.eidpp tie.or.space.prefix
+ "numpages" bibinfo.check * *
+ " (" swap$ * ")" * *
+ }
+ if$
}
if$
- }
- if$
+ }
+ if$
}
FUNCTION {format.vol.num.pages}
{ volume field.or.null
@@ -926,14 +1064,14 @@
'skip$
if$
swap$
- ", " bbl.nr * number tie.or.space.prefix pop$ * swap$ *
+ " " bbl.nr * number tie.or.space.prefix pop$ * swap$ *
}
if$ *
}
FUNCTION {format.chapter.pages}
{ chapter empty$
- { "" }
+ 'format.pages
{ type empty$
{ bbl.chapter }
{ type "l" change.case$
@@ -942,6 +1080,10 @@
if$
chapter tie.or.space.prefix
"chapter" bibinfo.check
+ pages empty$
+ 'skip$
+ { ", " * format.pages * }
+ if$
* *
}
if$
@@ -960,7 +1102,7 @@
"" *
" " *
get.bbl.editor
- "(" swap$ * ") " *
+ "(" swap$ * "). " *
* swap$
* }
if$
@@ -1150,7 +1292,6 @@
{ output.bibitem
author empty$
{ format.editors "author and editor" output.check
- add.blank
}
{ format.authors output.nonnull
crossref missing$
@@ -1184,6 +1325,7 @@
format.note output
fin.entry
}
+
FUNCTION {booklet}
{ output.bibitem
format.authors output
@@ -1220,22 +1362,23 @@
new.block
crossref missing$
{
+ format.bvolume output
format.number.series output
+ new.block
+ new.sentence
format.publisher.address output
- format.bvolume output
- format.chapter.pages "chapter and pages" output.check
new.block
new.sentence
}
{
- format.chapter.pages "chapter and pages" output.check
new.block
format.book.crossref output.nonnull
}
if$
format.date "year" output.check
date.block
- format.pages "pages" output.check
+ format.chapter.pages "chapter and pages" output.check
+ new.block
format.doi output
new.block
format.eprint output
@@ -1254,9 +1397,9 @@
crossref missing$
{ format.in.ed.booktitle "booktitle" output.check
format.edition output
+ new.block
format.number.series output
format.bvolume output
- format.chapter.pages output
new.sentence
format.publisher.address output
}
@@ -1266,7 +1409,7 @@
if$
format.date "year" output.check
conf.date.block
- format.pages "pages" output.check
+ format.chapter.pages "pages" output.check
format.doi output
new.block
format.eprint output
@@ -1284,13 +1427,18 @@
new.block
crossref missing$
{ format.in.ed.booktitle "booktitle" output.check
+ volume empty$ 'skip$
+ { bbl.volume volume tie.or.space.prefix
+ "volume" bibinfo.check * * output
+ }
+ if$
new.sentence
- format.number.series output
+ format.paper.number output
conf.date.block
format.pages "pages" output.check
new.sentence
venue output
- confmonth output
+ eventdate output
format.thesis.year "year" output.check
new.sentence
publisher empty$
@@ -1312,6 +1460,7 @@
fin.entry
}
FUNCTION {conference} { inproceedings }
+
FUNCTION {manual}
{ output.bibitem
author empty$
@@ -1392,6 +1541,46 @@
empty.misc.check
}
+FUNCTION {online}
+{ output.bibitem
+ author empty$
+ { format.editors "author and editor" output.check
+ }
+ { format.authors output.nonnull
+ crossref missing$
+ { "author and editor" editor either.or.check }
+ 'skip$
+ if$
+ }
+ if$
+ new.block
+ format.title
+ "title" output.check
+ new.block
+ organization "organization" bibinfo.warn output
+ address "address" bibinfo.check output
+ format.date "year" output.check
+ new.block
+ url empty$
+ { eprint empty$
+ { "missing url and eprint in" cite$ * warning$ }
+ { format.eprint output }
+ if$
+ }
+ { "url and eprint" eprint either.or.check
+ format.url "url" bibinfo.warn output
+ }
+ if$
+ new.block
+ format.note output
+ fin.entry
+}
+
+FUNCTION {electronic} { online }
+
+FUNCTION {www} { online }
+
+
FUNCTION {phdthesis}
{ output.bibitem
format.authors "author" output.check
@@ -1418,11 +1607,16 @@
editor empty$
{ organization "organization" bibinfo.check output
}
- { format.editors output.nonnull }
+ { format.editors output.nonnull
+ }
if$
new.block
format.btitle "title" output.check
format.bvolume output
+ new.block
+ venue "venue" output.check
+ eventdate "eventdate" output.check
+ new.block
editor empty$
{ publisher empty$
{ format.number.series output }
@@ -1447,7 +1641,7 @@
if$
}
if$
- format.date "year" output.check
+ format.date "year" output.check
format.doi output
new.block
format.eprint output
@@ -1465,6 +1659,7 @@
"title" output.check
new.block
format.tr.number output.nonnull
+ new.block
institution "institution" bibinfo.warn output
address "address" bibinfo.check output
new.block
@@ -1533,7 +1728,7 @@
write$ newline$
" \providecommand{\doi}{DOI \discretionary{}{}{}\begingroup \urlstyle{rm}\Url}\fi"
write$ newline$
- "\providecommand{\eprint}[2][]{\url{#2}}"
+ "\providecommand{\eprint}[2][]{\urlprefix\href{#1#2}{#1#2}}"
write$ newline$
}
EXECUTE {begin.bib}
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/tex/latex/asmeconf/asmeconf.cls new/tex/latex/asmeconf/asmeconf.cls
--- old/tex/latex/asmeconf/asmeconf.cls 2019-04-07 23:26:15.000000000 +0200
+++ new/tex/latex/asmeconf/asmeconf.cls 2020-04-15 23:33:36.000000000 +0200
@@ -1,11 +1,13 @@
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%
%% This file provides the asmeconf class for formatting conference papers according to
-%% ASME conference requirements as represented on ASME's conference web pages in March 2019.
+%% ASME conference requirements as represented on ASME's conference web pages in 2020.
%%
%% Please note that ASME's journals follow specifications different from ASME conference papers.
%%
-%% This file is version 1.03 dated 2019/04/06.
+%% This file is version 1.18 dated 2020/04/14.
+ \def\versionno{1.18}
+ \def\versiondate{2020/04/14\space}
%%
%% Author: John H. Lienhard V
%% Department of Mechanical Engineering
@@ -18,8 +20,8 @@
%% 2. With the associated amseconf.bst, match ASME's reference formats
%% 3. Maintain hyperref compatibility for pdf bookmarks and hyperlinks
%% 4. Use the newtxtext and newtxmath font packages, including relevant features
-%% 5. Provide automatic layout of author blocks for up to nine addresses
-%% 6. Provide sans serif Greek letters for use in section heading and captions
+%% 5. Provide automatic layout of author names and addresses
+%% 6. Support bold face, sans serif math in headings
%%
%% This class is compatible with either pdfLaTeX or LuaLaTeX. The class uses a number of packages,
%% many of which are part of the standard LaTeX distribution, and all of which are in TeXLive and
@@ -31,7 +33,7 @@
%% This class is not designed for unicode-math or fontspec, given that the ASME conference style is
%% specific with respect to the font selections.
%%
-%% Options for the class are described on lines 74-90.
+%% Options for the class are configured on lines 79-169.
%%
%% The class defines two environments: abstract and nomenclature. The latter has an optional argument to
%% control the space between the entries and the definitions.
@@ -39,12 +41,15 @@
%% New commands are described in the asmeconf-template.tex file. The \section[]{} command's optional
%% argument is changed to better support pdf bookmarks, and \section* is modified similarly.
%%
+%% Commands for entering conference headers and author names are specific to this class.
+%% See asmeconf-template.tex for details.
+%%
%%
% =========================================================
%%
%% LICENSE:
%%
-%% Copyright (c) 2019 John H. Lienhard
+%% Copyright (c) 2020 John H. Lienhard
%%
%% Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
%% associated documentation files (the "Software"), to deal in the Software without restriction,
@@ -64,7 +69,7 @@
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\NeedsTeXFormat{LaTeX2e}
-\ProvidesClass{asmeconf}[2019/04/04 ASME Conference Paper Format]
+\ProvidesClass{asmeconf}[\versiondate ASME Conference Paper Format (JHL)]
\LoadClass[twoside,twocolumn,10pt]{article}
% Two-sided layout not used in ASME's specs, although that's how the papers are printed
@@ -72,37 +77,104 @@
%%%%%%%%%%%%%% Options for the class %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\RequirePackage{ifthen}
+\newboolean{DefaultSups}
+\setboolean{DefaultSups}{true}
+\newboolean{Oldauthors}
+\setboolean{Oldauthors}{false}
+\newboolean{Balance}
+\setboolean{Balance}{false}
+\newboolean{lineno}
+\setboolean{lineno}{false}
+
+
+\RequirePackage{kvoptions}
+%\RequirePackage{kvsetkeys} % already loaded by kvoptions
+\SetupKeyvalOptions{
+ family=asmeconf,
+ prefix=asmeconf@,
+ setkeys=\kvsetkeys,
+}
+
+%%% for mathalfa, we may now pass options in this format: mathalfa=cal=euler, mathalfa=frak=boondox
+\define@key{asmeconf}{mathalfa}{%
+ \PassOptionsToPackage{#1}{mathalfa}%
+}
+
+%%% set key [nodefaultsups] to obtain newtx superiors font for footnotes.
+\define@key{asmeconf}{nodefaultsups}[false]{%
+ \setboolean{DefaultSups}{#1}
+}
+
+%%% set key [nodefaultsups] to obtain newtx superiors font for footnotes.
+\define@key{asmeconf}{nodefaultsups}[false]{%
+ \setboolean{DefaultSups}{#1}
+}
+
+%%% set key [balance] to balance column height on last page.
+\define@key{asmeconf}{balance}[true]{%
+ \setboolean{Balance}{#1}
+ \ClassWarningNoLine{asmeconf}{Loading flushend package to balance column height on last page}%
+}
+
+%%% set key [lineno] to obtain linenumbers.
+\define@key{asmeconf}{lineno}[true]{%
+ \setboolean{lineno}{#1}
+}
+
+%%% set key [lang,lang-second,lang-third] to pass languages to babel.
+
+%% In case language options are dropped during editing, include this. Subsequent choice of lang= will override it.
+\PassOptionsToPackage{english}{babel}
+
+\define@key{asmeconf}{lang}[english]{%
+ \PassOptionsToPackage{main=#1}{babel}%
+}
+\define@key{asmeconf}{lang-second}[english]{%
+ \PassOptionsToPackage{#1}{babel}%
+}
+\define@key{asmeconf}{lang-third}[english]{%
+ \PassOptionsToPackage{#1}{babel}%
+}
+
+\ProcessKeyvalOptions*
+
+%% option to have colored hyperlinks
+\DeclareOption{colorlinks}{%
+ \PassOptionsToPackage{colorlinks=true}{hyperref}%
+ }
+
%% option to omit ASME footer
\DeclareOption{nofoot}{%
\AtBeginDocument{\pagestyle{plain}}%
}
-%% Access many options from newtxmath
-%% See newtxmath documentation for details
-\DeclareOption{upint,smallerops,varvw,varg,slantedGreek,frenchmath,varbb,cmbraces}{\PassOptionsToPackage{}{newtxmath}}
-
-%% Access many options for mathalpha; defaults are scr=dutchcal,cal=euler
-%% See mathalfa documentation for details
-\DeclareOption{scr,cal,frak,bb,scrscaled,calscaled,frakscaled,bbscaled,scaled}{\PassOptionsToPackage{}{mathalfa}}
+%% Access many options from newtxmath. See newtx documentation for details.
+\DeclareOption{upint,smallerops,varvw,varg,uprightGreek,slantedGreek,frenchmath,varbb,cmbraces}{\PassOptionsToPackage{}{newtxmath}}
%% Option for slightly larger small capitals font
\DeclareOption{largesc}{\PassOptionsToPackage{largesc}{newtxtext}}
%% Option not to use latex default superscripts, instead using the newtxtext superiors font [nodefaultsups]
-%% The following coding is used because newtxtext cannot process "defaultsups=false"
-\newcommand{\ignore}[1]{#1}
-\DeclareOption{nodefaultsups}{%
- \renewcommand{\ignore}[1]{}%
- \DeclareOption{supstyle}{}%
+\ifthenelse{\boolean{DefaultSups}}{\PassOptionsToPackage{defaultsups}{newtxtext}}{\relax}
+
+%% option to use old authors
+\DeclareOption{oldauthors}{%
+ \setboolean{Oldauthors}{true}%
+ \ClassWarningNoLine{asmeconf}{Selected option for a grid of author blocks}%
+ }
+
+%% Option to hyphenate the typewriter font [hyphenate]
+\DeclareOption{hyphenate}{%
+ \PassOptionsToPackage{hyphenate}{inconsolata}%
+ \ClassWarningNoLine{asmeconf}{Allowing hyphenation of typewriter font}%
}
-\ExecuteOptions{scr=dutchcal,cal=euler}
-\ProcessOptions\relax
-
-%% now that \ignore is def'd and other options declared, we can deal with newtxtext defaultsups command
-\ignore{\DeclareOption{supstyle}{\PassOptionsToPackage{defaultsups}{newtxtext}}}
-\ExecuteOptions{supstyle}
-\ProcessOptions\relax
+%% Suppress warnings about mathalfa keys as unused global options
+\DeclareOption*{}
+
+\ProcessOptions \relax
+
%%%%%%%%%%%%% end options %%%%%%%%%%%%%%%%%%%
@@ -113,45 +185,81 @@
\setlength\columnsep{0.38in}
\RequirePackage[sort&compress,numbers]{natbib}
-\setlength\bibsep{3pt plus 1pt minus 2pt}
+\setlength\bibsep{1pt plus 1pt minus 1pt}
\RequirePackage{graphicx}
\RequirePackage[hyperref,fixpdftex,dvipsnames,svgnames,x11names]{xcolor}
\RequirePackage{xparse}
+\RequirePackage{metalogo,hologo} % Access various LaTeX logos if needed
%%%%%%%%%%%%%%%%%%%%%%%%
\RequirePackage{booktabs}
\RequirePackage{array}
-\RequirePackage{dcolumn} %%% alignment on decimal places
-\newcolumntype{d}[1]{D{.}{.}{#1}}
+\RequirePackage{dcolumn} %%% alignment on decimal places
+\newcolumntype{d}[1]{D{.}{.}{#1}} %% conflicts with babel's spanish language option.
%%%% FONT related %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\RequirePackage{mathtools} % extends amsmath
-\RequirePackage[utf8]{inputenc}
+\RequirePackage[T1]{fontenc}
+
+\RequirePackage{iftex} % check whether pdfTeX or a different engine is used
+\ifpdftex
+ \pdfminorversion=7 % This selection is not required.
+ \RequirePackage[utf8]{inputenc} % for backward compatibility with pre-2018 distributions
+\else
+ \relax
+\fi
+
+\RequirePackage{mathtools} % loads and extends amsmath
+
+\RequirePackage[]{babel}
\RequirePackage[]{newtxtext}
+\RequirePackage[varqu,varl]{inconsolata} % sans typewriter font
\RequirePackage[]{newtxmath}
% See package documentation
-\RequirePackage[]{mathalfa} % load optional fonts for Calligraphy, Script, etc.
-% See package documentation
+%% override \textsu if using default superiors
+\ifthenelse{\boolean{DefaultSups}}{\let\textsu\textsuperscript}{\relax}
+
+\RequirePackage[]{mathalfa} % load optional fonts for Calligraphy, Script, Fraktur
+% See mathalfa package documentation for capabilities of this package.
+% Option format: mathalfa=cal=euler (etc.)
\RequirePackage{bm} % load after all math to give access to bold math
+%% Ensure that the current font is used for equation tags, not \normalfont as set by amsmath
+\def\maketag@@@#1{\hbox{\m@th#1}}
-%%%% font size selection %%%%%%%%
-%%%% ASME's specs differ from latex standard article-10 class %%%
+% The article class calls \sloppy in two-column mode (\tolerance 9999, \emergencystretch 3em)
+% These adjustments affect line breaking; the values below are intended to produce
+% fewer lines with large spaces, without creating the problems of using \fussy in two-column mode.
+\tolerance 2500
+\emergencystretch 3em
-\renewcommand\LARGE{\@setfontsize\LARGE{15}{18}} %... default is 17
-\renewcommand\Large{\@setfontsize\Large{12}{14.5}} %... default is 14
-\renewcommand\large{\@setfontsize\large{11}{13.6}} %... default is 12
-\renewcommand\normalsize{\@setfontsize\normalsize{10}{12}}
-\renewcommand\small{\@setfontsize\small{9}{10.8}}
-\renewcommand\footnotesize{\@setfontsize\footnotesize{8}{9.6}}
+%%%% font size selection %%%%%%%%
+%%%% ASME's specs differ slightly from latex standard article-10 class %%%
+\renewcommand\LARGE{\@setfontsize\LARGE{16}{19.2}} %{18}{21.6}} updated 7/7/19 to match new ASME spec.
+ % ...default is 17.28/22 ... used for paper#
+\renewcommand\large{\@setfontsize\large{11}{13.6}} %... default is 12/14 ... used for headings
+
+%\renewcommand\Large{\@setfontsize\Large{14.4}{18}} % same as default
+%\renewcommand\normalsize{\@setfontsize\normalsize{10}{12}} % same as default
+%\renewcommand\small{\@setfontsize\small{9}{11}} % same as default
+%\renewcommand\footnotesize{\@setfontsize\footnotesize{8}{9.5}} % same as default
+
+
+%% This provides sans serif italic and sans serif bold italic math.
+%% It's intended only for use in the figure captions and section headings (recommend \bm{..} elsewhere).
+\DeclareMathVersion{sansbold}
+\SetSymbolFont{letters}{sansbold}{OML}{ntxsfmi}{b}{it}
+\SetSymbolFont{lettersA}{sansbold}{U}{ntxsfmia}{b}{it}
+\SetSymbolFont{symbols}{sansbold}{LMS}{ntxsy}{b}{n}
+\SetSymbolFont{operators}{sansbold}{\encodingdefault}{\sfdefault}{\bfdefault}{n}
+\SetMathAlphabet{\mathsf}{sansbold}{\encodingdefault}{\sfdefault}{b}{it}
%%%%%% footer %%%%%%%
@@ -165,12 +273,14 @@
\renewcommand{\headrulewidth}{0pt}
\renewcommand{\footrulewidth}{0pt}
-%%%%%% foonotes %%%%%%%
+%%%%%% footnotes %%%%%%%
\RequirePackage{fnpos}
\makeFNbottom
\makeFNbelow
+\setlength{\skip\footins}{\baselineskip} % <=== per ASME 1 extra line
+
\renewcommand{\footnoterule}{%
\kern -3pt
\hrule width 0.5in height 0.4pt
@@ -187,8 +297,10 @@
\RequirePackage[labelfont={sf,bf},hypcap=false]{caption}
\RequirePackage[hypcap=false,list=true]{subcaption}
-\captionsetup[figure]{name=FIGURE,labelfont={sf,bf,small},textfont={sf,bf,small},labelsep=period}
-\captionsetup[table]{name=TABLE,labelfont={sf,bf,small},textfont={sf,bf,small},labelsep=period}
+\DeclareCaptionLabelFormat{uppercase}{\MakeTextUppercase{#1} #2}
+\DeclareCaptionTextFormat{boldmath}{\mathversion{sansbold}#1}
+\captionsetup[figure]{labelformat=uppercase, labelfont={sf,bf,small},textfont={sf,bf,small},textformat=boldmath, labelsep=colon}
+\captionsetup[table]{labelformat=uppercase, labelfont={sf,bf,small},textfont={sf,bf,small},textformat=boldmath, labelsep=colon,skip=0.5\baselineskip} %name=TABLE,
%% This construction avoids a failure of hyperref in relation to uppercase caption
%% Discussion: https://tex.stackexchange.com/questions/375695/maketextuppercase-inside-tabl...
@@ -197,7 +309,13 @@
\renewcommand*{\caption}[2][\shortcaption]{\def\shortcaption{#2}\scaption[#1]{\MakeTextUppercase{#2}}}%
}
-
+%%%%%% introduce some caption or section names %%%%%%%%%%%
+ \providecommand{\nomname}{Nomenclature}
+ \providecommand{\keywordname}{Keywords}
+ \providecommand{\appendicesname}{APPENDICES}
+ \providecommand{\JAwords}{Joint first authors}
+ \providecommand{\CAwords}{Corresponding author}
+
%%%%%%%%%%%%%%%%%% Section headings %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%% wish to accommodate hyperref
@@ -206,23 +324,23 @@
\RequirePackage[raggedright,indentafter]{titlesec}
%% ASME specifies 10 pt headings
-\titleformat{\section}{\bfseries\sffamily\raggedright}{\thesection :}{0.5em}{\MakeTextUppercase}
-\titleformat{name=\section,numberless}{\bfseries\sffamily\raggedright}{}{0em}{\MakeTextUppercase}
+\titleformat{\section}{\mathversion{sansbold}\bfseries\sffamily\raggedright}{\thesection .}{0.5em}{\MakeTextUppercase}
-\titleformat{\subsection}{\bfseries\sffamily\raggedright}{}{0pt}{\indent}
-\titleformat{\subsubsection}[runin]{\bfseries\sffamily}{}{0pt}{\indent}[.\hspace*{0.5em}]
+\titleformat{\subsection}{\mathversion{sansbold}\bfseries\sffamily\raggedright}{\thesubsection}{0.5em}{}
+\titleformat{\subsubsection}[runin]{\mathversion{sansbold}\bfseries\sffamily}{\thesubsubsection}{0.5em}{}[.\hspace*{0.5em}]
-\titlespacing\section{0pt}{12pt plus 4pt minus 2pt}{2pt plus 2pt minus 1pt}
+\titlespacing\section{0pt}{12pt plus 4pt minus 2pt}{1pt plus 1pt minus 1pt} % from 2 pt 2 pt 1 pt, 7/7/19
\titlespacing\subsection{0pt}{12pt plus 4pt minus 2pt}{0pt plus 2pt minus 1pt}
-\titlespacing\subsubsection{0pt}{12pt plus 4pt minus 2pt}{0pt plus 2pt minus 1pt}
+\titlespacing\subsubsection{\parindent}{6pt plus 3pt minus 2pt}{0pt plus 2pt minus 1pt} % from 12 4 3, 7/7/19
%% Special handling of the appendices
%% Assumes that appendices are the last content in paper
\RenewDocumentCommand{\appendix}{}{%
- \pdfbookmark[0]{Appendices}{appendices}
+ \setcounter{section}{0}
+ \pdfbookmark[0]{\appendicesname}{appendices}
\renewcommand\thesection{\Alph{section}}
- \titleformat{\section}{\bfseries\sffamily\raggedright}{APPENDIX \thesection:}{0.5em}{\MakeTextUppercase}
+ \titleformat{\section}{\mathversion{sansbold}\bfseries\sffamily\raggedright}{\MakeTextUppercase{\appendixname}\ \thesection.}{0.5em}{\MakeTextUppercase}
}
%%%%%%%%%%%%% hyperref %%%%%%%%%%%%%%%%%%%
@@ -237,10 +355,10 @@
bookmarksnumbered=true,%
bookmarksopen=true,%
bookmarksopenlevel=1,%
- colorlinks=true,%%% <=== set false to get black type, but do so in .tex file
+% colorlinks=true,%%% <=== set true to get colored type, but do so via package options
linkcolor=blue, %
- citecolor=blue, % SeaGreen4,%
- urlcolor=blue, % Red3,%
+ citecolor=blue, %
+ urlcolor=blue, %
breaklinks=true,%
pdftitle={}, % <=== add in .tex file
pdfkeywords={}, % <=== add in .tex file
@@ -252,16 +370,22 @@
\urlstyle{same} % don't switch to typewriter font
-\RequirePackage{doi} % provides hyperlinks for doi in bibliography
+\RequirePackage{doi} % supports the nasty characters in some doi's
\renewcommand{\doitext}{DOI } % change the default value, {doi:}, to this per ASME specification
+\RequirePackage{bookmark} % improves handling of pdf bookmarks
-
-%% Since \bm is useful in headings, this fix will reduce frequency with which
-%% alternate pdfstrings must be given in revised section command as \section[pdfstring]{texstring}
+%% Since \bm may be useful in headings, this fix will reduce frequency with which
+%% alternate pdfstrings must be given in revised section command as \section[pdfstring]{texstring}
\pdfstringdefDisableCommands{%
\def\bm#1#{\relax}%
}
+%% Let's disable \( and \) in pdf bookmarks, 28/2/20
+\pdfstringdefDisableCommands{%
+ \def\({\relax}%
+ \def\){\relax}%
+}
+
%% Let's also make sure \NoCaseChange in section headings won't break pdf bookmarks
\pdfstringdefDisableCommands{%
\let\NoCaseChange\relax%
@@ -275,35 +399,65 @@
%% Let's make sure footnotes in section headings don't break pdf bookmarks.
\RequirePackage{etoolbox}
\robustify{\footnote}
+% \patchcmd{\section}{\sectionmark}{\let\footnote\@gobble\sectionmark}{}{} <== not really needed in this context 28/2/20
\pdfstringdefDisableCommands{%
\def\footnote#1{}%
}
-
%% Let's also add \footnote to the \TextUppercase exception list, so that footnote text won't be capitalized
-%% if given in section headings
-\RequirePackage{xpatch}
-\xpatchcmd{\@uclcnotmath}{\@nonchangecase\ref}{\@nonchangecase\ref\@nonchangecase\footnote}{}{}
+%% if given in section headings. Ditto for \eqref
+%
+\patchcmd{\@uclcnotmath}{\@nonchangecase\ref}{\@nonchangecase\ref\@nonchangecase\footnote}{}{}
+\patchcmd{\@uclcnotmath}{\@nonchangecase\ref}{\@nonchangecase\ref\@nonchangecase\eqref}{}{} %% corrected 24 Jan 2020
%%% Create an optional argument for unnumbered sections and set pdf bookmark (thru \addcontentsline).
%%% The optional argument will manually set the pdf bookmark for that section; can be used to avoid hyperref
%%% errors when macros are in section titles.
-%%% There should not be errors for $$, \cite, \ref, \label, \footnote, or \bm with current construction.
+%%% There should not be errors for $, \cite, \ref, \eqref, \label, \footnote, \NoCaseChange, or \bm with current constructions.
\let\svsection\section
\RenewDocumentCommand{\section}{s o m}{%
\IfBooleanTF {#1}
- {\svsection*{#3}\phantomsection
+ {\svsection*{#3}\phantomsection%
{\IfNoValueTF {#2}
- {\addcontentsline{toc}{section}{#3} }
- {\addcontentsline{toc}{section}{#2} }
- }
- }
+ {\addcontentsline{toc}{section}{#3}}
+ {\addcontentsline{toc}{section}{#2}}% removed trailing space 28/2/20
+ }%
+ }%
{\IfNoValueTF {#2}
{\svsection{#3}}
- {\svsection[#2]{#3}}
- }
+ {\svsection[#2]{#3}}%
+ }%
+}
+
+%%%%%%%%%%%%% Line numbering and balancing columns on last page %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\ifthenelse{\boolean{lineno}}{%
+ \RequirePackage[switch,mathlines]{lineno}
+ \renewcommand{\linenumberfont}{\normalfont\footnotesize\color{red}}
+ \AtBeginDocument{\linenumbers}
+ \ClassWarningNoLine{asmeconf}{Package lineno loaded, so final column balancing is disabled}
+%%% Allow line numbering in AMS math environments.
+%%% postdisplaypenalty adjusted to avoid extra line number at end, see discussion here: https://tex.stackexchange.com/a/461192/
+%%% multline has some problem that puts an extra line number above it.
+%%% Requires xparse and etoolbox
+\NewDocumentCommand{\losepostpenalty}{}{\patchcmd{\linenomathWithnumbers}{\advance\postdisplaypenalty\linenopenalty}{}{}{}}
+
+\NewDocumentCommand{\FixAMSMath}{m}{%
+ \AtBeginEnvironment{#1}{\losepostpenalty\linenomath}%
+ \AtEndEnvironment{#1}{\endlinenomath}%
+ \AtBeginEnvironment{#1*}{\losepostpenalty\linenomath}%
+ \AtEndEnvironment{#1*}{\endlinenomath}%
+}
+
+\NewDocumentCommand{\FixAll}{>{\SplitList{;}}m}{\ProcessList{#1}{\FixAMSMath}}
+\FixAll{align;alignat;gather;flalign;multline}
+
+ }{%
+ \ifthenelse{\boolean{Balance}}{\RequirePackage{flushend}}{\relax} % flushend is NOT compatible with lineno
}
+\providecommand{\@LN@col}[1]{\relax}
+\providecommand{\@LN}[2]{\relax}
%%%%%%%%%%%%% Define special environments %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@@ -316,36 +470,50 @@
\DeclareDocumentCommand{\keywords}{m}{%
\IfNoValueTF{#1}{%
\relax}{%
- \long\def\@keywords{\par\medskip\noindent{\bfseries\sffamily Keywords:} #1}%
+ \long\def\@keywords{\par\smallskip\noindent{\bfseries\sffamily \keywordname:} #1}%
}
}
\DeclareDocumentEnvironment{abstract}{}{%
- \section*{Abstract}%
+ \section*{\abstractname}\itshape%
}
- {\@keywords\bigskip%
+ {\upshape\@keywords%\medskip%
}
-
-%% Nomenclature environment.
+%%%%%%%%%%%% Nomenclature environment %%%%%%%%%%%%%%%%%%
+%%
%% Increase first optional argument to a dimension > 2em if wide entries cause undesired misalignment of columns.
%% Second argument can be used to rename, e.g., to List of Symbols.
%%
-\newcommand\entry[2]{\item[#1\hfill]#2}
+
\newlength\nomenwidth
+\newlength\savitemsep
-\DeclareDocumentEnvironment{nomenclature}{O{2em} O{Nomenclature}}{%
+%% If second argument of \entry is omitted, will produce an italicized heading (e.g. "Greek letters")
+%%
+\DeclareDocumentCommand{\entry}{m g}{%
+ \IfNoValueTF{#2}{%
+ \itemsep3\p@ plus 1\p@ minus 1\p@%
+ \goodbreak\item[\itshape#1\hfill]\setlength\itemsep\savitemsep\@itempenalty=1000%\nopagebreak% \smallskip
+ }{%
+ \item[#1\hfill]#2%
+ \@itempenalty=-\@lowpenalty%
+ }%
+}
+
+\DeclareDocumentEnvironment{nomenclature}{O{2em} O{\nomname}}{%
\setlength\columnsep{2em}
\setlength{\nomenwidth}{#1}
\section*{#2}
\raggedright
\begin{list}{}{%
- \setlength{\itemsep}{0pt}
- \setlength{\parsep}{\itemsep}
+ \setlength{\itemsep}{0pt}%
+ \setlength{\parsep}{\itemsep}%
\setlength{\labelsep}{1em}%
\setlength{\labelwidth}{\nomenwidth}%
\setlength{\leftmargin}{\labelwidth}%
\addtolength{\leftmargin}{\labelsep}%
+ \setlength\savitemsep\itemsep%
}%
}{\end{list}}
@@ -376,7 +544,7 @@
\providecommand\@PaperNo{\protect\phantom{NO.}}
\newcommand{\paperno}{%
-\vspace*{0.5in}
+\vspace*{2\baselineskip}
\parbox{\linewidth}{\raggedleft\bfseries\sffamily\LARGE%
\MakeTextUppercase{\@PaperNo}%
}%
@@ -386,17 +554,28 @@
\providecommand\@PaperTitle{\hbox{ }}
\newcommand{\papertitle}{%
-\vspace*{0.5in}
-\parbox{\linewidth}{\centering{\bfseries\sffamily\large%
-\MakeTextUppercase{\@PaperTitle}\par}
+\vspace*{3\baselineskip}
+\parbox{\linewidth}{\mathversion{sansbold}\centering{\bfseries\sffamily\large%
+\MakeTextUppercase{\@PaperTitle}\par} %%% <=== extra \par to make leading stick. See adjustment in \MakeTitle
}%
}
-%%%%%%%%%%% Author block %%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%% Author and affiliation block %%%%%%%%%%%%%%%%%%%%%%%%%%%%
\RequirePackage{xcoffins}
+%% To maintain compatibility with newtxtext superiors option, if used, save the definition
+\let\savethefootnote\thefootnote
+\let\savemakefnmark\@makefnmark
+
+
+%%%% option to retain original grid layout of authors
+\ifthenelse{\boolean{Oldauthors}}{%
+
+%%%%%%%%%%%%%%%%%%%% Old author layout %%%%%%%%%%%%%%%%%%%%%%%%%
+
\NewCoffin{\authorblock}
%% Allows for up to nine author groups... if you need more authors, the edits should be obvious
@@ -459,41 +638,158 @@
\DeclareDocumentCommand{\ConstructAuthorBlock}{}{%
\ifnum\value{authorno}>3
- \JoinCoffins\firstrowauthorblock[hc,b]\secondrowauthorblock[hc,t](0pt, -2\baselineskip)
+ \JoinCoffins\firstrowauthorblock[hc,b]\secondrowauthorblock[hc,t](0pt, -1.5\baselineskip)
\fi
\ifnum\value{authorno}>6
- \JoinCoffins\firstrowauthorblock[hc,b]\thirdrowauthorblock[hc,t](0pt, -2\baselineskip)
+ \JoinCoffins\firstrowauthorblock[hc,b]\thirdrowauthorblock[hc,t](0pt, -1.5\baselineskip)
\fi
\centerline{\TypesetCoffin\firstrowauthorblock} %% in this instance, \centerline is better than \centering
}
-%% To maintain compatibility with newtxtext superiors option, if used, save the definition
-\let\savethefootnote\thefootnote
-
%% Flag for corresponding author (expecting just one, but if two enter both email addresses and flag both authors)
-
\newif\ifCA\CAfalse
-\newcommand{\CAemail}[1]{\gdef\@CAemail{#1}}
-\DeclareDocumentCommand{\CorrespondingAuthor}{m m}{%
-\global\CAtrue%
-\CAemail{#2}%
-\renewcommand*{\thefootnote}{\fnsymbol{footnote}}
-\ignorespaces#1\ignorespaces\footnotemark[1]%
+% allow for NO email address to be given by omitting second argument
+\DeclareDocumentCommand{\CorrespondingAuthor}{m g}{%
+ \global\CAtrue%
+ \IfNoValueTF{#2}{%
+ \gdef\@CAsep{\relax}%
+ \gdef\@CAemail{\relax}%
+ }{%
+ \gdef\@CAsep{:\space}%
+ \gdef\@CAemail{#2}%
+ }%
+ \renewcommand*{\thefootnote}{\fnsymbol{footnote}}%
+ \ignorespaces#1\ignorespaces\footnotemark[1]%
}
%% Flag for joint first authors (two or more)
+\newif\ifJA\JAfalse
+
+\DeclareDocumentCommand{\JointFirstAuthor}{}{%
+ \global\JAtrue%
+ \renewcommand*{\thefootnote}{\fnsymbol{footnote}}%
+ \ignorespaces\footnotemark[2]%
+}
+
+%%% otherwise use new compact layout of authors
+}{% i.e., this begins "else"
+
+%%%%%%%%%%%%%%%%%%%%%% New author layout %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\NewCoffin{\AuthorBlock}
+\NewCoffin{\AffiliationBlock}
+\NewCoffin{\AffiliationsBlock}
+
+%% NB: \parbox width to \textwidth (full page) not \linewidth (single column)
+\SetHorizontalCoffin\AffiliationsBlock{}
+\DeclareDocumentCommand{\SetAuthors}{m}{%
+ \SetHorizontalCoffin\AuthorBlock{%
+ \parbox{\textwidth}{\centering\sffamily\bfseries\ignorespaces#1\ignorespaces}%
+ }
+}
+
+\def\@makefnmark{\hbox{\@textsuperscript{\sffamily\@thefnmark}}}%
+
+\DeclareDocumentCommand{\SetAffiliation}{m m}{%
+ \SetVerticalCoffin\AffiliationBlock{\textwidth}{%
+ \centering\sffamily\footnotemark[#1]#2\ignorespaces%
+ }
+ \JoinCoffins\AffiliationsBlock[hc,b]\AffiliationBlock[hc,t](0pt,-1pt)
+}
+
+
+%%% flag for corresponding author (usually just one, although you can have two by putting both email addresses
+%%% into field and attaching to both authors -- footnote will only print only the email in the last occurrence)
+
+%% Flag for corresponding author (expecting just one, but if two enter both email addresses and flag both authors)
+\newif\ifCA\CAfalse
+
+% allow for NO email address to be given by omitting the argument (g argument is deprecated, seems to have trouble with \IfNoValueTF) %% corrected spacing error 24 Jan 2020
+\DeclareDocumentCommand{\CorrespondingAuthor}{g}{%
+ \ignorespaces$\bm{^\ast}$%
+ \global\CAtrue%
+ % \IfNoValueTF{#1}{%
+ \ifblank{#1}{%
+ \gdef\@CAsep{\relax}%
+ \gdef\@CAemail{\relax}%
+ }{%
+ \gdef\@CAsep{:\space}%
+ \gdef\@CAemail{#1}%
+ }%
+}
+
+%%% Flag for joint first authors (two or more)
\newif\ifJA\JAfalse
\DeclareDocumentCommand{\JointFirstAuthor}{}{%
\global\JAtrue%
-\renewcommand*{\thefootnote}{\fnsymbol{footnote}}%
-\ignorespaces\footnotemark[2]%
+ $\bm{^\dagger}$%
+}
+
+%%% Affiliation mark
+\DeclareDocumentCommand{\affil}{m}{%
+ {\bfseries\footnotemark[#1]}%
}
-%%%% Make the title section
+%%% to deal with sequential notes as, e.g., "1,*", or "1,2,*" %%%%%%%%%%
+\let\oldaffil\affil
+\newcommand\nextToken\relax
+\renewcommand\affil[1]{%
+ \oldaffil{#1}\futurelet\nextToken\isOthernote}
+
+\newcommand\isOthernote{%
+ \ifx\CorrespondingAuthor\nextToken\textsuperscript{\sffamily\bfseries,}%
+ \else%
+ \ifx\JointFirstAuthor\nextToken\textsuperscript{\sffamily\bfseries,}%
+ \else
+ \ifx\affil\nextToken\textsuperscript{\sffamily\bfseries,}%
+ \fi%
+ \fi%
+ \fi%
+ \ignorespaces%
+}
+
+\let\oldCorrespondingAuthor\CorrespondingAuthor
+\renewcommand\CorrespondingAuthor[1]{%
+ \oldCorrespondingAuthor{#1}\futurelet\nextToken\isOthernote}
+
+\let\oldJointFirstAuthor\JointFirstAuthor
+\renewcommand\JointFirstAuthor{%
+ \oldJointFirstAuthor\futurelet\nextToken\isOthernote}
+
+\let\oldfootnote\footnote
+\renewcommand\footnote[1]{%
+ \oldfootnote{#1}\futurelet\nextToken\isOtherfnote}
+
+\newcommand\isOtherfnote{%
+ \ifx\footnote\nextToken\textsu{\mdseries,}%
+ \fi%
+}
+
+%%%
+
+\DeclareDocumentCommand{\SetAuthorBlock}{}{%
+ \let\savethefootnote\thefootnote
+ \JoinCoffins\AuthorBlock[hc,b]\AffiliationsBlock[hc,t](0pt,-\baselineskip)
+ \centerline{\TypesetCoffin\AuthorBlock}
+ \renewcommand*{\thefootnote}{\fnsymbol{footnote}}
+ \ifJA
+ \footnotetext[2]{\JAwords}
+ \fi
+ \ifCA
+ \footnotetext[1]{\CAwords\@CAsep\@CAemail}
+ \fi
+ \let\thefootnote\savethefootnote
+}
+
+} %% end ifthenelse for Oldauthors
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+
+%%%% Make the title and author section
\DeclareDocumentCommand{\MakeTitlePage}{}{%
\twocolumn[
\begin{@twocolumnfalse}
@@ -501,28 +797,45 @@
\paperno
\papertitle
\vspace*{2\baselineskip}
-\ConstructAuthorBlock
- \vspace*{3\baselineskip}
+ \ifthenelse{\boolean{Oldauthors}}{%
+ \ConstructAuthorBlock}{%
+ \SetAuthorBlock}
+ \vspace*{3\baselineskip}
\end{@twocolumnfalse}
]
+\let\@makefnmark\savemakefnmark
\renewcommand*{\thefootnote}{\fnsymbol{footnote}}
\ifJA
- \footnotetext[2]{Joint first authors}
+ \footnotetext[2]{\JAwords}
\fi
\ifCA
- \footnotetext[1]{Corresponding author:\space\@CAemail}
+ \footnotetext[1]{\CAwords\@CAsep\@CAemail}
\fi
\let\thefootnote\savethefootnote
}
+%%%%%%%%%%
+
+%% Provide compatibility with titling commands from standard LaTeX article class
+
+\RenewDocumentCommand{\maketitle}{}{\MakeTitlePage}
+\RenewDocumentCommand{\title}{}{\PaperTitle}
+
+\RenewDocumentCommand{\thanks}{m}{\relax} %% disabling this standard command, as it is inconsistent with the format
+
+%% Produces an unmarked footnote about the version date, to replace "date"
+%% This is for editing and should note be used in the final draft
+\NewDocumentCommand{\versionfootnote}{m}{\begin{NoHyper}\gdef\@thefnmark{}\@footnotetext{#1}\end{NoHyper}}
+
+\RenewDocumentCommand{\date}{m}{\versionfootnote} %% in case someone wants to use \date this way.
+
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%% Provide sans serif upright Greek letters, following a suggestion
%% to the class author by Michael Sharpe (March 2019).
-%% Access sans serif Greek from STIX fonts.
+%% Access sans serif Greek from newtxsf implementation of STIX fonts.
%%
-%% These are for use in the sans serif captions and headings if needed.
\DeclareSymbolFont{lettersAB}{U}{ntxsfmia}{m}{it}
\SetSymbolFont{lettersAB}{bold}{U}{ntxsfmia}{b}{it}
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/tlpkg/tlpobj/asmeconf.tlpobj new/tlpkg/tlpobj/asmeconf.tlpobj
--- old/tlpkg/tlpobj/asmeconf.tlpobj 2019-04-08 01:39:21.000000000 +0200
+++ new/tlpkg/tlpobj/asmeconf.tlpobj 2020-04-16 01:56:53.000000000 +0200
@@ -1,20 +1,17 @@
name asmeconf
category Package
-revision 50845
+revision 54758
shortdesc A template for ASME conference papers
relocated 1
-longdesc This package provides a LaTeX class, a BibTeX style, and a
-longdesc LaTeX template to format conference papers for the American
-longdesc Society of Mechanical Engineers (ASME) according to the
-longdesc requirements on ASME's conference web pages (as posted in March
-longdesc 2019). The .tex and .cls files are commented and should be
-longdesc self-explanatory. This work is not a publication of ASME
-longdesc itself.
-runfiles size=14
+longdesc This class provides a template to format ASME Conference papers
+longdesc according to the requirements on ASME's web pages (as posted in
+longdesc early 2020). The .tex and .cls files are commented and should
+longdesc be self-explanatory. The package depends on newtx. This work is
+longdesc not a publication of ASME itself.
+runfiles size=19
RELOC/bibtex/bst/asmeconf/asmeconf.bst
RELOC/tex/latex/asmeconf/asmeconf.cls
catalogue-ctan /macros/latex/contrib/asmeconf
-catalogue-date 2019-04-07 06:22:59 +0200
catalogue-license mit
-catalogue-topics class confproc
-catalogue-version 1.03
+catalogue-topics bibtex-sty class confproc engineering scientific-docs
+catalogue-version 1.18
++++++ asymptote.doc.tar.xz ++++++
++++ 67080 lines of diff (skipped)
++++++ asymptote.tar.xz ++++++
++++ 13395 lines of diff (skipped)
++++++ aucklandthesis.doc.tar.xz ++++++
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/doc/latex/aucklandthesis/README.TEXLIVE new/doc/latex/aucklandthesis/README.TEXLIVE
--- old/doc/latex/aucklandthesis/README.TEXLIVE 1970-01-01 01:00:00.000000000 +0100
+++ new/doc/latex/aucklandthesis/README.TEXLIVE 2019-06-05 16:50:09.000000000 +0200
@@ -0,0 +1,7 @@
+The following files have been removed in the TeX Live installation of
+the current package, typically due to duplication, lack of space, or
+missing source code. You can find these files on CTAN at
+ http://mirror.ctan.org/macros/latex/contrib/aucklandthesis
+If questions or concerns, email tex-live@tug.org.
+
+ aucklandthesis_userguide.pdf
Binary files old/doc/latex/aucklandthesis/aucklandthesis_userguide.pdf and new/doc/latex/aucklandthesis/aucklandthesis_userguide.pdf differ
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/tlpkg/tlpobj/aucklandthesis.doc.tlpobj new/tlpkg/tlpobj/aucklandthesis.doc.tlpobj
--- old/tlpkg/tlpobj/aucklandthesis.doc.tlpobj 2019-02-28 03:16:48.000000000 +0100
+++ new/tlpkg/tlpobj/aucklandthesis.doc.tlpobj 2019-06-06 01:38:55.000000000 +0200
@@ -1,9 +1,9 @@
name aucklandthesis.doc
category Package
-revision 41506
+revision 51323
shortdesc doc files of aucklandthesis
relocated 1
-docfiles size=177
+docfiles size=4
+ RELOC/doc/latex/aucklandthesis/README.TEXLIVE
RELOC/doc/latex/aucklandthesis/README.txt
- RELOC/doc/latex/aucklandthesis/aucklandthesis_userguide.pdf
RELOC/doc/latex/aucklandthesis/template.tex
++++++ aucklandthesis.tar.xz ++++++
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/tlpkg/tlpobj/aucklandthesis.tlpobj new/tlpkg/tlpobj/aucklandthesis.tlpobj
--- old/tlpkg/tlpobj/aucklandthesis.tlpobj 2019-02-28 03:16:48.000000000 +0100
+++ new/tlpkg/tlpobj/aucklandthesis.tlpobj 2019-06-06 01:38:55.000000000 +0200
@@ -1,6 +1,6 @@
name aucklandthesis
category Package
-revision 41506
+revision 51323
shortdesc Memoir-based class for formatting University of Auckland masters' and doctors' theses
relocated 1
longdesc A memoir-based class for formatting University of Auckland
++++++ authorarchive.doc.tar.xz ++++++
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/doc/latex/authorarchive/CHANGELOG.md new/doc/latex/authorarchive/CHANGELOG.md
--- old/doc/latex/authorarchive/CHANGELOG.md 2018-02-22 00:33:35.000000000 +0100
+++ new/doc/latex/authorarchive/CHANGELOG.md 2019-06-23 22:57:00.000000000 +0200
@@ -1,9 +1,37 @@
# Changelog
+
All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
-## [1.0.0] - 2018-02-21
+## [1.1.1] - 2019-06-23
+
+- Added PDF versions of the examples to the CTAN upload.
+
+### Added
+
+## [1.1.0] - 2019-06-23
+
+### Added
+
+- The links to the embedded files (references) are typeset at the bottom of the paper.
+- Support for `a4paper` for LNCS papers.
+
+### Changed
+
+- Updated LNCS output to the requirements of [Springer's Consent to Publish v3](http://resource-cms.springer.com/springer-cms/rest/v1/content/731196/data/v3).
+- If `nourl` is active, the DOI is used as link for the QR code.
+- File embedding is implemented using the [intopdf](https://www.ctan.org/pkg/intopdf) package. Links to the embedded files are shown in the generated PDF.
+- ACM format adapted to [acmart](https://github.com/borisveytsman/acmart) v1.50.
+- Use [lastpage](https://ctan.org/pkg/lastpage) package instead of custom label.
+
+## 1.0.0 - 2018-02-21
+
### Added
+
- Initial version uploaded to CTAN.
+
+[Unreleased]: https://github.com/adbrucker/authorarchive/compare/v1.1.1...HEAD
+[1.1.1]: https://github.com/adbrucker/authorarchive/compare/v1.1.0...v1.1.1
+[1.1.0]: https://github.com/adbrucker/authorarchive/compare/v1.0.0...v1.1.0
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/doc/latex/authorarchive/LICENSE new/doc/latex/authorarchive/LICENSE
--- old/doc/latex/authorarchive/LICENSE 2018-02-22 00:33:35.000000000 +0100
+++ new/doc/latex/authorarchive/LICENSE 2019-06-23 22:57:00.000000000 +0200
@@ -1,4 +1,4 @@
-Copyright (c) 2008-2016 Achim D. Brucker
+Copyright (c) 2008-2019 Achim D. Brucker
All rights reserved.
Redistribution and use in source and binary forms, with or without
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/doc/latex/authorarchive/README.md new/doc/latex/authorarchive/README.md
--- old/doc/latex/authorarchive/README.md 2018-02-22 00:33:35.000000000 +0100
+++ new/doc/latex/authorarchive/README.md 2019-06-23 22:57:00.000000000 +0200
@@ -5,30 +5,40 @@
<!-- toc -->
-- [Installation](#installation)
-- [Usage](#usage)
- * [Boolean Switches](#boolean-switches)
- * [Key/Value Options](#keyvalue-options)
-- [Embedding Bibliography Entries](#embedding-bibliography-entries)
-- [Development](#development)
-- [Alternative Packages](#alternative-packages)
-- [License](#license)
+- [authorarchive](#authorarchive)
+ - [Installation](#installation)
+ - [Usage](#usage)
+ - [Boolean Switches](#boolean-switches)
+ - [Key/Value Options](#key-value-options)
+ - [Embedding Bibliography Entries](#embedding-bibliography-entries)
+ - [Notes on Self-Archiving](#notes-on-self-archiving)
+ - [LNCS](#lncs)
+ - [Usage at arXiv.org](#usage-at-arxivorg)
+ - [Other publishers](#other-publishers)
+ - [Alternative Packages](#alternative-packages)
+ - [Authors](#authors)
+ - [Contributors](#contributors)
+ - [License](#license)
+ - [Master Repository](#master-repository)
<!-- tocstop -->
-## Installation
-Copy `authorarchive.sty` in a directory that is searched by LaTeX
-(e.g,. either your `texmf` tree or the local directory with your main
-LaTeX file.
+## Installation
+
+Copy `authorarchive.sty` and the directory `icons` in a directory that
+is searched by LaTeX (e.g., either your `texmf` tree or the local
+directory with your main LaTeX file).
## Usage
+
A simple use for LNCS-formatted papers is as follows:
+
```tex
\usepackage[LNCS,
key=brucker-authorarchive-2016,
year=2016,
- publication={Anonymous et al. (eds). Proceedings of the International
- Conference on LaTeX-Hacks, LNCS~42. Some Publisher, 2016.}
+ publication={Anonymous et al.\ (eds). Proceedings of the International
+ Conference on LaTeX-Hacks, LNCS~42. Some Publisher}
startpage={42},
doi={00/00_00},
doiText={0/00\_00},
@@ -37,33 +47,39 @@
```
The following layout-styles are pre-defined:
-* `ACM` for the two-column layout used by many ACM conferences
-* `IEEE` for the two-column layout used by many IEEE conferences
-* `LNCS` for the LNCS layout (as used by Springer)
-* `LNI` for the Lecture Notes in Informatics, published by the GI
-* `ENTCS` for the Elsevier ENTCS layout
+
+- `ACM` for the two-column layout used by many ACM conferences
+- `ENTCS` for the Elsevier ENTCS layout
+- `IEEE` for the two-column layout used by many IEEE conferences
+- `LNCS` for the LNCS layout (as used by Springer)
+- `LNI` for the Lecture Notes in Informatics, published by the GI
By re-defining the font command (`authorcrfont{}`) and the command that is
-used for positioning the copyright text (`\authorat{}`), the package can
+used for positioning the copyright text (`\authorat{}`), the package can
be adapted easily to other layouts. For example,
+
```tex
\renewcommand{\authorcrfont}{\scriptsize}
\renewcommand{\authorat}[1]{\put(25,56.5){#1}}
```
+
works nicely for Acta Informatica.
### Boolean Switches
-| Switch | Meaning |
-| -- | -- |
-| `nocopyright` | If present, no publisher's copyright notice is printed. Usual case for LNCS. |
-| `nourl` | If present, no link to the publication is inserted. |
-| `nobib` | If present, no embedding of bibliographic entries is made. |
+
+| Switch | Meaning |
+| -- | -- |
+| `nocopyright` | If present, no publisher's copyright notice is printed. Usual case for LNCS. |
+| `nourl` | If present, no link to the publication is inserted. |
+| `nobib` | If present, no embedding of bibliographic entries is made. |
+| `orcidicon` | For layouts displaying the author's ORCID identifiers as text, replace the ORCID identifier by the ORICD iD icon and a hyperlink (currently only supported for LNCS). |
### Key/Value Options
+
| Option | Default | Meaning |
| -- | -- | -- |
| `bibtexdir`| `.` | The directory where the bibliography entries are listed. |
-| `baseurl` | https://git.logicalhacking.com/adbrucker/authorarchive/src/master | The URL used as prefix for building the links. |
+| `baseurl` | https://git.logicalhacking.com/adbrucker/authorarchive/src/master | The URL used as prefix for building the links. |
| `suffix` | `.pdf` | The suffix to use at links. |
| `publisher` | `UNKOWN PUBLISHER` | The name of the publisher. Default values are set by the series (`LNCS`, ...). |
| `year` | `UNKOWN YEAR` | The year of the publication. |
@@ -81,6 +97,7 @@
baseurl) easily.
## Embedding Bibliography Entries
+
Mostly, it is hard for scientists to find the correct bibtex entry for
a paper. One solution to this issue is to embed the respective `.bib`
(BibTeX, for LaTeX users), `.enw` (Endnote), `.ris`, or `.word.xml`
@@ -88,12 +105,80 @@
file exist in `bibtexdir`, it gets embedded in the PDF.
You can use the
-[bibutils](https://sourceforge.net/p/bibutils/home/bib2xml/) for
+[bibutils](https://sourceforge.net/p/bibutils/home/Bibutils/) for
converting between these different formats for bibliographic
-references easily.
+references easily.
+
+## Notes on Self-Archiving
+Before using this package, please check with your signed copyright form,
+which rights you have. Especially whether you may self-archive the preprint
+or the postprint. For more information on that, read on at
+https://blogs.scientificamerican.com/information-culture/understanding-your-....
+
+None of the authors might be hold liable for copyright
+violations by using this package.
+
+### LNCS
+
+Sprinter states in his [Springer's Consent to Publish v3](http://resource-cms.springer.com/springer-cms/rest/v1/content/731196/data/v3):
+
+> Author may only post his/her own version, provided acknowledgment is given
+> to the original source of publication and a link is inserted to the published
+> article on Springer’s website.
+> The link must be provided by inserting the DOI number of the article in the
+> following sentence:
+> "The final publication is available at Springer via
+> `http://dx.doi.org/[insert DOI]`".
+
+The DOI (Digital Object Identifier) can be found at the bottom of the first
+page of the published paper.
+
+This package uses `https://doi.org` as `http://dx.doi.org`
+[is deprecated](https://www.doi.org/factsheets/DOIIdentifierSpecs.html).
+
+Thus, the proposed configuration for Springer is as follows:
+
+```latex
+\usepackage[LNCS,
+ key=brucker-authorarchive-2016,
+ year=2016,
+ publication={Anonymous et al.\ (eds). Proceedings of the International
+ Conference on LaTeX-Hacks, LNCS~42. Springer, 2016.}
+ startpage={42},
+ doi={10.1038/authorarchive},
+ nocopyright
+ ]{authorarchive}
+```
+
+## Usage at arXiv.org
+
+arXiv.org deletes bib files when submitting a pre print. As workaround, this package
+supports using the file suffix `.bibtex`. When no `.bib` is found, but a `.bibtex`
+file, this file is used and embedded as `.bib` file into the PDF.
+
+## Other publishers
+
+In general, one does not need to specify a certain publisher (or LaTeX document class).
+The default setting just prints the note centered at the bottom of the first page.
+
+```latex
+\usepackage[
+ key=brucker-authorarchive-2017,
+ year=2017,
+ publication={Anonymous et al.\ (eds). Proceedings of the International
+ Conference on LaTeX-Hacks, CEUR-WS Vol~42, 2017.}
+ startpage={42},
+ doi={10.1039/authorarchive},
+ nocopyright
+ ]{authorarchive}
+```
+
+Still, for some used document classes (e.g., `acmart`) there are specific
+package options available hat produce an alternative layout.
## Alternative Packages
+
The package [coverpage](https://ctan.org/pkg/coverpage) prepends a
separate PDF page before the first page of the paper. That page
contains the bibliographic information as BibTeX entry. One is forced
@@ -103,7 +188,7 @@
publisher are generated.
The package
-[llncsconf](https://git.logicalhacking.com/adbrucker/llncsconf) is a
+[llncsconf](https://ctan.org/pkg/llncsconf) is a
light-weight alternative to this package. It supports
[LNCS](http://www.springer.com/de/it-informatik/lncs) only. In
comparison to `authorarchive`, it provides support for the additional
@@ -111,14 +196,23 @@
code and links to the author's archive URL.
## Authors
+
Main author: [Achim D. Brucker](http://www.brucker.ch/)
### Contributors
-* [Oliver Kopp](https://github.com/koppor/)
-
+- [Oliver Kopp](https://github.com/koppor/)
## License
+
If not otherwise stated, all sub-projects are dual-licensed under a
-2-clause BSD-style license and/or the LPPL version 1 or any later
-version.
+2-clause BSD-style license and/or the LPPL version 1.3c or (at your
+opinion) any later version.
+
+SPDX-License-Identifier: LPPL-1.3c+ OR BSD-2-Clause
+
+## Master Repository
+
+The master git repository for this project is hosted by the [Software
+Assurance & Security Research Team](https://logicalhacking.com) at
+https://git.logicalhacking.com/adbrucker/authorarchive.
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/doc/latex/authorarchive/authorarchive.config new/doc/latex/authorarchive/authorarchive.config
--- old/doc/latex/authorarchive/authorarchive.config 2018-02-22 00:33:35.000000000 +0100
+++ new/doc/latex/authorarchive/authorarchive.config 1970-01-01 01:00:00.000000000 +0100
@@ -1,3 +0,0 @@
-\authorsetup{%
- baseurl={https://git.logicalhacking.com/adbrucker/authorarchive/src/master}
-}
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/doc/latex/authorarchive/brucker-authorarchive-2016.bib new/doc/latex/authorarchive/brucker-authorarchive-2016.bib
--- old/doc/latex/authorarchive/brucker-authorarchive-2016.bib 2018-02-22 00:33:35.000000000 +0100
+++ new/doc/latex/authorarchive/brucker-authorarchive-2016.bib 1970-01-01 01:00:00.000000000 +0100
@@ -1,12 +0,0 @@
-
-@InProceedings{ brucker-authorarchive-2016,
- year = 2016,
- page = {42--45},
- title = {A Simple Example of the \texttt{authorarchive} Package for
- \LaTeX},
- author = {Achim D. Brucker},
- booktitle = {Proceedings of the International Conference on
- \LaTeX-Hacks},
- series = {LNCS},
- number = 42
-}
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/doc/latex/authorarchive/brucker-authorarchive-2016.enw new/doc/latex/authorarchive/brucker-authorarchive-2016.enw
--- old/doc/latex/authorarchive/brucker-authorarchive-2016.enw 2018-02-22 00:33:35.000000000 +0100
+++ new/doc/latex/authorarchive/brucker-authorarchive-2016.enw 1970-01-01 01:00:00.000000000 +0100
@@ -1,8 +0,0 @@
-%0 Conference Proceedings
-%T A Simple Example of the authorarchive Package for \LaTeX
-%A Brucker, Achim D.
-%B Proceedings of the International Conference on \LaTeX-Hacks
-%D 2016
-%N 42
-%F brucker-authorarchive-2016
-
Binary files old/doc/latex/authorarchive/brucker-authorarchive-2016.pdf and new/doc/latex/authorarchive/brucker-authorarchive-2016.pdf differ
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/doc/latex/authorarchive/brucker-authorarchive-2016.ris new/doc/latex/authorarchive/brucker-authorarchive-2016.ris
--- old/doc/latex/authorarchive/brucker-authorarchive-2016.ris 2018-02-22 00:33:35.000000000 +0100
+++ new/doc/latex/authorarchive/brucker-authorarchive-2016.ris 1970-01-01 01:00:00.000000000 +0100
@@ -1,9 +0,0 @@
-TY - CONF
-AU - Brucker, Achim D.
-PY - 2016//
-TI - A Simple Example of the authorarchive Package for \LaTeX
-BT - Proceedings of the International Conference on \LaTeX-Hacks
-T3 - LNCS
-IS - 42
-ID - brucker-authorarchive-2016
-ER -
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/doc/latex/authorarchive/brucker-authorarchive-2016.tex new/doc/latex/authorarchive/brucker-authorarchive-2016.tex
--- old/doc/latex/authorarchive/brucker-authorarchive-2016.tex 2018-02-22 00:33:35.000000000 +0100
+++ new/doc/latex/authorarchive/brucker-authorarchive-2016.tex 1970-01-01 01:00:00.000000000 +0100
@@ -1,36 +0,0 @@
-\documentclass[final, runningheads, USenglish, pdftex]{llncs}
-\usepackage[T1]{fontenc}
-\usepackage[LNCS,
- key=brucker-authorarchive-2016,
- year=2016,
- publication={Anonymous et al. (eds). Proceedings of the International
- Conference on LaTeX-Hacks, LNCS~42. Some Publisher, 2016.}
- startpage={42},
- doi={00/00_00},
- doiText={0/00\_00},
- nocopyright
- ]{authorarchive}
-
-\usepackage{lipsum}
-
-\title{A Simple Example of the \texttt{authorarchive} Package for \LaTeX}
-\author{\protect\href{http://www.brucker.ch/}{Achim D. Brucker}}
-\institute{Some Departement, Somewhere}
-
-\begin{document}
- \maketitle{}
-
- \begin{abstract}
- \lipsum[1-2]
- \end{abstract}
-
- \section{Introduction}
- \lipsum[1-4]
-
- \section{Contribution}
- \lipsum[5-10]
-
- \section{Conclusion}
- \lipsum[10-12]
-\end{document}
-
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/doc/latex/authorarchive/brucker-authorarchive-2016.word.xml new/doc/latex/authorarchive/brucker-authorarchive-2016.word.xml
--- old/doc/latex/authorarchive/brucker-authorarchive-2016.word.xml 2018-02-22 00:33:35.000000000 +0100
+++ new/doc/latex/authorarchive/brucker-authorarchive-2016.word.xml 1970-01-01 01:00:00.000000000 +0100
@@ -1,16 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-http://schemas.openxmlformats.org/officeDocument/2006/bibliography" xmlns="http://schemas.openxmlformats.org/officeDocument/2006/bibliography" >
-
-brucker-authorarchive-2016
-Proceedings
-2016
-Proceedings of the International Conference on \LaTeX-Hacks
-42
-
-
-BruckerAchimD
-
-
-A Simple Example of the authorarchive Package for \LaTeX
-
-
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/doc/latex/authorarchive/examples/authorarchive.config new/doc/latex/authorarchive/examples/authorarchive.config
--- old/doc/latex/authorarchive/examples/authorarchive.config 1970-01-01 01:00:00.000000000 +0100
+++ new/doc/latex/authorarchive/examples/authorarchive.config 2019-06-23 22:57:00.000000000 +0200
@@ -0,0 +1,4 @@
+\authorsetup{%
+ baseurl={https://git.logicalhacking.com/adbrucker/authorarchive/src/master/examples}
+ ,bibtexdir={bib}
+}
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/doc/latex/authorarchive/examples/bib/brucker-authorarchive-2016.bib new/doc/latex/authorarchive/examples/bib/brucker-authorarchive-2016.bib
--- old/doc/latex/authorarchive/examples/bib/brucker-authorarchive-2016.bib 1970-01-01 01:00:00.000000000 +0100
+++ new/doc/latex/authorarchive/examples/bib/brucker-authorarchive-2016.bib 2019-06-23 22:57:00.000000000 +0200
@@ -0,0 +1,12 @@
+
+@InProceedings{ brucker-authorarchive-2016,
+ year = 2016,
+ page = {42--45},
+ title = {A Simple Example of the \texttt{authorarchive} Package for
+ \LaTeX},
+ author = {Achim D. Brucker},
+ booktitle = {Proceedings of the International Conference on
+ \LaTeX-Hacks},
+ series = {LNCS},
+ number = 42
+}
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/doc/latex/authorarchive/examples/bib/brucker-authorarchive-2016.enw new/doc/latex/authorarchive/examples/bib/brucker-authorarchive-2016.enw
--- old/doc/latex/authorarchive/examples/bib/brucker-authorarchive-2016.enw 1970-01-01 01:00:00.000000000 +0100
+++ new/doc/latex/authorarchive/examples/bib/brucker-authorarchive-2016.enw 2019-06-23 22:57:00.000000000 +0200
@@ -0,0 +1,8 @@
+%0 Conference Proceedings
+%T A Simple Example of the authorarchive Package for \LaTeX
+%A Brucker, Achim D.
+%B Proceedings of the International Conference on \LaTeX-Hacks
+%D 2016
+%N 42
+%F brucker-authorarchive-2016
+
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/doc/latex/authorarchive/examples/bib/brucker-authorarchive-2016.ris new/doc/latex/authorarchive/examples/bib/brucker-authorarchive-2016.ris
--- old/doc/latex/authorarchive/examples/bib/brucker-authorarchive-2016.ris 1970-01-01 01:00:00.000000000 +0100
+++ new/doc/latex/authorarchive/examples/bib/brucker-authorarchive-2016.ris 2019-06-23 22:57:00.000000000 +0200
@@ -0,0 +1,9 @@
+TY - CONF
+AU - Brucker, Achim D.
+PY - 2016//
+TI - A Simple Example of the authorarchive Package for \LaTeX
+BT - Proceedings of the International Conference on \LaTeX-Hacks
+T3 - LNCS
+IS - 42
+ID - brucker-authorarchive-2016
+ER -
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/doc/latex/authorarchive/examples/bib/brucker-authorarchive-2016.word.xml new/doc/latex/authorarchive/examples/bib/brucker-authorarchive-2016.word.xml
--- old/doc/latex/authorarchive/examples/bib/brucker-authorarchive-2016.word.xml 1970-01-01 01:00:00.000000000 +0100
+++ new/doc/latex/authorarchive/examples/bib/brucker-authorarchive-2016.word.xml 2019-06-23 22:57:00.000000000 +0200
@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+http://schemas.openxmlformats.org/officeDocument/2006/bibliography" xmlns="http://schemas.openxmlformats.org/officeDocument/2006/bibliography" >
+
+brucker-authorarchive-2016
+Proceedings
+2016
+Proceedings of the International Conference on \LaTeX-Hacks
+42
+
+
+BruckerAchimD
+
+
+A Simple Example of the authorarchive Package for \LaTeX
+
+
Binary files old/doc/latex/authorarchive/examples/brucker-authorarchive-2016-IEEEtran-nourl.pdf and new/doc/latex/authorarchive/examples/brucker-authorarchive-2016-IEEEtran-nourl.pdf differ
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/doc/latex/authorarchive/examples/brucker-authorarchive-2016-IEEEtran-nourl.tex new/doc/latex/authorarchive/examples/brucker-authorarchive-2016-IEEEtran-nourl.tex
--- old/doc/latex/authorarchive/examples/brucker-authorarchive-2016-IEEEtran-nourl.tex 1970-01-01 01:00:00.000000000 +0100
+++ new/doc/latex/authorarchive/examples/brucker-authorarchive-2016-IEEEtran-nourl.tex 2019-06-23 22:57:00.000000000 +0200
@@ -0,0 +1,22 @@
+\documentclass[conference]{IEEEtran}
+\usepackage[T1]{fontenc}
+\usepackage[IEEE,
+ key=brucker-authorarchive-2016,
+ year=2016,
+ publication={Anonymous et al.\ (eds). Proceedings of the International
+ Conference on LaTeX-Hacks. Some Publisher},
+ startpage={42},
+ nourl,
+ nocopyright
+ ]{../authorarchive}
+
+\usepackage{lipsum}
+
+\title{A Simple Example of the \texttt{authorarchive} Package for \LaTeX}
+\author{%
+ \IEEEauthorblockN{\protect\href{http://www.brucker.ch/}{Achim D. Brucker}}
+ \IEEEauthorblockA{Some Departement \\ Somewhere}
+}
+
+\input{input/body}
+
Binary files old/doc/latex/authorarchive/examples/brucker-authorarchive-2016-IEEEtran.pdf and new/doc/latex/authorarchive/examples/brucker-authorarchive-2016-IEEEtran.pdf differ
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/doc/latex/authorarchive/examples/brucker-authorarchive-2016-IEEEtran.tex new/doc/latex/authorarchive/examples/brucker-authorarchive-2016-IEEEtran.tex
--- old/doc/latex/authorarchive/examples/brucker-authorarchive-2016-IEEEtran.tex 1970-01-01 01:00:00.000000000 +0100
+++ new/doc/latex/authorarchive/examples/brucker-authorarchive-2016-IEEEtran.tex 2019-06-23 22:57:00.000000000 +0200
@@ -0,0 +1,23 @@
+\documentclass[conference]{IEEEtran}
+\usepackage[T1]{fontenc}
+\usepackage[IEEE,
+ key=brucker-authorarchive-2016,
+ year=2016,
+ publication={Anonymous et al.\ (eds). Proceedings of the International
+ Conference on LaTeX-Hacks. Some Publisher},
+ startpage={42},
+ doi={00/00_00},
+ doiText={0/00\_00},
+ nocopyright
+ ]{../authorarchive}
+
+\usepackage{lipsum}
+
+\title{A Simple Example of the \texttt{authorarchive} Package for \LaTeX}
+\author{%
+ \IEEEauthorblockN{\protect\href{http://www.brucker.ch/}{Achim D. Brucker}}
+ \IEEEauthorblockA{Some Departement \\ Somewhere}
+}
+
+\input{input/body}
+
Binary files old/doc/latex/authorarchive/examples/brucker-authorarchive-2016-acmart.pdf and new/doc/latex/authorarchive/examples/brucker-authorarchive-2016-acmart.pdf differ
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/doc/latex/authorarchive/examples/brucker-authorarchive-2016-acmart.tex new/doc/latex/authorarchive/examples/brucker-authorarchive-2016-acmart.tex
--- old/doc/latex/authorarchive/examples/brucker-authorarchive-2016-acmart.tex 1970-01-01 01:00:00.000000000 +0100
+++ new/doc/latex/authorarchive/examples/brucker-authorarchive-2016-acmart.tex 2019-06-23 22:57:00.000000000 +0200
@@ -0,0 +1,27 @@
+\documentclass[sigconf]{acmart}
+\copyrightyear{2017}
+\acmYear{2017}
+\setcopyright{acmlicensed}
+\acmConference[LHack '16]{1st International Conference on \LaTeX-Hacks}{December 4--6, 2017}{Salzburg, Austria}
+\acmBooktitle{LHack '16: The 1st International Conference on \LaTeX-Hacks, December 4--6, 2017, Salzburg, Austria}
+\acmPrice{15.00}
+\acmDOI{10.1145/000000.000000}
+\acmISBN{000-0-0000-0000-0/00/00}
+
+\usepackage[acmart,
+ key=brucker-authorarchive-2016,
+ year=2016,
+ publication={Anonymous et al. (eds). Proceedings of the International
+ Conference on LaTeX-Hacks, ACM, 2016},
+ startpage={42},
+ doi={00/0000},
+ nocopyright
+ ]{../authorarchive}
+
+\usepackage{lipsum}
+
+\title{A Simple Example of the \texttt{authorarchive} Package for \LaTeX}
+\author{\protect\href{http://www.brucker.ch/}{Achim D. Brucker}}
+
+\input{input/body}
+
Binary files old/doc/latex/authorarchive/examples/brucker-authorarchive-2016-entcs.pdf and new/doc/latex/authorarchive/examples/brucker-authorarchive-2016-entcs.pdf differ
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/doc/latex/authorarchive/examples/brucker-authorarchive-2016-entcs.tex new/doc/latex/authorarchive/examples/brucker-authorarchive-2016-entcs.tex
--- old/doc/latex/authorarchive/examples/brucker-authorarchive-2016-entcs.tex 1970-01-01 01:00:00.000000000 +0100
+++ new/doc/latex/authorarchive/examples/brucker-authorarchive-2016-entcs.tex 2019-06-23 22:57:00.000000000 +0200
@@ -0,0 +1,38 @@
+\documentclass{entcs}
+\usepackage[T1]{fontenc}
+\usepackage[ENTCS,
+ key=brucker-authorarchive-2016,
+ year=2016,
+ publication={Anonymous et al.\ (eds). Proceedings of the International
+ Conference on LaTeX-Hacks, Some Publisher},
+ startpage={42},
+ doi={00/00_00},
+ doiText={0/00\_00},
+ nocopyright
+ ]{../authorarchive}
+
+\usepackage{lipsum}
+
+\def\lastname{A.D. Brucker}
+
+\begin{document}
+ \begin{frontmatter}
+ \title{A Simple Example of the \texttt{authorarchive} Package for \LaTeX}
+ \author{\protect\href{http://www.brucker.ch/}{Achim D. Brucker}}
+
+ \begin{abstract}
+ \lipsum[1-2]
+ \end{abstract}
+
+ \end{frontmatter}
+
+ \section{Introduction}
+ \lipsum[1-4]
+
+ \section{Contribution}
+ \lipsum[5-10]
+
+ \section{Conclusion}
+ \lipsum[11-12]
+\end{document}
+
Binary files old/doc/latex/authorarchive/examples/brucker-authorarchive-2016-llncs-a4.pdf and new/doc/latex/authorarchive/examples/brucker-authorarchive-2016-llncs-a4.pdf differ
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/doc/latex/authorarchive/examples/brucker-authorarchive-2016-llncs-a4.tex new/doc/latex/authorarchive/examples/brucker-authorarchive-2016-llncs-a4.tex
--- old/doc/latex/authorarchive/examples/brucker-authorarchive-2016-llncs-a4.tex 1970-01-01 01:00:00.000000000 +0100
+++ new/doc/latex/authorarchive/examples/brucker-authorarchive-2016-llncs-a4.tex 2019-06-23 22:57:00.000000000 +0200
@@ -0,0 +1,20 @@
+\documentclass[final, runningheads, USenglish, a4paper, pdftex]{llncs}
+\usepackage[T1]{fontenc}
+\usepackage[LNCS,
+ key=brucker-authorarchive-2016,
+ year=2016,
+ publication={Anonymous et al.\ (eds). Proceedings of the International
+ Conference on LaTeX-Hacks, LNCS~42. Some Publisher},
+ startpage={42},
+ doi={00/00_00},
+ doiText={0/00\_00},
+ nocopyright
+ ]{../authorarchive}
+
+\usepackage{lipsum}
+
+\title{A Simple Example of the \texttt{authorarchive} Package for \LaTeX}
+\author{\protect\href{http://www.brucker.ch/}{Achim D. Brucker}}
+\institute{Some Departement, Somewhere}
+
+\input{input/body}
Binary files old/doc/latex/authorarchive/examples/brucker-authorarchive-2016-llncs.pdf and new/doc/latex/authorarchive/examples/brucker-authorarchive-2016-llncs.pdf differ
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/doc/latex/authorarchive/examples/brucker-authorarchive-2016-llncs.tex new/doc/latex/authorarchive/examples/brucker-authorarchive-2016-llncs.tex
--- old/doc/latex/authorarchive/examples/brucker-authorarchive-2016-llncs.tex 1970-01-01 01:00:00.000000000 +0100
+++ new/doc/latex/authorarchive/examples/brucker-authorarchive-2016-llncs.tex 2019-06-23 22:57:00.000000000 +0200
@@ -0,0 +1,27 @@
+\documentclass[final, runningheads, USenglish, pdftex]{llncs}
+\usepackage[T1]{fontenc}
+
+% Quickly make vector_iD_icon.pdf available to authorarchive.
+% The global installation is described in ../README.md
+\usepackage{graphicx}
+\graphicspath{{../icons/}}
+
+\usepackage[LNCS,
+ key=brucker-authorarchive-2016,
+ year=2016,
+ publication={Anonymous et al.\ (eds). Proceedings of the International
+ Conference on LaTeX-Hacks, LNCS~42. Some Publisher},
+ startpage={42},
+ doi={00/00_00},
+ doiText={0/00\_00},
+ orcidicon,
+ nocopyright
+ ]{../authorarchive}
+
+\usepackage{lipsum}
+
+\title{A Simple Example of the \texttt{authorarchive} Package for \LaTeX}
+\author{\protect\href{http://www.brucker.ch/}{Achim D. Brucker}\orcidID{0000-0002-6355-1200}}
+\institute{Some Departement, Somewhere}
+
+\input{input/body}
Binary files old/doc/latex/authorarchive/examples/brucker-authorarchive-2016-lni.pdf and new/doc/latex/authorarchive/examples/brucker-authorarchive-2016-lni.pdf differ
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/doc/latex/authorarchive/examples/brucker-authorarchive-2016-lni.tex new/doc/latex/authorarchive/examples/brucker-authorarchive-2016-lni.tex
--- old/doc/latex/authorarchive/examples/brucker-authorarchive-2016-lni.tex 1970-01-01 01:00:00.000000000 +0100
+++ new/doc/latex/authorarchive/examples/brucker-authorarchive-2016-lni.tex 2019-06-23 22:57:00.000000000 +0200
@@ -0,0 +1,24 @@
+\documentclass[english]{lni}
+\usepackage[T1]{fontenc}
+\usepackage[LNI,
+ key=brucker-authorarchive-2016,
+ year=2016,
+ publication={Anonymous et al.\ (eds). Proceedings of the International
+ Conference on LaTeX-Hacks. Some Publisher},
+ startpage={42},
+ doi={00/00_00},
+ doiText={0/00\_00},
+ nocopyright
+ ]{../authorarchive}
+
+\usepackage{lipsum}
+
+\title{A Simple Example of the \texttt{authorarchive} Package for \LaTeX}
+\author{%
+ \protect\href{http://www.brucker.ch/}{Achim D. Brucker}\\
+ Some Departement\\
+ Somewhere
+}
+
+\input{input/body}
+
Binary files old/doc/latex/authorarchive/examples/brucker-authorarchive-2016-sig-alternate.pdf and new/doc/latex/authorarchive/examples/brucker-authorarchive-2016-sig-alternate.pdf differ
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/doc/latex/authorarchive/examples/brucker-authorarchive-2016-sig-alternate.tex new/doc/latex/authorarchive/examples/brucker-authorarchive-2016-sig-alternate.tex
--- old/doc/latex/authorarchive/examples/brucker-authorarchive-2016-sig-alternate.tex 1970-01-01 01:00:00.000000000 +0100
+++ new/doc/latex/authorarchive/examples/brucker-authorarchive-2016-sig-alternate.tex 2019-06-23 22:57:00.000000000 +0200
@@ -0,0 +1,23 @@
+\documentclass[USenglish, pdftex, letterpaper]{sig-alternate}
+\usepackage[ACM,
+ key=brucker-authorarchive-2016,
+ year=2016,
+ publication={Anonymous et al.\ (eds). Proceedings of the International
+ Conference on LaTeX-Hacks, ACM, 2016},
+ startpage={42},
+ doi={00/0000},
+ nocopyright
+ ]{../authorarchive}
+
+\usepackage{lipsum}
+
+\title{A Simple Example of the \texttt{authorarchive} Package for \LaTeX}
+
+\numberofauthors{1}
+\author{
+ \alignauthor
+ \protect\href{http://www.brucker.ch/}{Achim D. Brucker}
+}
+
+\input{input/body}
+
Binary files old/doc/latex/authorarchive/examples/brucker-authorarchive-2016.pdf and new/doc/latex/authorarchive/examples/brucker-authorarchive-2016.pdf differ
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/doc/latex/authorarchive/examples/brucker-authorarchive-2016.tex new/doc/latex/authorarchive/examples/brucker-authorarchive-2016.tex
--- old/doc/latex/authorarchive/examples/brucker-authorarchive-2016.tex 1970-01-01 01:00:00.000000000 +0100
+++ new/doc/latex/authorarchive/examples/brucker-authorarchive-2016.tex 2019-06-23 22:57:00.000000000 +0200
@@ -0,0 +1,18 @@
+\documentclass[a4paper]{article}
+
+\usepackage[
+ key=brucker-authorarchive-2016,
+ year=2016,
+ publication={Anonymous et al.\ (eds). Proceedings of the International
+ Workshop on LaTeX-Hacks},
+ startpage={42},
+ doi={00/0000},
+ nocopyright
+ ]{../authorarchive}
+
+\usepackage{lipsum}
+
+\title{A Simple Example of the \texttt{authorarchive} Package for \LaTeX}
+\author{\protect\href{http://www.brucker.ch/}{Achim D. Brucker}}
+
+\input{input/body}
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/doc/latex/authorarchive/examples/input/body.tex new/doc/latex/authorarchive/examples/input/body.tex
--- old/doc/latex/authorarchive/examples/input/body.tex 1970-01-01 01:00:00.000000000 +0100
+++ new/doc/latex/authorarchive/examples/input/body.tex 2019-06-23 22:57:00.000000000 +0200
@@ -0,0 +1,18 @@
+\begin{document}
+ \maketitle{}
+
+ \begin{abstract}
+ \lipsum[1-2]
+ \end{abstract}
+
+ \section{Introduction}
+ \lipsum[1-4]
+
+ \section{Contribution}
+ \lipsum[5-10]
+
+ \section{Conclusion}
+ \lipsum[11-12]
+
+\end{document}
+
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/doc/latex/authorarchive/icons/README.md new/doc/latex/authorarchive/icons/README.md
--- old/doc/latex/authorarchive/icons/README.md 1970-01-01 01:00:00.000000000 +0100
+++ new/doc/latex/authorarchive/icons/README.md 2019-06-23 22:57:00.000000000 +0200
@@ -0,0 +1,21 @@
+# Icons for the use with authorarchive
+
+This directory contains icons that might be used together with
+the authorarchive LaTeX style. The use of these icons is
+restricted by the respective copyright holders.
+
+## ORCID iD Icon
+
+The iD icon ([vector_iD_icon.svg](vector_iD_icon.svg)) was obtained in
+SVG format from
+https://orcid.org/trademark-and-id-display-guidelines and converted
+to PDF ([vector_iD_icon.pdf](vector_iD_icon.pdf)) using
+[Inkscape](https://inkscape.org). According to the use and (display
+guidelines)[https://orcid.org/trademark-and-id-display-guidelines] of
+the ORCID iD icons, it can be used for displaying ORCID identifiers.
+
+An alternative to including the iD icon as PDF image is the
+[academicons](https://ctan.org/pkg/academicons) package. At the time
+of writing, this package requires xe(la)tex or lua(la)tex while the
+[authorarchive](https://ctan.org/pkg/authorarchive) packages requires
+pdf(la)tex.
Binary files old/doc/latex/authorarchive/icons/vector_iD_icon.pdf and new/doc/latex/authorarchive/icons/vector_iD_icon.pdf differ
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/doc/latex/authorarchive/icons/vector_iD_icon.svg new/doc/latex/authorarchive/icons/vector_iD_icon.svg
--- old/doc/latex/authorarchive/icons/vector_iD_icon.svg 1970-01-01 01:00:00.000000000 +0100
+++ new/doc/latex/authorarchive/icons/vector_iD_icon.svg 2019-06-23 22:57:00.000000000 +0200
@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 19.1.0, SVG Export Plug-In . SVG Version: 6.00 Build 0) -->
+