Skip to content

scipy-conference/conference.scipy.org

Repository files navigation

conference.scipy.org

This repository contains the landing page for conference.scipy.org. Each conference manages its own website. This site is only meant to capture the commonalities between them.

Quick Set Up

In a Python virtual environment, install dependencies:

$ make init

Build the site. The output will be in the output/ directory.

$ make html

To view the site locally:

$ make serve
< open browser to http://127.0.0.1:8000 >
( you should see your test page in the News and archives )
< Ctrl-C to exit server on terminal >

Adding and Editing Items

The website is a set of static pages generated by Pelican from Markdown files. The content is published automatically to GitHub Pages every time a pull request is merged to the main branch.

News items in content/news are published on the News pages. The format looks like this:

$ cd content/news
$ cat << EOF > 2024-03-05-test.md
> Title: Test
> Date: 2024-03-05
> Comments: true
> Categories: 
> Author: Ze Claw <[email protected]>
> Summary: Testing
> 
> Testing how this works!
> 
> EOF

Pages in content/pages map to top-level menu items as defined in pelicanconf.py.

After adding or making changes to an item, regenerate the site:

< Ctrl-C to exit server on the terminal if it's already running >
$ make html && make serve

Edit the Home Page and the Layout

The layout is defined in the theme/ folder.

$ ls theme
tuxlite_zfs

Update Dependencies

There's a Make target to update dependencies:

$ make update-deps

It'll read dependencies from pyproject.toml and update the requirements.txt file with the latest version.

Contact

The site is collaboratively edited by the SciPy Organizers. Please email [email protected] for details.