PCD Web interface

This is the web interface to the PublicCode.Directory (PCD) project.

Like everything else in life it is not complicated but it will take a bit of time and the responsability for the information provided lies only with the maintainers of the respective software.

How to improve / develop the web interface

In order for this to improve / fix the web interface project, please follow the steps below:

• You need a folder that contains the GRAV CMS. You can download a copy from here

• Clone / fork / download this repository

• Extract the downloaded folder and replace the content of the user/pages user/plugins user/themes folders with the folders from this repostiory

• You will need to have Docker, Noje.js and a Code editor installed on your computer

• cd into the newly created folder that contains the full Grav CMS with your changes

• Run the docker build . -t image-name command to build the image locally

• Modify the docker-compose.yaml file to modify the image to the newly locally build image image-name

• Run docker-compose up -d

• cd into the user/themes/public-code-directory

• Run npm install to get all dependencies installed locally

• You ca run the following comamnds locally:

  • npm run serve or yarn serve to start a local live development session
  • npm run build or yarn build to build the final project

• Once changes are done, you can push back to Github and create a Pull Request

• Credits go to our partners:
  • OpenUK for supporting this project
  • FSFE for supporting this project
  • Public Code Europe for helping out with the discovery and localization of the open source software
  • Vue.js and its creators for the simplicity and flexibility of their tools
  • Vue.js CLI for simplifying the creation of such websites / SPA / PWA

Grav

Grav is a Fast, Simple, and Flexible, file-based Web-platform. There is Zero installation required. Just extract the ZIP archive, and you are already up and running. It follows similar principles to other flat-file CMS platforms, but has a different design philosophy than most. Grav comes with a powerful Package Management System to allow for simple installation and upgrading of plugins and themes, as well as simple updating of Grav itself.

The underlying architecture of Grav is designed to use well-established and best-in-class technologies to ensure that Grav is simple to use and easy to extend. Some of these key technologies include:

• Twig Templating: for powerful control of the user interface
• Markdown: for easy content creation
• YAML: for simple configuration
• Parsedown: for fast Markdown and Markdown Extra support
• Doctrine Cache: layer for performance
• Pimple Dependency Injection Container: for extensibility and maintainability
• Symfony Event Dispatcher: for plugin event handling
• Symfony Console: for CLI interface
• Gregwar Image Library: for dynamic image manipulation

Requirements

• PHP 5.5.9 or higher. Check the required modules list
• Check the Apache or IIS requirements