https://github.com/princeton-astro-coffee/princeton-astro-coffee

A repository for the Princeton astro-coffee website. It lets department members vote for their favorite new arXiv papers, tags the department authors and displays the calendar of astroph-coffee hosts.
https://github.com/princeton-astro-coffee/princeton-astro-coffee

arxiv-daily arxiv-papers astrophysics

Last synced: about 1 month ago
JSON representation

A repository for the Princeton astro-coffee website. It lets department members vote for their favorite new arXiv papers, tags the department authors and displays the calendar of astroph-coffee hosts.

• Host: GitHub
• URL: https://github.com/princeton-astro-coffee/princeton-astro-coffee
• Owner: princeton-astro-coffee
• License: mit
• Created: 2021-01-16T00:18:59.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2023-02-01T03:59:26.000Z (almost 2 years ago)
• Last Synced: 2024-10-02T17:17:49.722Z (about 1 month ago)
• Topics: arxiv-daily, arxiv-papers, astrophysics
• Language: C
• Homepage: https://coffee.astro.princeton.edu/astroph-coffee/papers/today
• Size: 19.1 MB
• Stars: 1
• Watchers: 2
• Forks: 1
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
This repository is based on a template by Waqas Bhatti that can be found at [https://github.com/waqasbhatti/astroph-coffee](https://github.com/waqasbhatti/astroph-coffee). 

This repository is not to be used as a template and is customized to be used to run the Princeton astroph coffee sessions. 

If you would like to host a similar website for your institute, please use the repository mentioned [above](https://github.com/waqasbhatti/astroph-coffee).

## princeton-astroph-coffee - A simple platform for astro-ph arXiv discussion

This server helps organize the Princeton astro-ph coffee discussion by providing a way for people to

see local papers and vote on papers they want to talk about. It has the

following components:

* backend with arxiv scraping

* article abstract and metadata storage in sqlite3

* frontend built with tornado for viewing and voting on papers

* an archive of previous astro-ph discussions

* geofencing (and IP-address fencing) using the Maxmind GeoLite2 database to

  restrict voting locations

* reserving papers for later discussion (up to a week after their appearance)

* full-text search for paper titles, abstract titles, and author names

See the INSTALL.md file for instructions on how to install and run the

server. If you have questions or problems, please open an issue or drop me an

email.

### How it works

Everyone gets five votes to use in total per day, with one per paper. In

addition, everyone may reserve up to five papers for later discussion. The

server generally operates in two modes:

1. Vote mode: this is active whenever the voting period is active (defined in

   `src/conf/astroph.conf`). Papers are shown in their serial number order as on

   the astro-ph list page, and users can vote on papers they'd like to see

   talked about. Users can also reserve papers during the voting period for up

   to seven days if they want to talk about the papers at a later discussion

   session.

   ![Voting mode image](src/static/images/voting.png?raw=true)

2. Display mode: this is active outside the voting period. Local papers are

   highlighted at the top of the page with their full abstracts. Papers with at

   least one vote are shown below papers with local authors, in order of the

   number of votes they received. Reserved papers are shown next in

   reversed-order of their original arXiv appearance. Finally, all other papers

   are listed below the local, voted, and reserved papers.

   ![Display mode image](src/static/images/listing.png?raw=true)

An archive of all paper abstracts is also provided in reverse chronological

order, grouped by month and year to make it easy to see what people were

interested in talking about on previous days.