feat: add a Tools page printer for note merge and print presets
Chapter officers can merge a markdown note onto filtered students, teams, or events and save the recipe. Extra student-note columns are additional fields (any ## … fields heading) so they work as print tokens whether imported or typed by hand. Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
@@ -0,0 +1,59 @@
|
||||
# Page printer
|
||||
|
||||
**Created:** 2026-08-29
|
||||
**Last updated:** 2026-08-30
|
||||
**Description:** Merge a markdown note onto students, teams, or events and print one page per match. Save the recipe as a print preset.
|
||||
|
||||
## Where to open it
|
||||
|
||||
Sign in and go to **Tools → Page printer** (`/print`).
|
||||
|
||||
## Write a template note
|
||||
|
||||
Create a standalone note on **Notes** (not a page note or student note). Use `{{tokens}}` for values. Click a token chip on the printer page to copy it.
|
||||
|
||||
```markdown
|
||||
# Interview — {{FirstName}} {{LastName}}
|
||||
|
||||
| Grade | Interview Time | Application |
|
||||
| --- | --- | --- |
|
||||
| {{Grade}} | {{Interview Time}} | {{Application}} |
|
||||
|
||||
1. Why did you join TSA?
|
||||
2. What events interest you?
|
||||
```
|
||||
|
||||
Unknown tokens stay visible so typos are obvious. Empty values (including a missing Interview Time) print blank.
|
||||
|
||||
Put `{{PageBreak}}` on its own line to force a new printed sheet **inside** one record (for example, questions on page 1 and a scoring rubric on page 2).
|
||||
|
||||
Put `{{AnswerSpace}}` where you want ruled write-in lines. Markdown collapses blank lines, so extra empty lines in the note will not leave room to write.
|
||||
|
||||
Additional-field tokens use the same names as the Students index columns (for example `{{Interview Time}}`). Those values come from each student's `#Student:{id}` `## Additional fields` table. See [student-notes-import.md](student-notes-import.md).
|
||||
|
||||
## Filters
|
||||
|
||||
Pick **Students**, **Teams**, or **Events**, then optional filters.
|
||||
|
||||
For students: Grade, TSA year, and officer (any / officers only / non-officers). Example: TSA year `1` prints first-year students. `{{OfficerRole}}` still prints the office name when they have one. Additional fields such as Interview Time are merge tokens, not filters. Student pages sort by last name, then first name.
|
||||
|
||||
## Print presets
|
||||
|
||||
A print preset stores the *recipe* only: name, template note, entity type, and filters. It does not store merged pages. Each Preview uses the current roster and notes.
|
||||
|
||||
1. Set the note, entity, and filters.
|
||||
2. Enter a name and click **Save as**.
|
||||
3. Later, choose a preset, click **Preview**, then **Print**.
|
||||
4. **Update** overwrites the selected preset. **Delete** removes it.
|
||||
|
||||
If the template note was removed, the filters still load. Choose another note before Preview.
|
||||
|
||||
## Print
|
||||
|
||||
**Preview** builds the pages. **Print** opens the browser print dialog (same as other handouts). Navigation is hidden.
|
||||
|
||||
**New page per record** (on by default, saved with the preset) starts each match on a new sheet. Turn it off to flow records together; `{{PageBreak}}` in the template still works. Content that is taller than one sheet continues naturally.
|
||||
|
||||
**Font size (pt)** (default 12) and **Answer lines** (default 3) apply to every page-printer recipe. They are saved on the preset.
|
||||
|
||||
If Preview finds more than 75 matches, a warning is shown first.
|
||||
Reference in New Issue
Block a user