# People pages and research areas

## Structure of people pages

### One person - one file

Each person’s page corresponds to a single file in the _departmentpeople/ folder called [UVA_COMPUTING_ID].md (all these files are here on GitHub). This naming is for the purposes of consistency with links in the old website. This file corresponds to the page https://math.virginia.edu/people/[UVA_COMPUTING_ID]/. The people listings such as https://math.virginia.edu/faculty/ and listings by research areas are generated automatically.

Note. The subfolders in _departmentpeople/ are purely for convenience - they do not affect anything in the actual website.

Here’s an example of such a file for a particular faculty member. The page itself is at https://math.virginia.edu/people/aso9t/.

### Referencing a person on the website by UVA computing ID

Having all data on people in one place allows to quickly reference them by UVA computing ID. For example, the code {% include person_info.html UVA_id="aso9t" %} produces the following nice listing of information about a faculty member with computing ID aso9t:

This is powered by this include file on GitHub, and one can create similar files to get, for example, reference without office number. All links are also taken from the person’s data and are handled correctly in case, say, personal page or phone is missing:  ,   129 Kerchof Hall

If there is no such computing ID (e.g. if a person left), then one space is displayed: . (Code: {% include person_info.html UVA_id="no_such_id" %})

### Fields in the people pages

#### Content

The first 15 lines in this file are for configuration, separated by two ---. The lines after line 15 (after the second ---) can be any content the person would like on their page, such as

• Selected publications
• More detailed description of research interests
• Any links, pictures, and so on

The syntax is markdown. Math formulas are also supported. As usual, plain HTML is supported inside markdown.

#### Configuration

Most configuration fields are self-evident, except the following:

general_position

This field is used to put the person in a correct listing such as https://math.virginia.edu/visitors/ or https://math.virginia.edu/gradstudents/. Possible values are:

• emeritus
• faculty (tenure-track or tenured)
• gradstudent
• lecturer
• postdoc
• staff

This field is also used in automatically counting the number of faculty/postdocs/etc on pages like about.

The exact title of the position is under position: configuration field, as in position: Assistant Professor.

image

Put the image file (jpg or png, any size/dimensions, but square and up to 600x600 preferred) into the folder /img/people/ in the source code, and link it in a configuration field like image: __SITE_URL__/img/people/Obus.jpg.

Important! keep the __SITE_URL__ prefix as is, this is needed for correct automatic generation of the website.

office_hours

If you’d like, you can add office hours to be displayed on the website. They will be shown in the list of people and on the person’s page at the department website. However, this information should be kept up to date, and so office hours should probably not be added for all facutly.

areas

This is a field which determines how people are displayed by research area in the general lists of the people in the department (for example, here). See below for details.

These fields determine only where the person is displayed in the graduate research areas information page.

To add a person, make a new file and fill all the fields in. The person’s page will appear on the website on correct pages.

To remove a person, either delete the file, or remove it from the building of the website by adding published: false, say, before the areas: line.

[update: April 24, 2018]
The setting published: false appears to be broken in a new version of Jekyll, so please manually move the source files to a special folder /_UNPUBLISHED/ in the source

## Research areas

### Adding research areas to people

The listings of people by research area such as https://math.virginia.edu/research/analysis/ are generated automatically. To ensure correct generation of the website, one needs to add the exact research areas to each person’s configuration, as in the example above:

Possible values for research areas are quite broad and include the cup signs $\cup$ to indicate this. Here are the possible values for research areas one can put into a person’s .md page:

• Algebra&nbsp;$$\cup$$&nbsp;Representation Theory
• Geometry&nbsp;$$\cup$$&nbsp;Topology
• Analysis&nbsp;$$\cup$$&nbsp;PDE&nbsp;$$\cup$$&nbsp;Operator Algebras
• Probability&nbsp;$$\cup$$&nbsp;Combinatorics
• Mathematical Physics&nbsp;$$\cup$$&nbsp;Applied Mathematics
• History of$$\$$Mathematics

The list of these values is in the file _data/research_areas.yml (GitHub link), here is an example of one entry (the dash in the first line and indentation are important):

### Changing global research areas

For correct display of research areas, three conditions must be met:

1. The research area is described in _data/research_areas.yml as above
2. A simple file corresponding to the research area with permalink corresponding to the area’s shortname must be manually created. These files are in people/research/ folder, see an example file on GitHub.
3. In the people’s pages, the research area should be listed exactly, according to its name field.