Commit c62d008cf include txfonts into the set of
default LaTeX packages. However, txfonts changes
the main font of the document, conflicting the
requirement of acmart articles.
We skip txfonts by setting packageTxfonts to nop.
The 'acmart' class includes a '\bigtimes' command from the 'newtxmath'
package, if available. Scribble includes a '\bigtimes' command from the
'mathabx' package. These cannot co-exist.
If `newtxmath` is available, this PR does not import `mathabx` in acmart
documents.
If `newtxmath` is not available, this PR includes `mathabx` like normal
(same as all previous versions of `scribble/acmart`)
Add a `link-render-style` syntax property to control the rendering of
section links --- so that HTML output can say "section <number>", and
so that Latex/PDF output can have just the section number hperlinked
(as in acmart).
It seems unfortunate that the link rendering is so hardwired into each
rendering back-end, but maybe this can be made even more configurable
in the future. Meanwhile, Latex macros already provide an additional
layer of rendering control (but not enough, it turns out, to easily
perform the same adjustments as the 'number mode that matches acmart).
For `scriblib/figure` make `figure-ref` and `Figure-ref` similarly
sensitive to the link-rendering style.
For `scriblib/autobib`, change the hyperlinking of references
so that the color can be overridden, and make `scribble/acmart`
override it.
Prevent 'scribble/acmart' documents from loading the 'tocstyle' package,
because this package conflicts with 'acmart.cls'.
(Specifically, 'tocstyle' should be loaded before 'hyperref', but 'acmart.cls'
loads 'hyperref'.)
Without 'tocstyle', Scribble's 'table-of-contents' function produces an OK
table of contents.
See also:
https://tex.stackexchange.com/questions/378547/using-tocstyle-with-acm-acmart-style/
1. Change `add-acmart-styles` to add an element WITHOUT the `pretitle` style
for the collects phase. With this, an empty `#lang scribble/acmart` document
builds an empty PDF.
2. Add documentation for a "minimal" `scribble/acmart` document.
Change LaTeX implementation of `@title` to just use `\title` --- don't try to extract a subtitle.
- - -
This fixes a bug, where the `Title` meta-data in the PDF for a document titled
"Foo" was "oo" (same title with first letter missing). So, e.g., Google chrome
would show "oo" as the tab title for the document.
- - -
Why not try to fix subtitle extraction?
1. I don't think we need it in `scribble/acmart`, because there's a separate `@subtitle` command
2. Not sure how to extract a subtitle without using `\let` inside `\title`, but doing so generates 2 LaTeX warnings:
```
Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref) removing `\<let>-command' on input line 674.
Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref) removing `\SSubtitle' on input line 674.
```
The "visual" bug was probably due to this warning; after removing the `\let`
and `\SSubtitle` then only `\SubtitleDrop` and the actual title are left.
I guess `\SSubtitleDrop` removed the first character of the title.
(Why only the first character? I don't know.)
The LaTeX warning from `hyperref` is probably because acmart expects the
argument to `\title` to be a raw string. Though, the docs don't explicitly
say this. They only say "It is expected that this command [`\title`] is inserted
by the author of the manuscript."
The existing scribble/acmart language in this repo felt more like latex than Scribble. This package brings scribble/acmart more inline with the existing `scribble/acmart` package that was already on the package server. In particular, this commit:
* Remove maketitle from scribble/acmart
* Extends the title form to also have the fields in `scribble/base`'s title.
* Support author information. (Like scribble/sigplans authorinfo)
* Removed unneeded functions now redundant due to the author function. Namely, affiliation based ones.
* Factor out common functions to scribble/acmart and scribble/base into private module.
These functions might make sense to be public, but since they were already private in base
I thought it made sense to leave them that way. Additionally, it might make sense to have the
file be something other than private/tag, as private/tag currently requires tag, which is
different than the normal way where its tag that requires private/tag.
* Add short-title to scribble/latex-properties
* Adds an `command-optional` property which is like `command-extras`, but is a single
optional argument placed before the mandatory ones.
* Create email, affiliation, and institution structs so that authors can have multiple of each.
* Add/improve documentation and history (and bump version number).
Just like the 10pt option in `scribble/sigplan`,
putting @9pt @10pt @11pt or @12pt on the #lang line of a `scribble/acmart`
document passes to corresponding string to `\documentclass[....]`
And just like TeX, it's ok to give multiple font sizes. All but the last
are ignored.
