lszeremeta/megen repository overview

Molecular Entity Generator (MEgen) is a convenient online form to generate structured data about molecules. It supports all common structured data formats - JSON-LD⁠, RDFa⁠, and Microdata⁠. MEgen was created using PHP⁠ and Bootstrap⁠. Do you love️ Docker? You can use a MEgen container⁠. Come on, try MEgen now!

⁠What is structured data

Structured data⁠ is additional data placed on websites. It is not visible to ordinary internet users but can be easily processed by machines. There are 3 formats that we can use to save structured data - JSON-LD⁠, RDFa⁠, and Microdata⁠. MEgen supports them all and uses the MolecularEntity profile⁠.

⁠How to start

MEgen is available online. If you just want to try MEgen, this is the best option.

• megen.top⁠ - corresponds to the latest GitHub release⁠ (the most stable version)
• beta.megen.top⁠ - corresponds to the GitHub pre-release⁠ (latest possible changes, but may be less stable; published after every change in the master branch)

⁠Run Mengen on your own

MEgen needs HTTP server (e.g. Apache⁠ or NGINX⁠) and PHP⁠ to work. You can also use Docker image to run the app fast and easy.

⁠Docker image

You can use the pre-built image on Docker Hub⁠:

docker run --name megen -p 4000:80 -d lszeremeta/megen:latest

Then, you can use the app by reaching http://localhost:4000⁠.

⁠Local Docker build

Another option is to build the container yourself. You need to download the contents of the MEgen repository⁠ and then build and run the application. If you don't want or can't use git, you can download the zip archive⁠ and extract it, then execute the last two commands inside extracted code directory.

git clone [email protected]:lszeremeta/MEgen.git
cd MEgen
docker build -t megen .
docker run --name megen-container -p 4000:80 -d megen

Then, you can use the app by reaching http://localhost:4000⁠.

⁠Contribution

Would you like to improve this project? Great! We are waiting for your help and suggestions. If you are new to open source contributions, read How to Contribute to Open Source⁠.

⁠License

Distributed under MIT License⁠.

⁠See also

These projects can also be useful:

• SDFEater⁠ - Always hungry SDF chemical file format parser with many output formats
• Molstruct⁠ - Convert chemical molecule data CSV files to structured data formats