Development

Note

If not stated otherwise, the development documentation currently applies to all Ekklesia Python web apps, ekklesia-portal and ekklesia-voting. ekklesia-portal is used as an example in the documentation.

• Backend: Python 3.8

• Web framework: Morepath

• Frontend

  • Pyjade (like Pug)
  • Jinja
  • Bootstrap 4
  • Sass
  • Javascript

• Database: PostgreSQL 12

• Dependency management and build tool: Nix

• (Optional) Docker / Kubernetes for running Docker images built by Nix

Contents

• Development Quick Start
• Development Environment
  • Install Nix
  • Install Lorri
  • Running PostgreSQL as User
  • Updating The Development Environment
  • Editor / IDE Integration
• Concept Tutorial
  • Building Blocks
  • Generate a Concept
  • Test it
  • Extend it
• Testing
  • Running Tests
• Templates
  • HTML Tags and Attributes
    • Class and ID Literal
    • Values from Expressions
    • Boolean Attributes
    • Differences to Pug
  • Code
    • Buffered (With Output)
    • Unbuffered
  • Conditionals
  • Plain Text
    • Mixing Code with Text
  • Iteration
  • Comments
  • Code Style
• Stylesheets
  • Generate CSS
• Dependency Management