Repository files navigation

A web editor to generate and validatepubliccode.yml files

This app helps you create and validate apubliccode.yml file for your project.Simply fill out the form to generate a YAML file that meets the latest standards,which you can then download or copy to your project's root directory.

You can also use the app to check and correct an existingpubliccode.yml file.Just upload the file to import it, and the app will validate and help fix any issues.

First clone the repository:

git clone https://github.com/italia/publiccode-editor.git

Navigate to the created directory, and run:

npm cinpm run build:licensesnpm run build:wasm

In order to run the development server locally, you should run:

npm run dev

This will expose a webserver listening athttp://localhost:8080.

In order to develop in a container, you have to match the following criteria:

• VSCode installed
• Docker installed and running
• VSCode Devcontainer extension installed (doc)

You can clone the repo, run VSCode in that folder and run in a container.

Otherwise, you could simply click on following button.

This repo will be cloned in a Container Volume.

For more details, check Devcontainer documentation out at the following links

• Specs
• VSCode Devcontainer

Every configuration process, such as dependency installation or wasm configuration, is handled by Devcontainer.

In order to run the development server, you should run:

npm run dev

The editor is fully static and can be build with:

npm run build

and then serve the content ofdist/ in production.

By running:

docker build -t publiccode-editor .

you can build a Docker image. Subsequently, by running:

docker run -p 8080:80 publiccode-editor

you can run the Docker container and see the results athttp://localhost:8080.

To access the web-app in a specific language use thelang param like this:https://publiccode-editor-develop.vercel.app/?lang=en.

The languages that can be picked are:

• "it" 🇮🇹
• "en" 🇬🇧
• "fr" 🇫🇷
• "de" 🇩🇪
• "nl" 🇳🇱

We welcome contributions!If you encounter any issues with the app, please file an issue on GitHub.

For guidance on how to contribute effectively, check theCONTRIBUTING.md file in the root of the repository.

This project is covered by aGNU Affero General Public License v3.0 or later license.