Skip to content

developer-portal/website

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Website for Fedora Developer Portal

Project Page | Content Repository | Website Repository

Docker Repository on Quay

This repository contains Jekyll templates, CSS styles and images for the Fedora Developer Portal.

Please submit your ideas, bug reports or requests regarding:

Implementation

The whole site is generated with Jekyll as a static site with some dynamic parts. Site search functionality is implemented in JavaScript and the index is pre-generated during the Jekyll build.

There is an rss.py script that replaces the blog posts section on the index page in the generated _site/ from the Fedora Planet.

Development

We use Jekyll to generate the site, setup.sh script to install development dependencies (on Fedora) and we also provide Vagrantfile and Dockerfile to spin up the whole development environment. content repository is a git submodule.

See our development guide on how to run the site locally for development.

To build the site run jekyll build or jekyll serve. You need to install dependencies first.

Tests

We have some basic Capybara/Webkit test specifications that can help you to notice if something broke. They will also check all internal links between pages so you should also run them to test changes in content repository.

To execute the test suite run rspec spec. You need to install dependencies first and the site has to be already generated and available in _site/ folder.

Contributing

Contributions are welcome! For more information see our Contributing Guide.

You can find us on libera under #developer-portal if you have any further questions.