Skip to content

Commit 5fa23de

Browse files
committed
.
1 parent fb9b750 commit 5fa23de

File tree

4 files changed

+73
-173
lines changed

4 files changed

+73
-173
lines changed

public/content/about.md

Lines changed: 8 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -1,57 +1,18 @@
11
---
2-
title: 'About'
3-
slug: '/about'
2+
title: "About"
3+
slug: "/about"
44
---
55

66
## About
77

8-
This website aims to collect and organize research papers on **algorithms with predictions** (also known as **algorithms with machine learning advice** or **learning-augmented algorithms**).
8+
The goal of this project is to provide a comprehensive overview of the current state of research on Algorithms with Predictions and to curate links to further relevant materials. This resource is intended to help new researchers quickly orient themselves in the field while also serving as a valuable reference for the broader research community to organize and cluster the rapidly growing body of results and publications in this area.
99

10-
### What are Algorithms with Predictions?
10+
This project and its webpage are led and managed by [Alexander Lindermayr](https://www.alexanderlindermayr.com) and [Nicole Megow](https://www.uni-bremen.de/en/cslog/nmegow).
1111

12-
Algorithms with predictions represent a fascinating intersection of theoretical computer science and machine learning. These algorithms leverage machine learning predictions to improve their performance beyond worst-case guarantees, while maintaining robustness when predictions are inaccurate.
12+
It is an [open source initiative](https://github.com/algorithms-with-predictions/algorithms-with-predictions.github.io), and contributions from the community are highly encouraged, such as submitting references or links, suggesting improvements to presentation and organization, or sharing ideas for enhancing the platform. If you have any questions or suggestions, please don’t hesitate to reach out directly to [Alexander and Nicole](mailto:[email protected]).
1313

14-
Key characteristics include:
14+
Further contributors: [Bertrand Simon](https://cclab.pages.in2p3.fr/bertrand.simon/), [Adam Polak](https://adampolak.github.io/), [Niklas Hahn](https://webia.lip6.fr/~nhahn/index.html), [Christoph Dürr](https://webia.lip6.fr/~durrc/), [Ola Svensson](https://theory.epfl.ch/osven/)
1515

16-
- **Consistency**: Good performance when predictions are accurate
17-
- **Robustness**: Reasonable performance when predictions are wrong
18-
- **Smoothness**: Performance degrades gracefully with prediction quality
16+
Fortunately, the idea of this project has been picked up by other communities. The following forks of this project exist.
1917

20-
### Research Areas
21-
22-
This field spans multiple domains of algorithmic research:
23-
24-
- **Online Algorithms**: Making decisions without knowing future inputs
25-
- **Approximation Algorithms**: Finding near-optimal solutions efficiently
26-
- **Streaming Algorithms**: Processing data with limited memory
27-
- **Data Structures**: Optimizing access patterns with predicted queries
28-
- **Scheduling**: Improving job scheduling with workload predictions
29-
- **Network Problems**: Route optimization with traffic forecasts
30-
31-
### Community
32-
33-
The algorithms with predictions community has grown rapidly, with dedicated workshops, conference sessions, and research groups worldwide. This website serves as a central hub for:
34-
35-
- Paper discovery and organization
36-
- Research trend identification
37-
- Community building
38-
- Educational resources
39-
40-
### Contact
41-
42-
For questions, suggestions, or contributions to this website:
43-
44-
45-
- GitHub: [algorithms-with-predictions organization](https://github.com/algorithms-with-predictions)
46-
47-
### Technical Details
48-
49-
This website is built with:
50-
51-
- **React** and **Vite** for fast development and building
52-
- **Material-UI** for consistent design
53-
- **YAML** files for paper data management
54-
- **Markdown** for content pages
55-
- **GitHub Pages** for hosting
56-
57-
All code is open source and contributions are welcome!
18+
- [Satisfiability for Mathematics](https://bsubercaseaux.github.io/sat-for-math/) created and maintained by [Bernardo Subercaseaux](https://bsubercaseaux.github.io/)

public/content/contribute.md

Lines changed: 18 additions & 71 deletions
Original file line numberDiff line numberDiff line change
@@ -3,30 +3,21 @@ title: 'How to Contribute'
33
slug: '/contribute'
44
---
55

6-
## How to Contribute in General
6+
## Welcome, Contributors
77

8-
The sources and data for this webpage are available on
9-
[GitHub](https://github.com/algorithms-with-predictions/algorithms-with-predictions.github.io). It
10-
uses modern web technologies for static site rendering and is hosted via
11-
[GitHub Pages](https://pages.github.com/).
8+
This project is open source and lives on [GitHub](https://github.com/algorithms-with-predictions/algorithms-with-predictions.github.io). We welcome all contributions.
129

13-
Everyone is very welcome to contribute:
10+
For most changes, please open a **Pull Request**. For bigger ideas or questions, you can email us at [[email protected]](mailto:[email protected]).
1411

15-
- Maintain paper references, e.g. adding, updating and labeling references (see `papers/` directory
16-
and syntax below)
17-
- Add and edit further material. This page is generated from markdown files and is
18-
thus easy to modify.
19-
- Improve layout or design, add new features.
12+
---
2013

21-
Most contributions can be done via Pull Requests directly in the repository. For more involved
22-
suggestions or discussions, feel free to contact us
23-
14+
## Adding or Editing Papers
2415

25-
## Adding and Editing Paper References
16+
Paper data is stored as YAML files in the `papers/` directory.
2617

27-
Paper entries are based on YAML files, which are located in the directory `papers/`.
18+
### Paper File Structure
2819

29-
As an example, this is the data file for the caching paper by Lykouris and Vassilvitskii:
20+
Each paper is a `.yml` file. Name files descriptively (e.g., `Author21topic.yml`). Here’s a quick example:
3021

3122
```yaml
3223
title: Competitive Caching with Machine Learned Advice
@@ -38,68 +29,24 @@ publications:
3829
- name: ICML
3930
url: https://proceedings.mlr.press/v80/lykouris18a.html
4031
year: 2018
41-
dblp_key: conf/icml/LykourisV18
42-
bibtex: "@inproceedings{DBLP:conf/icml/LykourisV18,\\n author = {Thodoris Lykouris and\\n Sergei Vassilvitskii},\\n title = {Competitive Caching with Machine Learned Advice},\\n booktitle = {{ICML}},\\n series = {Proceedings of Machine Learning Research},\\n volume = {80},\\n pages = {3302--3311},\\n publisher = {{PMLR}},\\n year = {2018}\\n}\\n"
32+
dblp_key: conf/icml/LykourisV18 # Optional
33+
bibtex: "@inproceedings{...}" # Optional
4334
- name: arXiv
4435
url: https://arxiv.org/abs/1802.05399
4536
year: 2018
46-
month: 2
47-
day: 15
4837
```
4938
50-
### Required Fields
51-
52-
Each paper entry must contain:
53-
54-
- **title**: The full title of the paper
55-
- **authors**: List of authors (can be string or array)
56-
- **labels**: Categories/tags for the paper
57-
- **publications**: Array of publication venues
58-
59-
### Publication Fields
60-
61-
Each publication entry should include:
62-
63-
- **name**: Venue name (conference, journal, or "arXiv")
64-
- **url**: Direct link to the paper
65-
- **year**: Publication year
66-
- **dblp_key**: (optional) DBLP key for the entry
67-
- **bibtex**: (optional) BibTeX citation
68-
69-
### Labels/Categories
39+
### Key Fields
7040
71-
Use consistent labels to help with filtering:
41+
- **`title`**: Full paper title.
42+
- **`authors`**: Author names.
43+
- **`labels`**: A list of relevant categories (see below for common labels).
44+
- **`publications`**: List of venues, each with a `name`, `url`, and `year`.
7245

73-
- `online` - Online algorithms
74-
- `caching / paging` - Caching and paging problems
75-
- `streaming` - Streaming algorithms
76-
- `approximation` - Approximation algorithms
77-
- `game theory / mechanism design` - Game theory applications
78-
- `differential privacy` - Privacy-preserving algorithms
79-
- `survey` - Survey papers
8046

81-
## File Naming Convention
8247

83-
Name files descriptively based on authors and topic:
84-
- `AuthorName20keyword.yml`
85-
- `SmithJones21caching.yml`
86-
- `Survey23online.yml`
87-
88-
## Testing Your Contribution
89-
90-
Before submitting:
91-
92-
1. Validate YAML syntax
93-
2. Check that all URLs work
94-
3. Ensure consistent formatting
95-
4. Test locally if possible
96-
97-
## Content Pages
98-
99-
You can also edit the content pages by modifying the markdown files in `public/content/`:
48+
---
10049

101-
- `public/content/material.md` - Further Material page
102-
- `public/content/contribute.md` - How to Contribute page (this page!)
103-
- `public/content/about.md` - About page
50+
## Editing Website Content
10451

105-
These files use standard markdown with YAML frontmatter for metadata.
52+
You can edit the site's informational pages by modifying the markdown files in `public/content/`, such as `about.md` or this very file.

src/components/header.jsx

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -67,6 +67,7 @@ const Header = () => {
6767
borderRadius: 2,
6868
color: 'white !important',
6969
textDecoration: 'none !important',
70+
fontSize: '1.1rem',
7071
'&:hover': {
7172
backgroundColor: 'rgba(255, 255, 255, 0.1)',
7273
transform: 'translateY(-1px)',
@@ -130,7 +131,7 @@ const Header = () => {
130131
'&:visited': {
131132
color: 'white !important',
132133
},
133-
fontSize: '0.95rem',
134+
fontSize: '1rem',
134135
fontWeight: 500,
135136
}}
136137
>

src/components/paperlist.jsx

Lines changed: 45 additions & 54 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ import {
88
Tooltip,
99
Chip,
1010
} from '@mui/material';
11-
import { Download } from '@mui/icons-material';
11+
import { Download, Clear } from '@mui/icons-material';
1212
import * as React from 'react';
1313
import { useState, useMemo } from 'react';
1414
import PropTypes from 'prop-types';
@@ -126,6 +126,11 @@ const PaperList = ({ data }) => {
126126
}
127127
};
128128

129+
const handleClearFilters = () => {
130+
setSearchQuery('');
131+
setSelLabels([]);
132+
};
133+
129134
const labelColor = label => {
130135
if (TYPE_LABELS.includes(label)) {
131136
return 'typeLabels';
@@ -200,62 +205,48 @@ const PaperList = ({ data }) => {
200205
)}
201206
</Typography>
202207

203-
{/* Export BibTeX button */}
204-
{papersWithBibtex > 0 && (
205-
<Tooltip
206-
title={`Export BibTeX for ${papersWithBibtex} papers with bibliography`}
207-
>
208-
<IconButton
209-
size="small"
210-
onClick={handleExportBibtex}
211-
sx={{
212-
color: 'primary.main',
213-
'&:hover': {
214-
bgcolor: 'primary.light',
215-
color: 'primary.contrastText',
216-
},
217-
}}
218-
>
219-
<Download fontSize="small" />
220-
</IconButton>
221-
</Tooltip>
222-
)}
223-
</Stack>
224-
225-
{/* Active filters display */}
226-
{(searchQuery || selLabels.length > 0) && (
227-
<Stack
228-
direction="row"
229-
spacing={0.5}
230-
flexWrap="wrap"
231-
sx={{ gap: 0.5, mb: 1 }}
232-
>
233-
{searchQuery && (
234-
<Chip
235-
label={`"${searchQuery}"`}
236-
onDelete={() => setSearchQuery('')}
237-
size="small"
238-
color="primary"
239-
variant="outlined"
240-
sx={{ height: 24, borderRadius: 2 }}
241-
/>
208+
<Stack direction="row" spacing={0.5}>
209+
{/* Clear filters button */}
210+
{(searchQuery || selLabels.length > 0) && (
211+
<Tooltip title="Clear all filters">
212+
<IconButton
213+
size="small"
214+
onClick={handleClearFilters}
215+
sx={{
216+
color: 'secondary.main',
217+
'&:hover': {
218+
bgcolor: 'secondary.light',
219+
color: 'secondary.contrastText',
220+
},
221+
}}
222+
>
223+
<Clear fontSize="small" />
224+
</IconButton>
225+
</Tooltip>
242226
)}
243227

244-
{selLabels.map(label => (
245-
<Chip
246-
key={label}
247-
label={label}
248-
onDelete={() =>
249-
setSelLabels(prev => prev.filter(l => l !== label))
250-
}
251-
size="small"
252-
color={labelColor(label)}
253-
variant="outlined"
254-
sx={{ height: 24, borderRadius: 2 }}
255-
/>
256-
))}
228+
{/* Export BibTeX button */}
229+
{papersWithBibtex > 0 && (
230+
<Tooltip
231+
title={`Export BibTeX for ${papersWithBibtex} papers with bibliography`}
232+
>
233+
<IconButton
234+
size="small"
235+
onClick={handleExportBibtex}
236+
sx={{
237+
color: 'primary.main',
238+
'&:hover': {
239+
bgcolor: 'primary.light',
240+
color: 'primary.contrastText',
241+
},
242+
}}
243+
>
244+
<Download fontSize="small" />
245+
</IconButton>
246+
</Tooltip>
247+
)}
257248
</Stack>
258-
)}
249+
</Stack>
259250
</Box>
260251
</Fade>
261252

0 commit comments

Comments
 (0)