The COMSOC Community Website

This is the main website used by the Computation Social Choice (COMSOC) research community. It is intended to serve as a general presentation platform for COMSOC, while also providing all kinds of relevant resources and information to COMSOC researchers.

This website is made for the community by the community. If you want to contribute to its development, or think that some changes are needed, please use this GitHub page (or contact us if you don't know what to do). General instructions for the most common modifications are provided below.

How To

This website has been designed so as to make maintaining it as easy as possible. The website is automatically updated after each push to the repository, so all you have to do is to push your changes, wait a bit, and check that the outcome looks fine.

Below is a description of how to perform the most common management tasks:

• PhD Theses
• COMSOC Workshop Event
• COMSOC Workshop Proceedings
• Tools
• Special Issue
• Course
• Group Photos
• Archive Static Website

Note that if you are not a 'GitHub collaborator' of this repository, you first need to clone the repository and then submit pull requests (so in that case, the site will update only after one of the maintainers has approved your pull request).

Modify/Add a PhD thesis

To add a new PhD thesis, add the new entry to the file comsoc-website/_data/theses.yml [link] and it's all automatic from there. To correct an existing entry, simply find it in the file and modify it.

The YAML format for a thesis is as shown in the example below:

- name: Simon Rey
  affiliation: University of Amsterdam, ILLC
  year: 2023
  url: https://hdl.handle.net/11245.1/99e2cdb9-0c9a-46ca-8568-8bb2b77ca225
  title: "Variations on Participatory Budgeting: An Example"
  supervisors:
    - Ulle Endriss
    - Ronald de Haan
    - Jan Maly

Note that for titles including a ":" the title string needs to be put in quotes. If there is only one supervisor, keep the syntax and only include a single element in the supervisors list.

For the URL, use either a permanent link provided by the degree-granting institution or add a PDF to the repository (other kinds of links usually break after a few years). To add a PDF file, add it to the folder comsoc-website/assets/theses/ [link]. The url entry then needs to be: url: assets/theses/FILE_NAME.pdf.

Modify/Add a COMSOC Workshop Event

To add a new edition of the COMSOC Workshop, add the new entry to the file comsoc-website/_data/workshops.yml [link] and it will be automatically added to the website. To correct an existing entry, simply find it in the file and modify it.

The .yml format for a COMSOC Workshop is as shown in the example below.

- year: 2023
  edition: 9th International Workshop on Computational Social Choice
  location: Beersheba
  dates: 3-5 July
  website_url: https://tzin.bgu.ac.il/~omerlev/comsoc.html
  image: COMSOC_2023_banner.jpg
  has_proceedings: true

Note the reference to the image of the workshop (the banner used in the standard theme of the workshop series). The image file itself needs to be added to the repository comsoc-website/assets/images/workshops/ [link]. This image is used as background for the box describing the workshop.

If the value of has_proceedings is true, a link is automatically added to proceedings/YEAR. Only set this value to true if you have also added the proceedings (see below for that).

Modify/Add Proceedings of a COMSOC Workshop

The proceedings of the COMSOC Workshops are described in a .yml file. To add the proceedings of a new workshop create a file comsoc-website/_data/proceedingsYEAR.yml [link] where YEAR corresponds to the year of the workshop.

The YAML format is as in the following example:

- title: The Computational Complexity of Choice Sets
  authors:
    - Felix Brandt
    - Felix Fischer
    - Paul Harrenstein
  pdf_file: Brandt.pdf
  sort_key: BrandtFischerHarrenstein
  accepted_as: Presentations

The accepted_as describes the format in which the paper as been accepted. This value needs to be exactly one from the list proceedings_publication_types defined in the comsoc-website/_config.yml file [link]. If you use a different value, the display will not work. Update the list if needed. Note that the order of this list defines the order in which the different sections are displayed on a proceedings page.

To create the page corresponding to the proceedings, create a file comsoc-website/proceedings-YEAR.md [link] where YEAR corresponds to the year of the workshop. This file should contain the following information:

---
layout: proceedings
title: Proceedings COMSOC Workshop 2006
year: 2006
permalink: /proceedings/2006/
complete_proceedings: /assets/proceedings/comsoc2006.pdf
---

The complete_proceedings is not mandatory; it corresponds to the full proceedings (it is for now only available for the first four editions). If such a file exists, add it to the folder comsoc-website/assets/proceedings/ [link]

To add the PDF files of the papers, create a folder assets/proceedings/comsoc-YEAR/ [link] where YEAR corresponds to the year of the workshop. The PDF files have to be dumped there.

Finally, update the file comsoc-website/_layouts/proceedings.html [link] by adding the year in the all_years array in the header:

---
layout: default
all_years: [2006, 2008, 2010, 2012, 2014, 2016, 2018, 2021, 2023]
---

Modify/Add a Tool

Tools are described in the file comsoc-website/_data/tools.yml [link].

The YAML format is as exemplified below:

- name: preflib-tools
  topic: Preferences
  category: Preferences
  reference-tool: false
  type: Python
  url: https://github.com/PrefLib/preflibtools
  contributors:
    - name: Simon Rey
      url: https://simonrey.fr/
      maintainer: true
  language: Python
  has-tests: true
  documentation-url: https://preflib.github.io/preflibtools/
  description: >
    The PrefLib-Tools is a set of Python tools developed to work with preference data from the
    PrefLib.org website. This package provides input and output operations on PrefLib instances,
    and several property checks for the instance (preference domain, etc...)

The topic attribute needs to be one of the value of the list tools_topics defined in the comsoc-website/_config.yml file [link]. If you use a different value, the display will not work. Update the list if needed.

The category attribute indicates the end goal of the tool. Current values are: Preferences, Aggregation, Analysis, Application and Outreach. If you add additional values, remember to update the first section of the comsoc-website/tools.md file [link].

The reference-tool attribute indicate if this tool should be considered as a reference tool. These are tools that deserve special attention because of their significance within the COMSOC ecosystem.

The type attribute represents the kind of tool it is: "Website", "Python", ...

The language attribute is the programing language used to develop the tool. It is used to define the best practices.

The attribute has-tests indicates if unit-tests are included. This is mostly relevant for code libraries.

The documentation-url attribute points to the documentation of the tool. This is mostly relevant for code libraries.

If you want the description to be more fancy, by including a link for instance, you can include HTML tags in it (not markdown).

Modify/Add a Journal Special Issue

Journal special issues are described in the file comsoc-website/_data/specialissues.yml [link].

The YAML format is as exemplified below:

- journal: "Annals of Mathematics and Artificial Intelligence"
  topic: "Algorithms, Approximation, and Empirical Studies in Behavioral and Computational Social Choice"
  year: 2013
  volume: "68:1–3"
  url: "https://link.springer.com/journal/10472/68/1/page/1"

The volume entry typically includes both the volume and the issue number (but not all journals follow this format).

Modify/Add a Course

Courses are described in the file comsoc-website/_data/courses.yml [link].

The YAML format is as exemplified below:

- title: Computational Social Choice
  lecturer: Rohit Vaish
  lecturer_url: https://rohitvaish.in/
  institution: Indian Institute of Technology Delhi
  institution_url: https://home.iitd.ac.in/
  editions:
    - url: https://rohitvaish.in/Teaching/2023-Fall/
      name: 2023
    - url: https://rohitvaish.in/Teaching/2022-Fall/
      name: 2022-Fall

Modify/Add a Group Photo for the Front Page

The photos displayed on the front page are described in the file comsoc-website/_data/groupphotos.yml [link].

The format is as follows:

- src: Matching_Summer_School_2013.jpg
  title: Summer School on Matching Problems, Markets, and Mechanisms in Budapest (2013)
  url: https://archive.illc.uva.nl/COST-IC1205/Events/Action-Summer-Schools/Budapest-2013/

The src points to the photo in the directory comsoc-website/assets/images/group-photos [link]. The url points to the website of the event where the photo was taken.

If you are adding a new group photo, do not forget to put in the directory comsoc-website/assets/image/group-photos [link].

Archive a Static Website

To serve a standalone HTML website from the Jekyll project, perform the following steps:

• In the comsoc-website/_collections [link] folder, add an HTML file corresponding to the website you are adding, for instance website.html
• The content of comsoc-website/_collections/website.html should be:

---
permalink: /URL_TO_WEBSITE/:title
---

Here URL_TO_WEBSITE is the path at which the website is anchored.

• Create a folder comsoc-website/archive/website [link] where website is the name of the HTML representing the collection.
• Dump the content of the website in the folder.
• You are done.

This is used, for instance, to archive websites of old COMSOC Workshops.

Note that Server Side Includes like <!--#include file="header.html" --> are not supported. If you have a website that uses them, you should first flatten it. Similarly, you cannot serve a PhP website that way. Convert it into HTML before.

Development

The website was developed in Jekyll to provide easy integration with the GitHub tools. It should be relatively easy for anyone to make basic changes, even if they are not very familiar with Jekyll.

All the source files for the website are placed in the comsoc-website folder (due to GitHub Page requirements).

Layouts

The general layouts of the pages are described in the _layouts folder [link]. These layouts define the general structure of every page.

Pages

All pages are described in markdown files, mostly located in the root of the comsoc-website folder [link].

They all start with a header that indicates which layout is to be used, together with some additional information:

---
layout: default
title: This is the Title of the Page
---

Note that markdown files can incorporate HTML tags in case you need more flexibility for the display. Markdown parsing is automatically disabled in an HTML tag. You can enable it by adding the attribute markdown="1" to the HTML tag:

<section markdown="1">

# What is Computational Social Choice?
{: #comsoc}

The research field of computational social choice (COMSOC) 
is concerned with the design and analysis of methods for collective decision making. 
It is a dynamic interdisciplinary field of study at the interface of computer science and economics, 
fostering an exchange of ideas in both directions.
</section>

Page Structure

The page structure is as follows:

• Header with main menu (described in comsoc-website/_layouts/default [link])
• Alternation of <section> </section> for the content of the page.
• If there is need for in-page navigation links, there are added in the first section of the page (more on that below).
• Footer with the additional pages (described in comsoc-website/_layouts/default [link])

About the in-page navigation links. The section has to have the class section-with-navs. The navigation links are described in a <div class="page-navigation-wrap"> </div> that needs to be the last child of the <section> </section>. See the example below:

<section markdown="1" class="section-with-navs">

# Events

Besides the [COMSOC Workshop](workshops) and the [COMSOC Video Seminar](video-seminar),
there are also lots of other events where work on COMSOC gets presented and where COMSOC people meet.
On this page you will find a non-exhaustive list of such events.

<div class="page-navigation-wrap">
<div class="page-navigation">
<span><a href="#summer-schools">Summer Schools</a></span>
<span><a href="#dagstuhl">Dagstuhl Seminars</a></span>
<span><a href="#other">Other Events</a></span>
</div>
</div>
</section>

Style

The CSS style sheets are located in the assets/css folder [link].

Data

Many pages (PhD theses, seminar sessions, workshop proceedings, ...) are automatically constructed based on some data. These data files are located in the _data folder [link]. They are all .yml files, the syntax of which is described above.

Configuration

Global parameters for the website are stored in the file comsoc-website/_config.yml [link]. You can typically change the URL settings there, or update the link to the main repository.

Local Development

You can clone the repository and update it locally on your machine. On your machine, you can install all the prerequisites for a Jekyll website (see the Jekyll docs) and then run things locally.

To serve the website locally and see your changes live, run the following command inside the comsoc-website folder:

bundle exec jekyll serve

To build the website as a static HTML site, run the following command inside the comsoc-website folder:

bundle exec jekyll build

Note that you may have to change some parameters for this to run smoothly. A typical example is the baseurl parameter. Do not change the one in the _config.yml file, but simply pass the argument --baseurl YOUR_BASE_URL to the above commands.