mixxxdj/website

Name: website

Owner: Mixxx DJ Software

Description: The Mixxx.org website

Created: 2013-09-09 21:23:01.0

Updated: 2018-01-04 21:20:48.0

Pushed: 2018-01-11 07:18:13.0

Homepage: null

Size: 54248

Language: HTML

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

Mixxx Website

This repository contains the source to Mixxx website. This site is built with Cactus, a static site generator.

Quick Start

To get started contributing to the Mixxx website, first install all requirements (e.g. Cactus). Optionally, use a Virtualenv to isolate dependencies.

$ pip install -r requirements.txt

Then build the site from its templates:

$ cactus build

If all goes well, you should have the rendered HTML in your `.build` directory. To stand up a development server to test out your change, type:

$ cactus serve

You can then visit `http://127.0.0.1:8000` to see your development version of the site.

Documentation

Cactus uses Django's templates for rendering pages.

The main templates are stored in the `templates/folder. Leaf pages are stored in ``pages/`. If there is a snippet of code you want to use in multiple places on the site, place it in thetemplates/`` folder – for example templates/download_button.html.

Internationalization / Translation

All strings wrapped with `{% trans 'Hello World' %}are flagged for translation. Whenever adding new English strings to the website, please wrap them in a ``{% trans 'Hello World' %}``` block.

Publishing

Note: Requires SSH access to mixxx.org.

First, publish to http://staging.mixxx.org:

b staging rebuild publish

Visit the staging site to verify everything looks ok. Then, publish to the production site:

b production rebuild publish

Visit https://mixxx.org to verify everything looks ok.


This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.