Pipeline is The Rensselaer Polytechnic's next website. It will enable rapid development of new article layouts and interactive features. In the long term, it will provide a solid platform for our content over the coming decade and support The Poly's focus on online-first journalism.
Ensure these are installed before continuing.
You can change Pipeline's settings to use SQLite instead of Postgres, but this is not recommended because Pipeline relies on Postgres's full-text search features.
Pipeline is written in Python. It uses Sass and PostCSS on the frontend with webpack to glue them together.
Note about Postgres
Pipeline expects to be able to connect to a Postgres database named
pipeline. To set this up on macOS:
brew install postgresql brew services start postgresql createdb pipeline
The default dev database, defined in
settings/dev.py uses the following postgres url:
postgresql://postgres:email@example.com:5432/pipeline make sure that your database is configured to these settings. The pipeline database must exist, and the user
postgres must exist with password
postgres. Read more about postgres urls here.
Read about creating a user here. You will probably want postgres to be a superuser.
git clone firstname.lastname@example.org:thepoly/pipeline.git cd pipeline npm install npx webpack --config webpack.development.config.js pipenv install --dev pipenv run python manage.py createcachetable
pipenv shell python manage.py migrate python manage.py createsuperuser python manage.py runserver
If you have issues with the database, ensure that Postgres is running and you have created a database named
Pipeline can also be run in its production configuration with Docker. It requires three containers: one for running the Django project with gunicorn, another to put nginx in front of it and additionally serve static files, and finally a Postgres container.
Ensure that the
SECRET_KEY environment variable is set. Additionally, run the following inside of the
django container (e.g.
docker-compose exec django bash):
python manage.py migrate python manage.py createsuperuser
Pipeline will be available at port 8000 on localhost.
How to make changes to styling
With your terminal/command prompt running
python manage.py runserver, open another at the project folder location and run
npm run watch.
Now you can edit styles at pipeline/pipeline/static/css/pipeline.scss
Many of the following features are partially complete, but this isn't indicated. Look at the Issues page if you need to know what is being worked on.
- Index pages
- Article pages
- Basic layout
- Section-specific layouts
- Editor previews
- Archive pages
- WordPress importer
- Old site importer
- Related to authors
- Multiple per article
- RSS feed
- Facebook tags
- Twitter tags
- Apple News
- Home page
- Basic article prioritization
- Full user control of column layout
- Index page
- Individual pages
- Authored articles
- Bylined photos
- Staff photos
- Email addresses on staff pages
- Basic publish permission level
- Fine grained permissions
- G Suite authentication
- Basic headline search
- Search all fields of articles
- Search non-article pages
- Basic Prometheus metrics
- DB metrics
- HTTP Basic auth