python website django

Matīss Treinis 4867bb3cca Add markdown content, phase 1 migration		4 years ago
.venv	Initial commit	4 years ago
almalinux	Enable Spanish, Portuguese	4 years ago
ansible	.net, .com to .org redirect	4 years ago
commons	Add GA	4 years ago
frontend	Add markdown content, phase 1 migration	4 years ago
locale	Translated using Weblate (Spanish)	4 years ago
media	Initial commit	4 years ago
static	Showcase, contribute, section updates	4 years ago
www	Add markdown content, phase 1 migration	4 years ago
.editorconfig	Initial commit	4 years ago
.env.dist	New web	4 years ago
.gitignore	Deployment	4 years ago
.mypy.ini	New web	4 years ago
CONTRIBUTING.md	Fix pip3, update READMEs	4 years ago
Dockerfile	Initial commit	4 years ago
Dockerfile-frontend	Initial commit	4 years ago
Dockerfile-production	Admin styling, production dockerfile optimizations	4 years ago
LICENSE	Initial commit	4 years ago
Makefile	Allow to deploy from non-default repo and branch	4 years ago
Pipfile	Add markdown content, phase 1 migration	4 years ago
Pipfile.lock	Add markdown content, phase 1 migration	4 years ago
README.DEPLOY.md	Deployment	4 years ago
README.md	Fix pip3, update READMEs	4 years ago
docker-compose.production.yml	Scale instances	4 years ago
docker-compose.yml	Initial commit	4 years ago
kafe.lua	Allow to deploy from non-default repo and branch	4 years ago
manage.py	Initial commit	4 years ago
page_blog_dump.sql	Add markdown content, phase 1 migration	4 years ago
screenshot.png	Showcase, contribute, section updates	4 years ago

README.md

almalinux.org website

This repository contains website source code for https://almalinux.org.

This website is built with Python using Django web framework. It uses MariaDB as database backend, Docker and docker-compose for development environment deployment, and Pipenv is used to track project requirements, and manage Python dependencies.

JavaScript and SCSS is used for frontend, and is managed/built using Webpack Encore. See frontend/README for more details.

For developers

To deploy local development environment, you will need following dependencies installed on your development host:

Docker
docker-compose
make

Common development commands and automation related commands are listed in Makefile. Execute make help for a complete list of available commands.

Executing make dev will deploy a complete, ready to go development environment.

Directories and modules

/almalinux/ - Django project root.
/commons/ - A Django app-module with reusable utilities for app support.
/locale/ - Django locale files.
/media/ - Django file uploads.
/static/ - Static files and build output for frontend code.
/www/ - Django app that contains all logic for the website.
/frontend/ - JavaScript and SCSS frontend code.

Localization and translation

AlmaLinux OS localization and translation is managed using Weblate.

To contribute translations see AlmaLinux OS localization project in Weblate.

You can request new languages to be added by creating a ticket in GitHub issues.