Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions CMakePresets.json
Original file line number Diff line number Diff line change
Expand Up @@ -116,6 +116,7 @@
"rmq_tests",
"test_rmm",
"louds_tree_tests",
"wavelet_tree_tests",
"bp_tree_tests",
"dfuds_tree_tests",
"excess_positions_tests"
Expand All @@ -131,6 +132,7 @@
"rmq_tests",
"test_rmm",
"louds_tree_tests",
"wavelet_tree_tests",
"bp_tree_tests",
"dfuds_tree_tests",
"excess_positions_tests"
Expand Down Expand Up @@ -200,6 +202,7 @@
"rmq_tests",
"test_rmm",
"louds_tree_tests",
"wavelet_tree_tests",
"bp_tree_tests",
"dfuds_tree_tests",
"excess_positions_tests"
Expand All @@ -215,6 +218,7 @@
"rmq_tests",
"test_rmm",
"louds_tree_tests",
"wavelet_tree_tests",
"bp_tree_tests",
"dfuds_tree_tests",
"excess_positions_tests"
Expand Down
1 change: 1 addition & 0 deletions academic/.gitignore
Original file line number Diff line number Diff line change
@@ -1,2 +1,3 @@
/.quarto/
/_extensions/

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Restore the tracked ACM Quarto extension

With this ignore entry, the commit also removes the tracked academic/_extensions/quarto-journals/acm tree, but the existing paper projects still have _extensions -> ../../_extensions symlinks and use format: acm-pdf (for example academic/papers/algorithms_for_excess/paper.qmd:38). In a fresh checkout those symlinks are broken, so rendering the ACM papers can no longer resolve the required Quarto extension; keep the extension tracked or stop pointing the papers at it.

Useful? React with 👍 / 👎.

**/*.quarto_ipynb
26 changes: 12 additions & 14 deletions academic/AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,8 +10,6 @@ Materials are authored in [Quarto](https://quarto.org) for rich rendering (math,

```
academic/
├── _quarto.yml # Book project (reports, presentations, notes)
├── index.qmd # Project landing page
├── _extensions/ # Shared Quarto extensions (ACM journal format)
│ └── quarto-journals/acm/ # ACM acm-pdf extension
├── papers/ # Research papers (standalone Quarto projects)
Expand All @@ -30,14 +28,14 @@ academic/

## Architecture

### Two Quarto Project Types
Academic materials are standalone documents or standalone Quarto projects.
There is intentionally no root `academic/_quarto.yml` book project and no global
academic landing page. Render each note, report, presentation, or paper from its
own directory. The shared bibliography lives at `academic/bibliography/references.bib`.

The `academic/` directory contains **two kinds** of Quarto projects:

1. **Book project** (`academic/_quarto.yml`, `type: book`): Covers reports, presentations, and notes. Rendered from the `academic/` root.
2. **Standalone paper projects** (`papers/<name>/_quarto.yml`, `type: default`): Each paper is its own Quarto project. Rendered from the paper's directory.

Papers are standalone because Quarto book projects cannot resolve journal extensions (like `quarto-journals/acm`). Each paper directory has its own `_quarto.yml` and symlinks `_extensions/` to the shared extensions at `academic/_extensions/`.
Each paper directory has its own `_quarto.yml` and may symlink `_extensions/` to
the shared extension directory at `academic/_extensions/` when it needs the ACM
format.

### ACM Extension

Expand Down Expand Up @@ -69,12 +67,12 @@ quarto render # Produces paper.pdf + paper.tex
quarto preview # Live preview with reload
```

### Book (reports, presentations, notes)
### Notes, Reports, and Presentations

```bash
cd academic/
quarto render # Produces _book/ directory
quarto preview # Live preview
cd notes/rmq/
quarto render index.qmd --to pdf
quarto preview index.qmd
```

## Conventions
Expand Down Expand Up @@ -130,5 +128,5 @@ The following works are foundational to Pixie's design:
- Use `@AuthorYear` citation syntax in `.qmd` files
- LaTeX code blocks should use `{cpp}` or `{latex}` language tags
- Do not commit large binary files (>10MB) without explicit approval; consider using Git LFS
- Render papers from their own directory, NOT from the `academic/` book project root
- Render each material from its own directory, not from the `academic/` root
- Do NOT put `@` symbols in BibTeX comments — BibTeX tries to parse them as entries
Loading
Loading