* scribble/srcdoc: add `class*-doc` and `class-doc` provide forms.
* Add missing require of racket/class which contains the class? predicate.
* Add @history stanza to class*-doc and class-doc scribblings and bump version number in scribble-lib/info.rkt to 1.30.
The indentation for multi-line typesetting is weird, because it still
uses the table-basd layout that lines up all arguments independent of
nesting. But at least the parentheses are not broken.
Relevant to #211
1. Focus on the search box for either "s" or "S"
... accepting only "s" makes sense to me, but the comment said it
accepted "S" and well why not
2. Look for a "keyup" event instead of key press, so that pressing "s"
ONLY focuses on the box and does not focus-and-write-the-letter-"s"
"keyup" events apparently don't have a useful `charCode` field so this
PR looks at the `keyCode` field instead
when rendering multiple html files to a directory `d`, add
`d/index.html` to the set of files-to-be-writted to avoid overwriting
the main index with a part that happens to have the same tag
Add an optional argument to bib-entry to typeset a comment directly
after a citation --- with no punctuation between the end of the citation
and start of the comment.
Example: making an annotated bibliography, with an element that appears just
below each citation
Within `defform`, `...+` should be treated like `...` and made to not
refer to a `...+` binding. (The identifier `...+` is bound by
`syntax/parse`, so it's not difficult to end up with a for-label
binding of `...+`.)
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 `\phantomsection`s to the "*starx" macros so the generated sections
are valid link targets for hyperref.
Note that `\phantomsection` is provided by the `hyperref` package,
which is currently loaded by the `\packageHyperref` macro at the top
of `scribble-lib/scribble/scribble.tex`.
Also, correct the documentation about the interaction of
`#:sep` and property lists, and make the previous column's
properties used consistently for a separator column.
This was added in a recent version of the acmart style and is
required to set (or remove) the addresses field at the bottom of
the first page in some styles.
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.
The Latex renderer was not linking local references because Latex
output was intended as a printing-to-paper alternative to HTML.
For writing papers with acmart, however, local PDF hyperlinks
are relevant. So, enable them.
If a value is convertible to 'text, then use that conversion.
Otherwise, convert using `write` instead of always using "???".
Also, correct documentation to include convertible values among
the valid forms of content, and document the new conversion rules
there.
The ccsdesc function was defined, but not provided. Also added use of
exact-chars since its argument contains characters such as "~" which
should not be converted to \sim.
I'm not certain that mixing 'grouper and non-'grouper parts at a given
level makes sense. Still, this adjustment brings Scribble section
counting more in line with Latex, so that section links are less
likely to have the wrong number label.
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.
Moving the contracts to the original exports ensures that the bindings
from both modules are the same. In particular, making the bindings
different caused the documentation to have missing links.
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."
add contracts to location-formatting functions,
and make sure those functions convert their inputs to strings,
and fix a documentation bug in `techrpt-location`
Handle comma-separated Last,First and Last,Jr,First format for names in bibtex, as well as "von", "de la", "van de", and other separators that start with lowercase letters
These commands work like natbib's citeauthor and citeyear commands,
and facilities making possessive citations. For example:
> Thanks to @(cite-author foo)'s (@(cite-year foo)) paper on stuff...
These identifiers are added with `define-cite` as keywords, and thus
can be omitted with no downside for backwards compatibility.
@(define-cite cite citet generate-bib
#:cite-author cite-author
#:cite-year cite-year)
Also in this commit:
* Add documentation.
* Add tests for autobib
* Bump version and add history.
Fixes an incompatibility between jfp1.cls and the 'relsize' package.
Justification for the fix:
1. `pdflatex` fails on this document
```
\documentclass{jfp1}
\begin{document}
\maketitle
hello {\Large world}
\end{document}
```
2. `pdflatex` succeeds on this document
```
\documentclass{jfp1}
\renewcommand\Large{\@setfontsize\@xvpt{18}}
\begin{document}
\maketitle
hello {\Large world}
\end{document}
```
I do not know why (1) fails.
The new line in (2) is copied from `jfp1.cls`.
In places where module names are typeset, such as `racketmodname`,
there's no way to disable the special treatment of `_` as an
identifier prefix as in `racket`. Even using
`make-element-id-transformer` doesn't work, because the module-name
datum is explcitly disconnected from binding withing `racketmodname`.
* Prevent hyphens from appearing in @racket[...] identifiers when they overflow.
* Add SHyphen command.
A style file can redefine SHyphen to toggle how they want to
hyphen their text
* Add documentation
